# DZEconomy v2.1.2 Stability release. The jar now runs on almost any server: Java 8 and up, Minecraft 1.9 through 1.26.x. This update also fixes a pile of broken messages and config wiring that shipped in earlier builds. ## What changed ### Broader compatibility - Runs on Minecraft 1.9–1.26.x thanks to a feature adapter that picks the right API for each server version. - Drops the Java 21 requirement. The jar compiles to Java 8 bytecode and loads on any server from Java 8 up. ### New command - `/economy give <player> <amount> [currency]` — credit any currency from console or chat. Defaults to Money; `mobcoin(s)` and `gem(s)` work too. ### Things that were broken and now work - **Starting balance never applied.** New players now get their configured starting balance on first join. - **"Message not found".** Around twenty messages pointed to `messages.yml` keys that didn't exist. Welcome, PvP, payall, convert, and reload messages render properly now. - **Transfer limits and cooldowns did nothing.** `send`/`request`/`accept` now honor `max-transaction`, daily limits, cooldowns, `allow-self-transfer`, and combat tag blocking. `/money accept` enforces the same limits as a normal send. - **Relogging reset cooldowns and daily limits.** They now persist across restarts. - **PvP loot wiped 100% of a victim's balance.** The death listener read config keys that didn't exist. It now respects `pvp.loss-percent`, `minimum-balance`, broadcasts, and world blacklists. - **Leaderboards showed stale balances.** Baltop now reflects live cached balances. - **PvP kill message reported the wrong amount.** It shows the net credited after tax. - **`{killer}`, `{victim}`, `{mob}`, `{symbol}`, `{timeout}` printed literally.** They now resolve to real values. - **Convert confirmation showed the wrong amount.** It now reports what the player actually got after rates and fees. - **Daily reset wiped lifetime stats.** Daily resets only clear daily counters now. - **SQLite backups could be torn.** A WAL checkpoint runs before backing up. - **Migration could report success when it failed.** Failures are now counted, reported, and abort if a backend can't initialize. - **Version comparison was wrong.** `1.0-rc10` now sorts above `1.0-rc9`. ### Cleanup - Removed dead code: unused update tasks, the request GUI, an unused transaction log entry, and unused methods. - Removed dead config keys so existing installs stop chasing phantom settings. ## Install 1. Download `DZEconomy-2.1.2.jar` 2. Stop the server, drop it in `plugins/`, start the server 3. Run `/economy reload` if you already had a config Compatible with the existing `config.yml`, `messages.yml`, `ranks.yml`, and `mob-rewards.yml` from 2.1.0 and 2.1.1. ## Requirements Java 8+, Minecraft 1.9+, Bukkit/Spigot/Paper/Folia/Purpur. ## Links - Wiki: https://github.com/DemonZ-Development/DZEconomy/wiki - Issues: https://github.com/DemonZ-Development/DZEconomy/issues - Discord: https://discord.com/invite/GYsTt96ypf

**Full Changelog**: https://github.com/DemonZ-Development/DZEconomy/compare/v2.1.0...v2.1.1

## [2.1.0] — 2026-05-28 ### Added - **Server Adapter System** — Version detection and platform-specific behavior via `ServerAdapter` interface - **LegacyServerAdapter** — Explicit `Class.forName()` SQLite driver loading for Java 8-16 (fixes "No suitable driver found" on older servers) - **ModernServerAdapter** — SPI-based driver discovery with `Class.forName()` fallback for Java 17+ - **ServerAdapterProvider** — Automatic Java version detection and adapter selection - **SLF4J Shading** — Relocated to prevent runtime linkage conflicts with other plugins - **FoliaAdapter migration** — `MigrationManager` now uses `FoliaAdapter` instead of direct `Bukkit.getScheduler()` ### Fixed - **SQLite JDBC driver not loading** on legacy Paper/Spigot servers (classloader SPI issue) - **EntityDeathListener dead code** — `requirePlayerKill=false` setting had no effect due to redundant null check - **Java 14 switch expression** replaced with traditional switch for broader compatibility - **Shading gaps** — SLF4J, CheckerFramework, and ErrorProne now properly relocated - **Stale module-info.class** excluded from JAR - **Stale native-image.properties** excluded from JAR - **Empty META-INF/versions/9/org/ directories** cleaned from JAR - **ServerAdapterProvider null safety** — robust handling of edge cases in version detection

