ВЕРСИИ (8)

corrigido alguns bugs

adicionado features: pay-enabled: true receive-enabled: true cheque-enabled: true cheque-item: material: PAPER glow: false

Adicionado # Formatação de números format: decimal: "," # Separador decimal thousands: "." # Separador de milhares suffixes: 1000: K # Sufixo para milhares 1000000: M # Sufixo para milhões 1000000000: B # Sufixo para bilhões currencies: coins: name: "Coins" display-name: "Coins" symbol: "$" default-amount: 0 magnata-tag: "&6[MAGNATA]" magnata-placeholder: "moedas" magnata-changed: enabled: true message: "&6Novo magnata de {currency}: &e{player}&6!" discord: thumbnail-url: "https://media.discordapp.net/attachments/1212013207296671825/1447286472271986688/Adobe_Express_-_file_512x512.png?ex=69595910&is=69580790&hm=a999c94f124de435efa749e6f82dd88a6160b6e9d3d0ab9cf98806e2dbd933e5&=&format=webp&quality=lossless" banner-url: "https://media.discordapp.net/attachments/1212013207296671825/1456745173600964819/coins.png?ex=69597b2a&is=695829aa&hm=9f4ca4c97fc10c54f05016df485c46c14d77e07d0aba2e513b961a4098370d9e&=&format=webp&quality=lossless" gems: name: "Gemas" display-name: "Gemas" symbol: "✦" default-amount: 0 magnata-tag: "&b[MAGNATA]" magnata-placeholder: "gemas" adicionado isso! magnata-changed: enabled: true message: "&bNovo magnata de {currency}: &f{player}&b!" discord: thumbnail-url: "https://media.discordapp.net/attachments/1212013207296671825/1447286472271986688/Adobe_Express_-_file_512x512.png?ex=69595910&is=69580790&hm=a999c94f124de435efa749e6f82dd88a6160b6e9d3d0ab9cf98806e2dbd933e5&=&format=webp&quality=lossless" banner-url: "https://media.discordapp.net/attachments/1212013207296671825/1456745173986836600/gemas.png?ex=69597b2a&is=695829aa&hm=7dacfd772f0cd5eebe3039cd95a531c124c3e0d11690322351188fe2848f7a6f&=&format=webp&quality=lossless"

Atualização no sistema de NPC, corrigido money enviar! ou add! otimização no plugin! %peconomy_<...>% Aqui estão todos os placeholders existentes no código (incluindo os novos raw/bruto): Balance (saldo) Saldo formatado (você mesmo) %peconomy_balance_<moeda>% Saldo formatado (outro player/uuid) %peconomy_balance_<moeda>_<player|uuid>% Saldo bruto (você mesmo) ✅ %peconomy_balance_<moeda>_raw% %peconomy_balance_<moeda>_bruto% Saldo bruto (outro player/uuid) ✅ %peconomy_balance_<moeda>_<player|uuid>_raw% %peconomy_balance_<moeda>_<player|uuid>_bruto% <moeda> pode ser a key real (ex: gems) ou alias (ex: display-name/nome etc.), porque você usa resolveCurrencyKey(). Magnata (tag do magnata) Retorna a tag do magnata SOMENTE se o player for o magnata %peconomy_magnata_<moeda>% Se não for magnata (ou der algo inválido), retorna vazio. Toggle (status por moeda) %peconomy_toggle_<moeda>% Retorna "Enabled" ou "Disabled" (para o player que está vendo o placeholder). Actionbar (config global do player) %peconomy_actionbar% Retorna "Enabled" ou "Disabled". Title (config global do player) %peconomy_title% Retorna "Enabled" ou "Disabled". Last Transaction (última transação do player) Com valor formatado %peconomy_lasttransaction_<moeda>% Com valor bruto ✅ %peconomy_lasttransaction_<moeda>_raw% %peconomy_lasttransaction_<moeda>_bruto% Formato do retorno: <type> <valor> <targetName> (target pode vir vazio) Top (ranking) Formato base: %peconomy_top_<moeda>_<pos>_<campo>% Campos disponíveis: Nome do jogador %peconomy_top_<moeda>_<pos>_name% Valor (amount “normal”) %peconomy_top_<moeda>_<pos>_amount% Valor bruto (alias) ✅ %peconomy_top_<moeda>_<pos>_raw% %peconomy_top_<moeda>_<pos>_bruto% Valor formatado %peconomy_top_<moeda>_<pos>_formatted% Regras quando a posição não existir: name → "Nenhum jogador" amount/raw/bruto → "0" formatted → NumberFormatter.format(0, moeda)

Atualizado comandos! permitidos usar no console! atualizado o holograma dos npc!

Fixed errors in placeholders, corrected bugs with armorstand. %peconomy_balance_<moeda>% %peconomy_balance_<moeda>_<jogador|uuid>% %peconomy_magnata_<moeda>% %peconomy_toggle_<moeda>% %peconomy_actionbar% %peconomy_title% %peconomy_lasttransaction_<moeda>% %peconomy_top_<moeda>_<posição>_name% %peconomy_top_<moeda>_<posição>_amount% %peconomy_top_<moeda>_<posição>_formatted%

