Mobs y modelos

Dos módulos que funcionan juntos y por separado. Models pone un modelo de Blockbench sobre cualquier entidad viva, dibujado con displays de bloque, objeto y cabeza, así que no hace falta resource pack. Mobs convierte una plantilla en una entidad viva con nombre, equipo, atributos, habilidades, fases de combate y reacciones, y puede llevar uno de esos modelos.

Los modelos necesitan PacketEvents. Un mob es una entidad real, pero lo que dibuja (avisos, reacciones, un modelo) son displays y necesita PacketEvents como cualquier otro. Ningún módulo tiene comando: cada editor de abajo se abre desde código.

Modelos

Deja un archivo de Blockbench en la carpeta del plugin y ponlo por nombre:

plugins/<TuPlugin>/models/stone_golem.bbmodel
plugins/<TuPlugin>/models/stone_golem.animation.json   (opcional)

El nombre del modelo es el nombre del archivo en minúsculas. La carpeta se revisa como mucho una vez por segundo, así que guardar en Blockbench es el reload. Un <nombre>.animation.json (o <nombre>.json) de Bedrock o GeckoLib al lado añade animaciones.

PluginModels models = Models.of(this);
 
ModelOptions options = ModelOptions.DEFAULT
        .withScale(1.3)
        .withState(ModelState.ATTACK, "animation.golem.smash");
 
ModelInstance golem = models.attach(zombie, "stone_golem", options);
if (golem != null) {
    golem.onEvent(event -> {
        if (event.equals("impact")) shockwave(zombie.getLocation());
    });
}

Qué se lee

Los grupos pasan a ser huesos con sus pivotes y rotaciones, y cada cubo pasa a ser un display. Se leen keyframes de rotación, posición y escala con interpolación lineal, por pasos, Catmull-Rom y Bézier; los keyframes de timeline, sonido y partícula llegan como eventos por onEvent. Se leen proyectos de Blockbench 4 y 5. Las mallas, los locators y Molang se reportan una vez en problems(name) y se dejan fuera.

Cómo se dibuja un cubo sin resource pack

Gana la primera coincidencia:

1. Un sufijo en el nombre. body@stone o @minecraft:gold_block es ese bloque, @diamond_sword ese objeto. @mainhand, @offhand y @helmet muestran lo que el portador tiene o lleva en ese hueco. @head pone la textura en una cabeza de jugador, @hide no dibuja nada. El sufijo de un grupo se aplica a cada cubo suyo que no tenga uno propio.
2. Su textura. Un cubo cuyos texels coinciden todos con un bloque es ese bloque. Un cubo con diseño pasa a ser una cabeza de jugador con textura hecha con Exylia Skins, mostrada como su bloque principal hasta que la cabeza está lista.
3. Sin textura. Hormigón gris claro.

Opciones

Animaciones según el estado

El modelo reproduce idle, walk y run por su cuenta según la velocidad del portador, y attack, hurt, death, spawn y los lanzamientos cuando ocurren. Una animación se empareja con un estado, en orden, por: la opción states; su nombre exacto o la parte tras el último punto (animation.golem.walk); un nombre que contiene el estado como palabra (golem_walk_cycle). Un lanzamiento cast:<habilidad> busca <habilidad>, cast_<habilidad>, <habilidad>_cast, cast y luego attack; run sin nada encontrado reproduce walk. Las fases de combate eligen <estado>_p2 antes que <estado> cuando el mob está en la fase 2.

Las piernas se encuentran por el nombre de sus huesos (leg, thigh, knee, foot, paw, hoof…). Sus pies se quedan en el suelo: plantados al andar, con el cuerpo inclinándose un poco en las cuestas.

Ajustes y su editor

ModelTweaks guarda lo que un dueño de servidor ajusta sin abrir Blockbench: un desplazamiento, huesos ocultos o dibujados en otro material, una velocidad por estado y un tamaño de hitbox.

models.tweakEditor("stone_golem", options)
        .title("Gólem de piedra")
        .onSave(saved -> store(saved))
        .open(player);

El editor lista los huesos cambiados y tiene botones para tamaño y posición, velocidades, hitbox, y una vista previa que pone el modelo delante del jugador y va pasando sus animaciones.

Mobs personalizados

PluginMobs mobs = Mobs.of(this);
 
MobTemplate golem = MobTemplate.of("stone_golem", EntityType.IRON_GOLEM)
        .withName("{primary}&lGÓLEM DE PIEDRA &8[{success}%health%&8/{info}%max_health%&8]")
        .withAttributes(Map.of("max_health", 220.0, "attack_damage", 9.0))
        .withFlags(Set.of(MobFlag.AGGRESSIVE, MobFlag.NO_VANILLA_DROPS, MobFlag.BOSS_BAR))
        .withSkills(List.of(MobSkills.preset("slam").skill(), MobSkills.preset("judgement").skill()))
        .withFight(MobFight.NONE
                .withGlobalCooldown(Duration.ofMillis(1500))
                .withPhases(List.of(new MobPhase(0.5, "enrage", "{error}☠", 1.25, 1.3, 1, 1.15, "#ff3b3b"))))
        .withModel(MobModel.of("stone_golem").withScale(1.3).withDeath(MobModel.Death.ANIMATION_APART))
        .withExp(120);
 
