Desenvolvimento de Plugins para Minecraft

Use esta habilidade para trabalhos de desenvolvimento de plugins de servidor Minecraft nos ecossistemas Paper, Spigot e Bukkit.

Esta habilidade é especialmente útil para plugins com foco em jogabilidade, como sistemas de combate, encontros de ondas ou chefes, modos de guerra ou equipe, arenas, sistemas de kits, habilidades baseadas em cooldown, placares e regras de jogo controladas por configuração.

Para padrões de implementação fundamentados, extraídos de plugins reais do Paper, carregue estas referências conforme necessário:

• references/project-patterns.md para padrões de arquitetura de alto nível vistos em plugins de jogabilidade reais
• references/bootstrap-registration.md para onEnable, registro de comandos, registro de listeners e expectativas de encerramento
• references/state-sessions-and-phases.md para modelagem de sessão de jogador, fases de jogo, estado de partida e lógica segura para reconexão
• references/config-data-and-async.md para gerenciadores de configuração, dados de jogador baseados em banco de dados, flushes assíncronos e tarefas de atualização de UI
• references/maps-heroes-and-feature-modules.md para rotação de mapas, sistemas de heróis ou classes e crescimento modular de recursos
• references/minigame-instance-flow.md para instâncias de arena, contagens regressivas, atualizações de loot, sistemas de ondas, isolamento de visibilidade e propriedade de entidade para jogo
• references/persistent-progression-and-events.md para servidores PvP de longa duração com perfis, perks, buffs, quests, economia, eventos de domínio personalizados e registros de extensão
• references/build-test-and-runtime-validation.md para empacotamento Maven ou Gradle, dependências sombreadas, recursos gerados, dependências fracas, comandos de validação de configuração e planos de teste de servidor de primeira rodada

Escopo

• Em escopo: Desenvolvimento de plugins Paper, Spigot, Bukkit
• Em escopo: plugin.yml, comandos, preenchimento de tabulação, listeners, agendadores, configurações, permissões, texto Adventure, estado do jogador, fluxo de minijogo, instâncias de arena, cópias de mapa, loot, ondas, perfis persistentes, perks, buffs, quests, economia e loops de jogo PvP/PvE
• Em escopo: Arquitetura de plugin de servidor baseada em Java, depuração, refatoração e implementação de recursos
• Fora de escopo por padrão: Mods Fabric, mods Forge, mods de cliente, add-ons Bedrock

Se o usuário disser "plugin Minecraft", mas a pilha não estiver clara, primeiro determine se o projeto é Paper/Spigot/Bukkit ou uma pilha de modding.

Estilo de Trabalho Padrão

Quando esta habilidade for acionada:

1. Identifique a API do servidor e a versão alvo.
2. Identifique o sistema de build e a versão do Java.
3. Inspecione plugin.yml, a classe principal do plugin, e o registro de comandos ou listeners.
4. Mapeie o fluxo de jogabilidade antes de editar o código:
   • ciclo de vida do jogador
   • fases do jogo
   • temporizadores e tarefas agendadas
   • estado da equipe, arena ou partida
   • configuração e persistência
5. Faça a menor alteração coerente que mantenha o registro, a configuração e o comportamento em tempo de execução alinhados.

Se o plugin for focado em jogabilidade ou com estado, leia references/project-patterns.md e references/state-sessions-and-phases.md antes de editar.

Se a tarefa tocar em isolamento de arena, instâncias de mapa, reabastecimento de baús ou recursos, geração de ondas, votação de rotas, visibilidade do espectador ou chat específico do jogo, leia também references/minigame-instance-flow.md.

Se a tarefa tocar em progressão persistente do jogador, salvamento de perfis, recompensas de economia, perks, buffs, quests, eventos de combate personalizados ou servidores PvP compartilhados de longa duração, leia também references/persistent-progression-and-events.md.

Se a tarefa tocar em arquivos de build, metadados de plugin.yml, dependências sombreadas, saída de recursos gerados, implantação em um servidor de teste, integrações opcionais de plugin ou validação de lançamento, leia também references/build-test-and-runtime-validation.md.

Checklist de Descoberta de Projeto

Verifique estes primeiro quando presentes:

• plugin.yml
• pom.xml, build.gradle ou build.gradle.kts
• a classe principal do plugin estendendo JavaPlugin
• executores de comando e completadores de tabulação
• classes de listener
• código de bootstrap de configuração para config.yml, mensagens, kits, arenas ou arquivos YAML personalizados

…