Command guide

Slash commands appear when you type / in the configured server. Owner commands use the prefix in config.json (, in the examples). Seeing a slash command in Discord does not mean you can run it; /perm shows your bot access. Owners can run all commands. In the example config, the moderator role covers warnings, timeouts, case viewing and giveaways; the administrator role also covers kicks, bans, unbans, announcements and case changes. You can change those minimum levels in permissions. The ticket-handler role can claim and close tickets.

Slash commands

Command	Fields and result
`/help`	Lists the main tasks and where to start.
`/perm`	Shows your access level and whether setup lock is on.
`/warn`	Pick `member`, write `reason`. Saves a numbered case and tries to DM the member.
`/mute`	Pick `member`, write `reason` and `length` such as `30m`, `12h` or `7d`. Uses Discord timeout (maximum 28 days).
`/unmute`	Pick `member`; optional `reason`. Removes a timeout.
`/kick`	Pick `member`, write `reason`. Kicks and records a case.
`/ban`	Pick `member`, write `reason`; optional `length` such as `7d`. Without a length the ban is permanent. Timed bans are checked for expiry, and the bot only lifts a ban whose Discord audit reason still names its case.
`/unban`	Provide `user-id` and `reason`. Lifts a ban and records a case.
`/case`	Give a `number` to view. Choose `edit` with a new `reason`, or `remove`, if you have administrator access.
`/ticket claim`	In an open ticket, claim it as a handler.
`/ticket close`	In an open ticket, give a resolution. Saves a TXT transcript, sends it to the private ticket log and tries to DM the opener, then deletes the channel. If logging fails, it leaves the ticket open.
`/ticket list`	Lists your tickets. A handler may choose another `member`.
`/report`	Write `details`; optionally choose a `member`. Saves the report and sends it to the private report channel.
`/announce`	Write `message`, optionally choose a text `channel`. Administrator access required. Mentions are suppressed.
`/giveaway`	Write `prize`, `minutes` (1–10,080), and optional `winners` (1–20). Members enter with a button.

Examples: /ban member:@Example reason:Repeated scams length:7d creates a temporary ban. /ticket close reason:Resolved in support saves the conversation before the channel is removed. /case number:12 action:view reads case 12.

Owner prefix commands

These commands use the private ownerIds list, not a Discord role. The bot tries to delete the command message after reading it so setup IDs are not left in public chat.

Command	Result
`,help`	Shows all owner commands.
`,status`	Shows the setup lock and key channel settings.
`,lockdown on` / `,lockdown off`	Restricts staff commands to owners, or allows configured staff roles. Fresh installations start locked.
`,panel`	Posts a button that opens private tickets in the configured ticket category. Run it in the channel where members should see the panel.
`,reactionrole ROLE_ID EMOJI \| Panel text`	Posts a reaction-role panel in the current channel. The bot needs Manage Roles and its role above the target role. Example: `,reactionrole <ROLE_ID> ✅ \| React to receive updates`. Replace the placeholder with your own role ID.

Missing or refused commands

Run npm run deploy after changing the installed command set, and check that applicationId and guildId match the licence.
Enable Message Content Intent if owner prefix commands do not respond.
Run /perm and check your owner ID or configured role. While setup lock is on, only owners can use staff commands.
Check the bot role's position and Discord permissions if Discord rejects a role, timeout, kick, ban, channel or message action.
Check the configured log and category IDs if reports or tickets cannot be delivered.

The base edition does not contain a voice recording command or HTML transcript viewer. If your delivery record lists an add-on, see docs/VOICE.md or docs/HTML.md for its commands and setup.