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`:

```java 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*