Saltar al contenido principal

Comportamientos de mobs

Un comportamiento de mob es un archivo Lua que toma el control de la IA de un mob que FreeMinecraftModels no generó: un creeper generado de forma natural, una gallina, un saqueador de una incursión. Mientras dura la sustitución, el mob hace lo que dice el archivo. Después recupera su propia IA y se comporta como antes.

El plugin incluye cuatro comportamientos. Un creeper puede seguir a un jugador y explotar sobre quien ataque a ese jugador, una gallina puede volverse contra los jugadores y los saqueadores pueden huir asustados. Pones un comportamiento en un mob con un comando o desde un script Lua, durante un tiempo fijado o hasta que algo lo quite.

Disponibilidad según la versión

Los comportamientos de mobs necesitan la versión de FreeMinecraftModels posterior a la 2.15.0 y Minecraft 1.21.4 o posterior.

Qué hace una sustitución​

  • Los objetivos y el Brain propios del mob se detienen, así que no hace nada por sí mismo. Solo los comportamientos lo mueven, lo giran y lo hacen atacar.
  • Conserva todo lo demás: su salud, equipamiento, velocidad de movimiento y nombre, y la luz del sol sigue quemándolo.
  • Sigue desapareciendo cuando no hay ningún jugador a menos de 128 bloques, salvo que algo ya hubiera hecho que se quedara. La desaparición más lenta de un mob que se queda inactivo a entre 32 y 128 bloques de los jugadores no ocurre mientras está sustituido.
  • Se mueve y lucha como lo hace su tipo. Un creeper se hincha y explota, un esqueleto dispara flechas, un zombi golpea.
  • Un mob puede tener un dueño, un jugador o cualquier otra entidad viva. Sus propios ataques nunca dañan a su dueño: sus golpes, los proyectiles que dispara y la explosión de un creeper se cancelan. Los efectos de poción no se cancelan, ni tampoco nada que un comportamiento le haga al dueño mediante c.overlay.owner.
  • Cuando se acaba el tiempo o algo quita la sustitución, el mob recupera su propia IA. Un zombi vuelve a cazar jugadores y una gallina deambula.
  • La sustitución permanece en el mob tras descargas de chunks, reinicios del servidor y /fmm reload. Una con tiempo sigue contando mientras el mob está descargado, y desaparece si su tiempo se agotó entretanto. Las memorias de un comportamiento empiezan vacías cuando el mob vuelve.
  • Termina por sí sola cuando se acaba su tiempo, cuando el mob muere, cuando el mob se convierte en otro mob, como un aldeano en una bruja, o cuando un comportamiento llama a c.overlay:finish().

Comandos​

Todos necesitan el permiso freeminecraftmodels.mobbehaviors.admin, que tienen los operadores, y son solo para jugadores.

ComandoPropósito
/fmm mobbehavior apply <behaviors> [seconds] [radius]Sustituye la IA del mob al que miras, hasta a 32 bloques de distancia, por los comportamientos indicados, y te convierte en su dueño. Con un radio, toma en su lugar a todos los mobs que estén a esa cantidad de bloques o menos de ti en cada eje
/fmm mobbehavior applywild <behaviors> [seconds] [radius]Lo mismo, sin dueño
/fmm mobbehavior clearDevuelve su propia IA al mob al que miras
/fmm mobbehavior clear allDevuelve su propia IA a todos los mobs cargados con sustitución. Un mob en un chunk descargado conserva su sustitución y la retoma cuando el chunk se carga
/fmm mobbehavior listLista los comportamientos que se cargaron y cuántos mobs ejecutan uno
  • behaviors es un nombre, o varios separados por comas sin espacios, como coward,wander.
  • seconds es cuánto dura la sustitución. Omítelo, o usa 0, y dura hasta que se quite.
  • Un mob nunca ataca a su dueño ni le tiene miedo. Para probar hostile o coward contigo mismo, usa applywild.
  • hostile y coward no eligen a los jugadores en modo creativo o espectador, así que prueba en supervivencia. Un jugador en creativo que golpea al mob sigue siendo atacado o rehuido por el mob durante 10 segundos.
/fmm mobbehavior apply guardian
/fmm mobbehavior applywild hostile 30
/fmm mobbehavior applywild coward,wander 0 12

