Variables

Variables allow you to dynamically insert user, server, channel, and time information into your bot’s custom messages. Whenever ZEON sends a customized message, it parses these variables into real, live data.

Not all variables work in every context! For example, {rolecolor} won’t work in a message if there is no specific role involved in the trigger.

Complete Variable Reference

Below is a complete list of every single variable supported by the bot’s parser.

Advanced Tip: Variables like {target} and {author} are context-dependent. {author} is usually the person triggering the command, while {target} is the person being acted upon.

Server Variables

Variable	Description
`{servericon}`	Server icon URL
`{serverbanner}`	Server banner URL
`{serversplash}`	Server splash URL
`{serverdiscoverysplash}`	Server discovery splash URL
`{servermembercount}`	Total server member count
`{servervanity}`	The server’s vanity URL
`{servername}`	Name of the server
`{serverid}`	ID of the server
`{boostcount}`	Total number of boosts
`{boostercount}`	Total number of boosters
`{boostlevel}`	Current boost tier
`{serverowner}`	Mentions the server owner
`{serverownerid}`	Server owner’s ID
`{serverdescription}`	The server’s description
`{serverchannelcount}`	Total channel count
`{servertextchannelcount}`	Total text channel count
`{servervoicechannelcount}`	Total voice channel count
`{servercategorycount}`	Total category count
`{serverrolecount}`	Total role count
`{serveremojicount}`	Total emoji count
`{serverstickercount}`	Total sticker count
`{servercreatedat}`	Timestamp of server creation
`{serververificationlevel}`	Server verification level
`{servernsfw}`	Server NSFW level
`{servermaxmembers}`	Maximum members allowed
`{servermaxpresences}`	Maximum presences allowed
`{servermaxvideochannels}`	Maximum video channel users
`{serverpreferredlocale}`	Preferred locale of the server
`{servermfaenabled}`	MFA enabled status
`{serverexplicit}`	Explicit content filter level
`{serverfeatures}`	List of server features
`{serverafkchannel}`	Mentions the AFK channel
`{serverafktimeout}`	AFK timeout duration
`{serversystemchannel}`	Mentions the system channel
`{serverruleschannel}`	Mentions the rules channel
`{serverpublicupdateschannel}`	Mentions the public updates channel

User Variables

Variable	Description
`{user}`	Mentions the user
`{username}`	The user’s name
`{userid}`	The user’s ID
`{usernick}`	The user’s nickname
`{userdisplayname}`	The user’s display name
`{usericon}`	User’s display avatar URL
`{useravatar}`	User’s global avatar URL
`{userglobalavatar}`	User’s default avatar URL
`{userjoinedat}`	Timestamp of when they joined the server
`{usercreatedat}`	Timestamp of account creation
`{userbot}`	Whether the user is a bot
`{usertoprole}`	Mentions the user’s highest role
`{usertoproleid}`	ID of user’s highest role
`{userrolecount}`	Number of roles the user has
`{usercolor}`	The user’s role color
`{userhexcolor}`	The user’s hex color
`{userstatus}`	User’s current status
`{userpremium}`	Whether user is boosting
`{userpremiumsince}`	Timestamp of boost start
`{userdiscriminator}`	User’s discriminator
`{userglobalname}`	User’s global name
`{usertimedout}`	Whether the user is timed out
`{usertimeoutat}`	Timestamp of timeout expiry

Author Variables

Variable	Description
`{author}`	Mentions the author
`{authorname}`	The author’s name
`{authorid}`	The author’s ID
`{authornick}`	The author’s nickname
`{authordisplayname}`	The author’s display name
`{authoricon}`	Author’s display avatar URL
`{authoravatar}`	Author’s global avatar URL
`{authorjoinedat}`	Timestamp of when they joined the server
`{authorcreatedat}`	Timestamp of account creation
`{authorbot}`	Whether the author is a bot
`{authortoprole}`	Mentions the author’s highest role
`{authorrolecount}`	Number of roles the author has
`{authorcolor}`	The author’s role color
`{authorstatus}`	Author’s current status

Target Variables

Variable	Description
`{target}`	Mentions the target
`{targetname}`	The target’s name
`{targetid}`	The target’s ID
`{targetnick}`	The target’s nickname
`{targetdisplayname}`	The target’s display name
`{targeticon}`	Target’s display avatar URL
`{targetavatar}`	Target’s global avatar URL
`{targetjoinedat}`	Timestamp of when they joined the server
`{targetcreatedat}`	Timestamp of account creation
`{targetbot}`	Whether the target is a bot
`{targettoprole}`	Mentions the target’s highest role
`{targetrolecount}`	Number of roles the target has
`{targetcolor}`	The target’s role color
`{targetstatus}`	Target’s current status

Channel & Thread Variables

