Como criar um plugin de Minecraft

Passo a passo

1. 1.Escolha o software e a versão do servidor

   Os plugins rodam em servidores baseados no Bukkit: Spigot, Paper ou Folia (BungeeCord e Velocity para proxies). Escolha a versão do Minecraft que o seu servidor usa, da 1.8 à 26.x.

2. 2.Descreva o que o plugin faz

   Escreva os comandos, as permissões, o que acontece no jogo e o que deve ser configurável. Exemplo: "/sethome, /home e /delhome, no máximo 3 homes por jogador, 3 segundos de espera, mensagens no config.yml".

3. 3.Deixe o Codexe escrever e compilar

   O Codexe escreve as classes Java, o plugin.yml, o config.yml e o pom.xml, roda um build de verdade e corrige os erros de compilação antes de marcar o projeto como pronto.

4. 4.Teste em um servidor de verdade

   Aperte Teste agora para entrar em um servidor de Minecraft privado com o plugin instalado. Os jogadores de teste do Codexe executam cada comando e conferem o que você pediu.

5. 5.Baixe e instale o .jar

   Baixe o .jar compilado, coloque na pasta plugins/ do seu servidor e reinicie o servidor. Os arquivos de configuração aparecem em plugins/<PluginName>/.

O que é um plugin de Minecraft

Um plugin é um arquivo .jar que um servidor de Minecraft carrega da pasta plugins/. Ele adiciona comandos, regras de jogo, economias, minigames ou qualquer outra coisa, só no servidor: os jogadores entram com o jogo normal, sem precisar de mods.

Os plugins são escritos em Java (ou Kotlin) contra a API do servidor: Spigot e Paper para servidores de jogo, BungeeCord ou Velocity para proxies. Um plugin também precisa de um plugin.yml que diga ao servidor o nome, a classe principal, os comandos e as permissões dele.

O caminho manual: Java, Maven e a API do Spigot ou do Paper

Leva mais tempo para aprender, mas dá controle total. O Codexe produz o mesmo tipo de projeto, então você pode começar por um plugin gerado e continuar à mão.

1. Instale um JDK (Java 21 para 1.20.5 até 1.21.x, Java 25 para 26.x) e uma IDE como o IntelliJ IDEA.
2. Crie um projeto Maven ou Gradle e adicione a dependência paper-api ou spigot-api da sua versão, com escopo provided.
3. Escreva uma classe principal que estenda JavaPlugin, com onEnable() e onDisable().
4. Adicione o plugin.yml em src/main/resources com name, version, main, api-version e os seus comandos.
5. Registre os comandos com getCommand("name").setExecutor(...) e os listeners com getServer().getPluginManager().registerEvents(...).
6. Compile com mvn package, copie o .jar de target/ para a pasta plugins/ de um servidor de teste e reinicie.

Perguntas