El primero hace que el creeper al que miras te siga y te defienda. El segundo hace que una gallina te ataque durante 30 segundos. El tercero hace que todos los mobs a 12 bloques o menos huyan de ti hasta que ejecutes clear all.

Comportamientos incluidos​

NombreQué hace el mob
guardianSe queda cerca de su dueño y lucha contra quien hiere a su dueño, contra aquel a quien hiere su dueño y contra quien lo hiere a él
hostileAtaca al jugador más cercano, o a lo que nombre su ajuste targets
cowardHuye del jugador más cercano, o de lo que nombre su ajuste fears
wanderPasea cuando nada más lo mueve

Un mob sustituido ha perdido su propio paseo junto con el resto de su IA, así que sin wander se queda quieto siempre que sus demás comportamientos no tienen nada que hacer. Añade wander a la lista, como en coward,wander. Su lugar en la lista no importa: la priority de un comportamiento decide cuál mueve al mob.

Un mob que dispara usa su golpe cuerpo a cuerpo en lugar de disparar cuando su objetivo está a menos de reach.

Las velocidades multiplican la velocidad de movimiento propia del mob, así que 1 es su paso normal. Las distancias están en bloques y los tiempos en ticks.

guardian​

Sigue a su dueño cuando este se aleja a follow_distance y se detiene a follow_stop de él. Lucha primero contra el atacante del dueño, después contra el suyo y por último contra el objetivo del dueño. Cada uno se recuerda durante 10 segundos tras el golpe. Sin dueño, solo se defiende a sí mismo.

AjustePredeterminadoSignificado
follow_distance6Cuánto se aleja el dueño antes de que el mob vaya tras él
follow_stop3A qué distancia se acerca
follow_speed1.2Velocidad mientras sigue
chase_speed1.3Velocidad mientras lucha
reach2.2A qué distancia se acerca para golpear
fuse_distance3Un creeper enciende su mecha a esta distancia de su objetivo
fuse_escape7La mecha de un creeper se apaga cuando el objetivo llega a esta distancia, o se pierde de vista
shoot_distance12Un mob que dispara lo hace desde esta distancia o menos, mientras ve al objetivo
attack_ticks20Tiempo entre dos golpes o disparos
assisttrueTambién lucha contra aquel a quien hiere el dueño
defend_itselftrueTambién lucha contra quien lo hiere a él

hostile​

Ataca a quien lo hirió en los últimos 10 segundos; si no, al objetivo más cercano dentro de range. Busca un objetivo nuevo cada 10 ticks. Con dueño, lo respeta a él y a los demás mobs que lo sirven.

AjustePredeterminadoSignificado
targetsplayerplayer, hostile, passive, living o un tipo de entidad como zombie
range16A qué distancia nota los objetivos
damage0Lo que inflige un golpe. 0 lo deja al ataque propio del mob, que es 2 para un tipo que no tiene ninguno, como una gallina
chase_speed, reach, fuse_distance, fuse_escape, shoot_distance, attack_tickscomo guardianComo en guardian

coward​

Empieza a huir cuando algo que teme se acerca a menos de range, y se detiene cuando eso está a safe_distance. También huye de quien lo hirió en los últimos 10 segundos, mientras ese atacante esté a menos de range, o a menos de safe_distance una vez que ya está huyendo. Cada huida planifica una ruta de unos diez bloques que se aleja de lo que lo asustó. En una sala o un corral sin una salida tan larga, retrocede hasta la pared del fondo.

AjustePredeterminadoSignificado
fearsplayerplayer, hostile, passive, living o un tipo de entidad como wolf
range10Cuánto se acerca algo que teme antes de que huya
safe_distance16A qué distancia deja de huir
speed1.5Velocidad mientras huye
cornered_distance6Cuánto intenta retroceder donde no encuentra salida

wander​

Elige un punto a radius bloques como máximo, camina hasta allí y descansa. Cualquier otro comportamiento incluido le quita el mob de inmediato.

AjustePredeterminadoSignificado
radius8Hasta dónde llega un paseo
speed1Velocidad mientras pasea
rest_ticks60Descanso tras un paseo
rest_random_ticks120Se añade a cada descanso una cantidad aleatoria de 0 a este número de ticks, menos uno
walk_ticks200Un paseo que no puede terminar acaba tras este tiempo

