Variables Reference

Variables are dynamic placeholders you can use inside bot messages, welcome messages, bump reminders, and more. Wrap them in curly braces like {user.name}. Helpers like {lower(text)} can transform values.

User 18 vars
{user}The user's username.
{user.mention}Mentions the user — pings them in the message.
{user.name}The user's username.
{user.tag}The user's full tag e.g. username#0000. Falls back to username if discriminator is absent.
{user.id}The user's unique Discord ID.
{user.avatar}URL of the user's global Discord avatar.
{user.display_name}The user's display name in the server (nickname if set, otherwise username).
{user.display_avatar}URL of the user's display avatar (server avatar if set, otherwise global).
{user.guild_avatar}URL of the user's server-specific avatar. Falls back to global avatar.
{user.joined_at}The date the user joined the server.
{user.joined_at_timestamp}Unix timestamp (seconds) of when the user joined the server.
{user.created_at}The date the user's Discord account was created.
{user.created_at_timestamp}Unix timestamp (seconds) of when the account was created.
{user.top_role}The name of the user's highest role in the server.
{user.color}Hex color code of the user's top role color.
{user.role_list}All of the user's roles as mentions, comma separated.
{user.role_text_list}All of the user's role names as plain text, comma separated.
{user.bot}Returns Yes if the user is a bot, No otherwise.
{user.boost}Returns Yes if the user is currently boosting the server.
{user.boost_since}The date the user started boosting the server.
{user.boost_since_timestamp}Unix timestamp (seconds) of when the user started boosting.
Server / Guild 15 vars
{guild.name}The server's name.
{server.name}Alias for {guild.name}.
{guild.id}The server's unique Discord ID.
{guild.count}Total member count of the server.
{server.membercount}Alias for {guild.count}.
{guild.owner_id}The Discord ID of the server owner.
{guild.created_at}The date the server was created.
{guild.created_at_timestamp}Unix timestamp (seconds) of when the server was created.
{guild.boost_count}Number of active boosts on the server.
{guild.boost_tier}Server boost tier — No Level, Level 1, Level 2, or Level 3.
{guild.icon}URL of the server's icon image.
{guild.banner}URL of the server's banner image.
{guild.vanity}The server's vanity invite URL e.g. discord.gg/code.
{guild.role_count}Total number of roles in the server.
{guild.emoji_count}Total number of custom emojis in the server.
{guild.text_channels_count}Number of text channels in the server.
{guild.voice_channels_count}Number of voice channels in the server.
{guild.channels_count}Total number of channels in the server.
Channel 5 vars
{channel.name}The name of the channel.
{channel.id}The channel's unique Discord ID.
{channel.mention}A clickable channel mention e.g. #general.
{channel.topic}The channel's topic/description text.
{channel.position}The channel's position in the channel list.
Date & Time 7 vars
{date.now}Current date formatted as MM/DD/YYYY.
{date.utc_timestamp}Current Unix timestamp in seconds.
{date.now_proper}Current date in long format e.g. Wednesday, March 5, 2025.
{date.now_short}Short date format.
{date.now_shorter}Shorter compact date format.
{time.now}Current time formatted as HH:MM AM/PM.
{time.now_military}Current time in 24-hour format e.g. 14:30.
{time.utc_now}Current UTC time HH:MM.
Bump Reminder 2 vars
{bumpreminder.last_user_bump}Mentions the last user who bumped the server.
{bumpreminder.next_bump}Relative timestamp for when the next bump is available e.g. in 2 hours.
Welcome Points 5 vars
{welcome.sender}Mentions the member who sent the welcome.
{welcome.sender.name}Display name of the member who sent the welcome.
{welcome.receiver}Mentions the member who received the welcome.
{welcome.receiver.name}Display name of the member who received the welcome.
{welcome.points}The number of welcome points awarded.
Helper Functions 2 funcs
{lower(text)}Converts the given text to all lowercase. Example: {lower({user.name})}
{upper(text)}Converts the given text to all uppercase. Example: {upper({guild.name})}
scar bot · prefix ,

Commands

Explore every command  ·  prefix ,

