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.
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.
| Comando | Propó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 clear | Devuelve su propia IA al mob al que miras |
/fmm mobbehavior clear all | Devuelve 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 list | Lista los comportamientos que se cargaron y cuántos mobs ejecutan uno |
behaviorses un nombre, o varios separados por comas sin espacios, comocoward,wander.secondses cuánto dura la sustitución. Omítelo, o usa0, y dura hasta que se quite.- Un mob nunca ataca a su dueño ni le tiene miedo. Para probar
hostileocowardcontigo mismo, usaapplywild. hostileycowardno 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
| Nombre | Qué hace el mob |
|---|---|
guardian | Se 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 |
hostile | Ataca al jugador más cercano, o a lo que nombre su ajuste targets |
coward | Huye del jugador más cercano, o de lo que nombre su ajuste fears |
wander | Pasea 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.
| Ajuste | Predeterminado | Significado |
|---|---|---|
follow_distance | 6 | Cuánto se aleja el dueño antes de que el mob vaya tras él |
follow_stop | 3 | A qué distancia se acerca |
follow_speed | 1.2 | Velocidad mientras sigue |
chase_speed | 1.3 | Velocidad mientras lucha |
reach | 2.2 | A qué distancia se acerca para golpear |
fuse_distance | 3 | Un creeper enciende su mecha a esta distancia de su objetivo |
fuse_escape | 7 | La mecha de un creeper se apaga cuando el objetivo llega a esta distancia, o se pierde de vista |
shoot_distance | 12 | Un mob que dispara lo hace desde esta distancia o menos, mientras ve al objetivo |
attack_ticks | 20 | Tiempo entre dos golpes o disparos |
assist | true | También lucha contra aquel a quien hiere el dueño |
defend_itself | true | Tambié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.
| Ajuste | Predeterminado | Significado |
|---|---|---|
targets | player | player, hostile, passive, living o un tipo de entidad como zombie |
range | 16 | A qué distancia nota los objetivos |
damage | 0 | Lo 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_ticks | como guardian | Como 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.
| Ajuste | Predeterminado | Significado |
|---|---|---|
fears | player | player, hostile, passive, living o un tipo de entidad como wolf |
range | 10 | Cuánto se acerca algo que teme antes de que huya |
safe_distance | 16 | A qué distancia deja de huir |
speed | 1.5 | Velocidad mientras huye |
cornered_distance | 6 | Cuá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.
| Ajuste | Predeterminado | Significado |
|---|---|---|
radius | 8 | Hasta dónde llega un paseo |
speed | 1 | Velocidad mientras pasea |
rest_ticks | 60 | Descanso tras un paseo |
rest_random_ticks | 120 | Se añade a cada descanso una cantidad aleatoria de 0 a este número de ticks, menos uno |
walk_ticks | 200 | Un 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.
| Miembro | Devuelve | Descripción |
|---|---|---|
mob:override_ai(behaviors, options?) | true, o false y el motivo | Sustituye 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() | bool | Devuelve al mob su propia IA. true si tenía una sustitución |
mob.ai_overridden | bool | Indica si el mob ejecuta ahora una sustitución |
options es una tabla, y todas sus claves son opcionales:
| Clave | Significado |
|---|---|
owner | Una tabla de entidad o un texto UUID. Omítela para un mob que no sirve a nadie |
duration | Cuánto dura la sustitución, en ticks. Omítela y dura hasta que se quite |
settings | Una 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_aidevuelvefalsecon el motivo. Un jefe puede convertir en sus guardianes a los mobs que lo rodean, pero él mismo no se puede sustituir. - El
ownerpuede ser el jefe:owner = context.boss. - Dale una
durationa 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_aidevuelvefalsecon 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.luaque 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
iddebe serfmm:mob/seguido de su nombre, así quemob_behaviors/scared_of_cats.luadeclaraid = '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 reloadvuelve 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
prioritymá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 usan5paracowardy para la lucha deguardian,10parahostile,20para el seguimiento deguardiany40parawander. probe_intervales cada cuánto se consultacan_starta un comportamiento detenido, en ticks.tick_intervales cada cuánto ejecutacan_continueytickuno en ejecución. Ambos valen1por defecto y por encima de200cuentan como200.- Dos comportamientos de un mismo mob no pueden compartir un id de comportamiento, un id de sensor ni un nombre de memoria.
override_aiy el comando rechazan un par así y dicen por qué.
Qué recibe un callback
| Nombre | Qué es |
|---|---|
c.overlay | El lugar del mob en la sustitución. Consulta c.overlay |
c.settings | Los ajustes de este comportamiento para este mob: sus valores predeterminados con los de la sustitución encima |
c.memory | get(name), set(name, value), forget(name) y contains(name) para los nombres de memories. Cada mob tiene la suya |
c.tick | El tick de juego actual, para temporizadores |
c.entity | La tabla de entidad del mob, con current_location, health, entity_type y el resto |
c.perception, c.actuator | El 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.
| Miembro | Qué da o hace |
|---|---|
c.overlay.owner | La tabla de entidad del dueño mientras está vivo en el mundo del mob; si no, nil |
c.overlay.owner_attacker | Quien hirió al dueño en los últimos 10 segundos, o nil |
c.overlay.owner_target | A quien el dueño hirió en los últimos 10 segundos, o nil |
c.overlay.attacker | Quien 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.remaining | Los 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.
| Llamada | Control | Qué hace |
|---|---|---|
c.actuator:move_to(location, speed) | move | Camina hasta allí por una ruta |
c.actuator:flee(location, speed) | move | Planifica 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() | move | Se detiene |
c.actuator:look_at(location) | look | Gira la cabeza hacia allí durante los dos ticks siguientes |
c.actuator:attack(target) | attack | El 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) | attack | Un golpe que inflige esa cantidad de daño |
c.actuator:shoot(target) | attack | El 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,tickostopde un comportamiento, en un comportamiento que liste el control que necesita. - Guarda el estado de cada mob en
c.memory, declarado enmemories, 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_aise 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.