Desde un script Lua​

En todo script Lua que ejecuta FreeMinecraftModels, la tabla de entidad de un mob tiene tres miembros más. Las tablas de jugador no los tienen.

MiembroDevuelveDescripción
mob:override_ai(behaviors, options?)true, o false y el motivoSustituye la IA del mob. behaviors es un nombre o una lista de nombres. Un mob que ya tiene una sustitución recibe esta en su lugar
mob:restore_ai()boolDevuelve al mob su propia IA. true si tenía una sustitución
mob.ai_overriddenboolIndica si el mob ejecuta ahora una sustitución

options es una tabla, y todas sus claves son opcionales:

ClaveSignificado
ownerUna tabla de entidad o un texto UUID. Omítela para un mob que no sirve a nadie
durationCuánto dura la sustitución, en ticks. Omítela y dura hasta que se quite
settingsUna tabla de tablas de ajustes por nombre de comportamiento, con los valores que sustituyen los predeterminados de cada comportamiento
local ok, why = mob:override_ai({ 'guardian', 'wander' }, {
owner = player,
duration = 600,
settings = { guardian = { chase_speed = 1.6, assist = false } }
})

override_ai devuelve false con el motivo cuando un nombre de comportamiento no se cargó, o cuando la entidad no se puede sustituir. Una lista vacía, o un owner que no es ni una tabla de entidad ni un UUID, provoca un error. Un ajuste que el comportamiento no tiene, o un valor del tipo equivocado, se informa en la consola y se mantiene el valor predeterminado.

Desde scripts de EliteMobs​

Desde la versión de EliteMobs posterior a la 10.9.14, la tabla de entidad de un mob tiene los mismos tres miembros también en los scripts de EliteMobs, incluidos los poderes de jefe, cuando FreeMinecraftModels está instalado. FreeMinecraftModels sigue ejecutando los comportamientos, desde su propia carpeta mob_behaviors.

  • Allí se rechazan los élites, los jefes y los NPC de EliteMobs, y override_ai devuelve false con el motivo. Un jefe puede convertir en sus guardianes a los mobs que lo rodean, pero él mismo no se puede sustituir.
  • El owner puede ser el jefe: owner = context.boss.
  • Dale una duration a la sustitución. Dura más que el jefe que la inició.
  • Sin FreeMinecraftModels, o con una versión anterior a los comportamientos de mobs, override_ai devuelve false con el motivo.
mob:override_ai('guardian', { owner = context.boss, duration = 600 })

Desde otro plugin​

Un plugin accede a los comportamientos de mobs en Java mediante com.magmaguy.freeminecraftmodels.api.MobBehaviorAPI. overrideAI(mob, behaviors, owner, durationTicks, settings) devuelve null, o el motivo del rechazo. restoreAI(mob) e isAIOverridden(entity) devuelven un booleano, y behaviors() enumera los nombres cargados. Cada parámetro es un tipo simple de Java o de Bukkit, así que un plugin que compila contra un FreeMinecraftModels más antiguo puede buscar los métodos por su nombre. Llámalos en el hilo del servidor.

Qué mobs​

  • Se puede sustituir cualquier mob, sea lo que sea lo que lo generó. Los jugadores y los soportes para armadura no.
  • Está pensado para mobs que caminan por rutas: zombis, esqueletos, creepers, saqueadores, vacas, gallinas y similares. Hasta ahora se ha probado con husks, creepers y gallinas.
  • Los mobs que no caminan por rutas pueden moverse mal o no moverse en absoluto bajo una sustitución. Eso incluye slimes, cubos de magma, ghasts, phantoms, conejos, calamares y peces.
  • Las mascotas y otros mobs que ya ejecutan un programa de comportamiento, como un jefe de EliteMobs con un behavior, no se pueden sustituir.
  • Un élite de EliteMobs sin programa de comportamiento es un mob normal para FreeMinecraftModels y admite una sustitución, pero esa combinación aún no se ha probado.

