Why OpenEco?
Most economy plugins ignore Folia, treat multi-currency as an afterthought, or provide no real transaction history. OpenEco was written from scratch to handle all three properly — accounts are kept in memory for instant reads and writes, changes are persisted to your database of choice, and every transaction is recorded.

Features

Currencies

• Define as many named currencies as you want — dollars, gems, tokens, anything
• Each currency has its own decimal precision, starting balance, and optional max-balance cap
• All commands, placeholders, and API calls accept an optional [currency] argument
• Vault v1 and VaultUnlocked v2 both target your configured default currency automatically

Storage backends

• SQLite — default, zero extra config
• H2 — embedded local database
• MySQL / MariaDB / PostgreSQL — remote, for shared setups
• Switch backends by changing one line in config.yml

Transaction history

• Full record of every deposit, withdrawal, transfer, and admin action
• /history [player] [page] [currency] — players can browse their own history
• Configurable retention: keep forever or auto-prune after N days

Admin controls

• Freeze and unfreeze accounts
• Rename account display names
• Delete accounts and their full history
• /eco reload — reload config without restarting the server

PlaceholderAPI

• %openeco_balance%, %openeco_balance_formatted%, %openeco_rank%
• Leaderboard: %openeco_top_1_name%, %openeco_top_3_balance_formatted%, etc.
• Full currency-aware variants for every placeholder

Cross-server handoff (optional)

• Point multiple backend servers at the same MySQL/MariaDB/PostgreSQL database
• Velocity proxy addon handles account handoff so balances stay consistent when players switch backends
• Disabled by default — single-server installs need no extra config

Enhancements Addon (optional, bundled in the download)

Extra mechanics layered on top without modifying the core plugin:

• Interest — Periodic balance interest, configurable per currency
• Pay limits — Cap how much a player can send in a rolling time window
• Permission balance caps — Different max balances per permission group
• Currency exchange — /exchange <amount> <from> <to> at configured rates

For Plugin Developers
OpenEco registers a full service API through Bukkit's ServicesManager. Covers accounts, balance reads/writes, transfers, freeze state, history, leaderboard, and currency-aware overloads for every method. Full documentation is on the GitHub repository.

Requirements

• Paper 1.20.5+ or Folia 1.21+
• VaultUnlocked — required
• PlaceholderAPI — optional

Quick Start

1. Drop OpenEco.jar and VaultUnlocked.jar into plugins/
2. Start the server once — config.yml generates automatically
3. Configure your currency name, storage backend, and any optional rules
4. Run /eco reload or restart — done