Welcome to OpenEco
OpenEco is a single-server-first economy plugin for Paper and Folia. It keeps account balances in memory for fast local use, persists them through JDBC, and optionally coordinates account handoff when you run multiple backend servers behind a proxy against one shared remote database.
Quick Navigation
Features
In-memory economy, multi-currency, Vault, PlaceholderAPI, and network handoff.
Installation
Install the JAR, configure storage, and verify your first commands.
Commands
Player commands, admin /eco subcommands, and migration tools.
Configuration
Currencies, storage backends, pay rules, and messages.
Migration
Import from other economy plugins or move between storage backends.
Addon API
Integrate with OpenEco directly from your own Bukkit plugin.
Why OpenEco?
Most economy plugins optimize for one of two extremes: a lightweight in-memory layer with minimal persistence, or a database-heavy design that trades latency for distribution. OpenEco targets the middle ground that fits most Paper servers:
- Fast local reads and writes through an in-memory account registry.
- Reliable persistence via SQLite, H2, MySQL, MariaDB, or PostgreSQL.
- Optional proxy-assisted handoff when you need player transfers across backends — not real-time global replication.
If you need a distributed ledger or live balance broadcasts to every backend, OpenEco is not the right tool. See the Production guide for fit guidance.
Requirements
- Paper 1.20.5+ or Folia 1.21+
- Java 21
- Vault or VaultUnlocked
- PlaceholderAPI (optional)
