Every slash command with its syntax, examples and the things worth knowing beforehand. The search covers examples and notes too — look for “whitelist” and you also find the commands that only mention it in an example.
Server statusWhat is happening on a server — query it, show it, record it
Discord servers only
Syntax
/status
/status ip: <address>
/status ip: <address> edition: <Java|Bedrock>
Examples
/status
/status ip: hypixel.net
/status ip: play.example.eu edition: Bedrock
Worth knowing
Without an address the command uses the server stored with /default-ip set. If none is stored, the bot asks for one.
edition is only needed when Java and Bedrock are reachable under the same address. Otherwise the bot works it out itself.
/embed add type: Diagram ip: play.example.eu channel: #server-info language: English
/embed add type: Connection server: Survival
/embed list
/embed remove embed: #server-info — status — play.example.eu
Worth knowing
Status shows reachability, MOTD, version and player count. Whitelist shows the whitelisted names — that needs a connection through the plugin. Diagram shows the player count over time. Player stats shows totals for the linked chat sync. Connection shows the state of the chat sync itself, including when it was last heard from.
server picks a registered server from /server — that fills in address, edition and chat sync at once. ip still works on its own for a server that was never registered.
Without channel the embed is created in the current one. The bot needs permission to send and edit messages there.
language applies to this embed only. Without it, your own setting from /language is used.
/embed remove only ends the updating. The message itself stays and can be deleted by hand.
The range is a choice of three: 24 hours, 7 days or 30 days. Without it the shortest applies.
It is drawn from what the bot has recorded. A server queried for the first time today has no history covering 30 days yet.
The dashboard shows the same history under “Stats”, there with the peak and the share of reachable checks as well.
Works in DMs too
Syntax
/image ip: <address> type: <MOTD|Icon|Both>
Examples
/image ip: hypixel.net type: Both
/image ip: play.example.eu type: Icon
Worth knowing
The MOTD is drawn the way it looks in game — with the colour codes and formatting that plain text output swallows.
Minecraft integrationThe link between Discord and the running server
Administrators only
Discord servers only
Syntax
/setup
Examples
/setup
Worth knowing
The command first asks what you want to set up: chat sync, an auto-updating embed, a whitelist channel, a status voice channel, outage and audit alerts, the default server address, or an overview of what already exists.
Every step asks exactly one question and offers the possible answers as a menu — you need neither a channel ID nor a particular order.
The overview shows what is already running on this Discord server. It is the quickest way to find out whether a setup was actually saved.
The same works in the browser: the dashboard at mc-sync.eu/dashboard holds the same settings as forms, with previews and pick lists.
add hands out a token. It belongs under api.token in the plugin's configuration on your Minecraft server; the connection only exists after that.
The token is a password. It is shown to you alone — do not pass it on in a public channel.
token reissues a fresh one for an existing sync — the old one stops working immediately. If you need a grace period, reissue the token in the dashboard instead.
server picks an existing connection and suggests it as you type. Only add takes a name of your own choosing.
Several syncs on one Discord server are possible, one per Minecraft server. The name tells them apart in every other command.
guide shows the short version inside Discord. Advancements are only reported from Minecraft 1.12 onwards.
The command is visible to everyone on purpose. Discord can only assign permissions per command, not per subcommand — if this said “administrators only”, granting it per role could never take effect.
run checks two things separately: whether your role may run this command (the Discord side) and whether your server accepts it (commands.mode in config.yml).
Enter the command without the leading slash: whitelist add Notch, not /whitelist add Notch.
permission add, remove and list are reserved for administrators — the bot checks that itself.
Without server the command uses the channel it was typed in, then the guild's only connection, and otherwise asks which one you mean.
/whitelist-channel add channel: #whitelist mode: Verify only role: @Member
/whitelist-channel list
Worth knowing
The bot checks every posted name with Mojang first. A name that does not exist is never passed on.
mode decides what happens to a valid name: added to the whitelist through the plugin (default), or only verified — for teams that want to decide themselves.
server picks which registered Minecraft server (/server add) this channel whitelists to — leave it empty if you only have one.
Without role anyone in the channel may submit a name. Up to three roles narrow that down.
/default-ip set ip: play.example.eu edition: Bedrock
/default-ip show
Worth knowing
The setting applies to the whole Discord server, not per person.
It affects /status, /diagram and /image — everywhere the address may be left out.
The same is possible in the dashboard under “Servers” — the stored address sits at the top there and can be taken from the server list with one click.
Discord servers only
Syntax
/link start
/link show
/link remove
Examples
/link start
/link show
Worth knowing
start gives you a code. Type it in the Minecraft chat as !link <code> — that proves both sides: the code, because it was only ever shown to you, the name, because it came from inside the game.
A code is valid for ten minutes and is never forwarded to Discord, not even a failed attempt.
Linking your account is what makes /role-sync and real @mentions from the game chat possible.
The link is per Discord server — the same Minecraft account can be linked separately on each.
