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:
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.