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.* (declared, not enforced on the no-args path)	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 reload	Any	megablocksurvivors.*	Reloads MegaBlock Survivors content and refreshes FreeMinecraftModels imports if present
/mbs version	Any	None	Displays the current plugin version

setup, recommendedplugins, downloadpluginupdate, and downloadall are registered by MagmaCore's NightbreakPluginBootstrap.registerStandardCommands (shaded into the plugin), not by MegaBlock Survivors' own command classes.

Gameplay Commands

Command	Sender	Current purpose
/mbs start	Player	Starts a new match. Fails if you are already in a match or one is still being prepared.
/mbs quit	Player	Ends your current match and returns you to spawn
/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 stats-dump.log and writes the caller's current or most recent match summary as a JSON line
/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 automatically by the in-game dialog buttons and are not meant to be run manually:

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	Bans an equipment type from the rest of the run's reward pool (consumes one ban token)
/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

Debug and Admin Commands

Command	Sender	Current purpose
/mbs cheat	Player	Kills all enemies and instantly fulfills the portal sacrifice quota
/mbs beam	Player	Draws debug beam lines to all Target blocks within 20 blocks for 10 seconds
/mbs skipworld	Player	Skips to the next world in the current match

Notes

• MegaBlock Survivors' plugin.yml only declares the /mbs root command with a /megablocksurvivors alias. 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, and /mbs downloadall 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.
• The plugin's NightbreakPluginSpec is configured with hasContentPackages=false and hasPresetModes=false. As a result, MagmaCore does not register /mbs initialize (gated behind hasPresetModes) or the per-package content download/update commands (gated behind hasContentPackages). The /mbs downloadpluginupdate and /mbs downloadall commands are always registered, but with content packages disabled downloadall only fetches the plugin jar. Content for MegaBlock Survivors is delivered through its own MBSPackage system and managed via /mbs setup. (Some legacy chat strings may still reference an initialize/updatecontent flow that no longer exists on this build; ignore them.)
• All user-facing strings (chat messages, command descriptions, dialog titles) are loaded from plugins/MegaBlockSurvivors/translations.yml, so command descriptions can be re-localized without touching the jar.