Commands & Permissions

Everything runs under one root command, /bmine, with subcommands.

There are no aliases or shortcuts: short names like /mine or /shop clash with other plugins, so BusyMining registers /bmine only. If another plugin also claims /bmine, /busymining:bmine always reaches BusyMining.

Player commands

Every command needs busymining.player, which every player has by default.

Command Description
/bmine Open the main menu
/bmine help List every subcommand you have access to
/bmine menu Open the main menu
/bmine shop Open the Mine Shop
/bmine stats [player] Open the statistics menu for yourself or any player who has joined before
/bmine zeta Show your Zeta balance in chat
/bmine journal Open the Journal
/bmine artifacts Open the Artifact Identifier
/bmine singularity Open the Singularity
/bmine upgrades Open the Passive Upgrades menu
/bmine oracle Open the Oracle status menu
/bmine refinery Open the Mining Tome Refinery menu
/bmine vessel Open the Vessel menu for the pickaxe in your hand
/bmine minion Open the menu of your nearest minion within 10 blocks
/bmine thrallcd Show how long until a Thrall can appear again

Older versions used /mine (aliases /bm, /busymine) and nine standalone shortcuts such as /shop and /upgrades. Those were removed; use /bmine <name> instead.

Admin commands

All of these need busymining.admin (default: op).

Command Description
/bmine reload Reload every config, message and menu file and restart all modules
/bmine give <item> [player] [amount] Give a custom item. Amount is 1 to 2304. With no player, gives to yourself
/bmine addxp <player> <amount> Add mining XP. Works for offline players too
/bmine addzeta <player> <amount> Add Zeta. Works for offline players too
/bmine cullmobs Remove every Rune Guardian, Wraith, Oracle, Oracle minion, Thrall and Vessel boss BusyMining spawned
/bmine addvessel <vessel> [levels] [player] Add Vessel levels to the held pickaxe without a trial
/bmine minion give [player] Give a Mining Minion item

Testing tools

These exist to test the late-game loop quickly. Keep them to trusted staff.

Command Description
/bmine vesselready [player] Reveal all three Requium Orbs and set anger to 100% on the held pickaxe's trial
/bmine resetcooldowns [player] Clear the target's Oracle and Rune Guardian summon cooldowns

/bmine shop givezeta <player> <amount> is kept for older scripts. It only works on online players. Use /bmine addzeta in new setups.

Vessel names for addvessel are the lowercase ids from the Vessels page, such as valakas_nightfall. Tab completion lists them, along with every item id for /bmine give.

Permission nodes

Node Default Grants
busymining.player everyone Every player command. Without it, /bmine is refused
busymining.admin op Every admin command, admin lines in /bmine help, and opening other players' minions

Optional menu permissions

Each menu can be locked behind its own permission. The gates are off by default, so everyone can open every menu. Turn one on in config.yml:

yaml
GUIPermissions:
  Shop:
    enabled: true
    Permission: 'busymining.gui.shop'
Gate Default permission Locks
Main busymining.gui.main The main menu
Shop busymining.gui.shop The Mine Shop
Stats busymining.gui.stats The statistics menu
Journal busymining.gui.journal The Journal
Artifacts busymining.gui.artifacts The Artifact Identifier
Vessels busymining.gui.vessels The Vessel menu
Singularity busymining.gui.singularity The Singularity
Upgrades busymining.gui.upgrades Passive Upgrades
Oracle busymining.gui.oracle The Oracle status menu (not summoning)
Refinery busymining.gui.refinery The Mining Tome menu (not the physical Refinery)
Minion busymining.gui.minion Minion menus

The busymining.gui.* nodes are not declared in plugin.yml, so the server gives them to ops only. Grant them to your player groups through your permissions plugin when you turn a gate on. You can also change Permission: to any node you already use.