## OpenEco \u2014 Economy Plugin for Paper & Folia<\/p>\n
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 \u2014 no compromises.<\/p>\n
—<\/p>\n
### \u2726 Why OpenEco?<\/p>\n
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.<\/p>\n
—<\/p>\n
### Features<\/p>\n
**Currencies**
\n– Define as many named currencies as you want (dollars, gems, tokens \u2014 anything)
\n– Each currency has its own decimal precision, starting balance, and optional max balance cap
\n– All commands, placeholders, and API calls accept an optional `[currency]` argument
\n– Vault v1 and VaultUnlocked v2 both point at your default currency automatically<\/p>\n
**Storage**
\n– SQLite (default, zero config)
\n– H2 (embedded local)
\n– MySQL \/ MariaDB \/ PostgreSQL (remote)
\n– Switch backends by changing one line in config<\/p>\n
**Transaction History**
\n– Full record of every deposit, withdrawal, transfer, and admin action
\n– Per-player `\/history [page] [currency]` command
\n– Configurable retention \u2014 keep forever or auto-prune after N days<\/p>\n
**Admin Controls**
\n– Freeze \/ unfreeze accounts
\n– Rename account display names
\n– Delete accounts and their full history
\n– Reload config without restart<\/p>\n
**PlaceholderAPI**
\n– `%openeco_balance%`, `%openeco_balance_formatted%`, `%openeco_rank%`
\n– Leaderboard placeholders: `%openeco_top_1_name%`, `%openeco_top_3_balance_formatted%`, etc.
\n– Full currency-aware variants for every placeholder<\/p>\n
**Cross-Server (optional)**
\n– Enable shared MySQL\/MariaDB\/PostgreSQL across multiple backend servers
\n– Velocity proxy addon handles player handoff sync so accounts stay consistent when players switch backends
\n– Disabled by default \u2014 single-server setups need no extra config<\/p>\n
—<\/p>\n
### Enhancements Addon *(optional, included)*<\/p>\n
Extra mechanics layered on top without touching the core:<\/p>\n
| Feature | Description | —<\/p>\n ### For Developers<\/p>\n OpenEco exposes a full service API via Bukkit’s `ServicesManager`:<\/p>\n “`java Covers accounts, balance reads\/writes, transfers, freeze state, history, leaderboard, and all currency-aware overloads. Full docs in the API guide.<\/p>\n —<\/p>\n ### Requirements<\/p>\n | Requirement | Notes | —<\/p>\n ### Quick Start<\/p>\n 1. Drop `OpenEco.jar` and `VaultUnlocked.jar` into `plugins\/` —<\/p>\n *Documentation \u00b7 Issue Tracker \u00b7 Source Code*<\/p>\n","protected":false},"excerpt":{"rendered":" Fast, multi-currency economy plugin for Paper and Folia. Vault\/VaultUnlocked, PlaceholderAPI, transaction history, and cross-server handoff built in.<\/p>\n","protected":false},"featured_media":116429,"template":"","meta":{"_minecraft_slug":"openeco","_minecraft_project_id":"ygCWx7VX","_minecraft_author":"alexisbinh","_minecraft_license":"Apache-2.0","_minecraft_downloads":47,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"openeco.zip","_minecraft_size_bytes":1997773,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-15T21:14:11.417155Z","_minecraft_date_created":"2026-04-01T22:36:11.267300Z","_minecraft_date_modified":"2026-05-05T17:05:58.556961Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/openeco","_minecraft_icon_attachment_id":116429,"_minecraft_imported_at":"2026-06-06T20:27:30+00:00","_minecraft_import_hash":"3f5a1e83febd0aa4bd9b054799f13a6b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,125,126,127,128,92],"mod_loader":[131,132,133],"minecraft_version":[101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-116428","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|—|—|
\n| Interest | Periodic balance interest, configurable per currency |
\n| Pay limits | Cap how much a player can send in a time window |
\n| Permission balance caps | Different max balances per permission group |
\n| Currency exchange | `\/exchange
\nOpenEcoApi api = Bukkit.getServicesManager()
\n .getRegistration(OpenEcoApi.class)
\n .getProvider();
\n“`<\/p>\n
\n|—|—|
\n| Paper 1.20.5+ or Folia 1.21+ | Both supported |
\n| VaultUnlocked | Required |
\n| Vault | Also supported |
\n| PlaceholderAPI | Optional |<\/p>\n
\n2. Start the server once \u2014 config generates automatically
\n3. Edit `plugins\/OpenEco\/config.yml` to set your currency name and storage backend
\n4. `\/eco reload` \u2014 done<\/p>\n