143+ Commands 19 Categories
search
permissionsmoderationfilterjaileconomyauto welcomewlc pointsbump remindervanityautoresponderreactsembed builderlogginginvite trackerrolesswear jarutilityfunowner only
Owner Admin Mod Special Everyone — required permission level

Permission Management 15 cmds

,mod let @user
Grant a user Mod-level bot permissions.
Admin
,mod unlet @user
Revoke Mod-level bot permissions from a user.
Admin
,mod let list
List all users with Mod permissions.
Admin
,admin let @user
Grant a user Admin-level bot permissions.
Admin
,admin unlet @user
Revoke Admin-level bot permissions from a user.
Admin
,admin let list
List all users with Admin permissions.
Admin
,special let @user
Grant Special access (publish, ghost commands).
Admin
,special unlet @user
Revoke Special access from a user.
Admin
,special let list
List all Special users.
Admin
,fakepermissions add @role perm1, perm2
Grant fake bot permissions to a role (comma-separated). Valid perms: administrator, ban_members, kick_members, manage_guild, manage_channels, manage_roles, manage_messages, moderate_members, and more.
Admin
,fakepermissions remove @role perm1, perm2
Remove fake permissions from a role.
Admin
,fakepermissions list
View all fake permissions configured in the server.
Admin
,fakepermissions list @role
View fake permissions for one specific role.
Admin
,fakepermissions reset
Wipe all fake permissions entirely.
Admin
,fp ...
Shorthand alias for all ,fakepermissions commands.
Admin

Moderation 28 cmds

