Plugins Spigot e Paper

Os tipos Bukkit/Spigot/Paper geram um plugin de servidor que roda no Paper, no Spigot e nos forks deles. Escolha Java (projeto Maven) ou Kotlin (projeto Gradle com build.gradle.kts).

Para jogar com o seu plugin no jogo, inicie um servidor de teste privado com o Teste agora.

Quando você envia o pedido, o Codexe pergunta para qual versão do Minecraft é o plugin, da 1.8.8 à 26.3. O código é escrito para a API e o nível de Java dessa versão, e o servidor de teste roda essa versão. Os projetos criados antes de 30 de setembro de 2026 mantêm a versão escrita nos seus arquivos de build.

#O que colocar no pedido

• Software e versão do servidor: "Paper 1.21.4" ou "Spigot 1.20.1". O Paper tem uma API maior que a do Spigot. Código escrito para Spigot roda no Paper, mas não o contrário, então peça Spigot se precisar dos dois.
• Comandos com argumentos, quem pode usá-los e autocompletar com Tab.
• Permissões com os seus valores padrão (true, op, false).
• As chaves do config.yml que você quer poder editar.
• Armazenamento: YAML, SQLite, MySQL ou em memória.
• Integrações: Vault, PlaceholderAPI, LuckPerms, WorldGuard…, citadas explicitamente para que sejam adicionadas como dependências.

A Paper 1.21.4 plugin (Java) called Bounties.
- /bounty set <player> <amount>: takes money via Vault, adds it to the player's bounty.
- Killing a player with a bounty pays it to the killer.
- /bounty top shows the 10 highest bounties.
- Bounties stored in SQLite. Minimum bounty 100 (config.yml).
- Permission bounties.set (default true).

A Paper 1.21.4 plugin in Kotlin called Bounties, same features as above.
Use Kotlin idioms (data classes, extension functions) but keep the Bukkit API usage standard.

#O que o Codexe gera

• Um projeto Maven (Java) ou Gradle (Kotlin) com a dependência de API correta.
• A classe principal que estende JavaPlugin, mais classes de comandos, listeners e armazenamento.
• O plugin.yml com a classe principal, api-version, comandos e permissões, e o config.yml quando há configurações.

name: Bounties
version: 1.0.0
main: eu.codexe.bounties.Bounties
api-version: '1.21'
depend: [Vault]
commands:
  bounty:
    description: Manage bounties
permissions:
  bounties.set:
    default: true

#Versões e Java

O Codexe lê a versão do Minecraft no arquivo de build e compila com Java 17 (antes da 1.20.5), Java 21 (1.20.5 e mais recentes) ou Java 25 (26.x). Se você não disser uma versão, é usada a API do Paper/Spigot 1.20.6.

#Build e verificação

O Codexe compila o plugin antes de chamá-lo de Pronto e confere se o JAR contém as classes e um plugin.yml (ou paper-plugin.yml). Os builds de plugins costumam levar bem menos de um minuto. Veja Compilar.

#Instalação

Baixe o JAR, coloque-o em plugins/, reinicie o servidor (não use /reload) e confira no console se aparecem erros na inicialização.

#Problemas comuns