Tags

The Tags module lets you create custom commands (tags) and automatic message responses (triggers). Tags use the TagScript template language for dynamic responses, while triggers automatically respond to messages matching specific patterns.

Quick Reference

Command	Description	Permission	Cooldown
`.tag`	Create and manage custom commands	Everyone (create requires manage)	2s
`.trigger`	Create and manage auto-responders	Moderator	2s

Tags

Tags are custom commands that anyone can invoke. Think of them as user-created shortcuts for common responses, rules, FAQs, or fun content.

Subcommands

.tag <name>                      — Use a tag
.tag create <name> <content>     — Create a new tag
.tag edit <name> <content>       — Edit an existing tag
.tag delete <name>               — Delete a tag
.tag info <name>                 — View tag metadata (author, uses, etc.)
.tag list [--user @user]         — List all tags (optionally filter by author)
.tag alias add <alias> <name>    — Add an alias for a tag
.tag alias remove <alias>        — Remove a tag alias
.tag raw <name>                  — View the raw TagScript content
.tag transfer <name> <@user>     — Transfer tag ownership to another user

Aliases: t, tags Cooldown: 2 seconds

TagScript Variables

Tags use the TagScript template engine for dynamic content:

Variable	Description	Example
`{user}`	The user who ran the tag	`Alex`
`{user.mention}`	The user as a mention	`@Alex`
`{user.id}`	The user's ID	`123456789012345678`
`{server}`	The server name	`My Server`
`{channel}`	The channel name	`general`
`{args}`	All arguments passed after the tag name	`hello world`
`{args.0}`	First argument only	`hello`
`{args.1}`	Second argument only	`world`
`{random:a\|b\|c}`	Pick a random value from the list	`b`

Examples

Create a rules tag:

.tag create rules **Server Rules**
1. Be respectful
2. No spam
3. English only in #general

Create a tag with dynamic content:

.tag create greet Hello {user.mention}, welcome to **{server}**!

Create a random response tag:

.tag create 8ball {random:Yes|No|Maybe|Ask again later|Absolutely|Not a chance}

Use a tag with arguments:

.tag create say {args}
.tag say Hello everyone!

Triggers

Triggers are auto-responders that fire when a message matches a specific pattern. Unlike tags (which need to be explicitly invoked), triggers watch all messages in real time.

Subcommands

.trigger create <name> <response>    — Create a new trigger
.trigger edit <name> <response>      — Edit a trigger's response
.trigger delete <name>               — Delete a trigger
.trigger mode <name> <mode>          — Set the matching mode
.trigger enable <name>               — Enable a trigger
.trigger disable <name>              — Disable a trigger
.trigger list                        — List all triggers
.trigger info <name>                 — View trigger details
.trigger whitelist channel add <name> <#channel>  — Allow only in specific channels
.trigger whitelist channel remove <name> <#channel>
.trigger blacklist channel add <name> <#channel>  — Block in specific channels
.trigger blacklist channel remove <name> <#channel>
.trigger whitelist role add <name> <@role>   — Allow only for specific roles
.trigger whitelist role remove <name> <@role>
.trigger blacklist role add <name> <@role>   — Block for specific roles
.trigger blacklist role remove <name> <@role>

Aliases: tr, triggers, autoresponder, ar Permission: Moderator Cooldown: 2 seconds

Matching Modes

Mode	Behavior
`contains`	Triggers if the message contains the trigger phrase anywhere
`strict`	Triggers if the message contains the trigger phrase as a whole word
`exact`	Triggers only if the entire message exactly matches the trigger phrase
`startswith`	Triggers if the message starts with the trigger phrase
`endswith`	Triggers if the message ends with the trigger phrase
`regex`	Triggers if the message matches a regular expression

Examples

Auto-respond to common questions:

.trigger create ip The server IP is play.example.com
.trigger mode ip contains

Regex trigger for links:

.trigger create nolinks Please don't post links here.
.trigger mode nolinks regex
.trigger edit nolinks https?://\S+

Restrict a trigger to specific channels:

.trigger whitelist channel ip #faq #support

Be careful with contains mode on short phrases -- it can trigger on partial word matches. Use strict mode if you want whole-word matching, or exact for full-message matching.

Tags

On this page