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 status 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

CommandFields and result
/helpLists the main tasks and where to start.
/perm statusShows your role access, approved grants and setup lock.
/perm select group:ModerationRequests all moderation commands. Add optional command:warn for one command or member for another member.
/perm remove group:ModerationRequests removal of an approved group grant. Add the same optional command or member to remove that exact grant.
/warnPick member, write reason. Saves a numbered case and tries to DM the member.
/mutePick member, write reason and length such as 30m, 12h or 7d. Uses Discord timeout (maximum 28 days).
/unmutePick member; optional reason. Removes a timeout.
/kickPick member, write reason. Kicks and records a case.
/banPick 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.
/unbanProvide user-id and reason. Lifts a ban and records a case.
/caseGive a number to view. Choose edit with a new reason, or remove, if you have administrator access.
/ticket claimIn an open ticket, claim it as a handler.
/ticket closeIn 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 listLists your tickets. A handler may choose another member.
/reportWrite details; optionally choose a member. Saves the report and sends it to the private report channel.
/announceWrite message, optionally choose a text channel. Administrator access required. Mentions are suppressed.
/giveawayWrite prize, minutes (1–10,080), and optional winners (1–20). Posts an embed with prize, closing time, host and entry count; members enter with a button. The card changes when it ends.
/quarantine setupOwner: cover all current channels using the configured role and private room.
/automod status, /automod testOwner: read the configured mode and thresholds, or preview a text verdict without acting.
/quarantine hold, release, statusAuthorised staff: isolate a member with a reason, restore their saved roles, or inspect the state.
/staffapplyMembers: answer the configured staff application questions in a private form.
/staffrecord view, listAuthorised staff: view one record or the active roster.
/staffrecord appoint, removeAuthorised staff: grant a configured position and roles or end an appointment.
/staffrecord profileAppointed staff: set their own name and IANA timezone on the record.

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.

Permission approvals

Set permissionRequests.enabled to true and permissionRequests.reviewChannelId to a private text channel ID. Restart and run npm run deploy. A member can then use /perm select to request a whole group or a single command for themselves or another member. The bot posts Approve and Deny buttons in that channel, showing both requester and target. Only IDs in ownerIds can decide requests. Approved grants take effect immediately without granting a Discord role. /perm remove sends a matching removal request; approval removes that grant. An exact command grant and a whole-group grant are separate, so removing one does not silently remove the other. The setup lock still restricts non-owners until ,lockdown off. Removing a grant does not remove access inherited from a configured Discord role.

Groups: Moderation (warn, mute, unmute, kick, ban, unban), Cases (caseView, caseChange), Community (giveaway, announce), Staff records (staffManage) and Quarantine (quarantine). Command values are entered without a slash and are case-sensitive. Ticket handlers use roles.ticketHandler; owner-only setup and automod commands cannot be granted through this flow.

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.

CommandResult
,helpShows all owner commands.
,statusShows the setup lock and key channel settings.
,lockdown on / ,lockdown offRestricts staff commands to owners, or allows configured staff roles. Fresh installations start locked.
,panelPosts 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 textPosts 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.
,automod / ,automod test MESSAGEShows the mode and thresholds, or previews a text rule without taking action. Change rules in config and restart.
,quarantine statusShows whether the configured role and room have passed /quarantine setup.

Missing or refused commands

  • Run npm run deploy for each configured application and server after changing the installed command set.
  • Enable Message Content Intent if owner prefix commands do not respond.
  • Run /perm status and check your owner ID, configured role and grants. 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.

See Advanced automod and Staff applications and records for full setup and behaviour.