Triggers & shortcuts

Three ways to make the bot react to what people type.

Response triggers

An autoresponder. When a message matches the trigger, mira replies.

!response add gm {content: good morning {user.mention}}

!response add rules {title: Server Rules} {description: Read #rules.} {color: #5cacec}

!response view gm

!response list

!response remove gm

!response clear

Requires Manage Messages. Aliases: autoresponse, autoresponder, responder, trigger, ar. Responses are full scripts, so embeds, containers, buttons and variables all work.

How triggers are matched

Every response, reaction and previous-reaction trigger has a match type.

Match type	Fires when
`exact`	The message and the trigger are the same
`word`	The trigger is one of the words in the message
`substring`	The trigger appears anywhere in the message
`startswith`	The message starts with the trigger
`endswith`	The message ends with the trigger

Set it when you create the trigger with --match, or change it later with the match subcommand:

!response add gm --match word {content: good morning {user.mention}}

!response match word gm

!reaction add 💀 lmao --match word
!reaction match word lmao
!previousreact match exact lmao

Responses and reactions default to substring; previous reactions default to exact. match is aliased to matching and mode, and the flag accepts the obvious synonyms (--match contains, --match strict, --match prefix).

word is almost always what you want for short triggers. substring on gm fires on “gmail” and “ygm”; word doesn’t.

Restricting where they fire

!response restrict channel #general gm
!response restrict role @Member gm

Both toggle. Once a trigger has any channel restriction it fires only in those channels; same for roles. Aliases: limit, exclusive.

Restrict anything remotely annoying to one channel. An autoresponder that fires server-wide on a common word gets old within a day, and people will start triggering it on purpose.

Reaction triggers

Instead of replying, react.

!reaction add 🔥 fire

!reaction add 💀 skull
!reaction add 😭 sob

!reaction list

!reaction remove fire

!reaction clear

Requires Manage Messages. Aliases: react, rt.

React to everything in a channel

!reaction channel #art 🔥
!reaction channel list
!reaction channel remove #art

Every message in that channel gets the reaction. The standard setup for a showcase channel — see also gallery channels.

Reacting to the previous message

!previousreact add 💀 lmao

When someone types the trigger, the reaction goes on the message before theirs. So typing “lmao” puts 💀 on the message that was actually funny.

!previousreact list
!previousreact remove lmao
!previousreact clear

Aliases: previousreaction, prt, pr.

This is one of those features that seems pointless until a server starts using it, at which point it becomes the main way people react to things.

Command shortcuts

Map a word to a full command, including arguments.

!shortcut add p purge

!shortcut add mod role {0} @Moderator

!shortcut view mod

!shortcut list

!shortcut remove mod

Requires Manage Server. Aliases: alias, shortcuts, aliases. {0} is replaced with whatever the member types after the shortcut. So !mod @jake becomes !role @jake @Moderator. Useful shapes:

!shortcut add mute timeout {0} 1h
!shortcut add verify role {0} @Verified
!shortcut add nuke2 purge 100
!shortcut add warn2 warn {0} breaking rules

Shortcuts inherit the permissions of the command they run. !shortcut add ban2 ban {0} doesn’t let non-moderators ban people — they still need Ban Members, or a fake permission.

Choosing between them

I want to…	Use
Reply with text or an embed	Response trigger
Add a reaction	Reaction trigger
React to the message above	Previous reaction trigger
React to everything in a channel	Reaction channel
Shorten a command	Shortcut
Answer privately when clicked	Response buttons
Reply automatically to every message	You don’t. Restrict it.

Command reference

Command	Permission	Description
`response add <trigger> <script>`	Manage Messages	Create an autoresponder
`response view <trigger>`	Manage Messages	Preview one
`response list`	Manage Messages	All triggers
`response remove <trigger>`	Manage Messages	Remove one
`response clear`	Manage Roles	Remove all
`response restrict channel <channel> <trigger>`	Manage Messages	Limit to channels
`response restrict role <role> <trigger>`	Manage Messages	Limit to roles
`reaction add <emoji> <trigger>`	Manage Messages	Create a reaction trigger
`reaction list`	Manage Messages	All reaction triggers
`reaction remove <trigger>`	Manage Messages	Remove one
`reaction clear`	Manage Roles	Remove all
`reaction channel [channel]`	Manage Messages	React to everything in a channel
`reaction channel list`	Manage Messages	Configured channels
`reaction channel remove <channel>`	Manage Messages	Stop
`previousreact add <emoji> <trigger>`	Manage Messages	React to the previous message
`previousreact list`	Manage Messages	All of them
`previousreact remove <trigger>`	Manage Messages	Remove one
`previousreact clear`	Manage Roles	Remove all
`shortcut add <name> <invoke>`	Manage Server	Create an alias
`shortcut view <alias>`	Manage Server	What it runs
`shortcut list`	Manage Server	All shortcuts
`shortcut remove <alias>`	Manage Server	Remove one
`shortcut clear`	Manage Server	Remove all

Start here

Security

Restore

Moderation

Server setup

Last.fm

Social

Utility

Triggers & shortcuts

Response triggers

How triggers are matched

Restricting where they fire

Reaction triggers

React to everything in a channel

Reacting to the previous message

Command shortcuts

Choosing between them

Command reference

​Response triggers

​How triggers are matched

​Restricting where they fire

​Reaction triggers

​React to everything in a channel

​Reacting to the previous message

​Command shortcuts

​Choosing between them

​Command reference

Response triggers

How triggers are matched

Restricting where they fire

Reaction triggers

React to everything in a channel

Reacting to the previous message

Command shortcuts

Choosing between them

Command reference