NinthDOCS

Reference / Commands

Commands

A full list of Ninth Bot's slash commands and right-click menus, with every option. Use /help in Discord to see the commands you can use.

All commands work in servers only, not in DMs. Replies from moderation and admin commands are private to you.

Utility

CommandWhat it doesWho
/helpLists the commands you can use, by categoryEveryone

Tickets

CommandWhat it doesWho
/reportReports a member to staffEveryone

Tickets themselves are opened from a panel and handled with buttons. See Tickets.

Moderation

CommandWhat it doesWho
/warnWarns a member and DMs themModerate Members
/timeout setTimes a member outModerate Members
/timeout removeRemoves a timeout earlyModerate Members
/kickKicks a memberKick Members
/banBans a user, permanently or for a timeBan Members
/unbanLifts a banBan Members
/purgeBulk deletes recent messages in a channelManage Messages
/noteAdds a private staff noteModerate Members
/caseShows one caseModerate Members
/historyShows a member's profile and casesModerate Members
/reasonEdits a case's reasonModerate Members, and the case's moderator or Manage Server

Admin

CommandWhat it doesWho
/setupOpens the setup panelManage Server
/statusShows bot health, ping, database speed and background jobsManage Server
/alerts addAdds or updates a stream alertManage Server
/alerts removeRemoves a stream alertManage Server
/alerts listLists the server's stream alertsManage Server
/alerts testPreviews an alert card privatelyManage Server

Administrator also works wherever Manage Server is listed.

Context menus

Right-click (or long-press) a message or member, then choose Apps.

MenuOnWhat it doesWho
Report messageA messageReports the message to staffEveryone
ModerateA memberOpens a panel to warn, time out, kick, ban or note themModerate Members

/help

No options. Shows the command categories you have access to, and links to the dashboard and privacy policy. Only the person who ran it can use its menu.

/help

/report

OptionRequiredDescription
userYesThe member you are reporting
reasonYesWhy, up to 1000 characters
message_linkNoA link to a message in this server
evidence-1NoA file: image, video, text or PDF, up to 8 MB
evidence-2NoA second file
evidence-3NoA third file
/report user:@member reason:Posting scam links in #general evidence-1:screenshot.png

See Reports.

/warn

OptionRequiredDescription
userYesThe member to warn. They must be in the server
reasonYesWhy, up to 1000 characters
/warn user:@member reason:Spamming invites

/timeout set

OptionRequiredDescription
userYesThe member to time out
durationYesFor example 10m, 2h or 7d. 10 seconds to 28 days
reasonNoShown in the mod log and the DM, up to 1000 characters
/timeout set user:@member duration:1h reason:Harassment

/timeout remove

OptionRequiredDescription
userYesThe member whose timeout to remove
reasonNoWhy, up to 1000 characters
/timeout remove user:@member reason:Apologised

/kick

OptionRequiredDescription
userYesThe member to kick
reasonNoShown in the case and the audit log, up to 1000 characters
/kick user:@member reason:Repeated spam after warnings

/ban

OptionRequiredDescription
userYesThe user to ban. They don't have to be in the server
reasonNoShown in the case and the audit log, up to 1000 characters
durationNoFor a temporary ban, for example 1d, 12h or 2w, up to 365 days. Leave out for a permanent ban
delete-messagesNoHow much of their message history to delete: none, the previous hour, 6 hours, 24 hours, 3 days or 7 days
/ban user:@member reason:Raid account duration:30d delete-messages:Previous 7 days

/unban

OptionRequiredDescription
user-idYesThe banned user's ID, or a mention
reasonNoShown in the case and the audit log, up to 1000 characters
/unban user-id:123456789012345678 reason:Ban served

/purge

OptionRequiredDescription
amountYesHow many messages to delete, 2 to 100
userNoOnly delete this user's messages
reasonNoWhy, up to 1000 characters
/purge amount:30 user:@member reason:Spam wave

Messages older than 14 days and pinned messages are skipped.

/note

OptionRequiredDescription
userYesThe user the note is about. They don't have to be in the server
noteYesThe note, up to 1000 characters
/note user:@member note:Warned verbally in voice chat

/case

OptionRequiredDescription
numberYesThe case number. Suggests recent cases as you type
/case number:42

/history

OptionRequiredDescription
userYesThe user to look up
/history user:@member

/reason

OptionRequiredDescription
numberYesThe case number. Suggests recent cases as you type
reasonYesThe new reason, up to 1000 characters
/reason number:42 reason:Spamming invite links in #general

/setup

No options. Opens the private setup panel. See Setting up the bot.

/setup

/status

No options. Shows uptime, gateway ping, database latency, memory use and the last run of each background job. A job is marked overdue when it missed two runs, and shows its last error when it failed.

/status

/alerts add

OptionRequiredDescription
platformYesTwitch or YouTube
handleYesTwitch username, or YouTube handle or channel ID
channelNoA text or announcement channel. Default: the default alert channel
roleNoA role to ping. Default: the default ping role
liveNoAlert on live streams. Default: true
videosNoAlert on new videos (YouTube only). Default: true
shortsNoAlert on new Shorts (YouTube only). Default: true
custom_messageNoYour own alert text. Supports placeholders such as {streamer}, {title}, {url} and {role}
/alerts add platform:Twitch handle:ninth channel:#live role:@Live Pings

See Stream alerts for every placeholder.

/alerts remove

OptionRequiredDescription
alertYesThe alert to remove. Suggests your server's alerts as you type
/alerts remove alert:ninth

/alerts list

No options.

/alerts list

/alerts test

OptionRequiredDescription
platformYesTwitch or YouTube
handleYesThe creator's username or handle
/alerts test platform:Twitch handle:ninth

Report message

Right-click a message, choose Apps, then Report message. A form asks why you are reporting it (required, up to 1000 characters).

Moderate

Right-click a member, choose Apps, then Moderate. The panel shows Warn, Timeout, Kick, Ban and Note, limited to what you have permission for. Each opens a form:

ActionFields
WarnReason (required)
TimeoutReason (optional), duration (required, up to 28 days)
KickReason (optional)
BanReason (optional), duration (empty for permanent, up to 365 days), delete message history
NoteNote (required)

The panel only works for you, and expires after 15 minutes.