NexoriaEconomy

NexoriaEconomy is a standalone, lightweight currency system built for Minecraft servers running on Paper, Purpur, or Folia with Java 25+. It includes a native Vault economy provider implementation, transactional payment safeguards, and cached leaderboard rankings.

---

Why NexoriaEconomy?

Most economy plugins are either outdated, bloated with unnecessary features, or struggle with concurrency on modern server forks. NexoriaEconomy focuses exclusively on doing one thing right: handling balances accurately, securely, and with zero impact on server tick rates.

• Folia and Paper Native: Built using modern Brigadier command lifecycle events and non-blocking ConcurrentHashMap registries. Safe for regionized multithreading.
• Universal Vault Integration: Automatically registers as the primary Economy service provider. Works out of the box with QuickShop, ChestShop, ShopGUI+, AuctionHouse, Towny, Lands, and WorldGuard.
• Data Protection: Account data is written through an atomic file swap mechanism (balances.yml.tmp -> balances.yml), preventing database wipeouts or file corruption during unexpected crashes or forced restarts.
• Clean Command Routing: Native tab completion for all player names, numerical amounts, and administrative actions.

---

Commands and Permissions

Command	Aliases	Description	Permission	Default
/balance	/bal, /money	View your current account balance	nexoria.economy.use	Everyone (true)
/balance <player>	/bal, /money	Check another registered player's balance	nexoria.economy.use	Everyone (true)
/pay <player> <amount>	None	Transfer currency to an online player	nexoria.economy.pay	Everyone (true)
/baltop [page]	/balancetop	Display the server balance leaderboard	nexoria.economy.use	Everyone (true)
/eco give <player> <amount>	/economy	Deposit money into an account	nexoria.economy.admin	Operators (op)
/eco take <player> <amount>	/economy	Deduct money from an account	nexoria.economy.admin	Operators (op)
/eco set <player> <amount>	/economy	Set an exact balance for an account	nexoria.economy.admin	Operators (op)
/eco reset <player>	/economy	Reset balance to the default starting amount	nexoria.economy.admin	Operators (op)
/eco reload	/economy	Reload settings and account data from disk	nexoria.economy.admin	Operators (op)

---

Configuration (config.yml)

# ========================================================
# NexoriaEconomy - Main Configuration
# Supports Paper, Purpur and Folia
# ========================================================

currency:
  symbol: "$"
  name-singular: "Dollar"
  name-plural: "Dollars"
  starting-balance: 1000.0
  min-pay-amount: 1.0
  decimals: 2

# Leaderboard settings
baltop:
  cache-minutes: 5
  limit: 10

# Message formatting (Supports legacy color codes &)
messages:
  prefix: "&2[&a$&2]&r "
  no-permission: "&cYou don't have permission to do that."
  player-not-found: "&cPlayer not found."
  invalid-amount: "&cInvalid amount specified."
  insufficient-funds: "&cYou don't have enough money. (Required: {needed})"
  only-players: "&cThis command can only be used by players."
  reload-success: "&aConfiguration and balances reloaded."
  balance: "&7Your balance: &a{balance}"
  balance-other: "&7{player}'s balance: &a{balance}"
  pay-sent: "&7You sent &a{amount} &7to &e{player}&7."
  pay-received: "&7You received &a{amount} &7from &e{player}&7."
  cannot-pay-self: "&cYou cannot send money to yourself."
  admin-give: "&7Added &a{amount} &7to &e{player}&7's account. New balance: &a{balance}"
  admin-take: "&7Took &c{amount} &7from &e{player}&7's account. New balance: &a{balance}"
  admin-set: "&7Set &e{player}&7's balance to &a{balance}&7."