Variable	Description
`{channelid}`	ID of the channel
`{channelname}`	Name of the channel
`{channel}`	Mentions the channel
`{channelcreatedat}`	Timestamp of channel creation
`{channeltype}`	Type of the channel
`{channeltopic}`	The topic of the channel
`{channelcategory}`	The category the channel is in
`{channelcategoryid}`	ID of the channel’s category
`{channelnsfw}`	Whether the channel is NSFW
`{channelposition}`	The position of the channel
`{channelslowmode}`	The slowmode delay of the channel
`{channeldefaultthreadslowmode}`	Default thread slowmode delay
`{channelnews}`	Whether the channel is a news channel
`{channeluserlimit}`	User limit for voice channels
`{channelbitrate}`	Bitrate for voice channels
`{channelrtcregion}`	RTC region for voice channels
`{channelusers}`	Number of users in the voice channel
`{threadarchived}`	Whether the thread is archived
`{threadlocked}`	Whether the thread is locked
`{threadmembercount}`	Thread member count
`{threadmessagecount}`	Thread message count
`{threadautohideduration}`	Auto archive duration
`{threadowner}`	Mentions the thread owner
`{forumdefaultlayout}`	Forum default layout
`{forumdefaultsortorder}`	Forum default sort order
`{forumdefaultreaction}`	Forum default reaction

Message Variables

Variable	Description
`{messageid}`	ID of the message
`{messagecontent}`	The text content of the message
`{messageauthor}`	Mentions the message author
`{messageauthorid}`	Message author’s ID
`{messagecreatedat}`	Timestamp of message creation
`{messageeditedat}`	Timestamp of message edit
`{messageattachments}`	Number of attachments
`{messageembeds}`	Number of embeds
`{messagereactions}`	Number of reactions
`{messagepinned}`	Whether the message is pinned
`{messagejump}`	A clickable URL to jump to the message
`{messagetype}`	Type of the message

Role Variables

Variable	Description
`{roleid}`	ID of the role
`{rolename}`	Name of the role
`{rolemention}`	Mentions the role
`{rolecolor}`	The color of the role
`{rolehoist}`	Whether the role is hoisted
`{rolementionable}`	Whether the role is mentionable
`{roleposition}`	The position of the role
`{rolemembercount}`	Number of members who have this role
`{rolecreatedat}`	Timestamp of role creation
`{rolemanaged}`	Whether the role is managed
`{rolepermissions}`	The permissions value of the role

Emoji Variables

Variable	Description
`{emojiid}`	ID of the emoji
`{emojiname}`	Name of the emoji
`{emojimention}`	Renders the emoji
`{emojiurl}`	URL of the emoji image
`{emojianimated}`	Whether the emoji is animated
`{emojimanaged}`	Whether the emoji is managed
`{emojicreatedat}`	Timestamp of emoji creation

Invite Variables

Variable	Description
`{invitecode}`	The invite code string
`{inviteurl}`	The full invite URL
`{invitechannel}`	Mentions the invite’s channel
`{inviteuses}`	How many times the invite has been used
`{invitemaxuses}`	Max uses allowed for the invite
`{invitemaxage}`	Max age allowed for the invite
`{invitetemporary}`	Whether the invite grants temporary membership
`{invitecreatedat}`	Timestamp of invite creation
`{inviteexpiresat}`	Timestamp of invite expiration
`{inviter}`	Mentions the user who created the invite

Time, Date & Misc Variables

Variable	Description
`{timestamp}`	Relative time (e.g. “2 hours ago”)
`{time}`	Full date and time
`{unix}`	Current UNIX timestamp
`{date}`	Current Date
`{shorttime}`	Short time format
`{longtime}`	Long time format
`{shortdate}`	Short date format
`{year}`	The current year
`{month}`	The current month
`{day}`	The current day
`{hour}`	The current hour
`{minute}`	The current minute
`{second}`	The current second
`{random}`	A random number between 1 and 100
`{randuser}`	Mentions a random user in the server
`{randchannel}`	Mentions a random channel in the server

How to Use Variables

Variables must be wrapped in curly braces {}. For example, if you want to mention a user, you would simply type {user} in your message setup. When a module triggers a custom message, ZEON dynamically replaces the text with the actual data. Here is how you can practically use variables in different modules.

Vanity Roles

In the Vanity Roles module, when a user updates their status to include your server’s vanity URL, the bot can send a customized reward message. The variables evaluate in the context of the user receiving the role.

.vanityrole message Thank you {user} for repping {servername} in your status! You now have {userrolecount} roles.

Thank you @john_doe for repping ZEON Official in your status! You now have 4 roles.

Boost Greet

When a member boosts your server, you can use variables to show appreciation dynamically in a welcome channel.

.boostgreet message We just got boosted by {user}! We now have {boostcount} boosts and are at tier {boostlevel}!

We just got boosted by @jane_doe! We now have 15 boosts and are at tier 3!

Overview

Permissions

Security

Automod

Moderation

Modules

Music

Resources

Complete Variable Reference

How to Use Variables

Vanity Roles

Boost Greet

​Complete Variable Reference

​How to Use Variables

​Vanity Roles

​Boost Greet

Complete Variable Reference

How to Use Variables

Vanity Roles

Boost Greet