Field

Description

.User

The user's username together with discriminator.

.User.String

The user's username together with discriminator as string-type.

.User.Username

The user's username.

.User.ID

The user's ID.

.User.Discriminator

The user's discriminator (The four digits in a person's username).

.User.Avatar

The user's avatar ID.

.User.AvatarURL "256"

Gives the URL for user's avatar, argument "256" is the size of the picture and can increase/decrease twofold (e.g. 512, 1024 or 128, 64 etc.).

.User.Bot

Determines whether the target user is a bot - if yes, it will return True.

.User.Mention

Mentions user.

.RealUsername

Only works with join and leave messages. This can be used to send the real username to a staff channel when invites are censored.

.UsernameHasInvite

Only works with join and leave messages. It will determine does the username contain an invite link.

Field

Description

.Guild.ID

Outputs the ID of the guild.

.Guild.Name

Outputs the name of the guild.

.Guild.Icon

Outputs the ID of the guild's icon.

.Guild.Region

Outputs the region of the guild.

.Guild.AfkChannelID

Outputs the AFK channel ID.

.Guild.OwnerID

Outputs the ID of the owner.

.Guild.JoinedAt

Outputs when YAGPDB joined the guild.

.Guild.AfkTimeout

Outputs the time when a user gets moved into the AFK channel while not being active.

.Guild.MemberCount

Outputs the number of users on a guild.

.Guild.VerificationLevel

Outputs the required verification level for the guild.

.Guild.EmbedEnabled

Outputs whether embeds are enabled or not, true / false.

Field

Description

.Member.JoinedAt

When member joined the guild/server.

.Member.Nick

The nickname for this member.

.Member.Roles

A list of role IDs that the member has.

Field

Description

.Channel.Name

The Name of the channel.

.Channel.ID

The ID of the channel.

.Channel.Topic

The Topic of the channel.

.Channel.NSFW

Outputs whether this channel is NSFW or not.

Field

Description

.Message.ID

ID of the message

.Message.ChannelID

Channel id this message is in

.Message.Author

Author of the message (User object)

.Message.Timestamp

Timestamp of the message (use .Message.Timestamp.Parse for a time object, otherwise string)

.Message.Attachments

Attachments to this message (slice of attachment objects)

.Message.Embeds

Embeds on this message (slice of embed objects)

.Message.Mentions

Users this message mentions

.Message.Reactions

Reactions on this message (only available form getMessage)

.Message.Content

Text content on this message

Function

Description

currentUserCreated

The time the current user was created.

currentUserAgeHuman

The account age of the current user in more human readable format (3 days 2 hours, for example).

currentUserAgeMinutes

The account age of the current user in minutes.

Function

Description

adjective

Returns a random adjective.

dict key1 value1 key2 value2 etc

Creates a dictionary (not many use cases yet).

sdict "key1" "value1" "key2" "value2"

The same as dict but with only string keys and can be used in cembed. Has .Get "key" and .Set "key" methods, they allow to capture or change value content from given key. Example on using those methods in Snippets.

cslice value1 value2

Creates a slice (similar to array) that can be used elsewhere (cembed and sdict for example).

cembed "list of embed values"

Function to generate embed inside custom command. More in-depth here.

in list value

Returns true if value is in list.

inFold

Same as in, but is case insensitive.

add x y z ...

Returns x + y + z + ...., detects first number type; is it integer or float and based on that adds. (use toFloat on the first argument to force floating point math.){{ add 5 4 3 2 -1 }} sums all these numbers and returns 13.

mult x y z ...

Multiplication, like add or div, detects first number type. {{ mult 3.14 2 }} returns 6.28.

div x y z ...

Division, like add or mult, detects number type first. {{ div 11 3 }} returns 3 whereas {{ div 11.1 3 }} returns 3.6999999999999997

fdiv x y z ...

Meant specifically for floating point numbers division.

seq start stop

Creates a new array of integer, starting from start and ending at stop.

shuffle list

Returns a shuffled version of a list.

joinStr seperator str1 str2

Joins several strings into one, separated by the first arg (the separator), useful for executing commands in templates (e.g.{{joinStr "" "1" "2" "3"}} = 123).

randInt (stop, or start stop)

Returns a random integer between 0 and stop, or start - stop if two args are provided.

toFloat

Converts argument (numbers of strings) to type float64.

toInt

Converts something into an integer. Usage: (toInt x).

toInt64

Converts something into an int64. Usage: (toInt64 x).

toString

Converts something into a string. Usage: (toString x).

sendDM "message here"

Sends the user a direct message, only one DM can be sent per template (accepts embed objects).

sendMessage channel message

Sends message (string or embed) in channel, channel can be either nil, the channel ID or the channel's "name".

sendMessageNoEscape channel message

Sends message (string or embed) in channel, channel can be either nil, the channel ID or the channel "name". Doesn't escape mentions (e.g. role mentions or @here/@everyone).

sendMessageRetID channel message

Same as sendMessage, but also returns messageID for later use. Example in Snippets.

sendMessageNoEscapeRetID channel message

Same as sendMessageNoEscape, but also returns messageID for later use.

editMessage channel messageID newMessageContent

Edits the message in channel, channel can be either nil, channel's ID or "name". Light example in Snippets.

editMessageNoEscape channel messageID newMessageContent

Edits the message in channel and has same logic in escaping characters as sendMessageNoEscape.

addMessageReactions channel messageID reactions

