Skip to main content
JPPrison ships with two built-in currencies — Tokens and Gems — but lets you define unlimited custom economies via YAML. Every economy gets its own command set, leaderboard, payment system, and optional Vault bridge the moment you add it to the server.

​
How Economies Work

Every economy is a single YAML file stored in plugins/JPPrison/economies/. When JPPrison loads, it reads every file in that folder and registers a full command suite for each one automatically. Given an economy with id: crystals, the plugin generates all of the following commands with no extra configuration: The same pattern applies to every economy — replace crystals with any economy id.

​
Default Economies

JPPrison includes two economies out of the box: Both are fully reconfigurable. You can edit their YAML files, change their display names, symbols, and colors, or disable them entirely.

​
Creating a Custom Economy

1

Open the GUI Economy Creator (recommended)

Run /jpprison economy in-game. JPPrison opens a visual creator where you name the economy, pick a color, and set a symbol — no YAML editing required.
2

Or create the YAML file manually

Create a new file in plugins/JPPrison/economies/. The filename must match the economy id. For example, crystals.yml:
3

Reload the plugin

Run /jpprison reload to pick up the new file. JPPrison registers all commands for the new economy immediately — no server restart needed.
4

Use your new economy

Your economy is live. Try /crystals to check your balance or /crystals top to see the leaderboard — both commands are available the moment the reload completes.

​
Vault Integration

Setting vault: true on an economy exposes it to any plugin that hooks into the Vault economy API — shop plugins, auction houses, and permission plugins that charge on rank-up.
Only one economy can be the Vault economy at a time. If you set vault: true on multiple files, JPPrison uses the first one it loads and warns you in the console. Review your economy files and ensure only one has vault: true.

​
Timed Boosts

You can apply a temporary earnings multiplier to a single player or every online player using the timed boost command built into every economy:
Player boost — double Tokens for 1 hour:
Global boost — 1.5× Gems for 30 minutes:
Supported time units are s (seconds), m (minutes), and h (hours). Boosts stack with the prestige multiplier but are capped by the max-multiplier setting in config.yml. Active boosts are shown in the /prison HUD.
Use global boosts as scheduled events or vote rewards to keep players engaged during peak hours.

​
Economy Leaderboards

Every economy automatically tracks balances server-wide and exposes a top-10 leaderboard:
The leaderboard updates in real time and is also available as a configurable hologram placeholder for display boards in your prison mine lobbies.

​
Player Payments

Players can trade any economy currency directly with each other using the pay subcommand:
Payments are instant and logged. You can restrict the pay command per-economy by removing the relevant permission node (jpprison.economy.<id>.pay) from your permissions plugin.