Guía
Cómo crear un plugin de misiones para Minecraft
Actualizado el 18 de octubre de 2026
Las misiones dan a los jugadores un motivo para jugar: matar 20 zombis, minar 64 de hierro, llevarle 10 panes a un aldeano. Un plugin de misiones son tres cosas: objetivos que escuchan los eventos del juego, progreso guardado para cada jugador y recompensas. Definir las misiones en un archivo de configuración te permite añadir nuevas sin tocar el código.
Cambia las misiones y las recompensas por las tuyas.
Genera esto con CodexePaso a paso
1.Elige los tipos de objetivo
Empieza con unos pocos: matar un tipo de mob, romper o colocar bloques, recolectar objetos, craftear, llegar a un lugar, hablar con un NPC. Todas las misiones se construyen con ellos.
2.Define las misiones en un archivo
Cada misión en
quests.yml: un id, un nombre, una descripción, sus objetivos con cantidades, las recompensas y los requisitos (otra misión antes, un permiso, un nivel).3.Registra el progreso de cada jugador
Escucha los eventos de cada objetivo y suma al progreso del jugador. Guárdalo en SQLite o en un archivo para que sobreviva a desconexiones y reinicios.
4.Muestra el progreso
Un menú
/questscon las misiones activas y terminadas, más un mensaje, un título o una barra de jefe cuando cambia el progreso.5.Da recompensas
Objetos, experiencia, dinero a través de Vault o comandos de consola como
lp user %player% permission set ...para todo lo demás.6.Compila y completa una misión en el juego
Deja que Codexe lo compile, entra al servidor de prueba, acepta una misión y termínala. Después reinicia y comprueba que el progreso y las recompensas se guardaron.
Los objetivos y los eventos que hay detrás
| Objetivo | Evento | Detalle que decidir |
|---|---|---|
| Matar mobs | EntityDeathEvent | Contar solo las muertes causadas por el jugador o también por sus mascotas y flechas |
| Romper bloques | BlockBreakEvent | Ignorar los bloques que colocó el jugador, o los jugadores colocarán y romperán el mismo bloque |
| Recolectar objetos | Comprobación del inventario o evento de recogida | Si los objetos se quitan al entregar la misión |
| Craftear objetos | CraftItemEvent | Craftear con Mayús + clic crea varios a la vez |
| Llegar a un lugar | PlayerMoveEvent | Comprobar solo cuando el jugador cambia de bloque, no en cada movimiento |
| Hablar con un NPC | PlayerInteractEntityEvent | Qué entidad da la misión |
Quién da las misiones
La forma más sencilla de dar misiones es un comando o un menú. Para un personaje en el mundo, un aldeano o un soporte de armadura con un nombre personalizado y una etiqueta de PersistentDataContainer funciona sin otros plugins: el plugin lo reconoce cuando un jugador le hace clic derecho. Si tu servidor ya usa un plugin de NPC como Citizens, nómbralo en la petición para que el plugin se integre con él.
Descripción de ejemplo
«Un plugin de misiones para Paper 1.21.4 llamado Quests. Tipos de objetivo: matar mobs, romper bloques (no colocados por jugadores), recolectar objetos y hablar con un aldeano etiquetado como dador de misiones. Misiones definidas en quests.yml con nombre, objetivos, misión requerida y recompensas (objetos, experiencia, dinero de Vault, comandos de consola). /quests abre un menú con las misiones disponibles, activas y terminadas. Progreso mostrado en la barra de acción. Hasta 3 misiones activas. Las misiones diarias se reinician a medianoche, hora del servidor. Progreso guardado en SQLite.»
Misiones diarias y repetibles
- Indica cuándo se reinician: a una hora fija cada día o 24 horas después de que el jugador las terminara.
- Indica si las misiones diarias son aleatorias para cada jugador o iguales para todos.
- Guarda la hora de la última vez que se completó, no un indicador, para que los reinicios funcionen aunque el servidor esté apagado.
Preguntas
¿Pueden las misiones usar PlaceholderAPI?
Sí. Pide placeholders como la misión activa y su progreso, para que los marcadores y las listas de tabulación puedan mostrarlos. Nombra PlaceholderAPI en la petición para que se añada como dependencia.
¿Puedo escribir misiones con Skript?
Los sistemas de misiones pequeños caben en un Skript con variables. Muchos tipos de objetivo, menús y progreso guardado para cientos de jugadores se mantienen rápidos y ordenados más fácilmente en un plugin.
¿Cómo compruebo que las misiones funcionan?
Juégalas en el servidor de prueba de Codexe y añade pruebas con tus palabras, por ejemplo «un jugador normal ejecuta /quests y ve que se abre un menú». Las pruebas comprueban mensajes, objetos y menús, no mobs ni bloques del mundo.
Crea tu plugin de misiones
Este prompt se abre listo para enviar:
“Un plugin de misiones para Paper 1.21.4: tipos de objetivo matar mobs, romper bloques no colocados por jugadores, recolectar objetos y hablar con un aldeano etiquetado; misiones en quests.yml con objetivos, misión requerida y recompensas (objetos, XP, dinero de Vault, comandos de consola); menú /quests con misiones disponibles, activas y terminadas; progreso en la barra de acción; máximo 3 misiones activas; las misiones diarias se reinician a medianoche; progreso guardado en SQLite.”
Genera esto con Codexe