Same as addReactions or addResponseReactions, but can be used on any messages using its ID. Channel can be either nil, channelID or channel's name. Example in Snippets.

deleteMessage channel messageID (delay)

Deletes message with given messageID from channel. Channel can be either nil, channelID or channel's name. (Delay) is optional and defaults to 10 seconds. Example in Snippets.

mentionEveryone

Mentions @everyone.

escapeEveryone "input"

Escapes everyone mentions in a string.

mentionHere

Mentions @here.

escapeHere "input"

Escapes here mentions in a string.

escapeEveryoneHere "input"

Escapes everyone and here mentions in a string. Useful with sendMessageNoEscape, also applies to escapeEveryone/Here. Example in Snippets.

mentionRoleName "rolename"

Mentions the first role found with the provided name (case-insensitive).

mentionRoleID roleID

Mentions the role found with the provided ID.

hasRoleName "rolename"

Returns true if the user has the role with the specified name (case-insensitive).

hasRoleID roleID

Returns true if the user has the role with the specified ID (use the listroles command for a list of roles).

targetHasRoleName userID "rolename"

Returns true if the given user has the role with the specified name (case-insensitive).

targetHasRoleID userID roleID

Returns true if the given user has the role with the specified ID (use the listroles command for a list of roles). Example in Snippets.

addRoleID roleID

Adds the role with the given ID to the user that triggered the command (use the listroles command for a list of roles).

removeRoleID roleID

Removes the role with the given ID from the user that triggered the command (use the listroles command for a list of roles).

giveRoleName userID "rolename"

Gives a role by name to the target.

giveRoleID userID roleID

Gives a role by ID to the target.

takeRoleName userID "rolename"

Takes away a role by name from the target.

takeRoleID userID "roleID"

Takes away a role by ID from the target.

deleteResponse time

Deletes the response after a certain time (1-60 seconds).

deleteTrigger time

Deletes the trigger after a certain time (1-60 seconds).

addReactions "👍" "👎"

Adds each emoji as a reaction to the message that triggered the command (recognizes Unicode emojis and emojiname:emojiid).

addResponseReactions "👍" "👎"

Adds each emoji as a reaction to the response message (recognizes Unicode emojis and emojiname:emojiid).

exec "command" "args" "args" "args"

Execute a YAGPDB (e.g. reverse, roll, kick etc) in a custom command. Exec can be run max 5 times per command.

execAdmin "command" "args" "args" "args" etc

Function the same as exec but will override any permission requirement (such as the kick permission to use kick command etc.).

userArg ########

Function that can be used to retrieve a user from a mention string or ID.

currentTime

Gets the current time which can be used in a custom embed.

.CmdArgs

Gets all the arguments passed to the command.

slice "string" integer (integer2)

Outputs the "string" after cutting/slicing off integer (numeric) value of symbols (actually starting the string's index from integer through integer2) - e.g. {{slice "Fox runs" 2}}outputs x runs. When using also integer2 - e.g. {{slice "Fox runs" 1 7 }}, it outputs ox run. For slicing whole words, see example below in Snippets.

lower "string"

Converts the string to lowercase.

upper "string"

Converts the string to uppercase.

title "string"

Returns string with the first letter of each word capitalized.

split "string" "sepr"

Slices given "string" to substrings separated by "sepr"and returns new slice/array of the substrings. Example below in Snippets.

urlescape "string"

Escapes the string so it can be safely placed inside a URL path segment - e.g. "Hello, YAGPDB!" becomes "Hello%2C%20YAGPDB%21"

parseArgs required_args error_message ...carg

Checks the arguments for a specific type. More in depth here and an example in Custom Command Examples.​

carg type name

Defines type of argument for parseArgs. More in depth here and an example in Custom Command Examples.​

getMessage channelID messageID

Returns a Message object

sleep seconds

Pauses execution of template inside custom command for max 60 seconds. Argumentsecondsis of type integer. Example in Snippets.

reFind "regex" "string"

Compares string to regex pattern and returns first match. {{ reFind "AG" "YAGPDB is cool!" }}returns AG (regex pattern is case sensitive).

reFindAll "regex" "string"

Adds all regex matches from the string to a slice. Example in Snippets.

reReplace "regex" "string1" "string2"

Replaces string1 contents with string2 at regex match point. {{ reReplace "I am" "I am cool!" "YAGPDB is" }}returns YAGPDB is cool! (regex pattern is case sensitive).

humanizeDurationHours nanoseconds

Returns nanoseconds argument of type int64 in human readable format - as how long it would take to get towards given time - e.g. {{ humanizeDurationHours 9000000000000000000 }} returns 285 years 20 weeks 6 days and 16 hours.

humanizeTimeSinceDays typeTime

Returns time has passed since given argument of type Time in human readable format - e.g. {{ humanizeTimeSinceDays currentUserCreated }}

Case

Example

Basic if

{{if (condition)}} {{end}}

Not

{{if not (condition)}} {{end}}

And

{{if and (cond1) (cond2) (cond3)}}

Or

{{if or (cond1) (cond2) (cond3)}} {{end}}

Equals

{{if eq .Channel.ID ########}} {{end}}

Not equals

{{if ne .Channel.ID #######}} {{end}}

Less than

{{if lt (len .Args) 5}} {{end}}

Greater than

{{if gt (len .Args) 1}} {{end}}

Else if

{{if (case statement)}} {{else if (case statement)}} {{end}}

Else

{{if (case statement)}} {{else}} output here {{end}}