RelishEconomy

<div align="center"> ## 🪙 Multi-Currency Economy • Shop • Sell GUI • Physical Currency • ATM • Natural Source Currency • Personal Vault ⭐ !(https://cdn.modrinth.com/data/cached_images/9df4655d0afd67ba097405f931695951fcb513f2_0.webp) (https://github.com/iM5LB/RelishEconomy/raw/main/docs/assets/M5LBStore.png)](https://m5lb.run.place/) (https://img.shields.io/badge/Discord-Support-7289da?style=for-the-badge&logo=discord)](https://discord.gg/hjKcHavRjT) (https://img.shields.io/badge/Docs-Read-blue?style=for-the-badge&logo=gitbook)](https://im5lb.github.io/relisheconomy) (https://img.shields.io/badge/🐛%20Issues-Report-orange?style=for-the-badge)](https://github.com/iM5LB/relisheconomy/issues) (https://img.shields.io/badge/Store-License%20Keys-gold?style=for-the-badge)](https://m5lb.run.place/) (https://img.shields.io/badge/💖%20Donate-Love-ff69b4?style=for-the-badge)](https://creators.sa/m5lb) </div> --- ## 🌟 **Why Choose RelishEconomy?** RelishEconomy provides a solid economy foundation with multi-currency support, database flexibility, and seamless plugin integrations. Built for modern Minecraft servers with performance and reliability in mind. ### ✨ **Key Highlights** 🏦 **Multi-Currency System** - Support for multiple custom currencies 🚀 **High Performance** - Advanced caching with Caffeine for fast operations 🔧 **Full Integration** - Vault and PlaceholderAPI support 🗄️ **Database Flexibility** - SQLite and MySQL support 🌍 **Multi-Language** - Built-in English, Arabic, and Portuguese translations --- ## 📋 **Requirements** | Component | Requirement | |-----------|-------------| | **Minecraft** | 1.21+ | | **Server** | Paper, Purpur, or Paper-based forks | | **Java** | 21+ | | **Soft Dependencies** | Vault (recommended), PlaceholderAPI (optional) | --- ## 🚀 **Features Overview** ### 🆓 **Free Version** - ✅ Basic economy commands (`/balance`, `/pay`, `/baltop`, `/eco`) - ✅ **Multi-currency system** with custom properties - ✅ Per-currency formatting, permissions, and decimal control - ✅ **Currency exchange** with per-currency exchange rates - ✅ Command-based selling (`/sellhand`, `/sellhotbar`, `/sellall`) - ✅ Sold-item hover breakdowns for sell commands - ✅ Baltop leaderboard placeholders and balance placeholders - ✅ Data migration from other plugins - ✅ Player username storage alongside UUID balances - ✅ Towny and Vault economy compatibility - ✅ Vault and PlaceholderAPI support - ✅ SQLite and MySQL support - ✅ Config validation, backup, and auto-recovery for bundled files ### ⭐ **Premium Version** - ⭐ **Shop GUI** with category browsing - ⭐ **Sell GUI** for item selling - ⭐ **Transaction Logs GUI** for sell history navigation - ⭐ **Block interactions** (shop/sell blocks) - ⭐ **GUI customization** and interactions - ⭐ **Physical currency withdraw and shift-deposit** - ⭐ **ATM GUI** for physical currency deposit and withdraw - ⭐ **Craftable physical currency with owner metadata** - ⭐ **Custom model data** support for physical currencies - ⭐ **Natural-source currency conversion** for configured item sources - ⭐ **Composter selling** — throw items on composter to sell them - ⭐ **Personal Vault** — password-protected physical currency storage block with hover hologram --- ## 📦 **Installation** 1. **Download** the plugin JAR file 2. **Place** it in your server's `plugins` folder 3. **Start/Restart** your server 4. **(Optional)** For premium features, buy a license key from (https://m5lb.run.place/) 5. **Place license key** in `config.yml` 6. **Reload** the plugin ```bash # Quick setup commands /re help # View all commands /re version # Check plugin status /re reload # Reload configuration ``` --- ## 🎮 **Commands & Usage** ### 👤 **Player Commands** | Command | Description | Example | |---------|-------------|---------| | `/balance ` | Check balance | `/bal coins` | | `/pay <player> <amount>` | Send money | `/pay Steve 100` | | `/baltop ` | View leaderboard | `/baltop dollars 2` | | `/currency <list\|info>` | View currencies | `/currency list` | | `/exchange <from> <to> <amount>` | Convert currencies | `/exchange dollars coins 500` | | `/shop` ⭐ | Open shop GUI | `/shop` | | `/shop help` ⭐ | Show shop help | `/shop help` | | `/sell ` ⭐ | Open sell GUI | `/sell price` | | `/re atm` ⭐ | Open ATM GUI | `/re atm` | | `/sellhand` | Sell item in hand | `/sellhand` | | `/sellhotbar` | Sell hotbar items | `/sellhotbar` | | `/sellall` | Sell all items | `/sellall confirm` | | `/withdraw <currency> <amount>` ⭐ | Get physical currency | `/withdraw coins 10` | ### 👑 **Admin Commands** | Command | Description | Example | |---------|-------------|---------| | `/eco <give\|take\|set> <player\|all\|online> <amount>` | Manage balances | `/eco give Steve 1000` | | `/eco clear <player\|all\|online>