Como criar um plugin de economia para Minecraft

Passo a passo

1. 1.Decida o que o plugin é

   Ou ele é a economia (guarda os saldos e se registra como a economia do Vault), ou ele usa uma economia existente pelo Vault (uma loja, recompensas por cabeça, um plugin de empregos). A maioria dos servidores precisa de um de cada, não de duas economias.

2. 2.Escolha o servidor e a versão

   Escreva o software do servidor e a versão, por exemplo Paper 1.21.4. O plugin é compilado para a API e o nível do Java dessa versão.

3. 3.Liste os comandos e as regras

   /balance, /pay <player> <amount>, /baltop e comandos de admin como /eco give|take|set. Inclua o saldo inicial, o nome da moeda, as casas decimais e um pagamento mínimo.

4. 4.Escolha onde os saldos ficam salvos

   SQLite para um servidor, MySQL se vários servidores precisarem compartilhar os mesmos saldos. O dinheiro precisa sobreviver a reinícios e crashes, então nunca fica só na memória.

5. 5.Deixe o Codexe escrever e compilar

   Descreva o plugin e cite o Vault explicitamente para que ele seja adicionado como dependência. O Codexe escreve o código Java, o plugin.yml e o config.yml, compila e corrige os erros de build antes de o projeto ficar Pronto.

6. 6.Teste os pagamentos no jogo

   Aperte Teste agora e entre no servidor de teste. Faça pagamentos entre duas contas, tente valores grandes demais, negativos ou que não sejam números, depois reinicie e confira se os saldos continuam lá.

7. 7.Instale

   Coloque o Vault e o seu .jar na pasta plugins/ do servidor e reinicie. Remova qualquer outro plugin de economia ou decida qual deles o Vault deve usar.

Como o Vault se encaixa

O Vault é uma ponte, não uma economia. Um plugin de economia implementa a interface Economy do Vault e a registra no gerenciador de serviços do servidor; os outros plugins a pedem com getServer().getServicesManager().getRegistration(Economy.class) e chamam métodos como getBalance, withdrawPlayer e depositPlayer.

Assim, um plugin de loja nunca precisa saber qual economia você usa. No plugin.yml, use depend: [Vault] quando o plugin não funciona sem ele, ou softdepend quando o Vault é opcional. A API do Vault só é necessária para compilar; o Vault em si é instalado no servidor.

Decisões para escrever no pedido

• Formato do dinheiro: nome da moeda no singular e no plural, símbolo, quantas casas decimais.
• Limites: saldo inicial, saldo máximo, se os saldos podem ficar negativos.
• Jogadores offline: se /pay e /eco funcionam com jogadores que não estão online.
• Registro: um log de transações no banco de dados ou em um arquivo, para a staff poder verificar disputas.
• Como ganhar dinheiro: matando mobs, recompensas por tempo de jogo, vendendo itens ou só por comandos de admin.

Onde salvar os saldos

Exemplo de descrição

"Um plugin de economia para Paper 1.21.4 chamado Coins que se registra como a economia do Vault. /balance [player], /pay <player> <amount> com mínimo de 1, /baltop com o top 10 e /eco give|take|set para jogadores com coins.admin. Jogadores novos começam com 100 coins. Duas casas decimais. Todo pagamento registrado com data, quem enviou, quem recebeu e o valor. Saldos salvos em SQLite. Nomes da moeda e todas as mensagens no config.yml."

O Codexe usa SQLite por padrão quando você não pede outra coisa. Se você pedir MySQL, o plugin é escrito com uma opção storage-type, e o servidor de teste dá a ele um banco de dados MySQL próprio enquanto você testa.

Perguntas