variables
a variable is a word between braces that arii fills in when it sends a message: {user.displayName} becomes the person's name, {server.memberCount} how many people are here. they work in messages, cards, responses and flows. in the dashboard, { in any field offers them as you type.
writing one
- a value:
{user}mentions the person,{user.displayName}is their name,{server.name}the server's. - a part of a list:
{interaction.values.1}is the first thing picked,.lastthe last one,.counthow many. - when it might be empty, give it something else with
or:{user.banner | or:user.avatar}uses their avatar when they have no banner, and{member.nick | default:friend}writes "friend". - braces as they are: a backslash first,
\{user}, writes the braces themselves.
filters
a filter goes after a bar and changes how a value is written: {user.joinedAt | relative}. several can follow one another.
| filter | what it does | example |
|---|---|---|
relative | a date as time ago, as discord shows it. | {member.joinedAt | relative} |
date:F | a date in discord's styles: t, T, d, D, f, F or R; or just its day, month or year. | {server.createdAt | date:D} |
format | a number with its thousands separated. | {server.memberCount | format} |
ordinal | a number as a place: 1st, 2nd, 3rd. | {member.joinPosition | ordinal} |
duration | milliseconds as 3:45 or 1:02:03. | {track.duration | duration} |
truncate:20 | at most that many characters, with … at the end. | {server.name | truncate:20} |
upper | every letter big. | {user.name | upper} |
lower | every letter small. | {server.name | lower} |
capitalize | the first letter big. | {user.name | capitalize} |
and | a list as people say it: a, b and c. | {interaction.labels | and} |
join:" · " | a list with your own separator. | {interaction.labels | join: · } |
escape | markdown written as plain text (stars stay stars). | {user.name | escape} |
default:text | the text when the value is empty. | {member.nick | default:friend} |
or:another | another variable when the value is empty. | {user.banner | or:user.avatar} |
everywhere
in every message, card and response arii sends.
{user} the person
who it's about: who used it, joined, reacted…
- the personas a mention in messages, by name elsewhere.also:
{user.name}{user.id} - display namethe name people see.
- global namethe name chosen for the account, if any.
- tagthe username, or name#1234 for old accounts.
- avatartheir account's avatar, the same in every server.
- avatar decorationthe frame discord shows around the avatar.
- bannera link to the banner.
- account madewhen the account was made.
- is a botyes when it's a bot account.
{member} the person here
the same person, as this server knows them.
- the person hereas a mention in messages, by name elsewhere.also:
{member.id} - nicknamethe nickname in this server, if any.
- server namethe name shown in this server.
- avatartheir avatar in this server, else their account's.
- bannera link to the banner.
- joinedwhen they joined this server.
- join numberthey were the nth person to join. counted in servers of up to 1,000 members; in bigger ones, known for people who joined while arii was here.
- boosting sincewhen they started boosting; empty if they don't.
- colortheir name's color, as a number.
- highest roletheir highest role.also:
{member.highestRole.1}{member.highestRole.last}{member.highestRole.count} - number of roleshow many roles they have.
- statusonline, idle, dnd or offline.
{server} the server
this server.
- idits discord id.
- namethe name, as written.
- icona link to the icon.
- bannera link to the banner.
- descriptionits description.
- membershow many members.
- boostshow many boosts.
- boost level0 to 3.
- madewhen the server was made.
- prefixarii's command prefix here.
{owner} the owner
who owns this server.
- the owneras a mention in messages, by name elsewhere.also:
{owner.name}{owner.id} - display namethe name people see.
- global namethe name chosen for the account, if any.
- tagthe username, or name#1234 for old accounts.
- avatara link to the picture.
- avatar decorationthe frame discord shows around the avatar.
- bannera link to the banner.
- madewhen it was made.
- is a botyes when it's a bot account.
- nicknamethe nickname in this server, if any.
- server avatarthe avatar in this server, else the account's.
{channel} the channel
where it happens.
- the channelas a mention in messages, by name elsewhere.also:
{channel.name}{channel.id} - topicthe channel's topic.
{bot} arii
the bot itself.
- ariias a mention in messages, by name elsewhere.also:
{bot.name}{bot.id} - display namethe name people see.
- avatara link to the picture.
- servershow many servers arii is in.
- peoplehow many people arii can see.
{date} time
the moment it's sent.
- nowthe moment it's sent.
- timestampthe moment as a number (milliseconds).
{random} random
a different one each time.
- random numberadd a range after a colon, like random.number:1,100.
- random pickone of the words after a colon, like random.pick:"tea","coffee".
custom commands
when a custom command runs: what the person wrote.
{args} the command's words
what was written after the command: args.1, args.2…
- all their wordseverything written after the command.
flows
inside a flow: the run, and what it remembers.
{event} what happened
the details of what started the flow.
- on the rules screenthey haven't accepted the rules yet.
- who invited themempty when arii couldn't tell.also:
{event.inviter.name}{event.inviter.id} - display namethe name people see.
- what changedthe changes, as the filter names them.also:
{event.changes.1}{event.changes.last}{event.changes.count} - roles giventhe roles they got.also:
{event.rolesAdded.1}{event.rolesAdded.last}{event.rolesAdded.count} - roles takenthe roles they lost.also:
{event.rolesRemoved.1}{event.rolesRemoved.last}{event.rolesRemoved.count} - beforehow it was.
- nicknamethe nickname in this server, if any.
- avatara link to the picture.
- timed out untilwhen their timeout ends.
- boosting sincewhen they started boosting; empty if they don't.
- on the rules screenthey haven't accepted the rules yet.
- statuswhere it stands: someone's online, idle, dnd or offline, or a scheduled event's scheduled, active, completed or cancelled.
- custom statusthe words (and emoji) under their name.
- activitieswhat they're playing, listening to, watching or streaming, by name.also:
{event.before.activities.1}{event.before.activities.last}{event.before.activities.count} - streamingsharing their screen.
- stream linkwhere they're streaming, when they are.
- deviceswhere they're on: desktop, mobile or web.also:
{event.before.devices.1}{event.before.devices.last}{event.before.devices.count} - wordsthe message's words.
- channelthe channel it's about.also:
{event.before.channel.name}{event.before.channel.id} - mutedmuted, by themselves or the server.
- deafeneddeafened, by themselves or the server.
- videotheir camera is on.
- idits discord id.
- namethe name, as written.
- mention
- kindwhat kind it is.
- topicthe channel's topic.
- categorythe category it's in.also:
{event.before.category.name}{event.before.category.id} - age-restrictedmarked age-restricted.
- slowmodeseconds between messages.
- positionits place in the list.
- archivedthe thread is archived.
- lockedonly moderators can reopen it.
- colorthe color, as a number.
- shown apartshown apart in the member list.
- mentionableanyone can mention it.
- managedowned by an integration, like a bot's role.
- permissionsits permissions, by name.also:
{event.before.permissions.1}{event.before.permissions.last}{event.before.permissions.count} - descriptionits description.
- icona link to the icon.
- bannera link to the banner.
- vanity linkthe server's own invite code.
- verification levelhow much new members must have done before talking.
- boost level0 to 3.
- linka link to it.
- startswhen it starts.
- endswhen it ends.
- placewhere it happens.
- afterhow it is now.
- nicknamethe nickname in this server, if any.
- avatara link to the picture.
- timed out untilwhen their timeout ends.
- boosting sincewhen they started boosting; empty if they don't.
- on the rules screenthey haven't accepted the rules yet.
- statuswhere it stands: someone's online, idle, dnd or offline, or a scheduled event's scheduled, active, completed or cancelled.
- custom statusthe words (and emoji) under their name.
- activitieswhat they're playing, listening to, watching or streaming, by name.also:
{event.after.activities.1}{event.after.activities.last}{event.after.activities.count} - streamingsharing their screen.
- stream linkwhere they're streaming, when they are.
- deviceswhere they're on: desktop, mobile or web.also:
{event.after.devices.1}{event.after.devices.last}{event.after.devices.count} - wordsthe message's words.
- channelthe channel it's about.also:
{event.after.channel.name}{event.after.channel.id} - mutedmuted, by themselves or the server.
- deafeneddeafened, by themselves or the server.
- videotheir camera is on.
- idits discord id.
- namethe name, as written.
- mention
- kindwhat kind it is.
- topicthe channel's topic.
- categorythe category it's in.also:
{event.after.category.name}{event.after.category.id} - age-restrictedmarked age-restricted.
- slowmodeseconds between messages.
- positionits place in the list.
- archivedthe thread is archived.
- lockedonly moderators can reopen it.
- colorthe color, as a number.
- shown apartshown apart in the member list.
- mentionableanyone can mention it.
- managedowned by an integration, like a bot's role.
- permissionsits permissions, by name.also:
{event.after.permissions.1}{event.after.permissions.last}{event.after.permissions.count} - descriptionits description.
- icona link to the icon.
- bannera link to the banner.
- vanity linkthe server's own invite code.
- verification levelhow much new members must have done before talking.
- boost level0 to 3.
- linka link to it.
- startswhen it starts.
- endswhen it ends.
- placewhere it happens.
- rolesthe roles.also:
{event.roles.1}{event.roles.last}{event.roles.count} - startedwhat they started doing.also:
{event.started.1}{event.started.last}{event.started.count} - stoppedwhat they stopped doing.also:
{event.stopped.1}{event.stopped.last}{event.stopped.count} - linka link to it.
- message idthe message's id.
- channelthe channel it's about.also:
{event.channel.name}{event.channel.id} - kindwhat kind it is.
- topicthe channel's topic.
- categorythe category it's in.also:
{event.channel.category.name}{event.channel.category.id} - age-restrictedmarked age-restricted.
- slowmodeseconds between messages.
- positionits place in the list.
- wordsthe message's words.
- fileslinks to its files.also:
{event.attachments.1}{event.attachments.last}{event.attachments.count} - mentionsthe people it mentions.also:
{event.mentions.1}{event.mentions.last}{event.mentions.count} - replying toa link to the message it answers.
- how manyhow many there were.
- last pinwhen the newest pin was pinned.
- whenwhen it happened.
- emojithe emoji used.
- authorwho wrote the message (id).
- answerthe poll answer's number.
- threadthe thread.also:
{event.thread.name}{event.thread.id} - archivedthe thread is archived.
- lockedonly moderators can reopen it.
- channelthe channel the thread is in.also:
{event.parent.name}{event.parent.id} - addedwho or what was added.also:
{event.added.1}{event.added.last}{event.added.count} - removedwho or what was removed.also:
{event.removed.1}{event.removed.last}{event.removed.count} - rolethe role it's about.also:
{event.role.name}{event.role.id} - colorthe color, as a number.
- shown apartshown apart in the member list.
- mentionableanyone can mention it.
- managedowned by an integration, like a bot's role.
- positionits place in the list.
- permissionsits permissions, by name.also:
{event.role.permissions.1}{event.role.permissions.last}{event.role.permissions.count} - invite codethe invite's code.
- max useshow many times it works (0: no limit).
- lastsseconds it works for (0: always).
- temporarywho it lets in leaves when they go offline, unless given a role.
- actionwhat was done.
- whothe person a person's menu was used on.
- idits discord id.
- namethe name, as written.
- display namethe name people see.
- mention
- reasonwhy, when they said.
- eventthe scheduled event.
- idits discord id.
- namethe name, as written.
- linka link to it.
- descriptionits description.
- startswhen it starts.
- endswhen it ends.
- placewhere it happens.
- statuswhere it stands: someone's online, idle, dnd or offline, or a scheduled event's scheduled, active, completed or cancelled.
- stagethe stage.
- topicthe channel's topic.
- channelthe channel it's about.also:
{event.stage.channel.name}{event.stage.channel.id} - rulethe automod rule.
- idits discord id.
- namethe name, as written.
- onwhether it's on.
- kindwhat kind it is.
- keywordthe word automod matched.
- timewhen it happens.
- namethe name, as written.
- levelthe level they reached.
- level beforethe level they were at.
- xpall their xp now.
- reward rolesthe roles the level gave.also:
{event.rewards.1}{event.rewards.last}{event.rewards.count} - howmessage, voice or changed (someone gave them xp).
- numberits number, 0042.
- categorythe category it's in.
- who opened itthe person it's for.also:
{event.opener.name}{event.opener.id} - display namethe name people see.
- who did itwho closed it; empty when it closed by itself.also:
{event.by.name}{event.by.id} - display namethe name people see.
- commandthe command's name.
- how it was calledslash, prefix, words, userMenu or messageMenu.
- message linka link to the message.
{run} this run
about the flow running now.
- flowthe flow's name.
- startedwhen this run started.
- is a testyes when it's a test run from the dashboard.
music
when music plays: the song, the player and the queue.
{track} the song
what's playing.
- titleits title.
- artistwho made it.
- linka link to it.
- lengthhow long it lasts.
- picturea link to its picture.
- platformwhere it plays from.
- platform iconthe platform's emoji.
- asked bywho asked for it.also:
{track.requester.name}{track.requester.id} - display namethe name people see.
- global namethe name chosen for the account, if any.
- tagthe username, or name#1234 for old accounts.
- avatara link to the picture.
- avatar decorationthe frame discord shows around the avatar.
- bannera link to the banner.
- madewhen it was made.
- is a botyes when it's a bot account.
- nicknamethe nickname in this server, if any.
- server avatarthe avatar in this server, else the account's.
{player} the player
how the music plays.
- playedhow far it has played.
- volumehow loud it plays.
- volume iconan emoji for the volume.
- autoplayyes when autoplay is on.
- autoplay iconan emoji for autoplay.
- repeatoff, track or queue.
- pausedyes when it's paused.
{queue} the queue
the songs waiting.
- songshow many songs wait.
- lengthhow long it lasts.
roles given or taken
when a role is given or taken.
{role} the role
the role it's about.
- the roleas a mention in messages, by name elsewhere.also:
{role.name}{role.id} - colorthe color, as a number.
- membershow many people have it.
emoji
the bot's own emoji, by name.
{emoji} emoji
the bot's emoji pack.
in arii's own messages
each in its module's messages (a level up, a ticket, a giveaway): a response in the dashboard lists the ones it has.
{help} help
the help answer.
- commandsevery command usable here, by category.
- dashboarda link to the dashboard.
- commandone command's mention.
- descriptionwhat the command does.
- usagethe ways to write it.
- wherewhere it works.
{error} the error
what went wrong.
- permissionsthe missing permissions.
- channelthe channel that takes them away.
- fix linkadds arii again with what it needs.
- modulea module the server turned off.
- reasonwhy it couldn't be done.
- try again atwhen it works again.
- optionthe part that couldn't be read.
- usagehow to write the command.
{settings} settings
the server's arii settings.
- languagearii's language here.
- prefixthe command prefix.
- colorthe embeds' color.
- dashboarda link to the settings.
{cooldowns} cooldowns
- the listthe page's members, a line each.
- count
{notification} the notification
what it's about.
- titlewhat it's about.
- linkwhere to see it.
{gift} gift
- namethe name, as written.
- items
- claimBy
- linka link to it.
{invite} the invite
how they joined, when arii could tell.
- codethe invite they used.
- linkthe invite's link.
- invited bywho made the invite.
- useshow many joined with it.
{social} social
hugs, pats and friends.
- line“ari hugs luna ♡”.
- count“that's 3 hugs from ari to luna”, on its own line.
{picture} the picture
an avatar or banner.
- titlewhose picture it is.
- linkthe picture.
- account'sthe account's picture.
- server'sthe server's picture.
{info} the info
facts about someone or something.
- titlewhat it's about.
- detailsthe facts, a line each.
- pictureits picture.
- rolestheir roles.
- number of roleshow many roles.
- ownerwho owns it.
- categorythe category it's in.
- rolethe role.
{said} what was said
a message arii sent for someone.
- channelwhere it was sent.
- wordswhat was said.
- aswho it posed as.
- linka link to the message.
{steal} stealing
emoji and stickers taken from elsewhere.
- titlewhat's being taken.
- listthe items, numbered.
- free slotsroom left in the server.
- namesthe items' names, a line each.
- progresshow far it got.
- resultswhat happened to each.
- whereChoices
- where
{log} the log
a line of the log channel.
- titlewhat happened, with who and where.
- detailsthe details, a line each.
- footerthe ids to look things up.
{case} the case
a moderation case.
- numberthe case's number.
- actionwhat was done.
- whowho it was done to.
- their nametheir name when it happened.
- moderatorwho did it.
- reasonwhy.
- endswhen it ends, on its own line.
- appealthe appeals link, on its own line.
- notea note on its own line.
- detailsthe case in one line.
{cases} cases
someone's latest cases.
- listthe latest cases, a line each.
{purge} the cleanup
messages deleted at once.
- counthow many messages went.
{roles} roles
roles given or taken.
- summarywhat changed, a line each.
- giventhe roles given, as mentions.
- takenthe roles taken, as mentions.
- rolesthe roles named in the answer.
- whowho got or lost them.
- endswhen they end, on its own line.
- limitthe most roles of a panel one may hold.
- reasonwhy arii won't do it, a line each.
{rank} the rank
where a member stands: their level, xp and place.
- leveltheir level.
- xpall their xp.
- xp in this levelxp since they reached their level.
- xp for this levelxp from their level to the next.
- xp to goxp still to go to the next level.
- progresshow far into the level, from 0 to 1: a card's progress bar.
- placetheir place on the leaderboard.
- messagesmessages that earned xp.
- minutes in voiceminutes in voice that earned xp.
- memberwho it's about.
- level beforethe level they were at before.
- reward rolesthe roles the level gave, as mentions; empty when none.
{leaderboard} the leaderboard
a page of the server's best members.
- the listthe page's members, a line each.
- pagethe page shown.
- pageshow many pages there are.
- members with xphow many members have xp.
- on the first pageyes on the first page.
- on the last pageyes on the last page.
- linkthe leaderboard's page, when the server made it public.
{invites} invites
who someone brought, and the inviters.
- who it's aboutthe person whose invites these are.
- broughtmembers they brought who count.
- leftmembers they brought who left.
- not countedjoins that don't count (too new, came back...).
- joined in allevery join through their invites.
- the invitersa page of inviters, a line each.
- pagewhich page.
- pageshow many pages.
- on the first pagetrue on the first page.
- on the last pagetrue on the last page.
{reminder} the reminder
a personal reminder and when it comes.
- whatwhat to remind them of.
- whenwhen it comes, as a countdown.
- repeatshow often it comes again; empty when once.
- their reminderstheir reminders, a line each.
- how many they can keepthe most reminders their plan keeps.
- sign-in linkwhere to sign in to arii.
{wrapped} the wrapped
a month's or a year's listening.
- whosethe person's or the server's name.
- whenthe month or the year.
- minutesminutes listened.
- top songthe most played song.
- top artistthe most played artist.
- coverthe top song's picture.
{alert} the alert
a stream that started or a video that was posted.
- namethe channel's (or the member's) name.
- linkthe stream or the video.
- titlethe stream's or the video's title.
- gamethe game streamed; empty for a video.
- picturethe stream's or the video's picture.
- channel picturethe channel's picture.
- pingthe role pinged, as a mention; empty when none.
- rolethe role pinged.
- whenwhen it started or was posted.
- platformtwitch, youtube or discord.
{starboard} the starred message
a message on a starboard and its card.
- boardthe board's name.
- emojithe board's emoji.
- reactionsits reactions with that emoji.
- authorwho wrote it.
- author's nametheir name.
- author's picturetheir profile picture.
- wordswhat the message says.
- pictureits first picture; empty when it has none.
- channelwhere it was written.
- writtenwhen, as discord's date.
- linka link to the message.
- the listthe most starred messages, a line each.
{giveaway} the giveaway
a giveaway: its prize, winners and entries.
- prizewhat the winners get.
- descriptionits words.
- its numbercounted per server.
- how many winits number of winners.
- when it endsas discord's countdown.
- who runs itthe person who started it.
- people inhow many entered.
- their entriesthe person's entries, bonuses counted.
- who may enterwhat it asks, a line; empty when anyone may.
- how it standsrunning, paused or ended with its winners.
- the winnersas mentions.
- why notwhy someone can't enter.
- its pingthe role pinged as it starts.
- closedtrue when it isn't running.
- its linka link to its message.
- how many at oncegiveaways a server can run at once.
- its channelwhere it's posted.
- the running onesa line each.
{ticket} the ticket
a ticket: its number, category, who opened it and where.
- its number0042, counted per server.
- its categorythe kind of help it's for.
- who opened itthe person it's for.
- its thread or channelwhere it happens.
- its staffits staff roles, as mentions.
- who did itwho closed it, took it, or added someone.
- who was addedwho was added, taken out or handed it.
- who took itempty when nobody has.
- the reasonwhy it was closed.
- the reason linethe reason as a quote on its own line, or nothing.
- its category's wordsthe category's own words, after an empty line.
- the answersthe form's questions and answers.
- their open ticketslinks to the tickets they already have open.
- its new namewhat it was renamed to.
- its transcripta link to its transcript's page.
- their ratingthe stars they gave it.
{music} the music answer
what the music commands and the now-playing card say.
- playedhow far it has played.
- count
- playlist
- query
- source
- channel
- progresshow far into the level, from 0 to 1: a card's progress bar.
- toggle
- toggleEmoji
- shuffleEmoji
- loopEmoji
- autoplayEmoji
- likeEmoji
- along
- lastAction
- playerUrl
- votes
- xp for this levelxp from their level to the next.
- filter
- levels
- the listthe page's members, a line each.
- pagethe page shown.
- pageshow many pages there are.
- played
- upcoming
- on the first pageyes on the first page.
- on the last pageyes on the last page.
- onNow
- playChoices
- removeChoices
- playlistChoices
- skipped
- linkthe leaderboard's page, when the server made it public.
- reason
- header
- likesLine
- art
- descriptionits description.
- noSong
- visibilityChoices
- pickChoices
{flow} the flow
a flow writing in the log.
- namethe flow's name.
- wordsthe line it writes.