# 🚀 DZEconomy v2.0.0 — The Ultimate Performance & Folia Rewrite We are thrilled to present **DZEconomy v2.0.0**, a ground-up architectural rewrite of the plugin. DZEconomy has been completely overhauled to deliver elite performance, full thread-safety, 100% Folia compatibility, and a premium multi-currency economy experience for modern Minecraft servers. --- ## ✨ Key Features & Enhancements ### 1. 🪙 Multi-Currency Architecture * **Three Independent Currencies**: Built-in support for **Money ($)**, **MobCoins (★)**, and **Gems (◆)**. * **Custom Formatting & Limits**: Define custom decimal places, starting/max balances, display symbols, and transaction bounds per currency. * **Currency Conversion**: Convert seamlessly between currencies via `/economy convert` with configurable conversion rates and customizable transaction fees. ### 2. ⚡ Elite Performance & Storage Scaling * **In-Memory Balance Cache**: Completely eliminated flat-file O(N) directory scans for `/baltop` leaderboards. Caching layer is maintained in real-time. * **Robust Database Backends**: Supporting flat files, connection-pooled **MySQL (via HikariCP)**, and connection-optimized **SQLite** (using Connection WAL mode and automatic `PRAGMA` sync flushes to prevent concurrency locks). * **Live Storage Migration**: High-speed, seamless data migration between storage backends using `/economy migrate` (with automated pre-migration safety backups). ### 3. 🌿 100% Folia & Paper Compatibility * **Asynchronous Execution & Scheduling**: Fully compliant with Folia's region-based multithreaded scheduler. All operations (auto-saves, update checking, database queries) are delegated to async/region context wrappers. * **Memory & Classloader Leak Prevention**: Safe integration closures for PlaceholderAPI and LuckPerms prevent memory leaks on server reloads/plugin disable. ### 4. ⚔️ PvP Loot & Combat Tag Integration * **PvP Loss Percentages**: Configurable balance drops/steals upon player deaths with minimum safe retain thresholds. * **Active Combat Tagging**: Prevents economic evasion or money transfers during PvP combat using a smooth Action Bar countdown timer. ### 5. 🎯 Extensible Integrations & APIs * **Advanced PlaceholderAPI**: High-speed Cached placeholders for balances, limits, and ranks. * **LuckPerms Rank Multipliers**: Dynamically apply multipliers to Mob Rewards based on LuckPerms groups. * **Public Developer API**: `DZEconomyAPI` registered in Bukkit's `ServicesManager` for robust third-party plugin integrations. --- ## 📋 Changelog For the complete list of changes, please refer to the [CHANGELOG.md](https://github.com/DemonZ-Development/DZEconomy/blob/main/CHANGELOG.md).

## 🚀 DZEconomy v1.2.0 — Organized. Integrated. Polished. #### ✨ What this version adds #### 🏗️ Restructured internal packages for improved maintainability and clarity — API and implementation layers are now cleanly separated. #### 📦 JitPack support: DZEconomy can now be added as a Maven dependency instead of manual JAR installations. #### 🔌 Refactored and enhanced API: plugin hooking and third-party integrations are smoother and easier to use. #### ⚙️ Runtime enhancements: automatic update checker; optional “auto-update disable” feature for server owners who prefer manual control; suppression of PvP/PvE money-request GUI pop-ups to avoid combat interruptions; general visual polish and minor performance tweaks. #### 🧩 Developer-friendly: easier to build upon, extend, and maintain for plugin authors. #### 🎯 Why you should download it If you run a Minecraft server or develop plugins and you’re using DZEconomy, this upgrade will reduce headaches, improve integration into your ecosystem, and deliver a cleaner experience for your users or co-developers. #### 🔍 Important upgrade notes Check compatibility: If you’ve made custom extensions or hooks into the previous API, you may need to adjust your code due to the refactoring. Backup your data before upgrading: Always a smart move when changing core systems. Read the API changes in the documentation to smoothly transition any dependent plugins. --- **Thanks for using DZEconomy. Your feedback keeps the plugin evolving.** ---

