UltraBoss

UltraBoss es un plugin de Paper hecho por Social Studio (su creador firma como GupeLegend), con la colaboración de cantv@us, para crear tus propios jefes y convertirlos en un evento que todo el servidor ve venir. En vez de jefes que reemplazan mobs al azar donde nadie los encuentra, UltraBoss avisa con tiempo, hace aparecer al jefe lejos de los jugadores y anuncia sus coordenadas: hay que organizarse e ir a buscarlo. Cada jefe pelea por fases, tiene habilidades, invoca esbirros con límite, suelta botín de cualquier plugin y puede dejar un trofeo de recuerdo.

Descripción general

UltraBoss trae un jefe de ejemplo completo y comentado (ejemplo): su equipo, sus habilidades, sus fases, su botín, su diálogo, un arma con habilidades propias y un trofeo. Está pensado para que veas cada opción funcionando y armes tus jefes a partir de él, desde el archivo o desde el editor del juego.

BOSS » A boss appears in 15m.
BOSS » Ejemplo appeared at 312 68 -1204 (world).

Míralo en acción

El jefe de ejemplo contra dos jugadores: barra de jefe, esbirros, el cambio a la fase 2 y sus habilidades.

Características principales

• Un evento con aviso y coordenadas: el servidor se entera antes (15, 5 y 1 minuto por defecto) y, cuando aparece, todos reciben el lugar exacto.
• Lejos de todos: aparece entre 1000 y 1100 bloques de un jugador al azar, y nunca a menos de 1000 de otro. Es un destino, no algo con lo que te tropiezas.
• Cada jefe en su bioma: uno del desierto sale en desiertos, uno de cueva sale bajo tierra y uno de agua sale en el agua.
• Peleas de verdad: tres estados (en reposo, alerta y en combate), fases por vida, habilidades que avisan antes de pegar y una correa que lo devuelve a su arena.
• Esbirros con límite: cada jefe lleva la cuenta de los suyos, con tope por jefe, por mundo y por zona. Los esbirros nunca sueltan botín.
• Equipo y botín de cualquier plugin: armaduras, armas y drops se guardan completos, con nombre, modelo, encantamientos y datos ocultos de otros plugins.
• Armas de jefe con habilidades: agachado + clic derecho y agachado + clic izquierdo, cada una con su tiempo de espera.
• Trofeos sin resource pack: objetos de colección que no se pueden comer, fundir, fabricar ni intercambiar.
• Editor completo en el juego (/ub): todo lo del archivo se puede cambiar desde menús.
• Hasta 32 jefes (los esbirros no cuentan) e ítems sin límite.
• Inglés y español: mensajes, menús, nombres de jefes y diálogos.

Requisitos y compatibilidad

Importante: Paper limita la vida de cualquier mob a 1024. Para jefes con más vida, en spigot.yml pon settings.attribute.maxHealth.max: 8192 y reinicia. UltraBoss lo avisa en la consola y en /ub validate. El jefe de ejemplo tiene 800, así que funciona sin tocar nada.

Instalación y primeros pasos

1. Descarga el .jar de UltraBoss y ponlo en la carpeta plugins/ de tu servidor.
2. Inicia el servidor. En una instalación nueva el evento queda encendido y se crea el jefe de ejemplo.
3. Revisa la consola: debería aparecer UltraBoss v… enabled.
4. Ajusta los archivos de plugins/UltraBoss/ (ver Configuración) y ejecuta /ub reload.

Los datos viven en plugins/UltraBoss/:

Nota: si tu servidor ya tiene sus propios jefes, el de ejemplo no se agrega. Si vienes de una versión que guardaba todo en plugins/UltraView/UltraBoss/, los archivos se mueven solos la primera vez, sin pisar nada.

Sistema de eventos

Cuando aparece, el chat dice qué jefe salió y dónde.

Cada interval-minutes (45 por defecto) UltraBoss busca un lugar y hace aparecer un jefe:

