Skip to content

messages.yml๐Ÿ”—

DiscordToMinecraft...๐Ÿ”—

Placeholders

Example

Description

%allroles%

Owner | Developer | Boss man

All the user's roles separated by DiscordToMinecraftAllRolesSeparator

%message%

Hello!

The message content

%toprole%

Owner

The user's highest ranking role

%toprolealias%

Owner

The alias for the role from DiscordChatChannelRoleAliases, otherwise the role's name

%toproleinitial%

O

The first initial of the user's highest ranking role

%toprolecolor%

<dark_red>

The approximate color of the highest ranking role

%username%

scarsz

The user's username/nickname if set

%channelname%

global

The name of the Discord channel the message is coming from

PlaceholderAPI placeholders are also supported

...ChatMessageFormat๐Ÿ”—

The format used when sending messages from Discord to Minecraft.

...ChatMessageFormatNoRole๐Ÿ”—

The format used when sending messages from Discord to Minecraft for the user with no roles.

...ChatMessageFormat_<channel>๐Ÿ”—

The format used when sending messages from Discord to Minecraft for <channel>.

You can specify a different format per channel. To add a format for a channel named mychannel you'd add the following options to your messages.yml:

DiscordToMinecraftChatMessageFormat_mychannel: "[&bDiscord From MyChannel &r| %toprolecolor%%toprole%&r] %name% ยป %message%"
DiscordToMinecraftChatMessageFormatNoRole_mychannel: "[&bDiscord From MyChannel&r] %name% ยป %message%"

...ChatMessageFormatNoRole_<channel>๐Ÿ”—

The format used when sending messages from Discord to Minecraft for the user with no roles for <channel>.

This can be formatted using the same idea as the previous option:

DiscordToMinecraftChatMessageFormatNoRole_mychannel: "[&bDiscord From MyChannel&r] %name% ยป %message%"

...AllRolesSeparator๐Ÿ”—

The separator used in between roles in %allroles%

...ReplyFormat๐Ÿ”—

The format for the message displayed to indicate that the message is a reply NOTE: The %reply% placeholder needs to be present in the format if you want the DiscordToMinecraftMessageReplyFormat to display in your message.


MinecraftChatToDiscordMessage...๐Ÿ”—

Placeholders

Example

Description

%username%

jeb_

raw player username

%displayname%

BigBossManJeb

display name from things like nicknames

%usernamenoescapes%

jeb_

raw player username without escaping discord format (for use in inline code & code block markdown)

%displaynamenoescapes%

BigBossManJeb

display name from things like nicknames without escaping discord format (for use in inline code & code block markdown)

%message%

Hello!

message content

%primarygroup%

Owner

the name of the user's primary group

%world%

world

name of world player is in

%worldalias%

Mainland

alias of world player is in via Multiverse-Core

%date%

Sun Jan 1 15:30:45 PDT 2017

current date & time

%channelname%

global

the name of the channel that the message was sent in, if the message was sent in a channel at all

PlaceholderAPI placeholders are also supported

...Format๐Ÿ”—

the format used when sending messages from Minecraft to Discord.

...FormatNoPrimaryGroup๐Ÿ”—

used in place of MinecraftChatToDiscordMessageFormat when no primary group for the player was found.


ChatChannelHookMessageFormat๐Ÿ”—

This is a special message that's only used when a supported chat channel plugin is hooked. It modifies what the message would be like in-game to include information related to the channel the message is from.

Placeholders

Explanations

%channelcolor%

the color character corresponding to the channel

%channelname%

the literal name of the channel, usually the name only the server sees internally

%channelnickname%

the formal nickname of the channel, usually the name of the channel that players see

%message%

the message after processing through DiscordToMinecraftChatMessageFormat/DiscordToMinecraftChatMessageFormatNoRole

Dynmap...๐Ÿ”—

Placeholders

Example

Description

Same as Discord -> Minecraft placeholders

PlaceholderAPI placeholders are also supported

...NameFormat๐Ÿ”—

The format for the username part of the message sent to Dynmap (this may be hidden depending on dynmap settings).

...ChatFormat๐Ÿ”—

The format for the message part of the message sent to Dynmap.

...DiscordFormat๐Ÿ”—

Placeholders

Example

Description

%name%

Notch

the username for the message sent on the Dynmap web chat (could be blank)

%message%

Hello!

message content

PlaceholderAPI placeholders are also supported

The format for Dynmap messages going to Discord


