Guía para crear y editar ladders en Cumber (1.8 y 1.21)

Qué es un ladder#

Un ladder es un modo de juego de Practice: NoDebuff, BuildUHC, Sumo, Boxing… Cada ladder se define una sola vez y lo leen todos los servidores de la red (hub, arenas, FFA). No hace falta programar: se crea y se edita dentro del juego con /ladder y menús.

Un ladder se compone de:

• Nombre: identificador único (NoDebuff). Es la clave que usan la cola, las arenas, las estadísticas y los rankings.
• Ícono: el ítem que lo representa en los menús de cola y duelos.
• Kit: armadura y 36 ranuras de inventario con las que empieza cada jugador.
• Components: reglas que se le suman (construir, vidas, morir en el agua, bolas de fuego…). Un ladder sin components es un 1v1 de kit puro, sin reglas extra.
• Tags: etiquetas para agrupar ladders en la cola (por ejemplo Build, Classic).
• Estado: habilitado o no, ranked o no, fecha de lanzamiento y en qué casilla aparece en cada cola.

Dónde viven los datos: en la colección ladders de Mongo. Cuando guardas un ladder, el servidor avisa por Redis y los demás servidores lo recargan solos, sin reiniciar.

Antes de empezar#

• Permiso: cumber.command.ladder para todos los subcomandos de /ladder.
• Dónde: los menús son de jugador, así que se hacen desde el hub (o cualquier servidor con el módulo core) y no desde la consola. /ladder list y /ladder delete sí funcionan desde consola.
• Un solo jar para 1.8 y 1.21: Cumber corre con el mismo jar en Paper 1.8 y 1.21+. Los ladders son compartidos: el mismo documento lo leen servidores 1.8 y 1.21. Por eso al armar el kit y las listas de bloques hay que respetar la sección Diferencias entre 1.8 y 1.21.
• Nombres sin espacios: /ladder create toma una sola palabra. Usa el nombre final, con la mayúscula que quieres: distingue mayúsculas (Sumo y sumo son ladders distintos). No lo cambies después, porque cola, arenas y estadísticas lo usan como clave.

Crear un ladder paso a paso#

Paso 1: crearlo#

/ladder create BuildUHC

Se crea con el ícono de bedrock, deshabilitado, sin kit, sin components y sin tags. Hasta que lo habilites no aparece en ninguna cola.

Paso 2: abrir el editor#

/ladder edit BuildUHC

O /ladder list y haz clic en el nombre. Se abre el menú principal del ladder (ver siguiente sección).

Paso 3: ícono#

Toma en el cursor el ítem que quieres como ícono y haz clic en el marco de ítem (centro). Con Shift + clic vuelve a bedrock.

Paso 4: kit#

Botón de la pechera de diamante. Te pone en modo editor (ver El editor de kit).

Paso 5: components#

Botón del comparador: agrega las reglas del modo (ver Components).

Paso 6: publicarlo#

1. Asígnale uno o más match types (Ranked, Unranked…) y una casilla en la cola (ver Hacerlo aparecer en la cola).
2. Habilítalo con el botón de la palanca y, si es competitivo, márcalo ranked (espada de diamante).
3. Revisa que haya arenas que lo acepten (ver Arenas).
4. Pruébalo con /duel antes de abrirlo a todos.

El menú principal#

/ladder edit <ladder> abre un menú de 4 filas:

Habilitar, ranked y el ícono se guardan al instante y el menú se refresca solo.

El editor de kit#

Al pulsar la pechera:

1. Tu inventario se limpia y se carga el kit actual del ladder (armadura incluida).
2. Pasas a creativo.
3. Aparece en el chat un botón [EXIT].

Arma el kit como lo quieres:

• La armadura va en las ranuras de armadura; el resto en el inventario y la barra rápida.
• Las pociones se guardan con su efecto (ver diferencias de versión más abajo).
• Los ítems con nombre importan: una manzana dorada llamada Golden Head activa el component Golden Head.
• Los ítems con encantamientos, nombre, lore y cantidad se guardan tal cual.

Para terminar, pulsa [EXIT] o escribe /ladder close. En ese momento:

