Skip to main content
Please Note:
Server owners and staff accept that our team will only provide support for bot issues, NOT with setting the bot up for you. If you are having issues after a reasonable amount of research, trial, and error, feel free to join the support server, and we will try our best to help with any issues that may arise. Furthermore, we reserve the right to remove your whitelist if we feel HepBoat is not right for your community.

Tags

Plugin name: tags

The tags plugin adds the ability for HepBoat to respond with a custom message to a configured tag name.

A tag can also be called directly with its name and the guild prefix (e.g. !mytag).

Commands

NameDescriptionDefault LevelUsage
!tags add {name} {content} OR !tags create {name} {content}Create a tag.Trusted!tags add yes Yes hello friend OR !tags create wow oh yes
!tags show {name} OR !tags {name} OR !tag {name}Call a tag.Trusted!tags show popcorn OR !tags popcorn
!tags edit {name} {new content}Edit content of existing tag.Moderator!tags edit owo More OWO!
!tags remove {name} OR !tags rm {name} OR !tags del {name}Remove tag by name.Trusted!tags remove popcorn
!tags info {name}Get detailed info on a tag.Trusted!tags info popcorn
!tags all OR !tags listList all tags in the server.Trusted!tags all

Tag Flags

When calling a tag (e.g. !mytag or !tag mytag), you may add the following arguments in any combination.

FlagDescriptionArg TypeUsage
-cSend the tag into another channel.snowflake or mention!owo -c 532576772164812820 OR !owo -c #chat
-uMention a certain user when returning contents.snowflake or mention!owo -u 148359099782791168 OR !owo -u @JakeyPrime

Tag Content Tokens

The following tokens can be used in tag contents to dynamically generate content when a tag is called.

TokenDescription
{user}Will mention the joining user.
{server}Will include the server name.
{channel}Will mention the current channel.
{r<snowflake>}Will mention the specified role.
{c<snowflake>}Will mention the specified channel.
{u<snowflake>}Will mention the specified user.

Configuration Options

OptionDescriptionTypeDefault
max_tag_lengthMaximum length for a tag.intempty
min_level_remove_othersMinimum level for a user to delete another user's tags.int50

Configuration Example

plugins:
tags:
max_tag_length: 100
min_level_remove_others: 55

Hardening

Tag calls and commands can be hardened by using the Commands Configuration.

In overrides, the following special names are available.

NameDescription
tags-usrUsers that can trigger tag calls.
tags-usr-allowed-rolesAllows roles to run tags anywhere regardless of other override or lockdown settings.

The hierarchy of overrides for tags calls is

1. tag-usr-allowed-roles
2. tag.name
3. tag-usr

meaning that the overrides for a specific tag.name trigger will override the overrides for tag-usr.

In lockdown, the following special name is available.

NameDescription
tags-usrUsers that can trigger tag calls.

An example of a hardened configuration:

commands:
overrides:
- name: mytag
out:
level: 10
- name: tags-usr
out:
level: 50
- plugin.name: tags
out:
level: 100
lockdown:
- name: tags-usr
out:
channels: [532709830767542303] # chat

The above configuration sets the following:

  • allows tag commands (e.g. !tags edit) to be only called by users level 100 or higher
  • allows !mytag to be called by users level 10 or higher ONLY in channel #chat.
  • allows all other tag calls (e.g. !othertag) to be called by users level 50 or higher ONLY in channel #chat.