Bans

Ban Powers & Moderation Commands
Some commands require a matching xat power (like Badge, Boot, Zap). Others are core moderation commands (Ban/Mute/Gag/Unban) that depend on your rank/permissions in the chat.

1) Power-based action commands
These commands require you to OWN the matching power. If you don’t own it, the bot blocks it and tells you what power you need.

• !snakeban | Required power: Snakeban | Allowed on self without power: Yes
• !spaceban | Required power: Spaceban | Allowed on self without power: Yes
• !matchban | Required power: Matchban | Allowed on self without power: Yes
• !mazeban | Required power: Mazeban | Allowed on self without power: Yes
• !codeban | Required power: Codeban | Allowed on self without power: Yes
• !reverseban | Required power: Reverse | Allowed on self without power: Yes
• !zipban | Required power: Zip | Allowed on self without power: Yes
• !slotban | Required power: Slotban | Allowed on self without power: Yes
• !badge | Required power: Badge | Allowed on self without power: No
• !dunce | Required power: Dunce | Allowed on self without power: No
• !naughtystep | Required power: Naughtystep | Allowed on self without power: No
• !yellowcard | Required power: Yellowcard | Allowed on self without power: No
• !flipban | Required power: Flipban | Allowed on self without power: No
• !zap | Required power: Zap | Allowed on self without power: No
• !boot | Required power: Boot | Allowed on self without power: No

Power list reference: Ban Powers

---

2) Core moderation commands (no “power” required)
These do NOT depend on owning a power. They depend on permissions (owner/mod/bot rules).

• !ban — bans a user for X hours (with optional reason)
• !unban — unbans a user (and in your setup, resets moderation violation counters if enabled)
• !mute — mutes a user for a duration (1m/1h/1d etc) with a reason (owner-only in your setup)
• !gag — gags a user for a duration (optional reason) (owner-only in your setup)
• !ungag — removes gag and sets the user back to guest (owner-only in your setup)

---

!ban


• Usage: !ban [regname/xatid] [hours] [reason]
• What it does: converts hours → seconds and sends a ban packet like /g[seconds]
• How it finds the target:
• If you type an ID, it uses it directly
• If you type a regname, it tries to find them in the chat, otherwise it resolves using the database

---

!unban


• Usage: !unban [regname/xatid]
• What it does:
• Resolves the user ID from regname/ID
• Looks up the numeric chatId for the current bot from the database
• Sends an unban packet (/u) targeted to that chat
• Extra behavior (your setup):
• If moderation is enabled, it also resets the user’s violation counters (message + name) so they don’t instantly re-trigger filters

---

!mute


• Usage: !mute [userid/reg] [duration] [reason]
• Duration formats:
• 30s = 30 seconds
• 5m = 5 minutes
• 2h = 2 hours
• 1d = 1 day
• If no unit: treated as hours

---

!gag


• Usage: !gag [userid/reg] [duration] [reason]
• Duration formats: same as mute (s/m/h/d, default hours)

---

!ungag


• Usage: !ungag [userid/reg]
• What it does:
• Resolves the user ID
• Sends the “remove gag” action in your setup
• Also sets the user back to guest (/r)

---

Undo commands (power-based)
These are used to remove effects from power actions (where supported by your bot).

• !undunce [userid/reg] — removes Dunce from a user
• !undunceall — removes Dunce from everyone affected (admin/owner usage recommended)

---

Why commands get blocked


• Power-based commands: you don’t own the required power (Badge/Boot/Zap/etc).
• Core moderation commands: you don’t have permission (rank rules / bot owner rules).
• Invalid usage: missing ID, duration, or wrong format.

---

Tip: keep examples short


• !ban troublemaker 24 spam
• !unban troublemaker
• !mute 123456 10m flooding
• !gag username 1h being disruptive
• !ungag username
• !undunce username