Iris
Add to Discord

Custom Commands

Create custom text and embed commands.

Configure Custom Commands in the dashboard

Overview#

Custom commands are the answers you find yourself typing twice a week. Write one once and it replies for you, either as a command members run on purpose or as a trigger that fires on plain chat.

A prefix command is typed deliberately: .rules returns your rules. A text trigger watches conversation instead, so somebody asking how to verify gets the answer without having known there was a command for it.

The reply is plain text or a full embed, and usage is counted so you can see which ones earn their place.

Setup#

  1. Open the dashboard and go to Server > Custom Commands.
  2. Press Create Command.
  3. Choose Prefix command or Text trigger under How is it triggered?
  4. Enter the Command name, or the Trigger words and when they should fire.
  5. Write the Response, or fill in the embed fields for something richer.
  6. Restrict it with Allowed roles if not everybody should be able to use it, then save.

Settings#

SettingTypeDefaultWhat it does
How is it triggered?ChoicePrefix commandA command members type with the server prefix, or a trigger that fires on plain chat.
Command nameText-What follows the prefix, up to 32 characters. Prefix commands only.
Trigger wordsText-The words watched for, up to 64 characters. Text triggers only.
When should it fire?ChoiceMessage is exactly the triggerExactly, starts with, or is like the trigger. Text triggers only.
ResponseTextNoneThe plain text reply.
Embed titleTextNoneHeading of the embed reply.
Embed descriptionTextNoneBody of the embed reply.
Embed colorColour#105380Accent of the embed.
FooterTextNoneSmall line at the foot of the embed.
Thumbnail URLTextNoneSmall image in the top right.
Image URLTextNoneLarge image below the text.
Allowed rolesRolesEveryoneWho may use it. Empty means anybody can.

Commands#

CommandWhat it doesRequires
.custom helpCreate, list, edit and delete custom commands from chat.Manage Server

Permissions#

PermissionWhy Iris needs it
View ChannelsReads the channels commands and triggers fire in.
Send MessagesPosts the reply.
Embed LinksOnly for commands that reply with an embed.

What it looks like#

M
member Today at 8:53 PM

how do i verify

I
Iris APP Today at 8:53 PM
Getting verified

Head to #verification and press the Verify button. It takes about ten seconds and unlocks the rest of the server.

Still stuck? Open a ticket.
A text trigger answering a question nobody knew to ask a command for.

Tips and gotchas#

A custom command shadows a built-in one.

Built-in commands win. Pick a name Iris does not already use, and check /help if you are unsure.

The trigger fires on bot messages.

It does not. Only member messages are checked.

Can a command take arguments?

No. The reply is fixed text or a fixed embed, the same every time.

Can I stop a command working in one channel?

Add that channel to the ignore list in command management, which covers every command at once.