Using it

Purgatory

A purgatory ban does not kick the player to a login screen. It sends them to a sealed mine, where they mine ore for credits and are released automatically when they reach purgatory.unban-threshold credits (10000 by default).

How a player ends up there#

  • /ban goes to purgatory by default (purgatory.default-for-bans: true) unless you add -np. Use -p to force it when the default is off.
  • Warning escalation rules with purgatory: true.
  • If purgatory.enabled is false, every ban is a normal ban.

What the player experiences#

  • They are moved to the purgatory world and given a pickaxe. Right-clicking it opens the upgrade menu.
  • Mined ore pays credits. See "The Hollow and mining".
  • No damage, hunger or death (purgatory.no-damage).
  • Chat is set by purgatory.chat: none, purgatory (they only talk to each other) or staff (only staff with mcbans.purgatory.spy read it). They never see normal chat.
  • With purgatory.hide-others, purgatory players and everyone else cannot see each other, or each other in the tab list.
  • They can only use the commands in purgatory.allowed-commands. Staff with mcbans.purgatory.bypass ignore this list.
  • A boss bar (purgatory.bossbar) and a sidebar scoreboard (purgatory.scoreboard) show the ban reason, staff, length, time left, credits and pickaxe tier. The sidebar lines are in lang.yml.

Release#

Reaching the threshold lifts the ban and logs a release by "System". purgatory.release-location is spawn (main world spawn) or last (where the player was before). On a single server, purgatory.save-inventory keeps their inventory while they are inside and gives it back on release. A staff /unban also releases them.

A new purgatory ban starts from 0 credits and tier 1 when purgatory.reset-on-new-ban is on. Lifetime statistics are kept.

purgatory:
  enabled: true
  default-for-bans: true
  unban-threshold: 10000
  reset-on-new-ban: true
  world: "mcbans_purgatory"
  save-inventory: true
  release-location: "spawn"
  chat: purgatory
  hide-others: true
  bossbar: true
  scoreboard: true
  no-damage: true
  allowed-commands: [purgatory, msg, r, tell, reply, helpop, rules]