Reference
Placeholders
Tokens for messages and embeds, plus the PlaceholderAPI values the plugin exposes.
DiscordSynthesis uses %token% placeholders in messages.yml, features.yml embeds, and command lists. Which tokens resolve depends on the context — a report embed knows %reporter%, a chat message knows %message%. Unknown tokens are left untouched.
Player & rank
| Token | Resolves to |
|---|---|
%player% / %p% | The player's Minecraft username |
%uuid% | The player's UUID |
%rank% | The player's primary group / rank |
%name% | Generic name (webhook avatars, cracked servers) |
Discord member
| Token | Resolves to |
|---|---|
%user% | The Discord username |
%discord_user% | The Discord display name |
%discord_id% | The Discord user ID |
%role% | Their primary Discord role name |
%role_color% | That role's colour as a Minecraft colour code |
Server & time
| Token | Resolves to |
|---|---|
%server% | The server name |
%players% / %maxplayers% | Online and max player counts (bot status, stats) |
%v% | The value of a live-stat channel |
%date% / %time% / %timestamp% | Current date, time, and epoch millis |
%a% / %b% | Origin / destination server on a server switch |
Messages, reports & bans
| Token | Resolves to |
|---|---|
%message% | The chat/broadcast message |
%command% | The logged command |
%advancement% | The advancement earned |
%code% | A linking/verification code |
%reporter% / %reported% | Who filed / who was reported |
%reason% / %bug% | The report reason / bug text |
%staff% / %status% / %resolution% | Handling staff, report status, resolution |
%banned_by% / %source% | Who issued a synced ban and from where |
PlaceholderAPI
With PlaceholderAPI installed, other plugins (scoreboards, tab lists, signs) can read these %discordsynthesis_...% values:
%discordsynthesis_linked%true/false— whether the player has linked Discord.%discordsynthesis_discordname%- The linked Discord account's username.
%discordsynthesis_discorddisplayname%- The linked account's display name / nickname.
%discordsynthesis_messages%- Total Discord messages the player has sent.
%discordsynthesis_voiceminutes%- Total minutes the player has spent in voice.
%discordsynthesis_reactions%- Total reactions the player's messages have received.
%discordsynthesis_servermembercount%- Total Discord server member count.