Variable Dictionary - @curse' Docs

Don’t forget to check out the official documentation for @curse embeds and dynamic messaging @ https://docs.cursebot.site/resources/scripting

1. Core Variable Categories

Variable	Output
`guild`	The name of the server.
`guild.name`	The name of the server.
`guild.id`	The unique 18-digit Discord ID of the server.
`guild.owner_id`	The unique 18-digit Discord ID of the server owner.
`guild.icon`	The direct URL to the server’s icon image.
`guild.banner`	The direct URL to the server’s banner image.
`guild.splash`	The direct URL to the server’s invite splash image.
`guild.created_at`	The date the server was created.
`unix(guild.created_at)`	The Unix timestamp of the server creation date.
`guild.count`	The total number of members in the server.
`guild.member_count`	The total number of members in the server.
`guild.boost_count`	The total number of boosts the server has.
`guild.boost_tier`	The current boost tier level of the server.
`guild.emoji_count`	The total number of emojis in the server.
`guild.role_count`	The total number of roles in the server.
`guild.channel_count`	The total number of channels in the server.
`guild.text_channel_count`	The total number of text channels in the server.
`guild.voice_channel_count`	The total number of voice channels in the server.
`guild.category_channel_count`	The total number of category channels in the server.
`guild.features`	A list of the server’s enabled features.

Variable	Output
`user`	The user’s full Discord tag.
`user.id`	The unique 18-digit Discord ID of the user.
`user.mention`	Tags the user with a clickable mention.
`user.name`	The username of the user.
`user.tag`	The discriminator of the user.
`user.avatar`	The direct URL to the user’s current profile picture.
`user.bot`	Whether the user account is a bot (true or false).
`user.created_at`	The date the user’s Discord account was created.
`unix(user.created_at)`	The Unix timestamp of the account creation date.
`user.display_avatar`	The direct URL to the user’s display avatar.
`user.joined_at`	The date the user joined the server.
`unix(user.joined_at)`	The Unix timestamp of the server join date.
`user.join_position`	The numerical join position of the user in the server.
`suffix(user.join_position)`	The join position formatted with an ordinal suffix (1st, 2nd, etc.).
`user.highest_role`	The highest role assigned to the user.
`user.role_list`	A comma-separated list of the user’s roles.
`user.role_count`	The total number of roles assigned to the user (excluding @everyone).
`user.boost`	Whether the user is currently boosting the server (true or false).
`user.boost_since`	The date the user started boosting the server.
`unix(user.boost_since)`	The Unix timestamp of the boost start date.
`user.color`	The user’s display hex color based on their highest role.
`user.nickname`	The user’s nickname in the server.
`user.display_name`	The display name of the user.

Variable	Output
`channel`	The name of the channel.
`channel.name`	The name of the channel.
`channel.id`	The unique 18-digit Discord ID of the channel.
`channel.mention`	Tags the channel with a clickable mention.
`channel.topic`	The topic set for the channel.

Variable	Output
`moderator.mention` / `mod.mention`	Tags the moderator with a clickable mention.
`moderator.name` / `mod.name`	The username of the moderator.
`moderator.display_name`	The display name of the moderator.
`moderator.nick`	The moderator’s nickname in the server.
`moderator.tag`	The moderator’s full Discord tag.
`moderator.discriminator`	The discriminator of the moderator.
`moderator.id`	The unique 18-digit Discord ID of the moderator.
`moderator.avatar`	The direct URL to the moderator’s current profile picture.
`moderator.display_avatar`	The direct URL to the moderator’s display avatar.
`moderator.color` / `moderator.colour`	The moderator’s display hex color based on their highest role.
`moderator.top_role`	The name of the moderator’s highest role.
`moderator.joined_at`	The date the moderator joined the server.
`moderator.joined_at_timestamp`	The formatted timestamp of the server join date.
`moderator.created_at`	The date the moderator’s Discord account was created.
`moderator.created_at_timestamp`	The formatted timestamp of the account creation date.
`moderator.boost`	Whether the moderator is currently boosting the server (true or false).
`moderator.boost_since`	The date the moderator started boosting the server.
`moderator.bot`	Whether the moderator account is a bot (true or false).
`reason`	The reason provided for the moderation action.
`duration`	The duration of the moderation action.

Variable	Output
`victim.mention`	Tags the victim with a clickable mention.
`victim.name`	The username of the victim.
`victim.display_name`	The display name of the victim.
`victim.nick`	The victim’s nickname in the server.
`victim.tag`	The victim’s full Discord tag.
`victim.discriminator`	The discriminator of the victim.
`victim.id`	The unique 18-digit Discord ID of the victim.
`victim.avatar`	The direct URL to the victim’s current profile picture.
`victim.display_avatar`	The direct URL to the victim’s display avatar.
`victim.color` / `victim.colour`	The victim’s display hex color based on their highest role.
`victim.top_role`	The name of the victim’s highest role.
`victim.joined_at`	The date the victim joined the server.
`victim.joined_at_timestamp`	The formatted timestamp of the server join date.
`victim.created_at`	The date the victim’s Discord account was created.
`victim.created_at_timestamp`	The formatted timestamp of the account creation date.
`victim.boost`	Whether the victim is currently boosting the server (true or false).
`victim.bot`	Whether the victim account is a bot (true or false).

Variable	Output
`level.new_rank`	The user’s new level rank.
`level.user_xp`	The total XP amount of the user.

Variable	Output
`user.name`	The Last.fm username.
`user.avatar`	The direct URL to the Last.fm profile picture.
`user.plays`	The total number of scrobbles.
`user.url`	The direct URL to the Last.fm profile.
`author`	The Discord author object.
`author.name`	The username of the Discord author.
`author.nickname`	The nickname of the Discord author.
`author.discriminator`	The discriminator of the Discord author.
`album.name`	The name of the album.
`lower(album.name)`	The album name converted to lowercase.
`album.url`	The direct URL to the album page.
`album.cover`	The direct URL to the album cover image.
`track.name`	The name of the track.
`lower(track.name)`	The track name converted to lowercase.
`track.url`	The direct URL to the track page.
`track.spotify_url`	The direct URL to the track on Spotify.
`track.plays`	The total number of plays for the track.
`artist.name`	The name of the artist.
`lower(artist.name)`	The artist name converted to lowercase.
`artist.plays`	The total number of plays for the artist.
`artist.url`	The direct URL to the artist page.
`artist.image`	The direct URL to the artist image.

2. Frequently Asked Questions

2. 1. Where can I use these variables?

You can use these in any command that has a message or embed code parameter. This includes automated posts, custom responses, and greeting messages.

2. 2. What happens if I use a variable incorrectly?

If a variable is misspelled (e.g., {uesr}), @curse will treat it as plain text and won’t replace it with dynamic data. Always double-check your spelling against this guide!