• El kit se guarda (armadura + inventario) en el ladder.
• Todo el ladder se guarda (ícono, habilitado, ranked, components…) y se avisa a los demás servidores.
• Tu inventario se resetea y vuelves al menú.

Si cierras sesión o te desconectas sin salir del editor, el kit no se guarda (se descarta la edición). Sal siempre con [EXIT] o /ladder close. Solo se guardan las 36 ranuras del inventario y la armadura: la mano secundaria (1.9+) no forma parte del kit.

Cada jugador puede reordenar el kit a su gusto desde su propio editor de disposición. Esas disposiciones son un reacomodo del kit del ladder: si cambias después un ítem del kit, puede que algunos jugadores conserven su disposición anterior hasta que la rehagan.

Components: las reglas del ladder#

Un component es una regla que se suma al ladder. Se gestionan desde el comparador:

• Agregar: botón verde (dye lima) arriba a la derecha. Se abre la lista de components que el ladder aún no tiene. Al elegir uno se agrega con sus valores por defecto y se guarda.
• Editar: clic izquierdo sobre el component si tiene ajustes. Los que no tienen ajustes avisan "This component has no settings".
• Quitar: Shift + clic derecho. Se quita al instante.

Dentro de la pantalla de ajustes:

• Números: clic izquierdo sube, clic derecho baja. Muchos tienen Shift + clic para cambiar de a más (lo dice el lore).
• Interruptores: un clic alterna Enabled / Disabled.
• Listas por chat (bloques permitidos, efecto, duración): el menú se cierra, escribes en el chat y vuelve. Escribe cancel para salir sin cambios.

Los ajustes se guardan al cerrar la pantalla. Los cambios hechos por chat (listas de bloques, efecto) se aplican al instante en el ladder en memoria; para asegurarte de que quedan en Mongo, termina con el editor de kit (/ladder close), que guarda el ladder completo.

Components sin ajustes#

Components con ajustes#

Fireball (todos con clic izquierdo + / derecho −, Shift cambia de a más):

Avisos importantes de los components con ajustes:

• Limited Duration: el valor inicial es 15 minutos. Antes de la corrección del 2026-10-13 nacía en 24000: si un ladder viejo quedó con ese valor, ajústalo con Shift + clic.
• Effect: la duración se escribe como tiempo (30s, 5m) y el menú la muestra en segundos. Con duración 0 no se aplica nada. El efecto se da a todos al empezar la partida. El amplificador empieza en 0 (nivel I): Resistencia V es amplificador 4. Los ladders guardados antes del cambio conservan su valor en ticks (el menú lo muestra dividido entre 20).
• TNT: los ajustes de romper bloques y de daño ya no aparecen en el menú porque nunca tuvieron efecto: la explosión de la TNT tiene fuerza fija y no rompe bloques. En Fireball "Break Blocks" y "Allowed Blocks" sí funcionan y solo rompen bloques puestos por jugadores.
• Lista de bloques por nombre: se escribe el nombre exacto del Material, y ese nombre cambia entre 1.8 y 1.21 (ver más abajo).

Camas (Conditional unlimited reappearance)#

Cada equipo defiende una cama: mientras exista, sus jugadores reaparecen en su spawn al morir; cuando un rival la rompe, la siguiente muerte de cada jugador del equipo es una eliminación. Es el modo BedFight/Bedwars.

• Qué cama es de cada equipo: la que marques con un cartel (línea 1 el color del equipo en mayúsculas, línea 2 bed) puesto a menos de 3 bloques de la cama. Si no hay cartel, se usa la cama más cercana al spawn del equipo (hasta 16 bloques). Un equipo sin cama encontrada no reaparece y el log lo avisa.
• Romper camas: solo se puede romper la cama del rival; la propia no. Al romperla se avisa a toda la partida y la cama no suelta ítem. Se restaura al terminar la partida.
• Cualquier color de cama vale, en 1.8 y en 1.21.
• Las camas que no pertenecen a ningún equipo siguen protegidas como cualquier bloque del mapa.

Components que hoy no hacen nada#

No los agregues; no tienen efecto:

• Best Of Type: no está registrado, no aparece en la lista.

Etiquetas (tags)#

Los tags agrupan ladders en la cola. Un tag es global: se crea una vez y se le pone a varios ladders.

Comandos de tags#

Ponerle tags a un ladder#