DiscordConsoleChannel...๐Ÿ”—

...Format๐Ÿ”—

Placeholders

Example

Description

{level}

INFO, WARN, ERROR

message severity level

{name}

Server

logger name

{datetime}

Sun Jan 1 15:30:45 PDT 2017

current date & time

PlaceholderAPI placeholders are also supported

This is the format used when sending a line from the console to the console channel, if enabled

...TimestampFormat๐Ÿ”—

The date format that will be used for the {date} and {datetime} placeholders

...Prefix๐Ÿ”—

The literal prefix to prepend to a batch of lines

...Suffix๐Ÿ”—

The literal suffix to append to a batch of lines

...Padding๐Ÿ”—

The amount of padding to add inside the prefix


DiscordChatChannelConsoleCommandNotifyErrorsFormat๐Ÿ”—

Placeholders

Example

Description

%user%

scarsz

the name of the user that tried running the command

%error%

no permission

the reason for the error

Used when an error occurs with permissions for the player to run the command, not an error running the command itself. This is sent as a PM to the user.


DiscordChatChannelListCommand...๐Ÿ”—

...FormatOnlinePlayers๐Ÿ”—

the message at the beginning of the list, before all of the player names.

...FormatNoOnlinePlayers๐Ÿ”—

used instead for when no players are online

...PlayerFormat๐Ÿ”—

Placeholders

Example

Description

%username%

jeb_

raw player username

%displayname%

BigBossManJeb

display name from things like nicknames

%primarygroup%

Owner

the name of the user's primary group

%world%

world

name of world player is in

%worldalias%

Mainland

alias of world player is in via Multiverse-Core

PlaceholderAPI placeholders are also supported

the format of how each player should appear in the list

...AllPlayersSeparator๐Ÿ”—

the separator used in between players


MinecraftPlayer...๐Ÿ”—

Embed Information

Description

Color

accepts a hex color code (eg. "#ffffff") or a rgb integer (eg. 0)

Fields

format is "title;value;inline" (eg. "Who joined?;%displayname%;true") or "blank" to add a blank field

Timestamp