1. Avisa antes, en los minutos de warn-minutes ([15, 5, 1]).
2. Elige a un jugador al azar y busca un punto entre radius-min y radius-max bloques de él (1000–1100), donde ningún otro jugador esté a menos de min-player-distance (1000).
3. Elige el jefe según el bioma de ese punto. Primero el lugar y después el jefe, así siempre cae en un sitio al que se puede llegar.
4. Si ningún jefe es de ese bioma, trae uno de la misma dimensión (nunca un jefe del Nether en el Overworld). Con fallback-any-biome: false, en vez de eso avisa que no encontró lugar y lo vuelve a intentar en retry-seconds.
5. Anuncia el jefe y sus coordenadas (announce-coords: true).

La búsqueda solo mira chunks que ya existen: nunca genera terreno nuevo y nunca deja chunks cargados a la fuerza. La cuenta regresiva y la ubicación del jefe actual sobreviven a /ub reload y a los reinicios.

Agua y cuevas. En agua abierta (océano, río) el punto queda dentro del agua, y solo salen jefes nadadores (guardianes, ahogados…): un jefe de tierra nunca aparece en el fondo del mar. Con cave-chance (0.3) la búsqueda del Overworld a veces busca un hueco bajo tierra, para que los jefes de cueva también salgan.

Cuántos jefes a la vez

max-per-world:
  overworld: 3
  nether: 3
  end: 3

max-per-world es el máximo de jefes vivos en un mismo mundo, de 1 a 5 por dimensión (también vale un solo número para todas). Cuenta los del evento, los naturales y los que invoca el staff, y un jefe que se divide al morir cuenta como uno. Los mundos personalizados usan el valor del Overworld.

¿Prefieres uno solo a la vez? despawn-previous: true retira al jefe anterior, pero solo cuando el nuevo ya está vivo; si el nuevo no llega a salir, el viejo se queda.

¿Prefieres los jefes de antes, reemplazando mobs al azar? Apaga el evento y pon natural-spawns: true. max-per-world y max-alive siguen poniendo el tope.

Mecánicas de combate

La barra de jefe muestra su vida; el nombre y el color salen de su archivo.

Tres estados

Alejarse no reinicia la pelea gratis: el jefe guarda su vida y su fase, cancela los ataques que tenía pendientes y, al volver, espera un momento (resume-delay-ticks) en vez de soltar de golpe todo lo que "hubiera pasado".

Fases y habilidades

Al bajar del 66 % de vida pasa a la fase 2: lo dice el chat y se despiertan las habilidades con min-phase: 2.

• Fases: phases: [0.66, 0.33] son fracciones de vida. Fase 2 al 66 %, fase 3 al 33 %. Las habilidades con min-phase o max-phase solo funcionan en esas fases, así la pelea se pone más dura en vez de ser un intercambio largo.
• Disparadores (trigger): spawn (al aparecer), timer (cada period ticks), phase (al entrar a una fase), attack (al pegarle a un jugador), damaged (al recibir daño) y death (al morir).
• 19 tipos de habilidad: potion_aoe, potion_self, damage_aoe, ignite, explosion, web_trap, cage, mud_trap, tnt_trap, knockback, pull, summon, lightning, heal, arrows, evoker_fangs_circle, evoker_fangs_line, message y sound. El editor trae más de 40 recetas armadas con ellos.
• Avisan antes de pegar: los golpes fuertes (daño en área, explosiones, invocaciones) suenan una campana y marcan un anillo de partículas donde van a caer (telegraph-ticks, 30). Durante ese aviso el jefe se queda quieto.
• Al aparecer, solo las habilidades de ambiente (una frase o un sonido) suenan enseguida. Las de combate, como una invocación inicial, esperan a que empiece la pelea.

Esbirros con límite

Cada jefe lleva la cuenta de sus propios esbirros vivos:

Si una oleada pasaría algún tope, se recorta. Un esbirro montado en otro mob cuenta doble. Los esbirros nunca sueltan botín ni experiencia.

La correa de la arena

Cada jefe recuerda dónde nació. Si lo alejas más de leash-radius (96 bloques) o leash-height (48), cancela lo que estaba haciendo, avisa y vuelve a su origen, solo si ese lugar está cargado y es seguro. No se cura en el camino.

