Coffers Paper v0.1.0 - Foundation Release

Coffers v0.1.0

Welcome to the first foundation release of Coffers.

Coffers is a modern, from-scratch economy platform for Minecraft servers, designed to give server owners a cleaner path forward than older economy setups while still preserving the compatibility many servers still need today.

This release includes both the modern Coffers line and the new Coffers Legacy line for older server environments.

✨ Highlights

• 💾 Flexible storage support
  Choose between YAML, SQLite, or MySQL depending on your server’s size and requirements.

• 🔌 Optional Vault compatibility
  Coffers can run fully standalone, while still supporting Vault as a compatibility layer for older plugins that require it.

• 💰 Configurable currencies
  Define your own currencies, symbols, names, starting balances, and formatting rules.

• 📜 Transaction history and audit metadata
  Track balance changes with richer records for administration, debugging, and auditing.

• 🔄 Vault migration helpers
  Import balances from existing Vault-backed economy providers already in use on your server.

• 🧩 Developer-ready API
  Coffers includes an expanded API for future plugin-to-plugin integrations.

• 🏛 Legacy server support
  This release includes Coffers Legacy for older Bukkit, Spigot, Paper, and similar legacy-oriented server setups.

• ✅ Improved stability and validation
  Startup validation, safer command handling, and automated test coverage were added to improve reliability across the API, modern line, and legacy line.

🛠 Included Commands

Modern Coffers

• /coffers balance [player] [currency]
• /coffers pay <player> <amount> [currency]
• /coffers set <player> <amount> [currency]
• /coffers history [player] [limit]
• /coffers currencies
• /coffers migratevault [provider]

Coffers Legacy

• /cofferslegacy balance [player] [currency]
• /cofferslegacy pay <player> <amount> [currency]
• /cofferslegacy set <player> <amount> [currency]
• /cofferslegacy history [player] [limit]
• /cofferslegacy currencies
• /cofferslegacy migratevault [provider]

📦 What To Download

For modern server owners

• Coffers.jar
• Recommended for servers running Java 17 or newer

For older legacy-oriented server owners

• Coffers-Legacy.jar
• Intended for legacy Bukkit-family server setups
• Built for Java 16 compatibility
• If your server is already running Java 17+, use the modern Coffers.jar instead

For developers

• Coffers-API.jar

🗄 Storage Options

• 🟢 yaml — simple and lightweight for smaller servers
• 🔵 sqlite — persistent local database storage for single-server setups
• 🟣 mysql — shared database support for larger or networked deployments

These storage options are available in both the modern Coffers line and the legacy line.

🛡 Recent Stability Improvements

This release also includes a reliability pass across the project:

• startup validation now checks that the configured default currency actually exists
• invalid command input now returns cleaner messages instead of bubbling errors
• self-balance currency handling was improved for both modern and legacy commands
• Vault is no longer required for Coffers to load and run
• Coffers now uses Vault only as an optional compatibility layer when older plugins still depend on it
• automated tests were added for API defaults, modern economy service behavior, and legacy economy service behavior
• verified successfully with mvn clean test package

🚀 Why This Release Matters

This release turns Coffers from an early concept into a real foundation for modern and legacy Minecraft economy systems.

It lays the groundwork for:

• better long-term maintainability
• cleaner integrations
• richer economy features
• easier migration away from Vault-dependent setups
• support for both modern and older server environments under the same Coffers project

❤️ Thank You

Thank you for checking out Coffers and being part of the beginning of this project.

This is only the start.