Extractioncraft Commands and Permissions

Extractioncraft registers the root command:

/extractioncraft
/exc

Subcommands are registered through the MagmaCore command manager at runtime.

Admin Commands

Command	Permission	Default	Sender	Description
/exc initialize	extractioncraft.initialize	op	Player	Opens the first-time setup menu
/exc setup	extractioncraft.setup	op	Player	Opens the content package browser for installing, uninstalling, and managing content
/exc protection bypass	extractioncraft.protection.bypass	op	Player	Toggles the player's bypass for block and interaction checks that consult it. Does not bypass match teleport restrictions or PvP prevention.
/exc reload	extractioncraft.*	op	Any	Reloads the plugin. Running matches end and their players keep their items. A full server restart is recommended if the reload does not fully apply.

Player Commands

Command	Permission	Default	Sender	Description
/exc createMatch <contentPackage.yml>	extractioncraft.creatematch	true	Player	Creates a new match using the specified content package and places the player into it. Tab-completes available content package filenames.
/exc start	extractioncraft.start	true	Player	Starts the match the player is currently in, if the minimum player count is met
/exc leave	(none set)	true	Player	Leaves the current match, or cancels the player's match while it is still generating
/exc quit	(none set)	true	Player	Same as /exc leave.

MagmaCore Shared Commands

MagmaCore is bundled into Extractioncraft, so these commands ship with the plugin too.

Command	Permission	Default	Sender	Description
/exc recommendedplugins	extractioncraft.setup	op	Any	Opens (for players) or prints (for console) the list of companion plugins recommended for Extractioncraft.
/nightbreak plugins	nightbreak.plugins	op	Any	Opens the Nightbreak plugin catalog to browse and download MagmaGuy's other plugins. Registered once globally by MagmaCore.
/nightbreaklogin <token>	nightbreak.login	op	Any	Registers your nightbreak.io account token in-game so the server can fetch licensed content. Registered once globally by MagmaCore.
/nightbreaklogout	nightbreak.login	op	Any	Clears the stored nightbreak.io account token from the server. Registered once globally by MagmaCore.
/logify	logify.*	op	Any	Posts the current latest.log to mclo.gs, to make reporting bugs easier for admins. Registered once globally by MagmaCore.
/extractioncraftchangelog	op, extractioncraft.*, extractioncraft.setup or extractioncraft.initialize	op	Player	Shows unread Extractioncraft release notes from Nightbreak. dismiss marks them read and disable stops the join reminder. Registered after Extractioncraft finishes starting. See changelog notifications.

Permissions Summary

Permission	Default	Description
extractioncraft.initialize	op	Access to /exc initialize
extractioncraft.setup	op	Access to /exc setup and /exc recommendedplugins
extractioncraft.protection.bypass	op	Access to /exc protection bypass
extractioncraft.match.bypass	op	Lets staff teleport into match worlds and stay there while a match counts down or runs, instead of being refused or sent to the main world's spawn. It does not make them a match participant.
extractioncraft.*	op	Access to /exc reload
extractioncraft.creatematch	true	Access to /exc createMatch
extractioncraft.start	true	Access to /exc start
extractioncraft.leave	true	Declared in plugin.yml for /exc leave, but not enforced at runtime (the registered quit/leave command has no permission check)
nightbreak.plugins	op	Access to /nightbreak plugins (registered by MagmaCore)
nightbreak.login	op	Access to /nightbreaklogin and /nightbreaklogout (registered by MagmaCore)
logify.*	op	Access to /logify (registered by MagmaCore)

Notes

• The plugin.yml declares root commands /extractioncraft and /logify. The /extractioncraft subcommands are registered at runtime through the MagmaCore command manager.
• extractioncraft.* is used by /exc reload but is not declared in plugin.yml, so it is not a registered permission node. Operators pass it automatically; anyone else needs it granted explicitly by a permissions plugin.
• quit and leave are two aliases of the same command, which has no permission check. The extractioncraft.leave node is never enforced.
• /logify, /nightbreak, /nightbreaklogin, and /nightbreaklogout are registered globally by MagmaCore (which is bundled into the plugin), each only once across all MagmaCore plugins on the server. If another MagmaGuy plugin already claimed one of those names, Extractioncraft skips registering it and the existing one is used.
• Running /exc with no arguments lists registered subcommands allowed for that sender's permissions and sender type. The quit/leave handler has no usage string, so its help entry is incomplete.
• A subcommand registered without a permission node (currently only quit/leave) passes the permission check for every sender.
• Every Extractioncraft subcommand except /exc reload and /exc recommendedplugins is player-only. Console gets This command must be run as a player!.
• /exc createMatch refuses a player who is already in a match or waiting for one to generate, including a match from another plugin that uses the bundled MagmaCore match system.
• Extractioncraft does not register the shared downloadall subcommand, so the info button inside /exc setup does not suggest it. Use the setup menu itself to manage content.
• Extractioncraft does not register the shared downloadpluginupdate or applypluginupdate subcommands either, and the notice after an automatic plugin update download does not suggest applypluginupdate. Restart the server to use the update, or set nightbreak.applyPluginUpdatesWithoutRestart in config.yml before the download.