Pular para o conteúdo
Primeiros passos

Seu primeiro projeto

Um passo a passo de um primeiro projeto real, um plugin Paper de homes, do pedido ao JAR testado.

Atualizado

Nesta página
  1. O pedido
  2. O que acontece em seguida
  3. Confira o resultado
  4. Mude alguma coisa
  5. Compile e teste
  6. Próximos passos

Este passo a passo cria um plugin pequeno, mas real, para você ver cada etapa uma vez. O mesmo fluxo vale para todos os tipos de projeto.

#O pedido

Em Criar, escolha Plugin para Bukkit/Spigot/Paper (Java) e escreva:

Text
A Paper 1.21.4 plugin called SimpleHomes.
- /sethome saves the player's current location as their home (one home per player).
- /home teleports them there after a 3 second warm-up; moving cancels it.
- 30 second cooldown on /home, configurable in config.yml.
- Homes persist across restarts in a YAML file.
- Permissions: simplehomes.use (default true), simplehomes.bypasscooldown (default op).
- Messages configurable in config.yml, with color codes.

Repare no que ele contém: a plataforma e a versão, cada comando e o que ele faz, as regras de tempo, o armazenamento, as permissões e o que deve ser configurável. É isso que torna o primeiro resultado utilizável.

#O que acontece em seguida

  1. O Codexe vai mostrando os arquivos: um pom.xml do Maven, a classe principal, as classes de comandos e de listeners, plugin.yml e config.yml.
  2. O aviso muda para Verificando o projeto… e depois para Compilando…. O Codexe compila o plugin.
  3. Se o compilador apontar um erro (por exemplo, um import errado), você verá Corrigindo um problema…. O Codexe corrige o código e compila de novo. Isso não gasta os seus tokens.
  4. O projeto fica Pronto.

#Confira o resultado

  • Abra o plugin.yml e confira se os comandos e as permissões correspondem ao que você pediu.
  • Abra o config.yml: o cooldown e as mensagens devem estar lá.
  • Dê uma olhada rápida na classe principal. Você não precisa entender cada linha, mas consegue notar lacunas óbvias.

#Mude alguma coisa

No chat do projeto, digite:

Text
Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.

O Codexe edita os arquivos existentes em vez de começar do zero. Os pedidos seguintes custam bem menos que um projeto novo, porque só os arquivos afetados são reescritos. Quando a alteração mexe em um projeto compilável, o Codexe o verifica de novo.

#Compile e teste

Clique em Compilar para fazer um build novo e depois em Download JAR. Coloque o JAR na pasta plugins/ do seu servidor e reinicie. Teste cada comando, incluindo os casos-limite (mover-se durante o aquecimento, o cooldown, uma reinicialização).

#Próximos passos

Seu primeiro projeto | Codexe Docs