variables - placeholders & functions
- you can escape a placeholder or function via a backslash
\
before your placeholder. this way, the placeholder will not replace (e.g.\{user}
).
- advanced usage: user information can all be extended into a function to swap the user target of the information. for example,
{user_balance:395526710101278721}
would provide balance of that specific user id. - this means that
{user_balance:[$1]}
can provide the user balance of the first argument. for more information, read advanced ii: using user arguments in placeholders.
variable | example | description |
{user} | @iara#0001 | the user's @mention |
{user_tag} | iara#0001 | the user's username and tag |
{user_name} | iara | the user's username |
{user_avatar} | the user's avatar | |
{user_discrim} | 0001 | the user's discriminator (the numbers after your username) |
{user_id} | 395526710101278721 | the user's id |
{user_nick} | iara c: | the member's nickname in the server, if applicable |
{user_joindate} | Wed, Aug 15, 2018 2:32 AM | the date of when the member joined the server |
{user_createdate} | Wed, Dec 27, 2017 10:41 AM | the date of when the user joined discord |
{user_displaycolor} | #ffdfdf | the member's hex color when chatting |
{user_boostsince} | Wed, Mar 17, 2021 7:13 PM | the date the member has been boosting the server since (if they're not a booster, it'll say "Not a Booster") |
{user_balance} | 21983 | the member's balance |
{user_balance_locale} | 21,983 | the member's balance but with locale (comma separator) |
variable | example | description |
{server_name} | = m i m u = | the server's name |
{server_id} | 479115079338557469 | the server's id |
{server_membercount} | 407 | the server's member count |
{server_membercount_ordinal} | 203rd | the ordinal number of the member count |
{server_membercount_nobots} | 400 | the server's member count, but without bots* |
{server_membercount_nobots_ordinal} | 309th | the ordinal number of the server's member count without bots* |
{server_botcount} | 6 | the server's bot count* |
{server_botcount_ordinal} | 2nd | the ordinal number of the server's bot count* |
{server_icon} | the server's icon | |
{server_rolecount} | 40 | the server's role count |
{server_channelcount} | 20 | the server's channel count (includes all types of channels) |
{server_randommember} | @iara | the @mention of a random member of your server** |
{server_randommember_tag} | iara#0001 | the user and tag of a random member of your server** |
{server_randommember_nobots} | @iara | the @mention of a random member (that is not a bot) of your server** |
{server_owner} | @iara#0001 | the @mention of the server owner |
{server_owner_id} | 395526710101278721 | the user id of the server owner |
{server_createdate} | Wed, Dec 27, 2017 10:41 AM | the date the server was created on |
* = due to discord's constraints with intents, the numbers of bots / without bots can be unreliable since october 2020. this is a result of not being able to cache every bot without caching all members in your server.
** = due to discord's constraints with intents, random member variables only consists of cached members (usually members who are active in your chat).
variable | example | description |
{server_boostlevel} | 2 | the boost level, from 0 to 3, of the server |
{server_boostcount} | 16 | the number of boosts the server has |
{server_nextboostlevel} | 3 | the boost level the server is heading towards.* |
{server_nextboostlevel_required} | 30 | the number of boosts the server needs in total to reach the next boost level.* |
{server_nextboostlevel_until_required} | 14 | the number of boosts the server needs in order to reach the next boost level* |
* = "Max Level Reached" if it's already at level 3.
variable | example | description |
{server_prefix} | . | the server's prefix |
{server_currency} | 🍪 | the server's currency |
variable | example | description |
{channel} | #general | the mention of the channel |
{channel_name} | media | the name of the channel |
{channel_createdate} | Sun, Dec 27, 2020 3:11 AM | the date of when the channel was created |
variable | example | description |
{message_id} | 8832493284932843t | the id of the message that triggered the autoresponder |
{message_content} | hi! i'm new! | the content of the message that triggered the autoresponder.
pro-tip! it's the same as [$1+] , but with the trigger. |
{message_link} | the link to the message that triggered the autoresponder. |
variable | example | description |
{date} | Tue, April 27, 2021 10:41 AM | the date, now. |
there are no examples for these because this depends on either user input, or something else, and could simply be anything.
there are no examples for these because this depends on either user input, or defined elsewhere in your autoresponder. this can be simply anything.
for information on using this, please view intermediate guides on ranges and making choices, locked choices, as well as advanced guides on different matchmodes and using user arguments.
variable | description |
[range] | the range response made from the range in the {range:} function. |
[choice] | the choice made from the chosen list in the {choose:} function. |
[lockedchoice] | the corresponding locked choice made from {lockedchoose:} function |
[$N] | the Nth argument/word used to trigger the autoresponder send by the user. only applicable for modes of autoresponder that is not exact. |
[$N+] | the Nth word and words after that was used to trigger the autoresponder send by the user. only applicable for modes of autoresponder that is not exact. |
[$N-Z] | the Nth to Zth words / arguments used to trigger the autoresponder send by the user. only applicable for modes of autoresponder that is not exact. |
variable | usage | description |
{dm} | {dm} | redirects the response to be in dms. |
{sendto:} | {sendto:#general} | redirects the response to the channel specified. by default, it is the channel the autoresponder is invoked in. |
{embed:} | {embed}
{embed:#ffffff}
{embed:embed_name} | turns the reply to an embed. if input is provided, then you can put in a hex color, or a premade custom embed from the .embed command. |
variable | usage | description |
{delete} | {delete} | delete's the triggering message to the autoresponder |
{delete_reply:} | {delete_reply:10} | deletes the bot's reply after a given number of seconds. |
you can enable this to multiple users / permissions / roles / channels etc. by putting multiple function variables in your autoresponder.
variable | usage | description |
{requireuser:} | {requireuser:iara#0001}
{requireuser:395526710101278721} | limit the autoresponder to only respond to a specified user. |
{requireperm:} | {requireperm:manage_server} | limit the autoresponder to only respond if they have specified permission |
{requirechannel:} | {requirechannel:#general}
{requirechannel:598897082450968617} | limit the autoresponder to only respond if it's ran in specified channel |
{requirerole:} | {requirerole:@mods} {requirerole:484312842821173250} | limit the autoresponder to only respond if the user has the specified role
if the user does not have the specified role, it replies stating that they need specific roles |
{denychannel:} | {denychannel:#general} {denychannel:693258562603843707}
| ignores the autoresponder trigger when run in the specified channel |
{denyperm:} | {denyperm:Manage Roles} {denyperm:Manage_Messages}
| ignores the autoresponder trigger when the user has the specified permission |
{denyrole:} | {denyrole:@mischevious} {denyrole:693486619751350293}
| ignores the autoresponder trigger when the user has the specified role |
{requirebal:} | {requirebal:100} | requires the user’s balance to be at least the specified amount. |
variable | usage | description |
{modifybal:} | {modifybal:+1000}
{modifybal:+1000} {modifybal:=10000} {modifybal:*2} {modifybal:/3} {modifybal:+1000 | iara#0001} {modifybal:-1000 | iara#0001} {modifybal:=10000 | iara#0001} {modifybal:*2 | iara#0001} {modifybal:/3 | iara#0001} {modifybal:+1000 | [$1]} | adds, removes, sets, divides, or multiplies from user balance.
can only change by up to ±100,000 at once, and only 3 users at once.
supports the following simple math functions:
+ adds specified amount to existing balance- subtracts specified amount to existing balance= sets balance to be that specified amount* multiplies the existing balance by specified amount/ divides the existing balance by specified amount
can change balance from other users too, if you add the optional argument "user" after the pipe |. |
{cooldown:} | {cooldown:600} | sets a cooldown for the autoresponder to be ran in, in seconds. |
{addrole:} | {addrole:@cool kids} {addrole:@verified | iara#0001} {addrole:@verified | [$1]} | adds role to the user. optionally, you can add roles to other users, too, if you add the optional argument "user" after the pipe |. |
{removerole:} | {removerole:@cool kids} {removerole:@muted | iara#0001} {removerole:@muted | [$1]} | removes role from the user. optionally, you can remove roles to other users, too, if you add the optional argument "user" after the pipe |. |
{setnick:} | {setnick:a real cutie} {setnick:i love {user_nick}!} {setnick: iawa | iara#0001} {setnick: appropriate name | [$1]} | edits the user’s nickname in the server. optionally, you can change other users’ nicknames, too, if you add the optional argument “user” after the pipe |
|
{react:} | {react::pancakes:} | reacts the emoji to the triggering message to the autoresponder |
{reactreply:} | {reactreply::cute_dance:} | reacts the emoji to the bot reply |
using these functions can be pretty difficult! read up on our intermediate section on ranges and making choices, as well as locked choices, to fully understand.
for using arguments, read the advanced ii: using user arguments guide.
variable | description |
{range:} | chooses a value between a minimum and maximum, separated with - . (e.g. {range:1-10} ). supports up to 4 ranges, you can reference these in your autoresponder via [range] [range1] [range2] [range3] , also mentioned in advanced placeholders. |
{choose:} | chooses from a provided list of choices that are separated by the pipe | symbol. supports up to 4 choices, {choose:} {choose1:} {choose2:} {choose3:}.
you can reference these in your autoresponder via [choice] [choice1] [choice2] [choice3] , also mentioned in advanced placeholders. |
{lockedchoose:} | "locks" or "forces" a choice to happen based on a corresponding {choose:} decision. the order of the [choice] found in the {choose:} corresponds to the order of the [lockedchoice] found in the {lockedchoose:} .
for example, if a was chosen from {choose:x|y|z|a|b|c} , then n MUST be chosen from {lockedchoose1:k|r|m|n|o|p} . this is because a is the 4th option which was chosen, and n is the 4th option.
you can reference these in your autoresponder via [lockedchoice] [lockedchoice1] [lockedchoice2] [lockedchoice3] , also mentioned in advanced placeholders. |
{requirearg:} | requires an argument to be specified so you can refer to them properly in the [$N] placeholder. you can put the number of the argument in. for example, {requirearg:1} optionally takes an input type after the pipe | symbol, which forces the user to follow that type, e.g. {requirearg:2|number} . the types supported are user , channel , color , role and number . |
Last modified 2yr ago