💰 P_Economia

Plugin de Economia para Minecraft

P_Economia é um plugin robusto para servidores Minecraft que implementa um sistema de economia com múltiplas moedas, rankings dinâmicos, menus interativos, integração com Vault e PlaceholderAPI, cheques e displays de holograma.
Foi desenvolvido com foco em performance, personalização e escalabilidade, ideal para servidores que buscam uma economia avançada.

---

🚀 Funcionalidades

✅ Múltiplas Moedas – totalmente configuráveis (nome, símbolo, saldo inicial, tags de magnata).
📊 Rankings Dinâmicos – atualização automática, com hologramas e armor stands.
🔗 Integração com Vault – compatibilidade com outros plugins de economia.
🔧 Integração com PlaceholderAPI – placeholders personalizáveis para chats, scoreboards e mais.
🖥️ Menus Interativos – GUI para saldo, preferências, histórico e configurações.
📄 Sistema de Cheques – crie e resgate cheques físicos com valores em moedas.
💬 Mensagens Personalizáveis – suporte a chat, action bar e títulos (ativáveis/desativáveis por jogador).
👤 Skins Personalizadas – compatível com SkinsRestorer para exibir skins nos rankings.
🗄️ Banco de Dados – armazenamento persistente de saldos, transações e configs.

---

📦 Requisitos

• ⚡ Vault (opcional, mas recomendado)
• 📜 PlaceholderAPI (para placeholders personalizados)
• 🎭 SkinsRestorer (para skins em displays de ranking)

---

⚙️ Configuração

Arquivos gerados automaticamente em:
/plugins/P_Economy/

• config.yml → Configurações gerais.
• currencies.yml → Definição das moedas.
• commands.yml → Configuração de comandos.
• menus.yml → Configuração dos menus interativos.
• Idiomas/pt_br.yml e Idiomas/en_us.yml → Traduções e mensagens.

---

⌨️ Comandos Principais

Comando	Descrição	Permissão
/economia saldo [moeda]	Exibe o saldo do jogador.	peconomy.use
/economia top [moeda]	Mostra o top 10 jogadores.	peconomy.use
/economia toggle [moeda]	Ativa/desativa recebimento.	peconomy.use
/economia transacoes [moeda]	Histórico de transações.	peconomy.use
/economia message_prefs	Menu de preferências de mensagens.	peconomy.use
/economia cheque <valor> <moeda>	Cria um cheque.	peconomy.cheque
/economia reload	Recarrega configs.	peconomy.admin
/economia add/remove/set	Gerencia saldo de jogadores.	peconomy.admin

---

🔑 Permissões

• peconomy.use → Comandos básicos.
• peconomy.admin → Comandos administrativos.
• peconomy.cheque → Criar/resgatar cheques.
• peconomy.customcommands → Executar comandos personalizados nos menus.

---

🪄 Placeholders (PlaceholderAPI)

%peconomy_balance_<moeda>%       → "$100.00"
%peconomy_magnata_<moeda>%       → "[Magnata]"
%peconomy_toggle_<moeda>%        → "Enabled/Disabled"
%peconomy_actionbar%             → "Enabled/Disabled"
%peconomy_title%                 → "Enabled/Disabled"
%peconomy_lasttransaction_<moeda>% → "ADD $50 Mr_Haruki"
%peconomy_top_<moeda>_<posição>_<tipo>%

# 💰 P_Economia  
Economy Plugin for **Minecraft**

**P_Economia** is a robust plugin for Minecraft servers that implements an economy system **with multiple currencies, dynamic leaderboards, interactive menus, Vault and PlaceholderAPI integration, checks, and hologram displays**.  
It was developed with a focus on **performance, customization, and scalability**, making it ideal for servers looking for an advanced economy system.  

---

## 🚀 Features

✅ **Multiple Currencies** – fully configurable (name, symbol, starting balance, magnate tags).  
📊 **Dynamic Leaderboards** – automatic updates, with holograms and armor stands.  
🔗 **Vault Integration** – compatibility with other economy plugins.  
🔧 **PlaceholderAPI Integration** – customizable placeholders for chats, scoreboards, and more.  
🖥️ **Interactive Menus** – GUI for balance, preferences, history, and settings.  
📄 **Check System** – create and redeem physical checks with currency values.  
💬 **Customizable Messages** – support for chat, action bar, and titles (enable/disable per player).  
👤 **Custom Skins** – compatible with SkinsRestorer to display skins on leaderboards.  
🗄️ **Database** – persistent storage of balances, transactions, and configs.  

---

## 📦 Requirements

- ⚡ **Vault** *(optional, but recommended)*  
- 📜 **PlaceholderAPI** *(for custom placeholders)*  
- 🎭 **SkinsRestorer** *(for leaderboard display skins)*  

---

## ⚙️ Configuration

Files are automatically generated in:  
`/plugins/P_Economy/`

- `config.yml` → General settings.  
- `currencies.yml` → Currency definitions.  
- `commands.yml` → Command configuration.  
- `menus.yml` → Interactive menu configuration.  
- `Languages/pt_br.yml` and `Languages/en_us.yml` → Translations and messages.  

---

## ⌨️ Main Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/economy balance [currency]` | Displays the player’s balance. | `peconomy.use` |
| `/economy top [currency]` | Shows the top 10 players. | `peconomy.use` |
| `/economy toggle [currency]` | Enables/disables receiving. | `peconomy.use` |
| `/economy transactions [currency]` | Transaction history. | `peconomy.use` |
| `/economy message_prefs` | Message preferences menu. | `peconomy.use` |
| `/economy check <amount> <currency>` | Creates a check. | `peconomy.cheque` |
| `/economy reload` | Reloads configs. | `peconomy.admin` |
| `/economy add/remove/set` | Manage player balances. | `peconomy.admin` |

---

## 🔑 Permissions

- `peconomy.use` → Basic commands.  
- `peconomy.admin` → Administrative commands.  
- `peconomy.cheque` → Create/redeem checks.  
- `peconomy.customcommands` → Execute custom commands in menus.  

---

## 🪄 Placeholders (PlaceholderAPI)

```txt
%peconomy_balance_<currency>%        → "$100.00"
%peconomy_magnate_<currency>%        → "[Magnate]"
%peconomy_toggle_<currency>%         → "Enabled/Disabled"
%peconomy_actionbar%                 → "Enabled/Disabled"
%peconomy_title%                     → "Enabled/Disabled"
%peconomy_lasttransaction_<currency>% → "ADD $50 Steve"
%peconomy_top_<currency>_<position>_<type>%