Guia
Como criar um plugin de quests para Minecraft
Atualizado em 18 de outubro de 2026
As quests dão aos jogadores um motivo para jogar: matar 20 zumbis, minerar 64 de ferro, levar 10 pães para um aldeão. Um plugin de quests é três coisas: objetivos que escutam eventos do jogo, progresso salvo para cada jogador e recompensas. Definir as quests em um arquivo de configuração permite adicionar novas sem mexer no código.
Troque as quests e as recompensas pelas suas.
Gere isto com o CodexePasso a passo
1.Escolha os tipos de objetivo
Comece com alguns: matar um tipo de mob, quebrar ou colocar blocos, coletar itens, craftar, chegar a um lugar, conversar com um NPC. Toda quest é montada a partir deles.
2.Defina as quests em um arquivo
Cada quest em
quests.yml: um id, um nome, uma descrição, os objetivos com as quantidades, as recompensas e os requisitos (outra quest antes, uma permissão, um nível).3.Acompanhe o progresso por jogador
Escute os eventos por trás de cada objetivo e some ao progresso do jogador. Salve em SQLite ou em um arquivo para que sobreviva a saídas e reinícios.
4.Mostre o progresso
Um menu
/questscom as quests ativas e concluídas, mais uma mensagem, um título ou uma boss bar quando o progresso muda.5.Entregue as recompensas
Itens, experiência, dinheiro pelo Vault ou comandos de console como
lp user %player% permission set ...para todo o resto.6.Compile e conclua uma quest no jogo
Deixe o Codexe compilar, entre no servidor de teste, aceite uma quest e conclua. Depois reinicie e confira se o progresso e as recompensas foram salvos.
Os objetivos e os eventos por trás deles
| Objetivo | Evento | Detalhe a decidir |
|---|---|---|
| Matar mobs | EntityDeathEvent | Contar só os abates do jogador ou também os dos pets e das flechas dele |
| Quebrar blocos | BlockBreakEvent | Ignorar os blocos que o jogador colocou, senão ele vai colocar e quebrar o mesmo bloco |
| Coletar itens | Verificação do inventário ou evento de coleta | Se os itens são retirados quando a quest é entregue |
| Craftar itens | CraftItemEvent | Craftar com shift-clique faz vários de uma vez |
| Chegar a um lugar | PlayerMoveEvent | Verificar só quando o jogador muda de bloco, não a cada movimento |
| Conversar com um NPC | PlayerInteractEntityEvent | Qual entidade é quem dá a quest |
Quem dá as quests
O jeito mais simples de dar quests é um comando ou um menu. Para um personagem no mundo, um aldeão ou um suporte de armadura com nome personalizado e uma tag no PersistentDataContainer funciona sem outros plugins: o plugin o reconhece quando um jogador clica nele com o botão direito. Se o seu servidor já usa um plugin de NPC como o Citizens, cite-o no pedido para o plugin se integrar a ele.
Exemplo de descrição
"Um plugin de quests para Paper 1.21.4 chamado Quests. Tipos de objetivo: matar mobs, quebrar blocos (não colocados por jogadores), coletar itens e conversar com um aldeão marcado como quem dá quests. Quests definidas em quests.yml com nome, objetivos, quest exigida e recompensas (itens, experiência, dinheiro do Vault, comandos de console). /quests abre um menu com as quests disponíveis, ativas e concluídas. Progresso mostrado na action bar. Até 3 quests ativas. As quests diárias resetam à meia-noite no horário do servidor. Progresso salvo em SQLite."
Quests diárias e repetíveis
- Diga quando elas resetam: em um horário fixo todo dia ou 24 horas depois de o jogador terminar.
- Diga se as quests diárias são aleatórias para cada jogador ou iguais para todos.
- Guarde o horário da última conclusão, não uma flag, para que os resets funcionem mesmo com o servidor desligado.
Perguntas
As quests podem usar o PlaceholderAPI?
Sim. Peça placeholders como a quest ativa e o progresso dela, para que scoreboards e tab lists possam mostrá-los. Cite o PlaceholderAPI no pedido para ele ser adicionado como dependência.
Posso escrever quests com Skript?
Sistemas de quests pequenos cabem em um Skript com variáveis. Muitos tipos de objetivo, menus e progresso salvo para centenas de jogadores ficam mais fáceis de manter rápidos e organizados em um plugin.
Como confiro se as quests funcionam?
Jogue-as no servidor de teste do Codexe e adicione testes com as suas palavras, por exemplo "um jogador normal usa /quests e vê um menu abrir". Os testes verificam mensagens, itens e menus, não mobs ou blocos no mundo.
Crie o seu plugin de quests
Este prompt abre pronto para enviar:
“Um plugin de quests para Paper 1.21.4: tipos de objetivo matar mobs, quebrar blocos não colocados por jogadores, coletar itens e conversar com um aldeão marcado; quests em quests.yml com objetivos, quest exigida e recompensas (itens, XP, dinheiro do Vault, comandos de console); menu /quests com as quests disponíveis, ativas e concluídas; progresso na action bar; no máximo 3 quests ativas; quests diárias resetam à meia-noite; progresso salvo em SQLite.”
Gere isto com o Codexe