• Botón de la estantería en el menú principal: los tags del ladder (libro verde = ya lo tiene, papel = disponible). Un clic agrega o quita y guarda.
• O en Ajustes avanzados → Set ladder tag.

El casillero de cola de un tag (queueSlot) y si "pone en cola todos sus ladders al hacer clic" no se editan con comandos hoy: son campos del documento del tag en Mongo. Los comandos /laddertag piden el permiso cumber.command.ladder. Si renombras un tag, los ladders que lo tenían lo siguen guardando con el nombre viejo: vuelve a ponérselo.

Hacerlo aparecer en la cola#

Para que un jugador pueda entrar a la cola de un ladder deben cumplirse todas estas condiciones:

1. El ladder está habilitado (palanca).
2. Pertenece al match type que el jugador eligió (Ranked, Unranked…). Se añade en el menú de configuración de colas del hub: /cumber setup → ajustes de cola → el match type → Add ladder. Ahí también se cambian equipos y jugadores por equipo.
3. Si el match type es ranked, el ladder debe ser ranked (espada de diamante).
4. Su fecha de lanzamiento ya pasó (si tiene una).
5. Hay al menos una arena que lo acepte.

Casillas de la cola#

En Ajustes avanzados (yunque):

Para que el ladder vuelva al primer hueco libre del menú, usa Show in Queue y escribe auto (casilla -1, el valor por defecto de un ladder nuevo). Ocultarlo solo lo quita del menú de ese match type; para cerrarlo del todo, deshabilítalo (palanca).

Fecha de lanzamiento: hasta esa fecha el ladder sale en la cola como un tinte rojo con la fecha y no se puede entrar; después es normal y durante un tiempo se marca como "nuevo". Usa la zona horaria del servidor. Escribe none para quitar la fecha.

Arenas y ladders#

Cada arena dice para qué ladders sirve (/arena edit <nombre> → Tipos de arena). Lista vacía = sirve para todos. Un ladder que no esté en ninguna arena queda sin mapa y sus partidas no arrancan. Los detalles de qué pide cada ladder del mapa (agua para Sumo, aire para construir…) están en la guía de arenas.

Diferencias entre 1.8 y 1.21#

El código es el mismo y el ladder es el mismo, pero los ítems y los nombres de materiales no. La regla de oro: construye el ladder en el servidor de la versión más baja que lo va a jugar.

Checklist de compatibilidad antes de publicar#

1. ¿El kit está armado en el servidor de la versión más baja que lo va a jugar?
2. ¿Todos los ítems existen en esa versión? (sin escudo, tótem, élitros…)
3. ¿Las listas de bloques y el nombre del efecto están en nombres válidos en ambas versiones, o el ladder solo corre en una?
4. ¿Probaste una partida en cada versión en la que el ladder estará activo (/duel)?
5. Reentra al editor de kit y /ladder close una vez en la versión final para fijar los datos de pociones.

Cómo se guarda y se propaga#

• Todo lo que se hace desde el menú guarda el ladder en el momento: ícono, habilitar, ranked, nombre, components, tags y ajustes avanzados. Las listas por chat de los components quedan en memoria hasta el siguiente guardado (cerrar la pantalla de ajustes o salir del editor de kit).
• Forma segura de guardar: abre el editor de kit (pechera) y sal con /ladder close. Guarda todo el ladder.
• Al guardar, el servidor escribe en Mongo y manda una señal por Redis; los demás servidores recargan ese ladder en el momento. No hace falta reiniciar hub ni arenas.
• Si un ladder no carga al iniciar un servidor (documento dañado, por ejemplo una imagen de ítem corrupta), el log dice Failed to load ladder y el ladder falta solo en ese servidor. Un component con ajustes ilegibles ya no tumba el ladder: se omite y el log dice Failed to deserialize settings of component.

Borrar un ladder#

Pedernal en el menú (pide confirmación), o:

/ladder delete BuildUHC

Borra el ladder de Mongo y de todos los servidores. No quita su nombre de los match types ni de las listas de Tipos de arena: quítalo también ahí, o quedará una referencia colgada.

Comandos de referencia#

Permisos: cumber.command.ladder (ladder) y cumber.command.setup (setup).

Problemas comunes#

Glosario#