PerfEconomy
Lightweight Vault economy provider. Stores balances in SQLite or MySQL.
Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – Full region-thread-safe scheduling
• Vault Economy provider – Registers as Vault Economy when enabled; loads before other Perf plugins so balances are ready at startup
• SQLite & MySQL storage – HikariCP connection pooling with WAL SQLite tuning
• Familiar player commands – /balance (bal, money), /baltop (balancetop), and /pay out of the box
• PerfPay integration – /pay is owned by PerfPay when installed; PerfEconomy restores /pay automatically when PerfPay is absent
• Staff economy commands – /eco give, set, take, reset with bulk support via * or @a
• Admin toolkit – /perfeconomy status, health, balance admin, top list, import, backup, and debug
• Balance import – Migrate balances from Vault, EssentialsX, or CMI with confirm step and pre-import snapshot
• Snapshot backups – Create, list, restore, and diff balance snapshots on disk
• Leaderboard cache – Configurable cached top-balance list for chat and placeholders
• Transaction logging – Optional audit trail for balance changes
• Configurable currency – Display names, symbol, precision, compact suffixes (k/M/B/Q), and locale-aware grouping
• Pay limits – Configurable min/max transfer amounts; toggle /pay on or off
• DB failsafe – Queue or read-only mode when the database is temporarily unavailable
• Suspicious transaction alerts – Console logging and optional Discord webhook for large transfers
• PlaceholderAPI – Native %perfeconomy_*% placeholders plus %vault_eco_*% Vault-style bridge
• Developer API – PerfEconomyAPI for other plugins to read and mutate core balances
• Update checker – Optional BuiltByBit update notifications
Placeholders
%perfeconomy_balance% – Player balance (raw formatted amount)
%perfeconomy_balance_formatted% – Player balance (Vault-style formatted string)
%perfeconomy_rank% – Player balance rank on the server (- if unranked)
%perfeconomy_top_(rank)_name% – Name of player at leaderboard rank (1–100)
%perfeconomy_top_(rank)_balance% – Balance at rank (raw)
%perfeconomy_top_(rank)_balance_formatted% – Balance at rank (formatted)
%perfeconomy_top_(rank)_uuid% – UUID of player at rank
%vault_eco_balance% – Vault-style balance with economy fractional digits
%vault_eco_balance_fixed% – Balance without decimals
%vault_eco_balance_formatted% – Compact balance (e.g. 1.5k, 2.3M) with configurable suffixes
%vault_eco_balance_commas% – Balance with comma grouping
%vault_eco_balance_(points)dp% – Balance with custom decimal places (e.g. balance_2dp)
Commands
/balance [player] – View your balance or another player's balance (perfeconomy.balance.self / perfeconomy.balance.other)
/baltop [size] – View top balances in chat (perfeconomy.top)
/pay (player) (amount) – Send money to another player; disabled when PerfPay is installed (perfeconomy.pay)
/eco give (player) (amount) – Add balance to a player or all online players via * or @a (perfeconomy.eco.give)
/eco set (player) (amount) – Set a player's balance (perfeconomy.balance.set)
/eco take (player) (amount) – Remove balance from a player (perfeconomy.balance.take)
/eco reset (player) – Reset a player's balance to the configured start balance (perfeconomy.eco.reset)
/perfeconomy reload – Reload config and messages (perfeconomy.admin)
/perfeconomy help – Show admin command help (perfeconomy.admin)
/perfeconomy status – Show economy stub, storage, queue, and import status (perfeconomy.use)
/perfeconomy health – Quick DB/economy/queue health check (perfeconomy.use)
/perfeconomy balance [player] – View balance (perfeconomy.balance.self / perfeconomy.balance.other)
/perfeconomy balance (player) set (amount) – Set a player's core balance (perfeconomy.balance.set)
/perfeconomy balance (player) add (amount) – Add to a player's core balance (perfeconomy.balance.add)
/perfeconomy balance (player) take (amount) – Take from a player's core balance (perfeconomy.balance.take)
/perfeconomy top [size] – View top balances (perfeconomy.top)
/perfeconomy import (provider) confirm – Import balances from vault, essentialsx, or cmi (perfeconomy.import)
/perfeconomy backup create – Create a manual balance snapshot (perfeconomy.admin)
/perfeconomy backup list – List available snapshots (perfeconomy.admin)
/perfeconomy backup restore (id) confirm – Restore a snapshot (perfeconomy.admin)
/perfeconomy backup diff (id) (id) – Compare two snapshots (perfeconomy.admin)
/perfeconomy debug db-stats – Show database latency histogram (perfeconomy.debug)
Database
• SQLite (default)
• MySQL (configurable)
