Guía

Cómo crear un plugin de minijuegos para Minecraft

Actualizado el 18 de octubre de 2026

Un plugin de minijuegos gestiona rondas: los jugadores esperan en un lobby, empieza una cuenta atrás, la partida se juega con sus propias reglas, alguien gana y la arena se reinicia para la siguiente ronda. Todos los minijuegos, del spleef al Bed Wars, tienen el mismo esqueleto. Si lo haces bien, las reglas del juego son la parte fácil.

Empieza con este ejemplo y cambia las reglas.

Genera esto con Codexe

Paso a paso

  1. 1.Escribe las reglas de una ronda

    Cuántos jugadores, cómo empieza y termina una ronda, cómo se gana, qué pasa al morir (eliminado, reaparición, espectador) y qué reciben los jugadores al empezar.

  2. 2.Planifica la configuración de la arena

    Comandos de administración para crear una arena y fijar su lobby, sus puntos de aparición y sus límites, por ejemplo /mg create <name> y /mg setspawn <name>. Las arenas se guardan en un archivo para que sobrevivan a los reinicios.

  3. 3.Define los estados de la partida

    En espera, empezando (cuenta atrás), en juego y terminando. Cada estado permite cosas distintas: nadie rompe bloques en el lobby y nadie entra en una partida ya empezada.

  4. 4.Decide cómo se reinicia la arena

    Registra y deshaz los bloques cambiados durante la ronda, o vuelve a cargar una copia de un mundo plantilla. Sin reinicio, la segunda ronda empieza en un mapa destrozado.

  5. 5.Añade lo que ven los jugadores

    Un marcador lateral con los jugadores que quedan y el tiempo, una barra de jefe o títulos para la cuenta atrás, y mensajes en el chat para las muertes y el ganador.

  6. 6.Genera, compila y juega una ronda

    Descríbeselo a Codexe, deja que lo compile y entra al servidor de prueba con Pruébalo ahora. Pon un mínimo de jugadores bajo mientras pruebas para que pueda empezar una ronda.

Los estados de la partida

La mayoría de los errores de los minijuegos son jugadores haciendo algo en el estado equivocado. Escribir los estados en la petición hace que la IA construya el plugin en torno a ellos.

EstadoQué pasaReglas habituales
En esperaLos jugadores entran al lobbySin daño ni rotura de bloques; se sale con un objeto o un comando
IniciandoCuenta atrás al alcanzar el mínimoLa cuenta atrás se detiene si salen jugadores y se baja del mínimo
En juegoSe aplican las reglas del juegoNo se puede entrar, las muertes eliminan o hacen reaparecer, salir cuenta como derrota
TerminandoSe anuncia al ganador y se dan las recompensasLos jugadores vuelven a los pocos segundos y la arena se reinicia

Reiniciar la arena

  • Registrar y deshacer los cambios: guarda cada bloque antes de que cambie durante la ronda y vuelve a ponerlo al final. Rápido para arenas pequeñas donde los jugadores rompen o colocan pocos bloques.
  • Mundo plantilla: guarda una copia limpia del mapa, descarga el mundo jugado al terminar la ronda y copia la plantilla encima. Sencillo y fiable para mapas que acaban destruidos.
  • Sin cambios permitidos: en juegos como parkour o duelos PvP, cancela por completo los cambios de bloques y no hay nada que reiniciar.

Descripción de ejemplo

«Un plugin de minijuego de spleef para Paper 1.21.4. Los administradores crean arenas con /spleef create <name>, /spleef setlobby y /spleef setfloor (las dos esquinas del suelo de nieve). Los jugadores entran con /spleef join <arena>. La ronda empieza 15 segundos después de que haya 2 jugadores, hasta un máximo de 8. Los jugadores reciben una pala de diamante, rompen la nieve al instante y quedan eliminados cuando caen por debajo del suelo. El último jugador en pie gana 50 monedas a través de Vault. Los jugadores eliminados pasan a espectadores. El suelo de nieve se restaura después de cada ronda. Marcador lateral con los jugadores que quedan y el tiempo. Arenas guardadas en arenas.yml, mínimo de jugadores y recompensas en config.yml.»

Probar un minijuego

Un minijuego es difícil de juzgar por el código: tienes que jugar una ronda. Pruébalo ahora inicia un servidor Paper privado de tu versión con el plugin instalado, normalmente en un mundo plano, y tus amigos pueden entrar si los añades en Acceso al servidor. El plan Free permite 2 personas en un servidor de prueba, Pro 5, Business 10 y Enterprise 20.

Pide el mínimo de jugadores en config.yml para poder ponerlo en 1 o 2 mientras pruebas. Los jugadores de prueba también pueden entrar, ejecutar los comandos de entrada y de administración y comprobar los mensajes, lo que detecta comandos rotos antes de que juegues.

Preguntas

¿Una arena o varias?

Pide varias arenas desde el principio. Convertir más tarde un plugin de una sola arena en uno de varias obliga a reescribir cómo se guardan los jugadores y el estado de la partida.

¿Puedo crear un minijuego PvP para la 1.8?

Sí. Indica Spigot o Paper 1.8.8 en la petición: Codexe escribe el código para esa API antigua, y los servidores de prueba funcionan con versiones de la 1.8 a la 26.3.

¿Cómo funcionan las redes de minijuegos?

Las redes grandes ejecutan cada juego en su propio servidor detrás de un proxy BungeeCord o Velocity, con un servidor lobby que envía a los jugadores a una partida libre. Eso es un plugin de proxy más un plugin de juego, en dos proyectos.

Crea tu minijuego

Este prompt se abre listo para enviar:

“Un plugin de minijuego de spleef para Paper 1.21.4: arenas creadas con /spleef create, setlobby y setfloor, los jugadores entran con /spleef join, la ronda empieza 15 segundos después de que haya 2 jugadores (máximo 8), palas de diamante, eliminado al caer por debajo del suelo, el último jugador gana 50 monedas a través de Vault, espectadores para los eliminados, suelo de nieve restaurado después de cada ronda, marcador lateral con los jugadores que quedan y el tiempo, arenas guardadas en arenas.yml.”

Genera esto con Codexe
Cómo crear un plugin de minijuegos para Minecraft | Codexe