mobs.register(golem);
mobs.spawn(golem, spot);                       // cualquier hilo; un CompletableFuture<LivingEntity>
mobs.onDeath(death -> { /* pagar a death.killer() */ });

%health% y %max_health% en el nombre se redibujan con cada golpe y curación. Volver a hacer register con el mismo id sustituye la plantilla, así que recargar es volver a registrar.

La plantilla

La librería no guarda plantillas. Un plugin las guarda donde quiere; MobCodec convierte cada parte en un texto JSON para una columna de base de datos y al revés, dejando fuera los valores por defecto y saltando una pieza mala con un aviso en vez de tirar la plantilla entera.

Modo golpes

MobBehaviour con hits por encima de cero hace que la vida deje de importar: solo cuenta el cuerpo a cuerpo de un jugador, un golpe por jugador cada hitCooldown, y el último golpe lo rompe (MobDeath.Cause.BROKEN). Es la piñata, la caja que hay que abrir a golpes. lifetime quita el mob al cabo de un rato (Cause.EXPIRED), y roam lo ata a donde apareció: pasados esos bloques vuelve andando, y ocho más allá se le teletransporta de vuelta.

Habilidades

Una habilidad es un disparador, un tipo y sus números:

Lanzamientos

Un cast convierte una habilidad en un movimiento que un jugador puede leer y esquivar: una preparación que deja quieto al mob y muestra un aviso en el suelo, un impacto y una recuperación corta.

La biblioteca de habilidades

MobSkills.library() tiene presets listos, cada uno un lanzamiento por etapas con su estilo: slam, meteor, blades, charge, chain, bubble, portal, miasma, nova, blink, renew, enrage, rain, pounce, hook, volley, cleave, fissure, vortex, dread, eruption, smite, judgement, supernova, tempest, starfall y prism. MobSkills.preset(id).skill() es la habilidad; el editor de un plugin usa la lista como menú. mobs.preview(player, skill) lanza una con un doble de cristal que solo ve ese jugador, y no impacta nada.

mobs.theme(MobTheme) pone los colores con los que dibuja cada habilidad — aviso, peligro, curación, escudo, arcano, fuego, hielo, veneno, descarga y crítico —, tokens de la paleta por defecto.

Fases

MobFight guarda un cooldown global entre movimientos, el periodo de cada grupo de rotación, y las fases. Una MobPhase empieza por debajo de una parte de la vida y reproduce su style (enrage si está vacío, none para nada), añade un suffix al nombre, y multiplica velocidad, daño, daño recibido (resist) y tamaño, con un contorno opcional. Un modelo pasa a sus animaciones _p2 con ella.

Aspecto y reacciones

MobLook pone la variante, el cuerpo, el contorno y el aura, y cuatro reacciones, cada una AUTO salvo que se ponga otra:

numbers muestra números de daño flotantes. none apaga una reacción. mobs.visuals(MobVisuals) pone el techo del servidor: rango de los indicadores, lanzamientos dibujados a la vez, reacciones sí o no, y sacudida de cámara.

Un modelo en un mob

MobModel.of("stone_golem") pone un modelo a cada mob de la plantilla, con su escala, estados, ajustes y una muerte:

Los cubos de modelo cuentan contra max-model-parts en displays.yml.

Plantillas aleatorias

MobTemplate.random(id, random) saca un mob con rango para enseñar lo que puede ser una plantilla: un elite, un champion o, rara vez, un boss, cada uno con vida, daño, armadura, un repertorio de la biblioteca, fases y, desde champion, combos que encadenan dos movimientos. La misma semilla da el mismo mob. Nunca usa modo golpes, recompensas ni modelo.

Golpes, muertes y los editores

Quita los manejadores en onDisable, o un plugin apagado y vuelto a encender recibe los avisos dos veces.

El almacén compartido

ExyliaMobs guarda sus plantillas en su propia base de datos y las ofrece a través de MobStore, así que otro plugin puede spawnearlas sin depender de él:

Mobs.store().ifPresent(store -> {
    MobTemplate template = store.mobs().template("pinata_classic");
    if (template != null) store.mobs().spawn(template, spot);
});

stored() lee cada plantilla con sus pagos, save(template, payouts) escribe una, y edit(player, id, back) abre el editor propio del almacén. El almacén desaparece cuando su plugin se desactiva.