Default Variables

The following blocks will be present and accessable as defaults when running any tag.

Meta Variables

Meta variables reference meta attributes about the tag invocation.

Args Block

The {args} block represents the arguments passed after the tag name when invoking a tag. If no parameter is passed, it returns all the text after the invocation name. If an index is passed, it will split the arguments into a list by the given splitter, and return the word at that index. The default splitter is a “ “.

usage: {args([index]):[splitter]>}
aliases: None
payload: splitter
parameter: index

In the following examples, assume the tag’s name is argstag and the message content is [p]argstag My dog is cute! Would you like to see a photo?.

{args}
# My dog is cute! Would you like to see a photo?
o0l
{args(1)}
# My

{args(2):!}
# Would you like to see a photo?

Uses Block

The {uses} block returns the number of times a tag has been used.

usage: {uses}
aliases: None
payload: None
parameter: None

{uses}
# 1

Discord Object Variables

These blocks reference Discord objects from the tag invocation context.

Author Block

The {author} block with no parameters returns the tag invoker’s full username, but passing the attributes listed below to the block payload will return that attribute instead.

usage: {author([attribute])}
aliases: user
payload: None
parameter: attribute, None

Attributes:

Attribute	Description
`id`	`the author's Discord ID`
`name`	`the author's username`
`nick`	`the author's nickname, if they have one, else their username`
`avatar`	`a link to the author's avatar, which can be used in embeds`
`created_at`	`the author's creation date`
`timestamp`	`the author's account creation date as a UTC timestamp`
`joined_at`	`the date the author joined the server`
`joinstamp`	`the author's join date as a UTC timestamp`
`mention`	`a formatted text that pings the author`
`bot`	`whether or not the author is a bot`
`color`	`the author's top role's color as a hex code`
`top_role`	`the author's top role`
`roleids`	`a list of the author's role IDs, split by spaces`
`boost`	`If the user has boosted, this will be the UTC timestamp of when they did, if not this will be empty`
`timed_out`	`If the user is timed out, this will be the UTC timestamp of when they'll be untimed-out, if not timed out this will be empty`
`banner`	`the user's banner url`

Target Block

The {target} block follows the same usage and has the same attributes as the Author Block, but it defaults to the mentioned user in the tag invocation message if any users are mentioned, or the tag author.

usage: {target([attribute])}
aliases: member
payload: None
parameter: attribute, None

Channel Block

The {channel} block with no parameters returns the channel’s full name but passing the attributes listed below to the block payload will return that attribute instead.

usage: {channel([attribute])}
aliases: None
payload: None
parameter: attribute, None

Attributes:

Attribute	Description
`id`	`the channel's ID`
`name`	`the channel's name`
`created_at`	`the channel's creation date`
`timestamp`	`the channel's creation date as a UTC timestamp`
`nsfw`	`whether the channel is nsfw`
`mention`	`a formatted text that pings the channel`
`topic`	`the channel's topic`
`category_id`	`the category the channel is associated with, if no category this will return empty`
`jump_url`	`a link to the channel`

Server Block

The {server} block with no parameters returns the server’s name but passing the attributes listed below to the block payload will return that attribute instead.

usage: {server([attribute])}
aliases: guild
payload: None
parameter: attribute, None

Attributes:

Attribute	Description
`id`	`the server's ID`
`name`	`the server's name`
`icon`	`a link to the server's icon, which can be used in embeds`
`created_at`	`the server's creation date`
`timestamp`	`the author's account creation date as a UTC timestamp`
`member_count`	`the server's member count`
`bots`	`the number of bots in the server`
`humans`	`the number of humans in the server`
`description`	`the server's description if one is set or 'No description'`
`random`	`a random member from the server`
`vanity`	`if guild has a vanity, this returns the vanity else empty`
`owner_id`	`the server owner's ID`
`mfa`	`the server's mfa level`
`boosters`	`the server's active booster count`
`boost_level`	`the server's current boost level/tier`
`discovery_splash`	`a link to the server's discovery splash`
`banner`	`a link to the server's banner`