FAQ and troubleshooting

Installation

Do I need Vault, EssentialsX or an economy plugin? No. PulsePrison has its own economy and unlimited currencies. If Vault is installed, it registers as the server economy.

Do I need WorldEdit or WorldGuard? Only WorldEdit or FastAsyncWorldEdit for cells. Private mines work with packets without either. WorldGuard is optional: it adds the pulseprison-enchants flag, cell regions and allowed regions for AFK blocks.

Do I need PlaceholderAPI? Only to use PulsePrison placeholders in other plugins (TAB, scoreboards, holograms) or other plugins' %placeholders% in menus, actions and milestones.

Which versions are supported? Paper 1.20.4 to 1.21.11 with Java 17 or newer.

Does it work across several servers? Yes, with storage.type: mysql economy, ranks, pickaxes, clans and profiles are shared. Private mines, backpacks, pets and robots stay in each server's files. See Storage.

Configuration

I changed a file and nothing happens. /prison reload reloads config.yml, currencies, levels and menus. Progression systems have their own reload (list). Modules, storage, enchants and the rest apply on restart.

I updated the plugin and don't see a new option. New keys are added to your files on startup, without overwriting what you changed. If a file got too messy, rename it and let it generate again to compare.

How do I turn a system off? modules.<module>.enabled: false in config.yml and restart. See Modules.

How do I translate into another language? Add the code to language.available, restart and translate the messages_<code>.yml that is created. See Languages.

How do I change a menu? Edit its file in menus/ and run /prison reload. See Menus.

Pickaxe and enchants

Area enchants don't break anything. They only work inside PulsePrison mines or in WorldGuard regions with /rg flag <region> pulseprison-enchants allow. Also check max-blocks-per-activation in enchants.yml.

A player lost their pickaxe. Progress lives in their data, not the item: /pickaxe give <player>.

How do I test high level enchants without mining for hours? /padmin pickaxe me level set 100 and /padmin enchant me all set max.

There are too many enchant activation messages. Each player turns them off or moves them to the action bar in /settings. For everyone: settings.activation-messages in enchants.yml, with a higher cooldown-millis or fewer enchants in the list.

Why do my blocks go to the inventory instead of being sold? Auto-sell is off (/autosell on) or the block is priced at 0. See Selling.

Private mines

/pmine create says the mine couldn't be created. With staff permission the message shows the reason. The most common one: the default-mine type doesn't exist or is disabled. Create the type with the setup and check the console.

"Disabled private mine type: its structure is wider than the existing mine plots". Mines already exist with plots smaller than the new structure. Make the area narrower or delete the existing mines. See Common problems.

The console shows "was kicked for floating too long". It shouldn't happen anymore: PulsePrison avoids the flight check inside the mine world without letting players fly. If it appears, update the plugin.

I spawn in the void when entering my mine. The type's spawn was marked wrong. Repeat the spawn step of the setup standing next to the mine, or fix spawn in pmines/types/<type>.yml.

Economy and progression

How do I give currencies? /economy give <player> <amount> <currency>, or [give] <currency> <amount> in any reward.

How do I add ranks? In ranks.yml. The requirements charged are those of the rank you move to. See Ranks.

The economy inflates too fast. Check how many things add to sell: multipliers, prestige, rebirth, skill tree, pet, attributes, crystals, armor, skins, boosters and abilities. /stats shows the stat totals. See Stats.

Is rankup automatic? Yes, by default. Each player turns it off with /rankup auto off and the server with rankup.auto.enabled: false.

A command says "module disabled". It belongs to a module turned off in config.yml.

Developers

Can I build addons? Yes. See Building an addon.