Variables - mira

A variable is {object.property}. When the script runs, it’s swapped for the real value.

{description: {user.mention} joined — that's {guild.members} members now.}

Which variables exist depends on where the script runs. A welcome message knows about the member who joined; a ticket message knows about the ticket. The common ones below are available almost everywhere.

If a variable doesn’t exist in the current context, it’s left in the output as literal text. Seeing {user.rank} in your message means that variable isn’t available there — not that it’s spelled wrong.

Member

{user} on its own renders as a mention.

Variable	Result
`{user}` / `{user.mention}`	`@someone`
`{user.name}`	`someone`
`{user.display_name}`	Their nickname, or username if unset
`{user.global_name}`	Their display name
`{user.id}`	`1234567890`
`{user.avatar}`	URL to their avatar
`{user.created_at}`	Account creation, as a Discord timestamp
`{user.joined_at}`	When they joined this server
`{user.join_position}`	`47` — the Nth member to join
`{user.top_role}`	Their highest role
`{user.roles}`	Comma-separated role names
`{user.role_ids}`	Comma-separated role IDs
`{user.color}`	Their role colour
`{user.bot}`	`True` / `False`

user, member, author, u and m are interchangeable. {member.name} and {u.name} are the same as {user.name} — use whichever reads better to you.

Server

Variable	Result
`{guild.name}`	Your server’s name
`{guild.id}`	Its ID
`{guild.icon}`	URL to the icon
`{guild.members}`	Total member count
`{guild.humans}`	Non-bot members
`{guild.bots}`	Bot members
`{guild.boosters}`	Number of boosters
`{guild.boosts}`	Boost count
`{guild.boost_tier}`	`0`–`3`
`{guild.vanity}`	Vanity code, e.g. `mira`
`{guild.vanity_url}`	The full `discord.gg/...` link
`{guild.created_at}`	When the server was made
`{guild.owner}`	The owner

Aliases: guild, server, sv, g, s. {server.name} works.

Channel

Variable	Result
`{channel}` / `{channel.mention}`	`#general`
`{channel.name}`	`general`
`{channel.id}`	Its ID
`{channel.topic}`	The channel topic

Aliases: channel, ch, c.

Context-specific variables

Levels

Available in !level message:

Variable	Result
`{user.level}`	The level just reached
`{user.next_level}`	The one after it
`{user.xp}`	XP toward the current level
`{user.total_xp}`	Lifetime XP
`{user.required_xp}`	XP needed for the next level

!level message {content: gg {user.mention}} {description: level **{user.level}** — {user.required_xp} xp to {user.next_level}} {color: dominant}

Moderation

Available in !invoke responses, which override what moderation commands reply with:

Variable	Result
`{user}`	The member being punished
`{moderator}`	Who ran the command
`{reason}`	The reason given
`{case}`	The case number
`{duration}`	For temp punishments

!invoke ban {content: {user.name} got hit — case #{case}} {description: {reason}}

!invoke variables lists them in Discord.

Tickets

Available in ticket option messages:{case}, {panel}, {option}, {creator}, {claimer}, {reason}, plus {user} for whoever triggered the action.

!tickets option message Support billing greeting {title: Ticket #{case}} {description: hey {creator.mention} — someone will be with you shortly.}

Vanity and tag roles

In !vanity message and !tag message, {user} is the member who was awarded a role and {role} is the role they got.

Counter channels

Counter channel names use a different, flatter variable set — no user. or guild. prefix. {members}, {boosters}, {online}, {messages_today}, {voice_week} and so on. See Counters for the full list, or run !counter variables.

VoiceMaster

!voicemaster default name accepts {user.name}, and defaults to something like {user.name}'s channel.

Timestamps

Any date variable renders as a raw Unix timestamp, which means you can drop it straight into Discord’s timestamp markdown:

{description: account made <t:{user.created_at}:R>}

Renders as account made 3 years ago. The format letters are Discord’s own:

Suffix	Output
`:R`	`3 years ago`
`:d`	`20/04/2021`
`:D`	`April 20, 2021`
`:t`	`16:20`
`:F`	`Tuesday, April 20, 2021 16:20`

Add .iso to get an ISO 8601 string instead — {user.created_at.iso}.

Finding what’s available

Most modules have a variables subcommand that lists exactly what that context supports:

!welcome variables
!goodbye variables
!boost variables
!rejoin variables
!pingonjoin variables
!invoke variables
!counter variables
!autothread variables

Variables compose with operators. {guild.members|comma} gives 1,247, {user.name|upper} shouts, and {if: {user.bot}==True && beep boop && welcome} branches on a value.

​Member

​Server

​Channel

​Context-specific variables

​Timestamps

​Finding what’s available

Member

Server

Channel

Context-specific variables

Timestamps

Finding what’s available