set to true to use the time the message was sent or use a epoch timestamp for a specific time (https://www.epochconverter.com/)

Placeholders

Example

Description

%displayname%

BigBossManJeb

display name from things like nicknames

%username%

jeb_

raw player username

%displaynamenoescapes%

BigBossManJeb

display name from things like nicknames without escaping discord format (for use in inline code & code block markdown)

%usernamenoescapes%

jeb_

raw player username without escaping discord format (for use in inline code & code block markdown)

%date%

Sun Jan 1 15:30:45 PDT 2017

current date & time

%embedavatarurl%

<AvatarUrl>

the user's avatar

%botavatarurl%

<Bot Avatar Url>

the bot's avatar

%botname%

DiscordSRV bot

the bot's name

PlaceholderAPI placeholders are also supported

...JoinMessageFormat๐Ÿ”—

Placeholders

Description

%message%

join message as seen in-game

PlaceholderAPI placeholders are also supported

The message that gets broadcasted when a player joins the server.

...FirstJoinMessageFormat๐Ÿ”—

Placeholders

Description

%message%

first join message as seen in-game

PlaceholderAPI placeholders are also supported

The message that gets broadcasted when a player joins for the first time.

...LeaveMessageFormat๐Ÿ”—

The message that gets broadcasted when a player leaves.

...DeathMessageFormat๐Ÿ”—

Placeholders

Description

%deathmessage%

Raw death message

PlaceholderAPI placeholders are also supported

The message that gets broadcasted on player death.

...AchievementMessagesFormat๐Ÿ”—

Placeholders

Description

%achievement%

Title of the achievement/advancement

PlaceholderAPI placeholders are also supported

The message that gets broadcasted when a player gets an achievement.


ChannelTopicUpdater...๐Ÿ”—

Placeholders

Description

%playercount%

current player count

%playermax%

maximum player count

%date%

current date

%timestamp%

current time in seconds since UNIX epoch

%starttimestamp%

start time in seconds since UNIX epoch

%totalplayers%

total amount of players to ever join the main world

%uptimemins%

amount of minutes since DiscordSRV has started

%uptimehours%

amount of hours since DiscordSRV has started

%motd%

motto of the day of the server

%serverversion%

server version such as Spigot-1.9

%freememory%

free memory of the JVM in MB

%usedmemory%

used memory of the JVM in MB

%totalmemory%

total memory of the JVM in MB

%maxmemory%

max memory of the JVM in MB

%freememorygb%

free memory of the JVM in GB

%usedmemorygb%

used memory of the JVM in GB

%totalmemorygb%

total memory of the JVM in GB

%maxmemorygb%

max memory of the JVM in GB

%tps%

average TPS of the server

PlaceholderAPI placeholders are also supported

...ChatChannelTopicFormat๐Ÿ”—

message to set the chat channel's topic to every X seconds

...ConsoleChannelTopicFormat๐Ÿ”—

message to set the console channel's topic to every X seconds

...ChatChannelTopicAtServerShutdownFormat๐Ÿ”—

message to set the chat channel's topic when the server shuts down

...ConsoleChannelTopicAtServerShutdownFormat๐Ÿ”—

message to set the console channel's topic when the server shuts down


DiscordCommandFormat๐Ÿ”—

This is the message sent to players when they run "/discord". It's recommended to leave command syntax as a part of this.


NoPermissionMessage๐Ÿ”—

No permission message

UnknownCommandMessage๐Ÿ”—

Unknown command message

DiscordChatChannelServer...๐Ÿ”—

...StartupMessage๐Ÿ”—

message to be sent when server starts; leave blank to disable

...ShutdownMessage๐Ÿ”—

message to be sent when server shuts down; leave blank to disable


ServerWatchdogMessage๐Ÿ”—

Placeholders

Description

%guildowner%

The guild owner's mention tag.

%date%

The date & time when the message gets sent.

%timeout%

ServerWatchdogTimeout as a placeholder

%timestamp%

For use in discord's timestamp format EG: `

The watchdog constantly monitors the last time your server performed a game tick. If the time since the last tick goes above the set interval in seconds, Discord messages can be triggered.

CodeGenerated๐Ÿ”—

Placeholders

Description

%code%

the code generated for the player to link their account with

%botname%

the name of the bot on Discord

The message that appears in minecraft when a player runs the /discordsrv link command.

UnknownCode๐Ÿ”—

The message that appears in the bot's discord DMs if a user sends a 4 character message that isn't a generated code.

InvalidCode๐Ÿ”—

The message that appears in the bot's discord DMs if a user sends any message that isn't a generated code.

DiscordAccountLinked๐Ÿ”—

Placeholders

Description

%name%

the name of the Minecraft player that the user's Discord account was linked to

%uuid%

the uuid of the Minecraft player that the user's Discord account was linked to

The bot's DM response when a user gets their discord account linked.

DiscordAccountAlreadyLinked๐Ÿ”—

Placeholders

Description

%name%

the Minecraft uuid of the user's linked Minecraft account

%uuid%

the Minecraft username of the user's linked Minecraft account

The bot's DM response if a user tries to link their minecraft account but they're already linked.

DiscordLinkedAccountRequired๐Ÿ”—

Placeholders

Description

%message%

the message the user was not able to send because they were not linked

The bot's reply if a player that isn't linked tries to send a discord message through the registered text channel.

DiscordLinkedAccountCheckFailed๐Ÿ”—

The bot's reply if it can't check if a player is linked.

ClickToCopyCode๐Ÿ”—

The hover text for CodeGenerated's %code% placeholder.

MinecraftAccountLinked๐Ÿ”—

Placeholders

Description

%id%

the discord id of the Discord user that the user's Minecraft account was linked to

%username%

the discord name of the Discord user that the user's Minecraft account was linked to

The message to the player that gets sent when the player links their discord account.

MinecraftAccountAlreadyLinked๐Ÿ”—

The message to the player if they try to link their discord account but they're already linked.

LinkedCommandSuccess๐Ÿ”—

Placeholders

Description

%name%

the discord username of the Discord user that the user's Minecraft account is linked to

The message that appears to a linked player when they run /discordsrv linked.

UnlinkCommandSuccess๐Ÿ”—

Placeholders

Description

%name%

the discord username of the Discord user that the user's Minecraft account was linked to

The message that appears to a linked player when they run /discordsrv unlink.

MinecraftNoLinkedAccount๐Ÿ”—

The message that appears to an unlinked player when they try to use /discordsrv linked or /discordsrv unlink

LinkingError๐Ÿ”—

The message that appears to a player if the linking system did not register.

MinecraftNobodyFound๐Ÿ”—

Placeholders

Description

%target%

the input that led to no results being found

The message that appears to the player/console if /discord linked %target% is not found.


  1. Requires a server restart for changes to take effect.