Archivos​

  • Los comportamientos viven en plugins/FreeMinecraftModels/mob_behaviors/, en esa carpeta o en cualquier subcarpeta. Todo archivo .lua que haya allí es un comportamiento.
  • El nombre de un comportamiento es el nombre de su archivo sin .lua. Solo puede usar letras minúsculas, dígitos, ., _ y -.
  • Su id debe ser fmm:mob/ seguido de su nombre, así que mob_behaviors/scared_of_cats.lua declara id = 'fmm:mob/scared_of_cats'. Un archivo cuyo id no coincide con su nombre se omite con una advertencia.
  • Cuando dos archivos comparten nombre, se carga aquel cuya ruta va primero en orden, y la consola avisa sobre el otro.
  • FreeMinecraftModels escribe cada uno de sus cuatro comportamientos cuando mob_behaviors/ no tiene directamente en ella ningún archivo con ese nombre. Uno eliminado vuelve en el siguiente arranque o /fmm reload. Un archivo que editaste nunca se sobrescribe. Si mueves uno a una subcarpeta, el predeterminado vuelve a aparecer a su lado, y solo se carga aquel cuya ruta va primero en orden.
  • /fmm reload vuelve a leer todos los archivos. Las sustituciones en curso se detienen y vuelven a empezar con los archivos nuevos.

Escribir un comportamiento​

Un archivo de comportamiento es un módulo de comportamiento de mascota con otro prefijo de id: ai.module con settings, memories, behaviors y sensors. Las reglas compartidas están en los Programas de comportamiento de EliteMobs. Empieza por el archivo incluido más cercano a lo que quieres, cópialo con un nombre nuevo y cambia su id, los ids de sus comportamientos y los nombres de sus memorias para que empiecen por el nombre nuevo.

Este comportamiento hace que un mob huya de los gatos:

-- Runs from the nearest cat within range.
return ai.module {
id = 'fmm:mob/scared_of_cats', revision = 1,
settings = { range = 8, speed = 1.4 },
behaviors = {
ai.behavior {
-- Asked and run every 5 ticks: each run plans a new way out.
id = 'fmm:mob/scared_of_cats', priority = 5, probe_interval = 5, tick_interval = 5,
controls = { ai.controls.move },
can_start = function(c)
return c.overlay:nearest(c.settings.range, 'cat') ~= nil
end,
tick = function(c)
local cat = c.overlay:nearest(c.settings.range, 'cat')
if cat ~= nil then c.actuator:flee(cat.current_location, c.settings.speed) end
end,
stop = function(c) c.actuator:stop_moving() end
}
}
}
  • El número de priority más bajo va primero y toma los controles que lista a un comportamiento en ejecución con un número más alto. Los comportamientos incluidos usan 5 para coward y para la lucha de guardian, 10 para hostile, 20 para el seguimiento de guardian y 40 para wander.
  • probe_interval es cada cuánto se consulta can_start a un comportamiento detenido, en ticks. tick_interval es cada cuánto ejecuta can_continue y tick uno en ejecución. Ambos valen 1 por defecto y por encima de 200 cuentan como 200.
  • Dos comportamientos de un mismo mob no pueden compartir un id de comportamiento, un id de sensor ni un nombre de memoria. override_ai y el comando rechazan un par así y dicen por qué.

Qué recibe un callback​

NombreQué es
c.overlayEl lugar del mob en la sustitución. Consulta c.overlay
c.settingsLos ajustes de este comportamiento para este mob: sus valores predeterminados con los de la sustitución encima
c.memoryget(name), set(name, value), forget(name) y contains(name) para los nombres de memories. Cada mob tiene la suya
c.tickEl tick de juego actual, para temporizadores
c.entityLa tabla de entidad del mob, con current_location, health, entity_type y el resto
c.perception, c.actuatorEl contexto Mind de MagmaCore. Consulta Contexto de un programa Mind

c.overlay​

Las cuatro entidades se leen de nuevo cada vez, así que guarda una en una variable local cuando un callback la use más de una vez.

