Guia

Como criar um plugin de minigame para Minecraft

Atualizado em 18 de outubro de 2026

Um plugin de minigame roda partidas: os jogadores esperam em um lobby, uma contagem regressiva começa, o jogo segue as próprias regras, alguém vence e a arena é resetada para a próxima partida. Todo minigame, do spleef ao bed wars, tem o mesmo esqueleto. Acerte isso e as regras do jogo viram a parte fácil.

Comece por este exemplo e mude as regras.

Gere isto com o Codexe

Passo a passo

  1. 1.Escreva as regras de uma partida

    Quantos jogadores, como uma partida começa e termina, como alguém vence, o que acontece ao morrer (eliminado, respawn, espectador) e o que os jogadores recebem no início.

  2. 2.Planeje a configuração da arena

    Comandos de admin para criar uma arena e definir o lobby, os pontos de spawn e os limites, por exemplo /mg create <name> e /mg setspawn <name>. As arenas ficam salvas em um arquivo para sobreviver a reinícios.

  3. 3.Defina os estados de jogo

    Esperando, iniciando (contagem regressiva), jogando e terminando. Cada estado permite coisas diferentes: ninguém quebra blocos no lobby, ninguém entra em uma partida em andamento.

  4. 4.Decida como a arena é resetada

    Registre e desfaça os blocos alterados durante a partida, ou recarregue uma cópia de um mundo modelo. Sem reset, a segunda partida começa em um mapa destruído.

  5. 5.Adicione o que os jogadores veem

    Uma scoreboard lateral com os jogadores restantes e o tempo, uma boss bar ou títulos para a contagem regressiva e mensagens no chat para abates e para o vencedor.

  6. 6.Gere, compile e jogue uma partida

    Descreva o minigame ao Codexe, deixe compilar e entre no servidor de teste com o Teste agora. Deixe o mínimo de jogadores baixo durante os testes para que uma partida possa começar.

Os estados de jogo

A maioria dos bugs de minigame vem de jogadores fazendo algo no estado errado. Escrever os estados no pedido faz a IA construir o plugin em torno deles.

EstadoO que aconteceRegras típicas
EsperandoOs jogadores entram no lobbySem dano, sem quebrar blocos, sair com um item ou comando
IniciandoContagem regressiva quando o mínimo é atingidoA contagem para se os jogadores saírem e ficarem abaixo do mínimo
JogandoAs regras do jogo valemSem entrar no meio, mortes eliminam ou dão respawn, sair conta como derrota
TerminandoVencedor anunciado, recompensas entreguesJogadores mandados de volta após alguns segundos, arena resetada

Resetando a arena

  • Registrar e desfazer alterações: salve cada bloco antes de ele mudar durante a partida e coloque de volta no final. Rápido para arenas pequenas em que os jogadores quebram ou colocam poucos blocos.
  • Mundo modelo: mantenha uma cópia limpa do mapa, descarregue o mundo jogado após a partida e copie o modelo por cima. Simples e confiável para mapas que são destruídos.
  • Nenhuma alteração permitida: em jogos como parkour ou duelos de PvP, cancele totalmente as alterações de blocos e não há nada para resetar.

Exemplo de descrição

"Um plugin de minigame de spleef para Paper 1.21.4. Os admins criam arenas com /spleef create <name>, /spleef setlobby e /spleef setfloor (os dois cantos do piso de neve). Os jogadores entram com /spleef join <arena>. A partida começa 15 segundos depois de haver 2 jogadores, até 8. Os jogadores recebem uma pá de diamante, quebram neve instantaneamente e são eliminados quando caem abaixo do piso. O último jogador de pé ganha 50 coins pelo Vault. Os eliminados viram espectadores. O piso de neve é restaurado após cada partida. Scoreboard lateral com os jogadores restantes e o tempo. Arenas salvas em arenas.yml, mínimo de jogadores e recompensas no config.yml."

Testando um minigame

É difícil avaliar um minigame pelo código: você precisa jogar uma partida. O Teste agora inicia um servidor Paper privado da sua versão com o plugin instalado, geralmente em um mundo plano, e seus amigos podem entrar se você os adicionar em Acesso ao servidor. O plano Free permite 2 pessoas em um servidor de teste, o Pro 5, o Business 10 e o Enterprise 20.

Peça o mínimo de jogadores no config.yml para poder colocá-lo em 1 ou 2 durante os testes. Os jogadores de teste também podem entrar, rodar os comandos de entrada e de admin e conferir as mensagens, o que pega comandos quebrados antes de você jogar.

Perguntas

Uma arena ou várias?

Peça várias arenas desde o início. Transformar depois um plugin de uma arena só em um de várias arenas significa reescrever como os jogadores e o estado do jogo são armazenados.

Posso criar um minigame de PvP para 1.8?

Sim. Escreva Spigot ou Paper 1.8.8 no pedido: o Codexe escreve o código para essa API mais antiga, e os servidores de teste rodam versões da 1.8 à 26.3.

Como funcionam as redes de minigames?

Redes grandes rodam cada jogo em um servidor próprio atrás de um proxy BungeeCord ou Velocity, com um servidor de lobby que manda os jogadores para uma partida livre. Isso é um plugin de proxy mais um plugin de jogo, em dois projetos.

Crie o seu minigame

Este prompt abre pronto para enviar:

“Um plugin de minigame de spleef para Paper 1.21.4: arenas criadas com /spleef create, setlobby e setfloor, os jogadores entram com /spleef join, a partida começa 15 segundos depois de 2 jogadores (máx. 8), pás de diamante, eliminado ao cair abaixo do piso, o último jogador ganha 50 coins pelo Vault, espectadores para os eliminados, piso de neve restaurado após cada partida, scoreboard lateral com os jogadores restantes e o tempo, arenas salvas em arenas.yml.”

Gere isto com o Codexe
Como criar um plugin de minigame para Minecraft | Codexe