Using it

The Hollow and mining

On first start mcBans builds the Hollow around 0,0 in the purgatory world: a sealed, lit cave with a deep terraced ore pit, rock pillars, glow vines, amethyst and lanterns, plus a spawn deck. The cave is closed on every side so nobody can leave it.

  • Players can only break ore blocks inside the mine area, and only with the purgatory pickaxe.
  • A mined block turns into bedrock and grows back as a random ore after purgatory.mine.regen-seconds (30 by default).
  • Set purgatory.mine.auto-build: false if you want to use your own build.

Admin setup commands#

These need mcbans.purgatory.setup and must be run in game on the server that hosts purgatory:

  • /purgatory tp teleports you to the purgatory spawn.
  • /purgatory setspawn sets the spawn to where you stand (you must be in the purgatory world).
  • /purgatory setmine pos1 then pos2 marks your own ore area.
  • /purgatory refill restores every ore block now.
  • /purgatory rebuild builds the Hollow again. You get a message when it finishes.

Ore values#

value is the credits for one block, smelt-value is the credits once the pickaxe has auto-smelt, and weight is how common the ore is when blocks regrow. For "4 coal = 1 credit", set value: 0.25. Any ore you list can be mined, and any block not listed cannot.

ores:
  COAL_ORE:      { value: 0.5,  smelt-value: 0.5,  weight: 40 }
  COPPER_ORE:    { value: 0.75, smelt-value: 1.25, weight: 25 }
  IRON_ORE:      { value: 1.5,  smelt-value: 2.5,  weight: 18 }
  GOLD_ORE:      { value: 3,    smelt-value: 5,    weight: 8 }
  REDSTONE_ORE:  { value: 2,    smelt-value: 2,    weight: 5 }
  LAPIS_ORE:     { value: 3,    smelt-value: 3,    weight: 3 }
  DIAMOND_ORE:   { value: 12,   smelt-value: 12,   weight: 1 }

Pickaxe tiers#

Players buy tiers with credits from the same balance that counts toward release, so each upgrade delays freedom a little. Credits per block are (smelt-value if auto-smelt, otherwise value) times fortune-multiplier. efficiency is the Efficiency level, haste the Haste effect level, and radius mines every ore in a cube around the block (0 = one block, 1 = 3x3x3, 2 = 5x5x5).

pickaxe:
  tiers:
    1: { name: "<gray>Rusty",    item: WOODEN_PICKAXE,    cost: 0,    efficiency: 0, haste: 0, fortune-multiplier: 1.0,  auto-smelt: false, radius: 0 }
    2: { name: "<white>Stone",   item: STONE_PICKAXE,     cost: 250,  efficiency: 2, haste: 0, fortune-multiplier: 1.0,  auto-smelt: false, radius: 0 }
    3: { name: "<yellow>Iron",   item: IRON_PICKAXE,      cost: 1000, efficiency: 3, haste: 1, fortune-multiplier: 1.25, auto-smelt: true,  radius: 0 }
    4: { name: "<aqua>Diamond",  item: DIAMOND_PICKAXE,   cost: 2500, efficiency: 5, haste: 2, fortune-multiplier: 1.5,  auto-smelt: true,  radius: 1 }
    5: { name: "<light_purple>Netherite", item: NETHERITE_PICKAXE, cost: 5000, efficiency: 5, haste: 3, fortune-multiplier: 2.0, auto-smelt: true, radius: 1 }
Tune the pace

With the defaults, a player needs 10000 credits. Raise ore values or lower unban-threshold for a shorter stay, and do the reverse for a longer one. Players can check progress in the sidebar and boss bar.