Help

Troubleshooting and FAQ

A banned player was not sent to purgatory and got a normal ban screen.

Check that purgatory.enabled is true, that the ban was not given with -np, and that purgatory.default-for-bans is on (or use -p). Run /mcbans info to see where purgatory lives. On a network, make sure network.purgatory-server matches the proxy server name and purgatory.server matches in the proxy config.

/purgatory setspawn, setmine, refill or rebuild says purgatory is not hosted here.

These only work on the server that hosts the purgatory world. On a single server that is the server itself. On a network, run them on the backend that has network.this-is-purgatory-server: true. For setspawn and setmine you must also stand in the purgatory world, which /purgatory tp takes you to.

My staff cannot open Settings or run /mcbans reload.

Those need mcbans.admin, which is not part of mcbans.staff. The purgatory section of the panel needs mcbans.purgatory.admin.

A staff member says "no permission" for -ip.

The -ip flag needs mcbans.ip. It is part of mcbans.staff.

I cannot ban, mute, kick or freeze another staff member.

Players with mcbans.exempt are protected from other staff while online. It defaults to false, so check your permission plugin for a wildcard that includes it. You can still warn them.

Webstore credits did not arrive.

The command must be run from the console as purgatory give {username} <credits>. The player has to have joined the server at least once, or you can use their UUID. Test the same command by hand in the console. The player does not have to be online.

Purgatory players see the normal TAB header or footer.

TAB overwrites anything sent directly. Install TAB and check the startup log for "Hooked TAB". If TAB's header/footer feature is disabled, mcBans falls back to the normal tab list, and TAB may overwrite it.

Players cannot join and see "Your record could not be loaded".

The database could not be reached. Check your MySQL details and that the database is running. If you would rather let players in unchecked while the database is down, set storage.deny-login-on-error: false, but banned players could then join.

Can I use SQLite or YAML on a network?

No. SQLite and YAML are for a single server. A network needs one MySQL or MariaDB database that every backend and the proxy use.

The update checker does nothing.

Update checks only run in copies downloaded from BuiltByBit and when updates.enabled is true. Auto-download also needs updates.auto-download: true and a license for the resource. The new jar is installed on the next restart.

A warning did not trigger a punishment.

Thresholds match the exact number of active warnings. Expired or removed warnings do not count (warns.expire-after is 30 days by default), and the 4th warning does nothing with the default rules.

A player says the ore does not break in purgatory.

They must use the purgatory pickaxe, and the block must be an ore from purgatory.ores inside the mine area. A mined block turns into bedrock until it regrows. If you set your own mine with /purgatory setmine, check that the area covers the ores.

How do I give a player their stuff back or end a stint early?

Use /unban <player>. It releases them from purgatory, and on a single server their saved inventory is returned. To reduce a stay without unbanning, give credits with /purgatory give.