MiembroQué da o hace
c.overlay.ownerLa tabla de entidad del dueño mientras está vivo en el mundo del mob; si no, nil
c.overlay.owner_attackerQuien hirió al dueño en los últimos 10 segundos, o nil
c.overlay.owner_targetA quien el dueño hirió en los últimos 10 segundos, o nil
c.overlay.attackerQuien hirió a este mob en los últimos 10 segundos, o nil
c.overlay:nearest(radius, kind?)La entidad viva más cercana de un tipo dentro del radio, o nil. kind es player, hostile (monstruos), passive (animales), living (el predeterminado) o un tipo de entidad por su nombre de Bukkit, como zombie o iron_golem. Los aldeanos y los golems no son ni hostile ni passive. El radio llega a 128 bloques como máximo
c.overlay:entity(uuid)La entidad viva con ese UUID mientras está viva en el mundo del mob; si no, nil. Para un comportamiento que guarda en una memoria el UUID de su objetivo
c.overlay.remainingLos ticks que le quedan a la sustitución, o nil cuando no tiene fin
c.overlay:finish()Termina la sustitución cuando acabe este tick, y el mob recupera su propia IA

owner_attacker, owner_target, attacker y nearest nunca devuelven al dueño del mob ni a otro mob que sirva al mismo dueño. nearest también omite a los jugadores en modo creativo y espectador, y los soportes para armadura.

Moverse y luchar​

Estas llamadas de c.actuator hacen el trabajo. Cada una necesita que su comportamiento liste el control indicado.

LlamadaControlQué hace
c.actuator:move_to(location, speed)moveCamina hasta allí por una ruta
c.actuator:flee(location, speed)movePlanifica una ruta de unos diez bloques que se aleja de la ubicación y la sigue. false cuando el mob no encuentra salida o no puede planificar rutas. Llámalo cada pocos ticks, no en cada tick
c.actuator:stop_moving()moveSe detiene
c.actuator:look_at(location)lookGira la cabeza hacia allí durante los dos ticks siguientes
c.actuator:attack(target)attackEl golpe propio del tipo: un golpe que inflige el daño de ataque del mob, o 2 para un tipo que no tiene ninguno. Un creeper se hincha en su lugar, mientras la llamada llegue en cada tick, y explota cuando está del todo hinchado. Un tick sin la llamada y se deshincha
c.actuator:attack(target, damage)attackUn golpe que inflige esa cantidad de daño
c.actuator:shoot(target)attackEl disparo propio del tipo: la flecha de un esqueleto, la ballesta de un saqueador, la poción de una bruja, el escupitajo de una llama. false para un tipo que no tiene ninguno

flee, shoot y attack con un daño son nuevos con los comportamientos de mobs, y funcionan también en los módulos de comportamiento de mascotas, donde flee necesita un cuerpo que planifique rutas y shoot un cuerpo cuyo tipo dispare.

Reglas​

  • Llama al actuador solo desde el start, tick o stop de un comportamiento, en un comportamiento que liste el control que necesita.
  • Guarda el estado de cada mob en c.memory, declarado en memories, con nombres que empiecen por el nombre del comportamiento.
  • Mantén los callbacks cortos. Los comportamientos de mobs se ejecutan bajo los mismos límites que los módulos de comportamiento de mascotas y comparten con ellos los 10 ms por tick.

Cuando algo va mal​

Nada de esto detiene el servidor ni a los demás mobs. Busca en la consola, sin distinguir mayúsculas, mob behavior.

  • Un comportamiento no se carga. Un archivo que no compila, cuyo id no coincide con el nombre de su archivo o cuyo nombre tiene otros caracteres se omite con una advertencia que nombra el archivo y el motivo. Todos los demás archivos se cargan igualmente.
  • El comando o override_ai se niega. Dice por qué: un nombre de comportamiento que no se cargó, junto con los que sí, o una entidad que no se puede sustituir.
  • El mob se queda quieto. Sus comportamientos no tienen nada que hacer. Añade wander, o comprueba que estás en supervivencia y no eres el dueño del mob.
  • Un callback falla con los mobs en marcha. Se registra una vez por callback y tipo de fallo hasta la siguiente recarga. El comportamiento se detiene, o no se inicia, y se consulta de nuevo en su siguiente comprobación de probe_interval.
  • Un mob no pudo retomar su sustitución. Cuando se carga su chunk y uno de sus comportamientos ya no existe, la consola lo dice y el mob conserva su propia IA. La sustitución vuelve cuando el archivo vuelve a estar en su sitio y se ha ejecutado /fmm reload: de inmediato en los mobs cargados, y en los demás cuando se cargan.

Tras una corrección, ejecuta /fmm reload.