Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Vystorm

Player XP as your Vault currency: payments, XP cheques, requests, bill splitting, online bonus, leaderboard.

Report XPVaultEconomy?

Requires Vystorm Core (free) – the shared base of all Vystorm plugins (English/German language files, in-game config editor, update check). Just drop one extra jar into plugins/, no setup.

XPVaultEconomy banner

Your players' XP bar is their wallet. XPVaultEconomy turns Minecraft experience into your server's Vault currency: one XP point is one coin. When a shop plugin charges 500, those 500 points come straight off the player's experience bar, and paying someone moves real XP from one bar to the other.

Features

Your XP is money

XP as currency

  • XP is the balance. Every Vault deposit, withdrawal or payment changes level and XP bar right away. Whole numbers only, no bank accounts, one global account per player.
  • Nothing lost on first join. The XP a player already has becomes their starting balance.
  • XP cheques. /economy cheque 500 3 turns XP into three tradeable paper cheques of 500 each. Hand them over, sell them in chest shops, store them in chests; right-click redeems one. Each cheque works exactly once, so copies are worthless.
  • Short amounts. Every money command accepts k and m: /pay Steve 2.5k, /economy cheque 1m.

Pay friends with XP

Paying each other

  • Payments. /pay, clickable chat buttons (pay, reply, page through) and a confirm step that shows the level you'll end up at. Save up to 20 favourite payees.
  • Player menu. Sneak + right-click a player with an empty hand to pay them or request XP from them, without typing a command. Admins can open the player's booking history from the same menu.
  • Requests and bill splitting. Ask someone for XP with a reason, or split a bill across up to 16 players. Each payer confirms their own share; open requests expire after 24 hours. Players can block requests from a specific person.
  • Personal limits. Players can cap single payments and their daily total.
  • History and privacy. /economy history shows the last ten bookings and exports up to 100 to CSV. /economy privacy on hides your balance from the leaderboard and other players.
  • Savings goal. Set a target like /economy goal set 10000 Equipment and watch the progress. Nothing is reserved.
  • Leaderboard. /baltop with pages.
  • Account menu. /economy or /vmenu → Economy → XP Account opens a dialog with balance, bonus, payments and leaderboard.

Stay online, earn XP

Online bonus

  • By default 2 XP after the first minute, growing 2 % with every further minute.
  • Short disconnects don't break the streak (30 minutes grace).
  • Optional AFK pause.

For admins

  • /economy admin give|take|set changes balances; /economy admin history <player> shows a player's latest bookings with counterpart and payment ID for support cases.
  • YAML storage by default, or MySQL through Vystorm Core's shared database so one balance follows the player across a network.
  • English and German, picked per player. Add more languages via lang/<code>.yml.

Commands & permissions

Command What it does
/money [player], /bal Show a balance
/pay <player> <XP> Pay a player
/baltop [page], /moneytop, /xptop Leaderboard
/economy XP Account menu
/economy cheque <XP> [count] Issue up to 64 XP cheques
/economy goal | favorite | request | split | requests | requestblock | limits | history | privacy Savings goal, payees, requests, splits, limits, history, privacy
/economy admin give|take|set <player> <XP> Change a balance
/economy admin history <player> [count] A player's latest bookings
/economy admin info|reload Account count and storage, reload config

Aliases: /xpeconomy, /xpeco. German subcommands work too.

Permission Default For
xpeconomy.balance everyone Own balance, menu, goal, privacy, history
xpeconomy.pay everyone Payments, favourites, requests, splits, blocks, limits
xpeconomy.top everyone Leaderboard
xpeconomy.cheque everyone Issue and redeem XP cheques
xpeconomy.balance.others OP Look up other players' balances
xpeconomy.admin OP /economy admin, server settings; includes all others

Configuration

Edit the whole config.yml in game with /vadmin config XPVaultEconomy, or under /vsettings → Server → XP Economy.

language: auto
economy:
  starting-balance: 0
  maximum-balance: 2000000000
storage:
  type: yaml              # yaml or mysql (Core shared database)
online-rewards:
  enabled: true
  base-xp: 2.0
  interval-seconds: 60
  growth-multiplier: 1.02
  reconnect-grace-minutes: 30
  afk:
    pause-after-seconds: 0  # 0 = no AFK pause

If MySQL is selected but unreachable, the plugin disables itself rather than falling back to the file. Requests, limits, privacy and history always stay local to each server.

Requirements

  • Paper or Purpur 1.21.8 to 26.2 (plain Spigot is not supported), Java 25
  • Vystorm Core (free); the player menu entries need Core 0.43.0 or newer
  • VaultUnlocked (registers as Vault). XPVaultEconomy serves both the legacy Vault economy API and Vault 2.

More from Vystorm

Vystorm Core, Vystorm Rails, VystormPortals, CustomTrees, BlockIntegrations, Vystorm Veins, Winter Is Coming, Vystorm Insomnia, Vystorm Gallery, Vystorm Paddock, Vystorm Snapshot, Vystorm Boards and Vystorm Estates, all free.

Free and open source (MIT).

Information

Category
Economy
Published
October 29, 2026
License
MIT
0Downloads
0Stars

Pinned Versions

Members

1