# P\_Economy Sistema avançado de economia **multi‑moeda** para servidores Minecraft (Spigot/Paper). --- ## ✨ Recursos Principais * **Multi‑moeda**: moedas configuráveis (`currencies.yml`) com formatação customizada. * **Banco de dados**: suporte a SQLite e MySQL, com persistência de saldos, transações, cheques, preferências e rankings. * **Top / Rankings**: atualização automática, com integração em NPCs (Citizens) e Displays (ArmorStand + TextDisplay). * **Integrações**: * **Vault** — compatibilidade com plugins existentes. * **PlaceholderAPI** — placeholders para hologramas, menus e mensagens. * **Citizens** — NPCs Top com skins dinâmicas. * **SkinsRestorer** — suporte a cabeças/skins personalizadas. * **Menus**: interfaces gráficas configuráveis (`menus.yml`). * **Cheques**: itens que representam valor e podem ser resgatados. * **API Pública**: interface `MoedasService` com suporte a eventos Bukkit. --- ## ⚙️ Configuração Essencial ### `config.yml` ```yml debug: false database: type: sqlite host: localhost port: 3306 database: peconomy username: root password: "" top: update-interval: 60 # segundos max-players: 10 ``` ### `currencies.yml` ```yml format: decimal: "," thousands: "." currencies: coins: display-name: "Moedas" symbol: "¢" default-amount: 0.0 magnata-tag: "&6[MAGNATA]" ``` ### Idiomas (`Idiomas/pt_br.yml`) ```yml messages: invalid-currency: "&cMoeda inválida." balance: "&7Saldo em {currency}: &f{amount}" no-permission: "&cSem permissão." ``` --- ## ⌨️ Comandos * `/economia` — abre menu principal. * `/economia saldo <moeda>` — mostra saldo. * `/economia pagar <jogador> <moeda> <quantia>` — transfere dinheiro. * `/economia toggle [moeda]` — ativa/desativa recebimento. * `/economia cheque <valor> <moeda>` — cria cheque. * `/economia transacoes [moeda]` — mostra histórico. * `/economia message_prefs [actionbar|title|chat]` — altera preferências. * `/economia setbalance|addbalance|removebalance` — gerencia saldos. * `/economia resettop|updatetop` — gerencia ranking. * `/economia topdisplay <set|remove|list>` — gerencia Displays. * `/economia npc|topnpc <set|remove|reload|update>` — gerencia NPCs Citizens. * `/economia reload` — recarrega configs. --- ## 🏦 Banco de Dados Tabelas principais: * `balances` — saldos por jogador/moeda. * `transactions` — histórico de transações. * `cheques` — cheques emitidos e resgatados. * `toggles` — status de recebimento por moeda. * `message_prefs` — preferências (actionbar/title/chat). * `top_displays` e `top_npcs` — posições fixas. * `pending_messages` — mensagens entregues a jogadores offline. --- ## 🧩 API Pública (`MoedasService`) ```java BigDecimal getBalance(UUID playerId, String currency); CompletableFuture<TransactionResult> deposit(UUID playerId, String currency, BigDecimal amount, String reason); CompletableFuture<TransactionResult> withdraw(UUID playerId, String currency, BigDecimal amount, String reason); CompletableFuture<TransactionResult> transfer(UUID from, UUID to, String currency, BigDecimal amount, String reason); List<ApiTransaction> getTransactions(UUID playerId, String currency, int limit); List<TopEntry> getTop(String currency, int limit); String createCheque(UUID creator, String currency, BigDecimal amount); CompletableFuture<BigDecimal> redeemCheque(UUID redeemer, String chequeId, String currency); ``` ### DTOs * `TransactionResult` (status, novo saldo, mensagem) * `ApiTransaction` (id, uuid, moeda, tipo, valor, target, timestamp) * `TopEntry` (jogador, nome, valor, moeda) ### Eventos * `BalanceChangePreEvent` / `BalanceChangePostEvent` * `TransferPreEvent` / `TransferPostEvent` --- ## 🔌 Integrações * **Vault** — economia padrão. * **PlaceholderAPI** — placeholders `%peconomy_*%`. * **Citizens** — NPCs Top. * **SkinsRestorer** — skins customizadas. --- ## 📌 Exemplo de Uso (em outro plugin) ```java MoedasService eco = Bukkit.getServicesManager().load(MoedasService.class); UUID playerId = player.getUniqueId(); // Depositar 100 moedas eco.deposit(playerId, "coins", BigDecimal.valueOf(100), "reward"); ``` --- ## 📜 Changelog (resumido) * Estrutura inicial com Multi‑moeda, Banco de Dados e API. * Suporte a Vault, PlaceholderAPI e Citizens. * Cheques adicionados. * Eventos API para depósitos, saques e transferências. * Comandos unificados em `/economia`. * Menus configuráveis em `menus.yml`.

# 💰 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) ```txt %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>%