DZEconomy is a feature-rich, high-performance economy plugin built for Paper 1.16+ servers. It provides three fully independent currency systems, LuckPerms rank integration, combat tagging, mob rewards, and a powerful developer API — all in one lightweight plugin.
| Category | Feature | Description |
|---|---|---|
| 💰 | Triple Currency System | Money, MobCoins, and Gems — each independent with custom formatting, limits, and settings |
| 🏅 | LuckPerms Rank Integration | Per-rank balance caps, tax rates, and reward multipliers |
| ⚔️ | Combat Tag System | Block economy actions during PvP to prevent abuse |
| 🐾 | Mob Rewards | Per-mob currency drops with spawner detection |
| 🔄 | Currency Conversion | Configurable conversion paths with rates, fees, and cooldowns |
| 💾 | Multi-Backend Storage | SQLite (default), MySQL, and FlatFile with built-in migration |
| 🔌 | Developer API | Full API with events, async support, and batch operations |
| 🚀 | High Performance | Async operations, intelligent caching, and batch writes |
| 🌍 | Fully Configurable | MiniMessage formatting, customizable messages, and modular config |
| 🔢 | PlaceholderAPI | Placeholders for all balances and rank info |
| 📝 | Transaction Logging | CSV/JSON audit logs with rotation |
| 🌿 | Folia Compatible | Full region-based scheduling support out of the box |
- Download the latest release from Modrinth or GitHub Releases
- Place
DZEconomy-2.1.0.jarin your server'splugins/folder - Restart your server
- Configure
config.ymlto your liking (defaults work great!) - Done! ✅ Players now have balances for all three currencies
| Requirement | Minimum | Recommended |
|---|---|---|
| Server Software | Paper 1.16 | Paper 1.21+ |
| Java | 21 | 21 (latest) |
| LuckPerms | Optional | ✅ Recommended |
| PlaceholderAPI | Optional | ✅ Recommended |
⚠️ Note: DZEconomy supports Bukkit, Spigot, Paper, Folia, and Purpur. See the Installation Wiki for details.
| Command | Description |
|---|---|
/money |
Check your money balance |
/money send <player> <amount> |
Send money to another player |
/money top |
View money leaderboard |
/mobcoin |
Check your MobCoin balance |
/mobcoin send <player> <amount> |
Send MobCoins to another player |
/mobcoin top |
View MobCoin leaderboard |
/gem |
Check your Gem balance |
/gem send <player> <amount> |
Send Gems to another player |
/gem top |
View Gem leaderboard |
/economy convert <player> <from> <to> <amount> |
Convert between currencies |
| Command | Description |
|---|---|
/economy reload |
Reload all configuration files |
/economy status |
View plugin status and statistics |
/economy migrate <from> <to> |
Migrate between storage backends |
/money add <player> <amount> |
Give money to a player |
/money remove <player> <amount> |
Take money from a player |
/money set <player> <amount> |
Set a player's money balance |
/mobcoin add/remove/set <player> <amount> |
Manage MobCoin balances |
/gem add/remove/set <player> <amount> |
Manage Gem balances |
📖 See the Commands Wiki for the complete reference.
# config.yml — Core settings
currencies:
money:
enabled: true
symbol: "$"
starting-balance: 500.0
decimal-places: 2
supports-decimals: true
player-pay: true
mobcoin:
enabled: true
symbol: "★"
starting-balance: 0
decimal-places: 0
supports-decimals: false
player-pay: true
gem:
enabled: true
symbol: "◆"
starting-balance: 0
decimal-places: 0
supports-decimals: false
player-pay: true
storage:
backend: sqlite # sqlite, mysql, or flatfile
save-interval: 60
cache-size: 1000
combat-tag:
enabled: true
duration: 15
blocked-actions:
- send
- request
- accept
ranks:
provider: luckperms
tax:
enabled: true
default-rate: 0
destination: server📖 See the Configuration Wiki for every option explained.
Hook into DZEconomy from your own plugins with a clean, type-safe API.
<repository>
<id>jitpack</id>
<url>https://jitpack.io/</url>
</repository>
<dependency>
<groupId>com.github.DemonZ-Development</groupId>
<artifactId>DZEconomy</artifactId>
<version>2.1.0</version>
<scope>provided</scope>
</dependency>repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
compileOnly 'com.github.DemonZ-Development:DZEconomy:2.1.0'
}// Get the DZEconomy plugin instance
DZEconomy dzeconomy = (DZEconomy) Bukkit.getPluginManager().getPlugin("DZEconomy");
DZEconomyAPI economy = dzeconomy.getAPI();
// Check a player's balance
double balance = economy.getBalance(player.getUniqueId(), CurrencyType.MONEY);
// Add MobCoins
economy.addCurrency(player.getUniqueId(), CurrencyType.MOBCOIN, 50);
// Check if a player can afford something
if (economy.hasBalance(player.getUniqueId(), CurrencyType.GEM, 100)) {
economy.removeCurrency(player.getUniqueId(), CurrencyType.GEM, 100);
// Give the item...
}📖 See the API Wiki for the complete API reference.
- Java 21 (JDK)
- Git
# Clone the repository
git clone https://github.com/DemonZ-Development/DZEconomy.git
cd DZEconomy
# Build with Gradle
./gradlew shadowJar
# The JAR will be in build/libs/
ls build/libs/DZEconomy-2.1.0.jar# Run tests
./gradlew test
# Build without tests (faster)
./gradlew shadowJar -x testContributions are welcome! Please read our Contributing Guide before submitting.
- Fork the repository
- Create a feature branch:
git checkout -b feature/my-feature - Commit your changes:
git commit -m "Add my feature" - Push to the branch:
git push origin feature/my-feature - Open a Pull Request
Found a bug? Please open an issue with:
- Server software and version (e.g., Paper 1.21.4)
- DZEconomy version
- Steps to reproduce
- Expected vs. actual behavior
- Relevant console logs / stack traces
DZEconomy is licensed under the GNU General Public License v3.0.
Copyright (C) 2025 DemonZ Development
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
See the LICENSE file for the full license text.
| Resource | URL |
|---|---|
| 📦 Modrinth | modrinth.com/plugin/dzeconomy |
| 💬 Discord | discord.com/invite/GYsTt96ypf |
| 📖 Wiki | github.com/DemonZ-Development/DZEconomy/wiki |
| 🐛 Issues | github.com/DemonZ-Development/DZEconomy/issues |
| 📦 Source | github.com/DemonZ-Development/DZEconomy |
| 🌐 Website | demonzdevelopment.online |
DZEconomy v2.1.0 — Made with ❤️ by DemonZ Development