MegaBlock Survivors Commands

MegaBlock Survivors registers a single root command:

/mbs
/megablocksurvivors

The Nightbreak token command used during setup is separate and provided by MagmaCore:

/nightbreaklogin <token>

Setup and Content Management

Command	Sender	Permission	Current purpose
/mbs	Any	megablocksurvivors.*	Prints quick-start help (start, setup, reload)
/mbs setup	Player	megablocksurvivors.setup	Opens the Nightbreak content browser menu (Free / Premium / Resources filters)
/mbs recommendedplugins	Any	megablocksurvivors.setup	Shows the recommended companion plugins catalog (opens a menu for players, prints a list for the console)
/mbs downloadpluginupdate	Any	megablocksurvivors.*	Downloads the latest MegaBlock Survivors plugin jar from Nightbreak (requires a linked account)
/mbs downloadall	Any	megablocksurvivors.*	Downloads the plugin update. (MBS ships with hasContentPackages=false, so this command does not pull content packages -- it is effectively a plugin-update alias here.)
/mbs applypluginupdate	Any	megablocksurvivors.*	Applies a plugin update that is already downloaded to the server's update folder without restarting. MegaBlock Survivors reloads, which ends active matches. Refused when no newer valid update is waiting, or when a plugin from another author depends on MegaBlock Survivors
/mbs reload	Any	megablocksurvivors.*	Runs a full MegaBlock Survivors disable/load/enable cycle, ending active matches and reloading its config, translations, content, worlds, NPCs, and displays. If model assets are imported and FreeMinecraftModels is enabled, the shared importer also triggers FMM's content reload
/mbs version	Any	None	Displays the current plugin version

setup, recommendedplugins, downloadpluginupdate, downloadall, and applypluginupdate are registered by MagmaCore's NightbreakPluginBootstrap.registerStandardCommands (shaded into the plugin), not by MegaBlock Survivors' own command classes. See Automatic Updates for the shared update settings.

Release Notes

MagmaCore also registers a separate top-level command for the shared changelog inbox:

/mbschangelog
/mbschangelog dismiss
/mbschangelog disable

It opens unread MegaBlock Survivors release notes, marks them as read, or turns off the join reminder for you. It is player-only and needs OP or one of megablocksurvivors.*, megablocksurvivors.setup, or megablocksurvivors.initialize. See Nightbreak Changelog Notifications.

Gameplay Commands

Command	Sender	Current purpose
/mbs start	Player	Starts a new match. Fails if you are already in a match or still setting one up, or if you are already in another plugin's match that uses MagmaCore's shared match system.
/mbs quit	Player	Ends your current match, or cancels one you are still setting up. A player already in the match is moved to the mbs_spawn lobby, or back to where they ran /mbs start when the lobby is not loaded
/mbs stats	Player	Opens your equipment and stats screen for the current match
/mbs summary	Player	Prints a chat summary of your current or most recent match (duration, highest wave, damage breakdown, equipment, kills)
/mbs dump	Player	Clears the shared stats-dump.log, then writes the caller's current or most recent match summary as a JSON line if one exists. With no summary, the old log is still cleared
/mbs sacrifice	Player	Triggers the current stage of the nearest Altar of Blood (25% / 50% / 75% HP)
/mbs meta	Player	Opens the meta-progression (Soul Echo Shrine) shop dialog
/mbs meta upgrade <track>	Player	Purchases a single level on the named meta-progression track. Tracks: hp, luck, speed, weaponslots, passiveslots, extralives, bantokens, rerolltokens.

Internal Commands

These commands are triggered by the in-game dialog buttons. Use the buttons: the handlers do not all enforce the expected screen or match phase, and manually invoking the ban/reroll commands can consume a token without an open reward screen.

Command	Sender	Current purpose
/mbs selectgamemode <challenge|endless>	Player	Picks the game mode from the first pre-match screen
/mbs selectdifficulty <easy|medium|hard>	Player	Picks the difficulty from the second pre-match screen
/mbs selectweapon <weaponType>	Player	Selects a starting weapon from the class selection screen
/mbs reward <number>	Player	Picks a reward from the level-up reward screen
/mbs reward-ban <type>	Player	Filters an equipment type from later reward draws (consumes one ban token); the exhausted-pool fallback can return banned types
/mbs reward-reroll	Player	Re-rolls the current reward options (consumes one reroll token)
/mbs hourglass-reward <number>	Player	Picks a reward from the hourglass reward screen
/mbs chest-reward <number>	Player	Picks a reward from the chest reward screen
/mbs resume	Player	Resumes gameplay after a reward selection
/mbs skip	Player	Sent by the reward-picker animation's skip button. Ends the animation and shows the final reward options. Does nothing outside a match

Reward-picker animations are disabled, so the reward options appear immediately and /mbs skip currently has no effect. It needs no permission.

Debug and Admin Commands

Command	Sender	Current purpose
/mbs cheat	Player	Removes all tracked enemies without drops or kill credit, fills the portal sacrifice quota, and makes the player ignore match damage for the rest of the run. The timed ghost army's contact kill still applies
/mbs beam	Player	Draws debug beam lines for 10 seconds to Target blocks in a cube extending 20 blocks along each axis from the player
/mbs skipworld	Player	Skips to the next world in the current match

These three debug commands currently set no permission requirement. /mbs cheat marks the run as cheated, but /mbs skipworld only advances the world and does not set that flag. Do not treat the leaderboard's cheat filter as protection against debug world skipping.

Permissions

Permission	Declared in	Grants
megablocksurvivors.*	NightbreakPluginSpec	Admin commands: /mbs, /mbs reload, /mbs downloadpluginupdate, /mbs downloadall, /mbs applypluginupdate, and the first-time setup reminder
megablocksurvivors.setup	NightbreakPluginSpec	/mbs setup and /mbs recommendedplugins
megablocksurvivors.initialize	NightbreakPluginSpec	Only /mbschangelog. No /mbs initialize command is registered
megablocksurvivors.match.bypass	plugin.yml (default: op)	Teleport into running match worlds without being refused or sent back out. Holders are still moved out before a finished match's worlds are deleted

Notes

• MegaBlock Survivors' plugin.yml declares the /mbs root command with a /megablocksurvivors alias and the megablocksurvivors.match.bypass permission. Every subcommand is registered through MagmaCore's CommandManager at runtime.
• Commands without an explicit permission set have no permission requirement.
• /mbs setup and /mbs recommendedplugins are gated by megablocksurvivors.setup; /mbs reload, /mbs downloadpluginupdate, /mbs downloadall, and /mbs applypluginupdate are gated by megablocksurvivors.*. Both permissions are declared in the plugin's NightbreakPluginSpec so operators can grant a setup-only role separately from the full admin role.
• MegaBlock Survivors calls the simplified shared bootstrap overload, which does not register /mbs initialize. With hasContentPackages=false, per-package download/update commands are also omitted, and /mbs downloadall downloads only the plugin jar. Manage its MBSPackage content through /mbs setup.
• Many gameplay strings use plugins/MegaBlockSurvivors/translations.yml. Some shared command descriptions, content-menu messages, and leaderboard text remain hardcoded in English.