Plugin Minecraft EconomyAPI

🔌 Sobre o EconomyAPI

EconomyAPI é um plugin central de economia e uma implementação de API, originalmente criada por onebone. É publicado e distribuído para ecossistemas de servidores no estilo Bedrock/PocketMine (variantes PocketMine/Nukkit) e tem como objetivo fornecer um backend de moeda compartilhado e métodos programáticos que outros plugins podem chamar.

🎯 Objetivo

O EconomyAPI fornece um sistema de moeda centralizado para que autores de plugins possam ler e modificar saldos de jogadores, registrar eventos relacionados à economia e permitir que administradores do servidor exponham comandos básicos de economia aos jogadores. Ele resolve o problema de vários plugins precisarem de implementações de economia separadas, oferecendo uma camada de API comum.

⚙️ Recursos

• Expõe métodos de API programáticos para consultar e atualizar saldos (os exemplos na documentação incluem um acessor no estilo getInstance).
• Fornece comandos de economia para jogadores, como saldo, pagamento e ajustes de dinheiro para administradores.
• Emite eventos e hooks que outros plugins podem escutar para o tratamento de transações.
• Amplamente usado como dependência/componente central para outros addons e extensões de economia do PocketMine/Nukkit.

🧩 Para quem é

• Desenvolvedores de servidores e plugins que precisam de um backend de economia compartilhado em software de servidor Bedrock no estilo PocketMine/Nukkit.
• Administradores de servidores Bedrock pequenos e médios que dependem de ecossistemas de plugins integrados ao EconomyAPI.

🏗️ Exemplos de uso

• Um plugin de loja ou marketplace lê e desconta saldos de jogadores por meio de chamadas do EconomyAPI.
• Um plugin de leilão ou recompensas concede moeda chamando os métodos add/reduce da API.
• Redes de servidores que incluem plugins addon que esperam um provedor de economia comum.

⌨️ Comandos

(Os comandos e nós de permissão acima foram retirados de listagens públicas de recursos do PocketMine/Nukkit; a disponibilidade exata pode variar conforme a build/fork.)

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe a build oficial do plugin para a sua distribuição de servidor (PocketMine/Poggit ou build da comunidade Nukkit).
• Coloque o arquivo do plugin baixado no diretório plugins/ do servidor.
• Pare e inicie o servidor novamente (reinicie) e verifique a saída do console para confirmar que o plugin foi carregado.

(O formato exato do pacote pode variar conforme a distribuição e a build; siga as etapas de instalação da distribuição escolhida.)

🧠 Observações técnicas

• O EconomyAPI é distribuído em várias builds/forks para os ecossistemas PocketMine e Nukkit; builds diferentes podem incluir comandos ou pontos de entrada da API ligeiramente diferentes.
• O plugin expõe padrões de acesso programático usados por outros addons (exemplos na documentação da comunidade mostram chamadas como EconomyAPI::getInstance() ou EconomyAPI.getInstance().addMoney(...)).
• Em alguns momentos, o plugin recebeu alertas em canais de distribuição por questões de desempenho ou manutenção; considere o estado atual de manutenção e alternativas compatíveis ao implantá-lo em servidores de produção.

🤝 Quando este plugin é útil

Se o seu servidor ou ecossistema de add-ons espera um provedor de economia comum para servidores no estilo Bedrock/PocketMine/Nukkit, o EconomyAPI oferece uma API amplamente adotada e um conjunto de comandos básicos para jogadores com os quais muitos outros plugins se integram.