NewEconomy

A complete, modern, and highly configurable economy plugin for Minecraft Paper 1.21+ servers, built with performance, scalability, and integration in mind. Fully compatible with the Vault API and featuring native Discord integration for cross-platform economy management.

---

🔗 Discord Integration

Seamlessly connect your Minecraft economy with Discord.

• /discord link — Generate a secure code to link your Discord account
• /discord unlink — Unlink your Discord account
• Discord Bot Command: /pay @User <amount> — Send money directly from Discord
• Automatic Sync: Payments and balances are always linked to the player’s Minecraft account
• Auto-link Authentication: Fast and secure account linking through the Discord bot

---

✨ Features

💰 Base Economy System

• Full Vault API compatibility
• Clean and modern visual messages with colors and formatting
• Fully localized commands and messages
• Granular and permission-based access control
• JSON data storage with asynchronous saving
• Custom events for easy integration with other plugins
• Built-in Discord account linking system

---

🚀 Advanced Economy Systems

• 🏦 Bank system with configurable daily interest
• 💳 Loan system with installments and limits
• 🎁 Daily rewards with streak bonuses
• 🏆 Achievement system with configurable prizes
• 📊 Complete transaction history
• 🤝 Player-to-player payment requests
• 💬 Discord Payments: send money using /pay @User directly from Discord
• 🔄 Automatic sync between Discord and Minecraft accounts

---

📋 Requirements

• Minecraft: 1.21+
• Server Software: Paper (recommended)
• Java: 21+
• Dependencies: Vault (optional, for integration)
• Discord Bot: Optional (required for Discord payments and account linking)

---

🧾 Commands

🔹 Basic Commands

• /saldo — View your balance
• /saldo <player> — View another player's balance
• /pagar <player> <amount> — Send money
• /economia — Main help menu
• /economia top — Richest players ranking
• /economia stats — Server economy statistics

---

🏦 Banking System

• /banco — Bank menu
• /banco depositar <amount> — Deposit money
• /banco sacar <amount> — Withdraw money
• /banco saldo — View bank balance
• /banco info — View interest details

---

💳 Loan System

• /emprestimo — Loan menu
• /emprestimo pegar <amount> — Request a loan
• /emprestimo pagar <amount> — Pay an installment
• /emprestimo info — View loan details

---

🎁 Rewards & Achievements

• /diario — Claim daily reward
• /conquistas — View achievements

---

📜 History & Requests

• /historico [page] — View transaction history
• /solicitar <player> <amount> [reason] — Request a payment
• /solicitar aceitar <player> — Accept a request
• /solicitar recusar <player> — Decline a request

---

🛠 Administrative Commands

• /ecoadmin give <player> <amount> — Give money
• /ecoadmin remove <player> <amount> — Remove money
• /ecoadmin set <player> <amount> — Set balance
• /ecoadmin reset <player> — Reset player account
• /ecoadmin reload — Reload configuration

---

🔐 Permissions

Basic

• neweconomy.use — Use basic commands
• neweconomy.balance — View own balance
• neweconomy.balance.others — View others' balance
• neweconomy.pay — Send money

Systems

• neweconomy.bank — Bank access
• neweconomy.loan — Loan access
• neweconomy.daily — Daily rewards
• neweconomy.achievements — Achievements
• neweconomy.history — Transaction history
• neweconomy.request — Payment requests
• neweconomy.discord — Discord account linking
• neweconomy.discord.pay — Discord payment commands

Admin

• neweconomy.admin — Administrative access
• neweconomy.* — Full access

---

⚙️ Configuration

The config.yml allows full customization:

Base Settings

• Currency name and symbol
• Starting balance
• Transfer limits
• Optional transaction fees
• Auto-save interval

Optional Systems

• Enable or disable each feature
• Bank interest rates
• Loan limits and rules
• Daily reward values
• Achievements and rewards
• Payment request expiration

Discord Integration

• Bot token
• Command prefix
• Auto-link options
• Mention payment behavior
• Sync mode between Discord and Minecraft

Messages

• Fully customizable messages
• Minecraft color codes supported
• Dynamic placeholders

---

📄 License

This plugin is distributed under the MIT License.