Consejo: todos los valores de la pelea están en SpawnMobs/config.yml, en la sección encounter, y cada jefe puede cambiarlos en su propio archivo.

Diseña tu propio jefe

Cada jefe es una entrada de YAML en SpawnMobs/mobs/. El de ejemplo, ejemplo.yml, tiene cada opción comentada:

ejemplo:
  type: ZOMBIE
  display: '&6&lEjemplo'
  health: 800
  damage: 12
  armor: 6
  equipment: { HAND: EjemploEspada, OFF_HAND: SHIELD, HEAD: GOLDEN_HELMET }
  bossbar: { enabled: true, color: YELLOW, style: SEGMENTED_12, range: 40 }
  dialog: ejemplo
  phases: [0.66, 0.33]          # fase 2 al 66 % de vida, fase 3 al 33 %
  skills:
    lentitud: { type: potion_aoe, trigger: timer, period: 160, radius: 8, effect: SLOWNESS }
    rayos:    { type: lightning, trigger: timer, period: 140, min-phase: 3, range: 24 }
  drops:
    - { item: EjemploTrofeo, chance: 1.0 }
    - { vanilla: DIAMOND, chance: 0.2 }
    - { xp: 150 }
  spawn:
    natural: true
    biomes: [PLAINS, FOREST, MEADOW]

Los tiempos van en ticks: 20 ticks = 1 segundo.

Nota: el límite es de 32 jefes (los esbirros no cuentan). Si en los archivos hay más, los que sobran no se cargan y aparecen en /ub validate; /ub create no deja crear el 33.

Editor visual en el juego (/ub)

/ub muestra tus jefes con su vida, daño, armadura, fases, habilidades y probabilidad de aparición.

No hace falta abrir ningún archivo: /ub es un editor completo. La pantalla principal dice cuántos jefes usas de los 32 y cuántos están vivos en cada mundo. Al tocar un jefe se abre su menú:

El menú de un jefe: cada fila es una parte de su archivo.

• Armadura y armas: toma un ítem de tu inventario y haz clic en un espacio, o shift + clic en el ítem. Clic derecho vacía el espacio. Funciona con zombis, esqueletos, piglins, saqueadores, vindicadores, evocadores y vexes.
• Botín: shift + clic en cualquier ítem del inventario y se vuelve un drop tal cual es. La cantidad es la de tu pila y la probabilidad empieza en 100 %; clic izquierdo para ajustarla, clic derecho para quitarlo.
• Habilidades, fases, apariencia, diálogo y aparición, cada uno con su menú.

Tu ítem nunca se gasta: se copia. Los ítems de otros plugins se guardan completos (nombre, modelo, encantamientos y datos ocultos), así que funcionan sin ninguna integración. El jefe nunca suelta su equipo.

/ub create <id> crea un jefe nuevo y /ub delete <id> borra su definición.

Armas, trofeos y apariencia

Armas con habilidades

Un ítem de jefe puede tener una habilidad con agachado + clic derecho (ability:) y otra con agachado + clic izquierdo (ability-left:), cada una con su tiempo de espera. El ejemplo es EjemploEspada, en items/items.yml. Hace falta agacharse a propósito: así el uso normal del arco, la ballesta, el tridente y el escudo no cambia.

Trofeos

Con trophy: true un ítem se vuelve un objeto de colección: un material vanilla con su propio nombre, descripción y brillo, que se apila hasta 64. No necesita resource pack. Un trofeo no se puede comer, usar de combustible, fundir, usar en pociones, fabricar, intercambiar con un piglin ni darle de comer a un animal, y uno hecho con un tótem de la inmortalidad no salva la vida. Sí se puede renombrar en un yunque. El ejemplo es EjemploTrofeo.

¿Tienes un ítem de otro plugin que quieres dar o soltar? Tenlo en la mano y usa /ub item import <id>.

La cara de un jugador

/ub skin ejemplo Notch

La skin se pide a Mojang una sola vez y se guarda en skins.yml; después el jefe ya no depende de esa cuenta. Necesita LibsDisguises para mostrarla; sin él, el jefe conserva su mob base.

