DZEconomy - Advanced Multi-Currency Economy Plugin

Transform your server's economy with a professional-grade, multi-currency system designed for modern PaperMC servers (1.21.1).

Whether you're running an RPG server, PvP network, or trading hub, DZEconomy provides the sophisticated economic foundation your server needs.

---

Multi-Currency System

Three fully independent currencies working in perfect harmony:

• 💰 Money - Primary currency for everyday transactions and trading
• 🪙 MobCoin - Combat-focused currency earned through PvE activities
• 💎 Gems - Premium currency for high-value transactions and exclusive items

Each currency maintains its own balance system, commands, and economic rules while allowing seamless conversions between them.

---

Core Features

Rank-Based Progression

Deep LuckPerms integration creates tiered economic systems where higher-ranked players enjoy:

• Increased transaction limits
• Reduced taxes on transfers
• Shorter cooldowns between transactions
• Special currency bonuses and perks

Player Interactions

Comprehensive transaction system beyond simple payments:

• Send funds directly to other players
• Request payments with accept/deny functionality
• Secure transactions with configurable cooldowns and limits
• Full transaction logging for administrative oversight

PvP Economy

High-stakes combat mechanics:

• Players drop all currencies on death
• Victors receive the spoils directly
• Creates intense PvP encounters
• Fully configurable for different game modes

PvE Rewards

Transform mob hunting into profitable gameplay:

• Custom MobCoin rewards for every mob type
• Special bonuses for boss mobs
• Configurable reward rates in mob-rewards.yml
• Encourages diverse gameplay activities

---

Integrations

PlaceholderAPI Support

Display economic information anywhere with comprehensive placeholders:

• %dz_money%, %dz_mobcoin%, %dz_gem% - Currency balances
• %dz_rank% - Player's economic rank
• Perfect for scoreboards, chat formatting, and GUI displays

Developer API

Build upon DZEconomy with our full asynchronous API:

// Easy integration for other plugins
EconomyService economy = Bukkit.getServicesManager()
    .getRegistration(EconomyService.class).getProvider();

// Perform async transactions
economy.depositAsync(playerUUID, CurrencyType.MONEY, amount, "Quest Reward")
    .thenAccept(result -> {
        if (result.isSuccess()) {
            // Handle success
        }
    });

---

Configuration

Extensive Customization Options

• config.yml - Currency settings, conversion rates, database configuration
• ranks.yml - Rank-based limits, taxes, cooldowns, and bonuses
• mob-rewards.yml - Mob-specific rewards and bonus configurations
• messages.yml - Fully customizable messages with color codes

Flexible Storage

Choose the database backend that fits your infrastructure:

• YAML flat-file storage for smaller servers
• MySQL support for large networks and cross-server synchronization
• Full async operations for optimal performance

---

Commands

Player Commands

Intuitive command structure for all three currencies:

• /money balance|send|request|accept|deny - Manage Money currency
• /mobcoin balance|send|request|accept|deny - Handle MobCoin transactions
• /gem balance|send|request|accept|deny - Control Gem currency
• /economy <from> <to> <amount> - Convert between currencies

Admin Commands

• /dzeconomy reload - Reload configuration files
• /dzeconomy debug - Enable debug logging
• /dzeconomy add <player> <currency> <amount> - Add currency to players

---

Quick Start

Installation

1. Download DZEconomy.jar from Modrinth
2. Place in your server's plugins/ folder
3. Restart your server
4. Configure the YAML files to match your server's needs
5. (Optional) Install PlaceholderAPI and LuckPerms for full functionality

Basic Setup

After first run, customize these files:

• Currency names and symbols in config.yml
• Rank benefits and limits in ranks.yml
• Mob rewards in mob-rewards.yml
• Server messages in messages.yml

---

Use Cases

Perfect for various server types:

• RPG Servers - Use different currencies for combat, trading, and premium content
• PvP Networks - High-stakes economy with full currency drops on death
• Minigame Networks - Reward players across different game modes
• Survival Economies - Create complex trading systems with currency conversion
• Hybrid Servers - Support multiple gameplay styles within one economic framework

---

Technical Excellence

Built for Production

Reliable, performant, and secure:

• Full async operations to prevent server lag
• Comprehensive error handling and logging
• SQL injection protection and secure coding practices
• Regular updates and active maintenance
• Thoroughly tested on PaperMC 1.21.1

Security & Permissions

Comprehensive permission system:

• dzeconomy.default - Basic player permissions
• dzeconomy.add - Add currency to players (admin)
• dzeconomy.admin - Full administrative access
• Rank-specific permissions via LuckPerms integration

---

Why Choose DZEconomy?

Unlike basic economy plugins, DZEconomy provides:

• 👉🏻 True multi-currency support with independent economies
• 👉🏻 Deep LuckPerms integration for progressive economic systems
• 👉🏻 Comprehensive PvP and PvE economic integration
• 👉🏻 Full async API for developers
• 👉🏻 Extensive customization options
• 👉🏻 Active development with responsive support

---

Support & Community

Need help? Have suggestions?

• Report bugs and request features on GitHub
• Regular updates with new features and improvements
• Active development with community-driven enhancements

---

Transform your server's economy today with DZEconomy - the professional-grade economic solution for modern Minecraft servers.

---

A DemonZ Development Plugin
The second plugin from DemonZ Development

---

Requirements

• Server Software: PaperMC 1.21.1 or compatible
• Java Version: Java 21+
• Optional Dependencies: PlaceholderAPI, LuckPerms