Mining Levels & Zeta

The core module. Mining a configured ore gives mining XP and Zeta, BusyMining's own currency. Mining level gates Oracles, Vessels and the rarer Refinery drops. Zeta pays for upgrades, Vessels and the Zeta Shop. Config file: modules/core/config.yml.

What counts as mining

A block only earns rewards when all of these are true:

  • The player is not in creative mode.
  • They are holding a pickaxe without Silk Touch.
  • BusyMining is on in the world (see Worlds).

The same rules apply to every mining drop (gemstones, fluxes, artifacts, Mysterious Dust). Extra blocks broken by Explosive, Vein Miner or Sonic never earn rewards.

Settings

yaml
Settings:
  EnabledWorlds: []
  DisabledWorlds:
  - 'example_world'
  DisableCustomMobWorlds:
  - 'example_world'
  MysteriousDustChance: 1.0
  AutoSaveSeconds: 300
  Other:
    HideBackArrows: false
    DisablePickaxeView: false
    DoubleDropNotify: ACTIONBAR
    MainMenuBackArrow:
      Commands:
        - 'example command 1'
  • EnabledWorlds, DisabledWorlds, DisableCustomMobWorlds: which worlds BusyMining runs in. See Worlds.
  • MysteriousDustChance: percent chance for Mysterious Dust to drop from any block with ORE in its name. Nagyn's Tranquility adds to it.
  • AutoSaveSeconds: how often cached player data is written to the database (minimum 30). Data is also saved when a player quits and when the server stops.
  • Other.HideBackArrows, Other.DisablePickaxeView, Other.MainMenuBackArrow: see Main Menu.
  • Other.DoubleDropNotify: where the Fortune passive upgrade's "Double Drop!" notice goes: ACTIONBAR (default), CHAT or NONE. See Passive Upgrades.

Worlds

BusyMining runs in every world by default. Pick the worlds it runs in one of two ways:

  • Allow-list: list your mining worlds under EnabledWorlds. BusyMining then works only there, and DisabledWorlds is ignored. New worlds stay off until you add them.
  • Block-list: leave EnabledWorlds empty ([]) and list the worlds to turn off under DisabledWorlds.
yaml
Settings:
  EnabledWorlds:
  - 'world_resources'
  - 'world_resources_nether'
  - 'world_resources_end'

Write a world as its folder name (what Multiverse's /mv list shows) or as its namespaced key (what the Worlds plugin's /world list shows under each namespace, e.g. worlds:world_resources). Case doesn't matter, and a name without a namespace matches the key in any namespace.

In a world where BusyMining is off:

  • Mining earns no XP, Zeta, gemstones, fluxes, artifacts or Mysterious Dust, and passive upgrades (Fortune, Zeta Greed, Efficiency) do nothing.
  • Pickaxe enchants (Explosive, Vein Miner, Sonic, Melt) and vessel effects (Aurora's Blaze, Memento's Stopwatch and the rest) don't fire.
  • Blocks mined there don't count toward the Singularity.
  • Rune Guardians, Oracles, Thralls and Vessel bosses can't be summoned or spawn.
  • Minions can't be placed. A minion placed before its world was turned off stays idle; its owner can still open it and pick it up.

Menus and /bmine commands work in every world.

DisableCustomMobWorlds turns off only the custom mobs, in worlds where everything else stays on. All three lists take names the same way. /bmine reload applies changes.

Zeta and XP per ore

yaml
Zeta:
  Amounts:
    COAL_ORE: 30
    REDSTONE_ORE: 70
    LAPIS_ORE: 130
    DIAMOND_ORE: 350
    EMERALD_ORE: 400
    NETHER_QUARTZ_ORE: 30
    IRON_ORE: 40
    GOLD_ORE: 90

MiningLevels:
  Amounts:
    COAL_ORE: 15
    REDSTONE_ORE: 35
    LAPIS_ORE: 50
    DIAMOND_ORE: 150
    EMERALD_ORE: 200
    NETHER_QUARTZ_ORE: 15
    IRON_ORE: 25
    GOLD_ORE: 40
  BaseXP: 2000
  MiningLevelScalar: 1.125

Names match partially: COAL_ORE also covers DEEPSLATE_COAL_ORE. Add an exact entry (for example DEEPSLATE_DIAMOND_ORE: 500) to give a variant its own value. Any block you list works, not only ores. Blocks that aren't listed give nothing.

The level curve

The XP needed to go from level L to L+1 is BaseXP × MiningLevelScalar^(L-1), rounded down. With the defaults that's 2,000 XP for level 2, 2,250 for level 3, and about 34,000 per level by level 25. There is no level cap.

Bonuses

  • Mining XP: Experience Boost enchantment (+10% per level) and Neptulus' Wave.
  • Zeta: Zeta Greed passive upgrade (+10% per level), Zeta Boost enchantment (+10% per level), Seraph's Grasp, and the Singularity's Zeta Booster perk, which applies to Zeta from every source.

Zeta Tears

A Zeta Tear is Zeta in item form. Players get them from Oracles or by withdrawing 10,000 Zeta in the Vessel menu, and right-click one to redeem it. Its value is zeta_tear.amount in items.yml.

Checking progress

/bmine zeta prints the balance, /bmine stats opens the statistics menu, and the main menu's head shows level, XP and Zeta. The same numbers are available as placeholders.