Tags
Overview​
Tags are custom commands that allow for users to create custom responses to a given tag name. Simply add a tag, and then invoke it with either command notation or inline notation and ClemBot will respond with that tags content in a given channel.
ClemBot's tags support the idea of ownership. If a user creates a tag, that tag is owned by them until they either leave the server or transfer the tag to someone else. By owning the tag they are allowed to either edit or delete the tag. When a user leaves a server all their owned tags become unclaimed and are free to be claimed by anyone else in the server.
ClemBot also tracks what tags are popular and allows for you to access that information. You can view the total number of uses of a tag as well as its owner and creation date with the tag info command or on the dashboard.
caution
If you leave the server, all your tags will become unowned and be up for grabs for anyone else in the server.
Inline Notation​
Tags in ClemBot can be invoked in the middle of a message by prefixing the tag name with a $
.
This allows for more organic tag usage in the middle of a conversation.
note
By default, the tag prefix for any server is $
. However, this can be changed.
See Prefix on how to view, change, and reset the prefix.
Example​
Hello there new person. Have you checked out $funstufftodo here yet?
Dashboard​
A guilds tags can be viewed from the tag tab on the dashboard. You can filter tags, create new tags or just view what tags have been created.
Commands​
Tag​
If invoked with no tag name it will show all tags in the server. If a name is provided, it will attempt to invoke that tag.
Aliases​
tags
Format​
!tag
!tag <tagname>
Example​
!tag
!tag mytagname
Add​
Create a tag in the server.
Aliases​
create
make
Required Claims​
tag_add
Format​
!tag add <TagName> <TagContent>
Example​
!tag add MyTag ClemBot is an awesome bot!
Remove​
Delete a tag from the server.
Aliases​
delete
remove
Required Claims​
tag_delete
note
You do not need the tag_delete
claim to delete a tag that you own.
Format​
!tag delete <TagName>
Example​
!tag delete MyTag
Edit​
Edit a tag in the server.
Format​
!tag edit <TagName> <NewTagContent>
Example​
!tag edit MyTag ClemBot is an super super super awesome bot!
Info​
Gets info about a given tag in a server.
Aliases​
about
Format​
!tag info <TagName>
Example​
!tag info MyTag
Claim​
Claims a given unowned tag.
Format​
!tag claim <TagName>
Example​
!tag claim SomeUnownedTag
Transfer​
Transfers a given owned tag to a new owner in the same server.
Format​
!tag transfer <TagName> <TagRecipient>
Example​
!tag transfer MyTag @MyBestFriend
note
If a user has the tag_transfer
claim, they can transfer tags they do not own.
Unclaimed​
Lists all unclaimed tags in the server.
Example​
!tag unclaimed
Prefix​
A group of commands used to preview, set, or reset the prefix for tags.
Format​
!tag prefix [<prefix> | reset]
Tag Prefix​
Gets the current tag prefix.
Example​
!tag prefix
!tag prefix #
note
Custom tag prefixes can have more than one character.
caution
Custom tag prefixes cannot contain the character `
.
Required Claims​
custom_tag_prefix_set
note
The command !tag prefix
does not require the claim, but !tag prefix <new prefix>
does.
Tag Reset​
Resets the tag prefix.
Aliases​
revert
Example​
!tag prefix reset
Required Claims​
custom_tag_prefix_set
note
When running the command !tag prefix reset
, the tag prefix will be reverted to $
.