How commands work
Slash commands, context-menu commands, per-command permissions, cooldowns, private replies and output redirection. The settings every Arclo command shares.
On this page
Arclo registers its commands with Discord separately for each server, from that server's own settings: a server sees the commands of the systems it has switched on, minus any it has switched off. What each one is allowed to do, and by whom, is decided per server on the dashboard.
Three kinds of command
- Slash commands: typed with
/. Most have subcommands:/voice name,/backup create,/counter social add. - Message context commands: right-click a message → Apps. Report Message, Stick Message, Remind Me, Add Emojis.
- User context commands: right-click a member → Apps. Moderation History, Warn Member, Report Member.
Why there are subcommands rather than more commands
Discord allows 100 slash commands, five message context commands and five user context commands per server, and your own Custom Commands are registered against the same limits. Arclo groups related operations under one command name so that a system with twenty-five operations costs one of those hundred slots rather than twenty-five.
Per-command settings
Every command can be configured from Command Info (open a system, then a command's Settings), or from the Commands section of its own system's page, which is a Commands tab on the tabbed pages. Both edit the same record.
Command Info
Every Arclo command. What it does, how to use it, and who may run it.
Enabled
240/ 263
Running in your server
Disabled
23
Switched off, or their system is off
Restricted
31
Limited to roles or permissions
Slash commands
72/ 100
Discord allows 100 per server
Commands
Open a system to switch its commands and choose who may run them.
Onboarding & Access
28 commands
Essentials
5- Enabled
- Switching a command off removes it from your server. Arclo registers each server's commands from its own settings, so a command you have switched off, or one belonging to a system you have not enabled, is not in the slash menu at all. Your settings are kept: switch it back on, or enable the system, and it returns within about a minute.
- Role permissions
- No role filter (the default) leaves the command to its built-in access rule and Discord's own permissions. Only these roles lets nobody else run it; Everyone except shuts out the roles you name. Administrators always pass.
- Channel permissions
- All channels, Only these channels or All channels except, picking channels, voice channels or whole categories. Threads follow their channel, and a category covers every channel in it, temporary voice channels included. Administrators are never restricted. The usual home for
/rankis a bot-commands channel. - Required Discord permissions
- Require one or more real Discord permissions. All of them are needed, not any. Administrators and the server owner bypass this.
- Cooldown
- None, Per user (each member waits between their own uses) or Whole server (one use, then everybody waits). Applies to the command, not to the system.
- Private response
- The reply is visible only to whoever ran the command. Most commands start with it on. The
/infolookups and the moderation commands start public, so the channel sees the answer. - Redirect output
- Send the reply to a channel you choose instead of the one it was typed in, with a mention of whoever ran it. Handy for keeping long output out of chat. Private replies are never redirected, because that would publish something meant to be private: turn Private response off first.
- Custom replies
- Rewrite what the command says. See the message editor.
Commands that ignore all of that
A handful of commands are administrator-only inside the handler, whatever the dashboard says: every Backups & Templates command (/backup load among them), the commands that edit XP, invites and achievements, /case delete and /role all. Their role, channel, cooldown and permission controls are locked, and the settings say so; you can still switch one off, redirect its public output and edit its replies. A command that can destroy a server should not be one dropdown away from being handed to a role.
Destructive commands are marked
Anything that cannot be undone carries a red Destructive badge on Command Info, and Cannot be undone in the command tables in this documentation. Read the badge before you hand the command to your moderators.
Bulk changes
On Command Info, every system's group has All on, All off, Manage (role, channel, permission, cooldown, privacy and redirect settings for all its commands at once) and Reset. Select switches the page to picking any set of commands, with Enable, Disable, Edit settings… and Reset… for the selection. Reset puts everything back to its defaults (the enabled state, every rule and any custom replies), which is not the same as switching it off, and it cannot be undone.
If a command is not working
- It may be switched off (then it is not in the slash menu at all), or limited to roles or channels that leave you out: check Command Info.
- Its system may be off. A system that is off takes all of its commands out of your server's slash menu.
- Discord may not have synced. Reload the client with
Ctrl+R. - The reply may be older than fifteen minutes. Buttons on Arclo's own posted messages last forever; components attached to a reply to your command stop responding after Discord's fifteen-minute editing window. Run it again.
The full list of commands is at Command reference.
Still stuck? Ask in the support server: somebody there has almost certainly configured this before.
