Guia

Como criar um plugin de Spigot

Atualizado em 7 de outubro de 2026

Um plugin de Spigot usa a API do Bukkit/Spigot, então roda no Spigot e em todos os forks dele, incluindo o Paper. Isso o torna a escolha mais abrangente quando você não sabe onde o plugin vai rodar. Este guia cobre o projeto, o código e o build.

Mude o exemplo para o seu servidor.

Gere isto com o Codexe

Passo a passo

  1. 1.Configure o Java e uma ferramenta de build

    Instale o JDK que corresponde à sua versão do Minecraft (17, 21 ou 25) e use Maven ou Gradle.

  2. 2.Adicione a API do Spigot

    Adicione o spigot-api da sua versão, do repositório do Spigot, com escopo provided. Ele só é necessário para compilar; o servidor o fornece em tempo de execução.

  3. 3.Escreva comandos e listeners

    Registre um CommandExecutor com getCommand("name").setExecutor(...) e os listeners de eventos com registerEvents.

  4. 4.Escreva o plugin.yml

    Nome, versão, classe principal, api-version (a partir da 1.13), comandos e permissões.

  5. 5.Compile e instale

    mvn package, depois copie o .jar de target/ para a pasta plugins/ do servidor e reinicie.

Versões antigas (1.8 a 1.12)

Muitos servidores de minigames ainda rodam a 1.8. A API é mais antiga (sem api-version e com nomes de materiais diferentes), então o plugin precisa ser escrito para essa versão, e não copiado de um tutorial da 1.21. O Codexe pergunta a versão e escreve o código para essa API.

Com o Codexe

Descreva o plugin e diga "Spigot" com a versão. O Codexe gera o projeto Maven, compila, corrige os erros e deixa você testar em um servidor de teste dessa versão antes de baixar.

Perguntas

Preciso do BuildTools?

Só para rodar um servidor Spigot ou para usar NMS (código interno do servidor). Para compilar contra a API normal, a dependência spigot-api basta.

Plugin de Spigot ou plugin de Paper?

Spigot se ele precisa rodar em qualquer lugar; Paper se o seu servidor roda Paper e você quer a API extra dele. Veja como criar um plugin de Paper.

Crie um plugin de Spigot

Este prompt abre pronto para enviar:

“Um plugin para Spigot 1.8.8 chamado Kits: /kit <name> dá um conjunto configurável de itens com um cooldown por kit, kits definidos no config.yml, permissão kits.<name> por kit e cooldowns salvos entre reinicializações.”

Gere isto com o Codexe
Como criar um plugin de Spigot: configuração, código e build | Codexe