,ban @user [reason]
Ban a user from the server. DMs them the custom ban message if one is set.
Admin
,ban message [text] [optional gif/image URL]
Set the custom DM message sent to banned users. Add a URL at the end to include an image or GIF.
Admin
,unban [user ID]
Unban a user by their Discord ID.
Admin
,kick @user [reason]
Kick a user from the server.
Mod
,kick message [text] [optional gif/image URL]
Set the custom DM message sent to kicked users.
Mod
,timeout @user [duration] [reason]
Timeout a user. Duration examples: 10m, 1h, 2d, 7d.
Mod
,timeout message [text] [optional gif/image URL]
Set the custom DM message sent to timed-out users.
Mod
,warn @user [reason]
Warn a user and DM them the reason.
Mod
,warn message [text] [optional gif/image URL]
Set the custom DM message sent when warning a user.
Mod
,warnings @user
View all warnings for a user, each with a unique ID code.
Everyone
,warnings remove @user [warning ID]
Delete a single warning by its code.
Mod
,warnings clear @user
Clear every warning for a user at once.
Mod
,warning ...
Alias for all ,warnings commands.
Mod
,clear [1-500]
Bulk-delete up to 500 messages in the current channel.
Admin
,clear @user [1-500]
Delete only a specific user's messages from the current channel.
Admin
,lock
Lock the current channel so @everyone can no longer send messages.
Mod
,unlock
Unlock the current channel.
Mod
,lockdown
Lock every text channel in the server at once.
Admin
,unlockdown
Unlock every text channel in the server at once.
Admin
,nuke [#channel]
Deletes and recreates a channel, wiping all messages. Defaults to the current channel. Shows confirm/cancel buttons.
Admin
,snipe
Show the last deleted message in this channel.
Mod
,snipe [number]
Show an older snipe. e.g. ,snipe 2 for the second-to-last deleted message.
Mod
,cs
Clear all saved snipes for the current channel.
Mod
,moderation logs @user
View a staff member's full moderation action history (bans, kicks, warns, etc.), paginated.
Mod
,moderation reset @user
Clear all moderation logs for a specific staff member.
Admin
,forcenickname @user [nickname]
Permanently force a nickname on a user. If they try to change it, it will automatically snap back.
Mod
,forcenickname remove @user
Lift the forced nickname from a user, letting them change it freely again.
Mod
,forcenickname list
View all users currently under a forced nickname in this server.
Mod

Word & Link Filter 7 cmds

,filter add word1 word2 word3
Add words to the auto-delete filter (space separated).
Mod
,filter remove word1 word2
Remove words from the filter.
Mod
,filter list
View all filtered words, paginated with navigation buttons.
Mod
,filter punishment [ban/kick/timeout/none] [duration]
Set the punishment for sending filtered words. Duration only applies to timeout, e.g. ,filter punishment timeout 10m
Mod
,filter links on
Enable auto-deletion of Discord invite links.
Mod
,filter links off
Disable auto-deletion of Discord invite links.
Mod
,filter links punishment [ban/kick/timeout/none] [duration]
Set the punishment for posting Discord invite links.
Mod

Jail System 3 cmds

,setup jail
Auto-creates the jail role and jail channel. Run this once before using jail.
Admin
,jail @user [reason]
Jail a user: strips all their roles, applies the jail role, notifies them in the jail channel.
Mod
,unjail @user [reason]
Release a jailed user and restore all their previous roles automatically.
Mod

Economy 10 cmds

,bag
Check your own coin balance.
Everyone
,bag daily
Claim your daily $5,000 reward. Resets every 24 hours.
Everyone
,bag set @user [amount]
Set a user's balance to an exact amount.
Owner
,pay @user [amount]
Transfer coins to another user. Shows a confirm/cancel prompt first.
Everyone
,cgamble [amount] [heads/tails]
Gamble on a coin flip. Use all or max as the amount (capped at $250,000). Win = 2x your bet.
Everyone
,cg [amount] [heads/tails]
Shorthand for ,cgamble.
Everyone
,leaderboard
View the top 10 richest members in the server.
Everyone
,lb
Shorthand for ,leaderboard.
Everyone
,leaderboard exempt @user
Toggle a user's exemption from the economy leaderboard. Run again to un-exempt.
Owner
,give everyone [amount]
Add coins to every single member's balance at once.
Owner

Auto Welcomer 9 cmds

,welcome set #channel [message]
Add a welcome channel and optionally set its message in one go. Supports full embed script syntax. Max 4 channels.
Admin
,welcome message #channel [message]
Update or set the message for an already-added welcome channel.
Admin
,welcome remove #channel
Remove a channel from the welcome list.
Admin
,welcome test
Preview welcome messages for all configured channels.
Admin
,welcome test #channel
Preview the welcome message for one specific channel.
Admin
,welcome on
Enable welcome messages.
Admin
,welcome off
Disable welcome messages (settings kept).
Admin
,welcome reset
Wipe all welcome settings entirely.
Admin
,welcome
View current welcome system status and configured channels.
Admin

WLC Points 7 cmds

,wlc
Welcome the last person who joined. Gives YOU (the runner) one point. Only works once per join — shows an error if someone already welcomed them.
Mod
,wlc message [text]
Set the welcome message. Variables: {welcome.sender}, {welcome.sender.name}, {welcome.receiver}, {welcome.receiver.name}
Mod
,wlc thankyou message [text]
Set the points notification (auto-deletes after 5 seconds). Variables: {welcome.receiver}, {welcome.points}
Mod
,wlc points @user
View a user's total welcome points.
Mod
,wlc points reset @user
Reset a user's welcome points to zero.
Mod
,wlc leaderboard
Top 10 welcomers by points (exempt users hidden).
Mod
,wlc leaderboard exempt @user
Toggle a user's leaderboard exemption. Run again to un-exempt.
Mod

Bump Reminder 9 cmds

,bumpreminder channel #channel
Set which channel bump reminders and thank-you messages are posted in.
Mod
,bumpreminder remind message [text]
Set the message sent when it's time to bump again (fires 2 hours after last bump). Use {bumpreminder.last_user_bump} to mention the last bumper.
Mod
,bumpreminder thank you [text]
Set the message sent immediately after a successful Disboard bump. Use {user.mention}, {bumpreminder.next_bump}.
Mod
,bumpreminder autolock on
Lock the bump channel after each bump, auto-unlock when the 2-hour reminder fires.
Mod
,bumpreminder autolock off
Disable auto-lock.
Mod
,bumpreminder on
Enable the bump reminder system.
Mod
,bumpreminder off
Disable the bump reminder system (settings saved).
Mod
,bumpreminder reset
Reset both remind and thank-you messages to blank.
Mod
,bumpreminder check
View current config: channel, messages, autolock state, and when the next bump is due.
Mod

Vanity Rewards 7 cmds

,vanity set [text]
Set the vanity text to watch for in user bios. e.g. ,vanity set .gg/scar — enables the system automatically.
Mod
,vanity reward @role1 @role2
Set the role(s) awarded to users who have the vanity in their bio.
Mod
,vanity message #channel [text]
Set the thank-you message channel and content. Variables: {user.mention}, {vanity.reward}
Mod
,vanity thankyou #channel [text]
Alias for ,vanity message.
Mod
,vanity on
Enable the vanity reward system.
Mod
,vanity off
Disable the vanity reward system.
Mod
,vanity
View current vanity config.
Mod

Autoresponder 6 cmds

,ar add [trigger] [response]
Add a new autoresponder. Wrap trigger in quotes for spaces: ,ar add "good morning" Good morning!
Mod
,ar create [trigger] [response]
Alias for ,ar add.
Mod
,ar remove [trigger]
Remove an autoresponder by its trigger word/phrase.
Mod
,ar delete [trigger]
Alias for ,ar remove.
Mod
,ar list
View all active autoresponders.
Mod
,autoresponder ...
Full-name alias for all ,ar commands.
Mod

Message Reacts & Auto Reacts 11 cmds

,mr add [trigger] emoji1 emoji2
React with emojis whenever any message contains the trigger word.
Mod
,mr add @user [trigger] emoji1 emoji2
React with emojis only when a specific user's message contains the trigger.
Mod
,mr remove [trigger]
Remove a global message react by its trigger.
Mod
,mr remove @user [trigger]
Remove a user-specific message react.
Mod
,mr delete ...
Alias for ,mr remove.
Mod
,mr list
View all active message reacts.
Mod
,messagereact ...
Full-name alias for all ,mr commands.
Mod
,autoreact add @user emoji1 emoji2 emoji3
React to EVERY message a user sends with these emojis, no trigger needed.
Mod
,autoreact remove @user
Stop auto-reacting to all of a user's messages.
Mod
,autoreact delete @user
Alias for ,autoreact remove.
Mod
,autoreact list
View all active auto reacts.
Mod

Embed Builder 7 cmds

,embed create [name]
Create a new named embed. Opens an interactive button-based editor with live preview.
Mod
,embed edit [name]
Re-open the interactive editor for an existing embed.
Mod
,embed preview [name]
Preview how an embed currently looks.
Mod
,embed list
List all saved embed names.
Mod
,embed remove [name]
Permanently delete a saved embed.
Mod
,embed colour #RRGGBB
Set the default embed colour for this server. e.g. ,embed colour #FF69B4
Mod
,embed color #RRGGBB
Alias for ,embed colour.
Mod

Server Logging 2 cmds

,log set #channel
Set the log channel and enable logging. Logs message edits/deletes, joins/leaves, bans, kicks, timeouts, role changes, nickname changes, and more.
Mod
,log off
Disable server logging (channel setting is kept).
Mod

Invite Tracker 4 cmds

,invitetracker set #channel
Set the channel where invite tracking logs are posted (shows who invited each new member).
Mod
,invitetracker off
Disable the invite tracker.
Mod
,it set #channel
Shorthand for ,invitetracker set.
Mod
,it off
Shorthand for ,invitetracker off.
Mod

Role Management 3 cmds

,role @user [role name / @role / ID]
Toggle a role on a member — assigns if they don't have it, removes if they do.
Admin
,role create [name]
Create a new server role with the given name.
Admin
,role icon @role [emoji or image URL]
Set an icon for a role. Requires server Level 2 Boost.
Admin

Swear Jar 11 cmds

,swearjar on
Enable the swear jar — bot tracks and responds when tracked words are used.
Mod
,swearjar off
Disable the swear jar.
Mod
,swearjar words add word1,word2,word3
Add words to track (comma separated, no spaces between).
Mod
,swearjar words remove word1,word2
Remove words from tracking.
Mod
,swearjar words list
View all currently tracked words.
Mod
,swearjar words reset
Reset the word list back to built-in defaults.
Mod
,swearjar message [text]
Customize the swear notification message. Variables: {user.mention}, {user.name}, {count}
Mod
,swearjar check [@user]
Check how many swears someone has. Defaults to yourself.
Everyone
,swearjar reset @user
Reset a user's swear count to zero.
Mod
,swearjar leaderboard
Top 10 biggest swearers in the server.
Everyone
,sj ...
Shorthand alias for all ,swearjar commands.
Mod

Utility 35 cmds

,avatar [@user]
Show a user's avatar. Defaults to yourself.
Everyone
,av [@user]
Shorthand for ,avatar.
Everyone
,banner [@user]
Show a user's profile banner.
Everyone
,userinfo [@user]
Full user info card: username, ID, join date, account age, roles, badges, boost status. Defaults to yourself.
Everyone
,ui [@user]
Shorthand for ,userinfo.
Everyone
,server icon
Show the server's icon as a large image.
Everyone
,server banner
Show the server's banner as a large image.
Everyone
,afk [reason]
Set yourself as AFK with an optional reason. Bot auto-replies when someone mentions you. Cleared automatically when you next send a message.
Everyone
,time [@user]
Check a user's current local time (they must have set their timezone). Defaults to yourself.
Everyone
,time set [Timezone]
Set your timezone using IANA format. e.g. America/New_York, Europe/London, Asia/Tokyo
Everyone
,time on
Make your timezone visible to others (default state).
Everyone
,time off
Hide your timezone so others can't check your local time.
Everyone
,prefix [new prefix]
Change the bot's command prefix for this server.
Admin
,valid [emoji]
Set the bot's success checkmark emoji for this server.
Admin
,invalid [emoji]
Set the bot's error/fail emoji for this server.
Admin
,variables
View all user variables like {user.mention}, {user.name}, etc.
Everyone
,variables user
Show all user-related variables.
Everyone
,variables guild
Show all server/guild variables.
Everyone
,variables server
Alias for ,variables guild.
Everyone
,variables date
Show all date and time variables.
Everyone
,variables bump
Show bump reminder variables.
Everyone
,variables helpers
Show helper functions like {lower(text)}, {upper(text)}.
Everyone
,vars ...
Shorthand for all ,variables subcommands.
Everyone
,cmd alias [command] [shortcut]
Create a command shortcut. e.g. ,cmd alias ban b — now ,b runs ,ban
Mod
,cmd alias remove [shortcut]
Remove a command shortcut.
Mod
,cmd alias list
View all active command shortcuts for this server.
Mod
,livechat on #channel
Mirror every message sent in this channel into another channel in real time.
Mod
,livechat off
Stop mirroring messages from this channel.
Mod
,publish #channel [message]
Send a message to another channel as the bot.
Special
,ghost on
Enable ghost mode — bot ignores all non-owner commands server-wide.
Special
,ghost off
Disable ghost mode.
Special
,setup j2c
Auto-create a Join-to-Create voice channel system with a management panel.
Admin
,customize avatar [image URL or attachment]
Set a per-server avatar for the bot (unique to each server). Attach an image or provide a URL.
Server Owner
,customize avatar reset
Reset the bot's server avatar back to the global default.
Server Owner
,help
Shows the bot's help menu.
Everyone
,bless [@user]
Sends a random Bible verse. Optionally bless another user by mentioning them.
Everyone

Fun 2 cmds

,coinflip
Flip a coin — bot dramatically reveals heads or tails after a short delay.
Everyone
,uwu [text]
UwU-ifies the text you provide (replaces r/l with w, adds ny sounds, random face at end).
Everyone

Owner Only 8 cmds

,status
Bot stats panel: ping, uptime, memory usage, server count, cached users, Node.js version, Discord.js version.
Owner
,serverlist
Paginated list (5 per page) of every server the bot is in. Shows: name, ID, owner, member count, channel counts, boost tier, and an auto-generated invite link.
Owner
,cmd list
Full command directory categorised by type.
Owner
,cmd checklist
Run a diagnostic scan on all registered commands. Shows new, missing, and passing command counts.
Owner
,aj whitelist [user ID]
Add a user to the global bot owner whitelist.
Owner
,aj unwhitelist [user ID]
Remove a user from the global owner whitelist.
Owner
,aj list
View all whitelisted owner users.
Owner
,bot customization list
View all per-server bot customizations (avatars, embed colors, etc.) across every server.
Owner