# Mute Warn

> Troubleshooting mute hierarchy, warning points, duration format, and point decay

- Skill: `kangarko/mute-warn` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kangarko/mute-warn`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kangarko/mute-warn/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kangarko (https://skillmd.com/u/kangarko)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/kangarko/mute-warn

---


# Mute & Warning Troubleshooting

## Diagnostic Flow — "Player can still chat while muted"

1. Check mute is active and hasn't expired
2. Check `Mute.Prevent_Writing: true`
3. Check `Soft_Mute` setting — if true, the muted player sees their own messages (thinks they're chatting normally but nobody else sees them)
4. Channel mute only affects that channel — player may chat in other channels
5. Check `chatcontrol.bypass.mute` permission

## Common Mistakes

- **`Soft_Mute` is deceptive by design** — muted player sees their own messages and thinks they're chatting normally. Other players don't see anything. Users (admins) report "mute isn't working" because the muted player doesn't complain — they don't know they're muted
- **Duration format is strict: `30m` not `30 m`** — no spaces between number and suffix. `s`/`m`/`h`/`d` suffixes. No duration = permanent
- **Point decay only for online players** — offline players retain their points indefinitely. Points only decay via the `Reset_Task` when the player is online
- **Mute hierarchy: proxy > server > channel > player** — higher-level mutes take priority

## Cross-Plugin Conflicts

- Mute state is checked in the channel send pipeline. If another plugin handles chat before ChatControl, the mute may not apply