EcoItems

drops:
  - { ecoitem: legendary_sword, chance: 0.15 }

UltraBoss funciona igual sin EcoItems: si el id no existe, solo se salta ese drop.

Referencia de comandos

• /ub remove <id> retira todas las peleas de ese jefe; un UUID elige una sola. near elige el jefe cargado más cercano (32 bloques) y all retira todos, incluso los de chunks descargados. En español también valen eliminar, cerca y todos.
• Retirar no da botín, experiencia ni habilidades de muerte, y limpia sus esbirros. El /kill de vanilla también retira a un jefe, incluso si está pausado.
• /ub m spawn no invoca un jefe si su mundo ya llegó a max-per-world (los esbirros siempre se permiten).

Permisos

Los jugadores no necesitan ningún permiso para pelear contra los jefes.

Configuración avanzada

SpawnMobs/config.yml tiene los ajustes del motor:

enabled: true

event:
  enabled: true
  interval-minutes: 45        # cada cuánto aparece un jefe
  warn-minutes: [15, 5, 1]    # avisos antes
  radius-min: 1000            # distancia al jugador elegido
  radius-max: 1100
  min-player-distance: 1000   # ningún otro jugador más cerca que esto
  max-attempts: 20
  despawn-previous: false     # true = uno solo del evento a la vez
  announce-coords: true
  fallback-any-biome: true
  cave-chance: 0.3            # a veces busca el punto bajo tierra
  retry-seconds: 60

natural-spawns: false         # jefes reemplazando mobs al azar
max-per-world: { overworld: 3, nether: 3, end: 3 }
max-alive: 0                  # tope de todo el servidor para los naturales (0 = sin tope)
ignore-unnatural: true        # los naturales no salen de spawners ni huevos
idle-despawn-minutes: 30      # un jefe que nadie pelea se va solo
tick-period: 10               # cada cuántos ticks corre el motor
on-kill-commands: []          # comandos al matar un jefe: %player% %boss% %boss_snake%

La sección encounter tiene los valores de la pelea que se ven en La pelea. El config.yml de la raíz solo tiene language:.

Idiomas y traducciones

Inglés (por defecto) y español. language: cambia todo: mensajes, menús, nombres de jefes, nombres y descripciones de armas y cada frase de los diálogos. Los jefes que crees en el juego conservan el nombre que les escribiste.

Preguntas frecuentes

¿El jefe aparece encima de los jugadores? No. Aparece entre 1000 y 1100 bloques de un jugador al azar y a más de 1000 de cualquier otro. Para pruebas puedes bajar radius-min, radius-max y min-player-distance.

¿Genera terreno nuevo para buscar dónde poner al jefe? No. Solo mira chunks que ya existen y nunca deja chunks cargados a la fuerza.

¿Puedo tener más de 32 jefes? No: el tope es fijo para que el plugin siga liviano. Los esbirros no cuentan y los ítems no tienen límite.

¿Mi jefe tiene 1024 de vida aunque le puse más? Es el tope de Paper. Sube settings.attribute.maxHealth.max en spigot.yml y reinicia.

¿Puedo usar ítems de ItemsAdder, Oraxen, Nexo o EcoItems? Sí. Desde el menú, el equipo y el botín guardan el ítem completo, sin integración. Para EcoItems también existe ecoitem: en el archivo.

¿Los esbirros dan botín? Nunca, ni ítems ni experiencia.

¿Qué pasa si nadie pelea contra el jefe? Después de idle-despawn-minutes (30) sin recibir daño, desaparece sin botín.

¿Funciona en Spigot? No. Usa la API de Paper. Funciona en Paper, Purpur y Folia.

¿Se conecta a internet? Solo cuando el staff usa /ub skin: le pide esa skin a Mojang una vez. Sin resource pack, sin puertos abiertos, sin estadísticas de uso.

Descargas y soporte

• GitHub (código abierto, licencia MIT): github.com/GupeLegend/UltraBoss
• Modrinth: modrinth.com/plugin/ultra-boss — se publica muy pronto.
• Social Studio: gupe.dev