Commands - CosmicCubicle/PariahBot GitHub Wiki
16 slash commands, plus 3 right-click actions. Staff come in two levels (see Server-Roles):
-
(Admin): Discord's Administrator permission, or an admin role (
/setup admin-role add). -
(Mod): a mod role (
/setup mod-role add), or any admin.
Manage Channels alone is neither. Everything else is open to all members.
Run npm run deploy after changing any command definition, or Discord won't
show the change.
| Command | What it does |
|---|---|
/help |
Lists every currently registered command and its options — generated from what's actually loaded, so it's never out of date. |
/ping |
Bot and Discord API latency. |
/level rank [user] |
Your level and XP, or someone else's. |
/level leaderboard |
Top 10 members by XP in this server. See Activity-Levels. |
/vc … |
Controls for the temporary voice channel you currently own — see below. |
/streamers link platform account |
Link your own Twitch or YouTube channel for alerts. Needs the streamer role. See /streamers. |
/streamers unlink [platform] |
Remove your own links. |
Full guide: Temp-Voice-Channels.
Not admin-gated: it's scoped to whoever owns the channel they're connected to.
| Subcommand | Effect |
|---|---|
name <name> |
Rename your channel |
limit <n> |
Set a user limit (0 = unlimited) |
lock / unlock
|
Stop / allow new people joining |
kick <member> |
Disconnect someone from your channel |
claim |
Take ownership if the owner left. Mods can claim from a non-mod owner who's still present |
transfer <member> |
Hand ownership to someone else in the channel |
Admins can switch off any of these for owners, except claim, with /voice owner-control.
Each command or subcommand is marked (Admin) or (Mod) in Discord. Below, a command is mod-level unless it says otherwise.
Full guide: Server-Roles.
| Subcommand | Effect |
|---|---|
member-role |
Set/create/clear the member role. Required by the captcha and /roles apply-channel-defaults
|
admin-role add / remove / list / clear
|
Manage the roles that count as admins. Any number allowed |
mod-role add / remove / list / clear
|
Manage the roles that count as mods. Any number allowed |
streamer-role |
Set/create/clear. Members holding it can self-link a channel with /streamers link
|
feature list / enable / disable
|
Switch whole feature sets on or off for this server. See Feature-Switches |
Each takes either role: (an existing role), or name: + optional color: to
create one, or clear: true.
Full guide: Temp-Voice-Channels.
| Subcommand | Effect |
|---|---|
create [name] [category] |
Create a channel and register it as a join-to-create hub. category must already exist |
add <hub> [category] |
Register an existing voice channel as a hub |
edit <hub> [name_template] [default_limit] [min_limit] [max_limit] [category] [use_hub_category] |
Change a hub's temp channel name template, limits or category. Applies to new channels |
remove <hub> |
Unregister a hub and delete its channel |
list |
Configured hubs with their settings, and which owner controls are off |
audit |
Find hubs whose channel was deleted, with prune/restore buttons |
owner-control <control> <allowed> |
Allow or stop an owner control: rename, limit, lock/unlock, kick or transfer |
disable-owner-kick / enable-owner-kick
|
The same switch as owner-control for kick, kept for compatibility |
Full guide: Role-Menus.
| Subcommand | Effect |
|---|---|
dropdown create <channel> <role> [message_id] [title] [description] [descriptor] [apply_channel_defaults] |
Post a new role menu, or attach one to an existing bot message via message_id
|
dropdown add-role <message> <role> [descriptor] |
Add one more role to a menu |
dropdown remove-role <message> <role> |
Remove a role from the menu. Does not strip it from members who already picked it |
list |
Configured menus |
apply-channel-defaults <channel> |
Lock a channel to admin/bot posting, visible to the member role only |
Full guide: Verification and Honeypot.
| Subcommand | Effect |
|---|---|
captcha setup [channel] [adjust_visibility] |
Enable verification. Requires a member role to be set first. adjust_visibility also gates the server and limits the screening channel to unverified members + mod roles |
captcha disable |
Stop using the captcha. Leaves the channel and message in place |
honeypot setup [channel] [action] |
Enable the trap channel. action is kick (softban, default) or ban
|
honeypot disable |
Stop using the honeypot |
status |
Both features' current state |
Full guide: Moderation.
| Subcommand | Effect |
|---|---|
warn <member> <reason> |
DM a warning and record it. Counts towards an automatic timeout, if set |
kick <member> [reason] |
DM, then kick |
ban <user> [reason] [delete_messages] [duration] |
DM, then ban. duration (e.g. 7d, max 365d) makes it temporary. Works by ID on someone not in the server |
softban <user> [reason] [delete_messages] |
Ban, then unban at once, deleting their messages (default: last 24 hours) |
unban <user> [reason] |
Lift a ban, including a temporary one (pick from the suggestions) |
timeout <member> <duration> [reason] |
Discord timeout, up to 28 days |
untimeout <member> [reason] |
End a timeout early |
history <user> |
Every recorded action against someone, with case numbers, dates, moderators and reasons |
remove-case <case> |
(Admin) Delete one record (e.g. a mistaken warning). Doesn't undo the action |
config escalation <warnings> <within> <timeout> |
(Admin) Time members out automatically after that many warnings within that time |
config escalation-off |
(Admin) Turn automatic timeouts off |
config appeal-note <text> / config appeal-note-clear
|
(Admin) A line added to every ban DM |
config show |
(Admin) Show both settings |
Staff (admins and mods) can't be targeted, and you must outrank the target. Also available by right-clicking a member → Apps → Kick member, Ban member or Timeout member.
Blocks messages through Discord AutoMod, and reports each block through the admin alerts. Needs the bot to have Manage Server. Full details are on Banned-Words.
| Subcommand | Effect |
|---|---|
enable |
(Admin) Start blocking. Needs at least one list or custom word |
disable |
(Admin) Stop blocking. The lists and words are kept |
list add <list> / list remove <list>
|
(Admin) Turn a ready-made list on or off: Profanity, Sexual content, Slurs, Scams, Harassment, Drugs |
word add <words> |
Ban words or phrases, comma-separated. * is a wildcard |
word remove <word> |
Unban one custom word (pick from the suggestions) |
status |
On or off, the lists, the custom words (spoilered), and where blocks are reported |
Full guide: Auto-Delete.
| Subcommand | Effect |
|---|---|
set [channel] [count] [duration] |
Enable/update. At least one of count/duration required. Durations use h/m/s (24h, 1h30m) |
disable [channel] |
Turn it off |
status [channel] |
Current settings |
channel defaults to the channel you run it in. Pinned messages are never
deleted.
Full guide: Admin-Alerts.
| Subcommand | Effect |
|---|---|
channel <channel> |
Post alerts in this channel |
add-recipient <user> / remove-recipient <user>
|
Also DM a user |
remove-default |
Forget the #bot-alerts channel the bot made. The channel itself is left in place |
restore-default [channel] [name] [category] |
Set the alert channel: channel for one that already exists, or name (plus optional category) to have the bot make it. One of the two is required |
test |
Send a test alert to everything currently configured |
status |
Current destinations |
Full guide: Server-Log. section is one of Kicks and bans, Joins and
leaves, Messages or Server changes.
| Subcommand | Effect |
|---|---|
set <section> <channel> |
Post that section in this channel, and switch it on |
enable <section> |
Switch a section back on, in the channel it had |
disable <section> |
Switch a section off. Its channel is kept |
status |
Every section, its channel, and anything stopping it |
Full setup, including the API credentials the host needs, is on Streamer-Alerts.
| Subcommand | Who | Effect |
|---|---|---|
link <platform> <account> |
Streamer-role members | Link your own channel. One per platform; a new link replaces your old one |
unlink [platform] |
Anyone | Remove your own links (one platform, or all) |
add <platform> <account> [member] |
Mod | Add any channel, with no streamer role needed. member is optional |
remove [member] [account] [platform] |
Mod | Remove everything attached to a member, or one account (pick from the suggestions; a typed name also needs platform) |
channel <channel> [ping_role] |
Mod | Where alerts post, and an optional role to ping. Checks the bot can post there |
message <text> |
Mod | Custom text for alerts. The ping role is still pinged. Placeholders: {name} {title} {url} {platform} {role}
|
clear-message |
Mod | Back to just the ping |
disable |
Mod | Stop all alerts in this server. The list is kept |
list |
Mod | Settings, which platforms are on, and every streamer with how they were added |
account is a Twitch username, or a YouTube @handle, channel link or UC…
channel ID.
Full setup, including the Meta app and token the host needs, is on Instagram-Alerts. All subcommands are for staff (mods and admins).
| Subcommand | Effect |
|---|---|
add <account> |
Follow an account. Must be a public Business or Creator account. Only posts from now on are shared |
remove <account> |
Stop following one (pick from the suggestions, or type the username) |
channel <channel> [ping_role] |
The dedicated channel posts go to, and an optional role to ping. Checks the bot can post there |
message <text> |
Custom text for posts. The ping role is still pinged. Placeholders: {name} {title} {url} {platform} {role}
|
clear-message |
Back to just the ping |
disable |
Stop posting in this server. The list is kept |
list |
Settings, whether Instagram is set up on the host, and every followed account |
account is a username, @username or instagram.com/<username> link.
Full guide: RSS-Feeds. All subcommands are for staff (mods and admins).
| Subcommand | Effect |
|---|---|
add <url> <channel> [ping_role] [message] |
Follow a feed. Only items published from now on are posted. message placeholders: {feed} {title} {url} {role}
|
remove <feed> |
Stop following one (pick from the suggestions) |
test <feed> |
Post the feed's newest item now |
list |
Every feed, its channel, last check and any error |
Full guide: Giveaways.
| Subcommand | Effect |
|---|---|
create <prize> <duration> <winners> |
Start a giveaway in the current channel. duration is in minutes (1–43200), winners 1–20. Members enter from the posted button |
end <id> |
End one immediately. The ID comes from the creation reply |