Minions

The minion module. A small armour stand that mines nearby ores on its own and stores what it collects. Config file: modules/minion/config.yml.

Getting and placing one

Players buy a Mining Minion in the Zeta Shop for 5,000 Zeta. Admins can hand them out with /bmine give minion or /bmine minion give [player].

Right-click a block with the minion item to place it there. Placing works like placing an armour stand, so it's refused where your protection plugin wouldn't let you build. Each player can own up to MaxMinionsPerPlayer.

What it does

Every MinionMineSpeed ticks, the minion picks a random block with ORE in its name within MinionRadius blocks of itself, removes it, and adds its normal drops to its storage. It does not give its owner XP, Zeta or BusyMining drops.

Each block is checked as if the owner broke it, so ores in a claim the owner can't build in are left alone (see Protection Plugins). For the same reason a minion only works while its chunk is loaded and its owner is online; it pauses when the owner logs off and carries on when they're back.

Managing it

Right-click the minion, or stand within 10 blocks and run /bmine minion, to open its menu:

  • Stats: blocks mined and owner.
  • Collect: move everything in storage to your inventory (overflow drops at your feet).
  • Remove: pick the minion up, with its storage, and get the minion item back.

Only the owner can open a minion. Players with busymining.admin can open anyone's.

The minion limit is kept by the server in data/minions.yml, so a minion frees its owner's slot however it goes away (picked up by its owner or an admin, /kill, another plugin), even while the owner is offline. Unloading its chunk doesn't count as going away. Minions are invulnerable, so players can't punch them apart.

Settings

yaml
Settings:
  Enabled: true
  MaxMinionsPerPlayer: 3
  MinionMineSpeed: 100
  MinionRadius: 3
  • MaxMinionsPerPlayer: minions one player can have placed at once.
  • MinionMineSpeed: ticks between blocks mined (100 ticks = 5 seconds).
  • MinionRadius: how far the minion reaches, as a cube around itself.
  • Enabled is not read in this version. Use modules.minion in config.yml to turn minions off.

The menu title and its items are set in modules/minion/gui.yml.

Minions from older versions

Minions placed before this version are added to the limit the first time their chunk loads. Until then, an owner with old minions in unloaded chunks could place more than MaxMinionsPerPlayer.