OpenEco

OpenEco — Economy Plugin for Paper & Folia

A clean, fast, multi-currency economy plugin built for modern servers. OpenEco keeps balances in memory for instant reads and writes, persists to your database of choice, and integrates with the full Vault/VaultUnlocked ecosystem — no compromises.

---

✦ Why OpenEco?

Most economy plugins either ignore Folia entirely, bolt on multi-currency as an afterthought, or have no real transaction history. OpenEco was built from scratch to handle all three properly.

---

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 point at your default currency automatically

Storage

• SQLite (default, zero config)
• H2 (embedded local)
• MySQL / MariaDB / PostgreSQL (remote)
• Switch backends by changing one line in config

Transaction History

• Full record of every deposit, withdrawal, transfer, and admin action
• Per-player /history [page] [currency] command
• Configurable retention — keep forever or auto-prune after N days

Admin Controls

• Freeze / unfreeze accounts
• Rename account display names
• Delete accounts and their full history
• Reload config without restart

PlaceholderAPI

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

Cross-Server (optional)

• Enable shared MySQL/MariaDB/PostgreSQL across multiple backend servers
• Velocity proxy addon handles player handoff sync so accounts stay consistent when players switch backends
• Disabled by default — single-server setups need no extra config

---

Enhancements Addon (optional, included)

Extra mechanics layered on top without touching the core:

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

---

For Developers

OpenEco exposes a full service API via Bukkit's ServicesManager:

OpenEcoApi api = Bukkit.getServicesManager()
        .getRegistration(OpenEcoApi.class)
        .getProvider();

Covers accounts, balance reads/writes, transfers, freeze state, history, leaderboard, and all currency-aware overloads. Full docs in the API guide.

---

Requirements

Requirement	Notes
Paper 1.20.5+ or Folia 1.21+	Both supported
VaultUnlocked	Required
Vault	Also supported
PlaceholderAPI	Optional

---

Quick Start

1. Drop OpenEco.jar and VaultUnlocked.jar into plugins/
2. Start the server once — config generates automatically
3. Edit plugins/OpenEco/config.yml to set your currency name and storage backend
4. /eco reload — done

---

Documentation · Issue Tracker · Source Code