Custom Commands
Build real Discord slash commands for your server out of an ordered list of actions. No code, no hosting, and they appear in the slash menu like everything else.
On this page
A custom command is a name, a description and a list of actions. Arclo registers it with Discord for your server only, and it appears in your members' slash menu within about fifteen seconds of being published; the page says Syncing changes to Discord… until it has. It shares your server's hundred slash-command slots with Arclo's own commands, and Command Info shows how many of them Arclo's commands are using. A custom command takes no options: members run it as /name.
Building one
Switch it on
Server Management → Custom Commands, then Create Command.
Name and describe it
Lowercase letters, numbers, dashes and underscores, up to 32 characters; a space you type becomes a dash. Every one of Arclo's own command names is refused, even for systems you have switched off. The description is required: it is the line Discord shows beside the command in the slash menu.
Add actions
Up to 10, run in order.
Set who may use it
Roles, channels and a cooldown, with a bypass list. Administrators always pass.
Publish
Arclo registers the command with Discord. Nothing is posted to a channel: the command is the artifact. Save draft keeps a new command switched off, or parks an edit to a live one, without touching Discord.
Actions
| Action | What it does |
|---|---|
| Respond in the channel | Answers the person who ran it. The first one is the command's answer; later ones are follow-ups. It can delete itself after up to an hour, unless responses are private. |
| Send a message to a channel | Posts in a channel you pick, optionally deleting itself after up to an hour. |
| DM the member | Messages the person who ran it. A DM carries no buttons, and closed DMs are reported as a failed action. |
| Give the member roles / Remove roles from the member / Toggle roles on the member | Up to 10 roles, on the person who ran it. Toggle removes them if the member has them all and gives them otherwise. Arclo's highest role must sit above every role it hands out. |
A command with no reply answers privately anyway
It defers, does the work, and edits in a short summary of what ran, so a role-only command never looks like it failed. Anything that didn't run is listed too; a command that did reply gets those failures as a private follow-up.
Message features
- Response variants: up to 5 designs per message action, one picked at random each run. The same command can answer differently each time.
- Buttons: up to 5 on a reply or a sent message. A link button opens a URL; a response button replies privately to whoever clicked, with a message you designed. They keep working across restarts.
- Per-message design type: each variant, DM and button response independently chooses a classic embed or a Components V2 layout.
- Placeholders:
{user},{username},{display_name},{user_id},{server},{member_count},{channel},{channel_name},{uses}.{uses}counts the run that is happening, and in a response button's reply they describe whoever clicked. See the placeholder reference. - Pings: a reply or a message only ever notifies the person who ran the command. Role and
@everyonementions in the design still show, but ping nobody.
Permissions and cooldowns
- Role permissions
- Everyone, Only these roles or Except these roles.
- Channel permissions
- All channels, Only these channels or Except these channels.
- Cooldown
- Per member, Per channel or Server-wide, up to a year, with up to 10 roles that bypass it. A cooldown longer than two minutes is remembered across restarts.
- Private responses
- Only the person who ran it sees the reply and its follow-ups, so a private reply has no auto-delete.
Administrators pass all three checks, whatever they are set to.
Limits and behavior
Commands per server
10
Actions per command
10
Variants per message
5
Buttons per message
5
Roles per role action
10
Registration
Per server, in your 100 slash slots
Sync delay
About 15 seconds
Turning the system off removes the commands from Discord
Their definitions are kept, so switching it back on restores every one of them. Disabling a single command removes just that one.
When Discord refuses the list
Arclo's commands and yours go to Discord as one list. If Discord turns it down (a server out of slash slots, for one), the page shows Discord sync failed with Discord's reason, and the slash menu stays as it was until that is fixed.
Usage logs
The Logging card under your commands posts an embed to a channel every time a command runs, and a red one when an action fails, with who ran it and where. Each command's card also counts its uses and shows when it last ran.
Still stuck? Ask in the support server: somebody there has almost certainly configured this before.