Commands
Full reference for Discord slash commands and in-game Minecraft commands.
Overview
EveryoneEvery Madsi command works as a Discord slash command or with your server's text prefix (e.g. w!profile), except /link and /relink (their sign-in card is private, so they're slash-only), and /members, /mc-ban, /mc-kick and /mc-unban (slash-only by default; turn a text form on per command with its Text prefix switch). Run /help in Discord for the full, always-current list. Admins can add aliases, restrict, disable, or add prefixes to any command on the Commands page, see Command permissions.
The page, refresh, tab, picker and editor buttons on a command reply only work for the person who ran it; anyone else gets a private note to run the command themselves. That includes a card's Recipe and Enchantments buttons: run /recipe or /enchant yourself.
Account
Everyone| Command | Description |
|---|---|
/link | Link your Minecraft account via Microsoft sign-in. Opens a one-time link (valid ~10 minutes). |
/relink | Switch to a different Minecraft account. Removes old whitelist entries and adds new ones based on current rules. |
/unlink | Remove your linked Minecraft account. Removes whitelist entries and reverts nickname if sync is enabled. |
Profile & stats
Everyone| Command | Description |
|---|---|
/profile | Your linked profile (username, UUID, when you linked). Pass @user or a query to look someone up. |
/stats | Playtime, sessions, last seen, deaths, and advancements. Pass @user and server:<name> to target. |
/leaderboard | The server's top players by playtime. |
/activity | Player-count history and peak hours. Pass range: (24h, 7d or 30d) and server:<name> to target. |
Server & community
Everyone| Command | Description |
|---|---|
/server | Live server stats: player count, TPS, memory, uptime, and more. Configurable cooldown. |
/online | See who's currently online. |
/world | The server's worlds and which is live. switch needs the Worlds permission (and Guarded config when proxy, permission or login settings differ) and backup the Backups permission. |
/members | List everyone with a linked account (Manage Server, or Bans when the server allows it). |
/apply | Apply to join via the server's application form. |
Moderation
AdminThey need Discord's Manage Server, or a Madsi team role with Bans once the owner turns on Moderators can use moderation commands on the Members page.
| Command | Description |
|---|---|
/mc-ban | Ban a player from the Minecraft server, from Discord. |
/mc-kick | Kick a player from the Minecraft server. |
/mc-unban | Lift a ban. |
These three are slash commands only by default: a text prefix such as w!mc-ban gets a pointer to the slash command instead. Turn the text form on per command with its Text prefix switch on the Commands page.
In-game messaging
Everyone| Command | Description |
|---|---|
/whisper <message> [user | mc]: to a Discord member or a Minecraft player (prefix: whisper <name> <message>) | DM a player in-game (also /msg, /w, /tell). |
/reply <message> | Reply to your last whisper (also /r). Five whispers a minute to the same person (five a minute in all from in game); anyone can turn whispers off on their Preferences page, or in game with /madsi whispers off. |
Minecraft info & tools
Everyone| Command | Description |
|---|---|
/wiki <term> | Look up a block, mob, item, or mechanic. |
/recipe <item> | Show an item's crafting recipe. |
/enchant <enchant|item> | Enchantment details. |
/seed · /biome · /structure | World-generation lookups. |
/coords | Convert Overworld ↔ Nether coordinates. |
/mcversion · /mcformatting | Minecraft version info and chat formatting codes. |
/xp · /potion · /firework · /villager · /banner | Item & mechanic helpers. |
/mods | Export this server's mod list (Markdown, CSV, JSON) or a Modrinth .mrpack; server: picks one when several are connected. As a text command: mods csv, mods modpack. |
/mccommands | Browse & run your team's saved commands (built in the dashboard command builder). |
Fun
Everyone| Command | Description |
|---|---|
/splash · /mcfact · /buildidea | Random Minecraft flavor. |
/trivia | Start a Minecraft trivia round. In a public round the starter can reveal the answer, and a question nobody solves is revealed after 60 seconds. |
/8ball · /coinflip | Quick games. |
/dice | Roll up to 20 dice with sides and count, or dice 3d6 with a prefix. Several dice show each roll and the total. |
Madsi feedback
Everyone| Command | Description |
|---|---|
/feedback | Send a bug, idea, or question to the Madsi team. |
/roadmap | See what's being worked on and what's planned. |
/changelog | See what recently shipped. |
On the feedback board, a comment with a link or a Discord invite waits for a quick review before it shows (links to madsi.link and dashboard.madsi.link, the docs included, post straight away); you see yours marked Waiting for review until then. Names that read as Madsi or its staff (Madsi, Umbrarity, staff, admin, moderator, lookalike spellings included) are reserved. A post's comments close once it ships, so open a new post for anything more. Every feedback email has a one-click unsubscribe, and your feedback profile sets which emails you get.
Minecraft commands
AdminThese commands run in-game with a leading slash, or at the server console without one (madsi status). The admin ones check a permission node on every loader: madsi.status for status, madsi.admin for setup, reconnect and update. A permissions mod or plugin (LuckPerms, or anything using fabric-permissions-api or NeoForge's permission API) can grant them to anyone. Without one, operators stand in: level 2 for status and level 4 for the rest on Fabric and NeoForge, any operator on Paper. The console can run them all. link, msg, r and whispers are open to every player.
| Command | Needs | Description |
|---|---|---|
/madsi setup <token> | madsi.admin (level 4 op) | Set the server token and connect to Madsi. Saves to config/madsi.json and connects immediately. |
/madsi status | madsi.status (level 2 op) | Check the current connection status to the Madsi service. |
/madsi reconnect | madsi.admin (level 4 op) | Force a reconnection to the Madsi WebSocket. |
/madsi update | madsi.admin (level 4 op) | Check for a newer Madsi build and report what it finds. Nothing is downloaded. |
/madsi update confirm | madsi.admin (level 4 op) | Download and verify the newer build. Fabric and NeoForge replace the jar; Paper stages it in the update folder. Either way it applies on the next restart, never mid-session. |
/madsi link [code] | Any player | Start in-game account linking, or complete it with the code from Discord. Only works while Allow in-game linking is on. |
/madsi msg <player> <message> | Any player | Private message someone across the bridge. whisper, tell and w do the same thing. |
/madsi r <message> | Any player | Reply to the last private message you received across the bridge. |
/madsi whispers off|on | Any player | Stop or allow private messages across the bridge, on this community's servers. For a linked player on a server that checks Minecraft accounts it is the same switch as the Preferences page, which covers every server; a linked player on a server that doesn't is sent to the Preferences page instead. |
Managing commands
AdminCommands are available to all members by default, except /members, /mc-ban, /mc-kick and /mc-unban, which need Manage Server, or a Madsi team role with Bans once the server owner allows it on the Members page. Manage them on the Commands page in the dashboard:
- Restrict: limit a command to specific Discord roles and/or channels (leave both empty to allow everyone)
- Disable: toggle any command off entirely
- Aliases: give a command extra names (
/newnameworks alongside the original) - Prefixes: add text prefixes so
w!profileworks alongside/profile(Free 2, Basic 5, Pro 10). With none set,/works as a text prefix, so a plain message like/profileis answered too./members,/mc-ban,/mc-kickand/mc-unbananswer a prefix only once their Text prefix switch is on
Custom commands (Free 20, Basic 50, Pro 100) answer with a custom message you build on the Messages page: create one under Custom commands, give it a name, a description and any aliases, link the message, and optionally restrict it to roles and channels or mention the person who ran it. It works with your prefixes like the built-in ones, and as a slash command too when Slash is on: Free registers 2 as slash commands, Basic 5, Pro 10. A custom command's aliases work from a prefix only.
Most replies can be reworded on the Messages page, and so can the lines players see in Minecraft (whisper and in-game link notices), the moderation log, the applications and command builder logs, command alerts, the whisper-tracking lines, the review card's status line, buttons and headings, the prompts and buttons of an application answered in DMs, the /mccommands browser, /roadmap, /changelog and the console channel's replies. The { } button lists the variables that message can use: its own first (like {player_name} or {server_name} for the Minecraft server), then the ones that depend on where it's sent. A reply to a command also has the member ({user_mention}), the Discord server ({discord_server_name}) and the channel; a DM has the member and the Discord server; a post the bot makes on its own, like a join line or a health alert, has the Discord server, the date and time; a line shown in Minecraft has only {date} and {time}. {date} and {time} follow the timezone set on the Stats page. A variable a message can't fill is left as typed, and the preview shows it that way too. A whisper's text, a command's console output and the text of a logged or alerted command are kept private, so they can't go in a link, an image or icon address, or a line that has a link in it.
Some variables were renamed to say what they hold (for example {query} became {player_search}, {item_search} and so on, and {server_name} for the Discord server became {discord_server_name}). Messages you saved with the old names keep working.
The in-game /madsi admin commands need the madsi.status (status) or madsi.admin (setup, reconnect, update) permission on every loader. Without a permissions mod or plugin, operators have them: level 2 and level 4 on Fabric and NeoForge, any operator on Paper. They can also be run from the server console. link, msg, r and whispers are open to every player.