## DZEconomy v1.1.1 - Performance & Updater Release **A production-ready multi-currency economy plugin for Paper/Spigot/Bukkit servers featuring Money, MobCoin, and Gems with rank-based limits, interactive GUIs, PVP transfers, and comprehensive API.** ### ✨ What's New **🔄 Auto-Updater System** - New `/dzeconomy update` command with modes: `version`, `previous`, `next`, `latest`, `auto` - Automatic version checking on server startup - Admin notifications when updates are available - Safe download workflow using GitHub Releases API - Configurable update notifications (`update-checker.enabled`, `notify-on-join`) **🏆 Credits Command** - New `/dzeconomy credits` command (admin-only) - Displays creator and ecosystem information - Fixed branding message (not configurable) ### 🛠️ Improvements **⚡ Performance Overhaul** - Fully restructured async architecture for non-blocking operations - Intelligent caching system for balances, ranks, and PlaceholderAPI results - Optimized event handlers to reduce tick impact - Minimized object creation and GC pressure - Connection pooling improvements for MySQL/SQLite backends **💬 Enhanced Messaging** - Refined command help menus and error messages - Clearer update availability notifications - Improved formatting consistency across all outputs - Better admin feedback for update operations **🗄️ Database Reliability** - Hardened error handling across FlatFile/SQLite/MySQL storage - Improved lifecycle cleanup and connection management - Better edge-case handling for concurrent operations - Enhanced transaction safety ### 🐛 Bug Fixes - Fixed edge cases in request acceptance/denial flow - Resolved currency conversion rounding inconsistencies - Corrected PVP transfer edge cases - Improved GUI interaction timing issues - Database connection leak prevention ### 🔧 Technical Details **Compatibility & Requirements** - **Minecraft:** 1.21.1 - **Server:** Paper, Spigot, Bukkit, Purpur - **Java:** 21 - **Dependencies:** - LuckPerms (optional) - PlaceholderAPI (optional) **No Breaking Changes** - All configuration keys preserved - Command names and permissions unchanged - PlaceholderAPI placeholders remain identical - Public API contracts maintained - Drop-in replacement for v1.0.0 ### 📋 Full Feature Set **💰 Core Systems** - Three-currency economy: Money ($), MobCoin (MC), Gems (◆) - Rank-based tax rates, cooldowns, and daily limits via LuckPerms - Interactive request GUI with real-time countdown - Bidirectional currency conversion system - PVP death transfers for all currencies - Mob kill reward system with boss bonuses **💾 Storage Options** - FlatFile (YAML) - Default - SQLite - Local database - MySQL - Remote with HikariCP pooling **🔌 Integration** - Complete PlaceholderAPI support (9 placeholders) - Public API for third-party plugin development - Full Bukkit ServicesManager integration **⚙️ Configuration** - 4 YAML files: config.yml, ranks.yml, mob-rewards.yml, messages.yml - Unlimited custom ranks with per-currency settings - Fully customizable messages with color codes - Flexible mob reward categories ### 📦 Installation 1. Download DZEconomy-1.1.1.jar 2. Place in `plugins/` folder 3. Install LuckPerms (required) 4. Optionally install PlaceholderAPI 5. Restart server 6. Configure in `plugins/DZEconomy/`

# DZEconomy v1.0.0 - Initial Release 🎉 **We're excited to present DZEconomy, a comprehensive multi-currency economy system designed for modern PaperMC servers! This initial release brings a fully-featured economy framework to your server.** ## ✨ What's New in v1.0.0 ## Core Features Implemented: - ✅ Three Independent Currency Systems: Money, MobCoin, and Gems - ✅ Complete Transaction Framework: Send, request, accept/deny payments - ✅ Rank-Based Economy System: Deep LuckPerms integration for tiered benefits - ✅ Currency Exchange System: Convert between currencies with configurable rates - ✅ Mob Reward System: Earn MobCoins from killing mobs with special boss bonuses - ✅ Full PvP Economy: All currencies transfer on player death - ✅ PlaceholderAPI Integration: Display balances anywhere with custom placeholders - ✅ Dual Storage Support: MySQL and flat-file YAML storage options - ✅ Comprehensive Admin Commands: Full control over the economy system ## Command Systems: - /money - Complete money management commands - /mobcoin - MobCoin-specific commands - gemm - Gem currency commands - /economy - Currency conversion system - /dzeconomy - Administrative controls ## Technical Implementation: - 🔧 Full Async API for third-party plugin development - 🔧 Configurable cooldowns & limits per rank - 🔧 Customizable messages with color code support - 🔧 Tax system for economic balance - 🔧 Permission-based access control ## Configuration Files: - config.yml - Main configuration and currency settings - ranks.yml-- Rank-based limits and bonuses - mob-rewards.yml - Mob killing rewards system - messages.yml - Fully customizable messages ## 🚀 Getting Started 1. Download the plugin and place it in your plugins/ folder 2. Restart your server to generate configuration files 3. Configure currencies, ranks, and rewards to match your server's needs 4. Install PlaceholderAPI and LuckPerms for full functionality 5. Enjoy your new multi-currency economy system! ## 📝 Notes for Server Owners - This is the first stable release of DZEconomy - All features have been thoroughly tested on PaperMC 1.21.1 - Configuration files will be generated automatically on first run - The plugin includes comprehensive documentation in the README ## 🔮 Coming Soon **Based on community feedback, we plan to add:** - More currency types - Advanced shop integration - Quest and achievement hooks - Graphical user interfaces (GUIs) ## 🐛 Reporting Issues **Found a bug or have a suggestion? Please report it on our GitHub repository to help improve DZEconomy!** --- **Thank you for choosing DZEconomy as your server's economy solution! We're excited to see how you'll use these features to create amazing experiences for your players. 🎊** --- _A DemonZ Development plugin._ _The second plugin of DemonZ Development._