Aller au contenu principal

Comportements de mob

Un comportement de mob est un fichier Lua qui prend le contrôle de l'IA d'un mob que FreeMinecraftModels n'a pas fait apparaître : un creeper apparu naturellement, une poule, un pillard d'un raid. Tant que la substitution dure, le mob fait ce que dit le fichier. Ensuite, il retrouve sa propre IA et se comporte comme avant.

Quatre comportements sont fournis avec le plugin. Un creeper peut suivre un joueur et exploser sur quiconque attaque ce joueur, une poule peut se retourner contre les joueurs, et des pillards peuvent fuir de peur. Vous placez un comportement sur un mob avec une commande ou depuis un script Lua, pour une durée donnée ou jusqu'à ce que quelque chose le retire.

Disponibilité selon la version

Les comportements de mob nécessitent la version de FreeMinecraftModels postérieure à la 2.15.0, et Minecraft 1.21.4 ou plus récent.

Ce que fait une substitution​

  • Les propres objectifs et le Brain du mob s'arrêtent : il ne fait rien de lui-même. Seuls les comportements le déplacent, le font se tourner et attaquer.
  • Il garde tout le reste : ses points de vie, son équipement, sa vitesse de déplacement et son nom, et le soleil continue de le brûler.
  • Il disparaît toujours dès qu'aucun joueur n'est à moins de 128 blocs, sauf si quelque chose l'avait déjà fait rester. La disparition aléatoire, plus lente, qui frappe un mob resté inactif entre 32 et 128 blocs des joueurs n'a pas lieu tant qu'il est substitué.
  • Il se déplace et se bat comme son espèce. Un creeper gonfle et explose, un squelette tire des flèches, un zombie frappe.
  • Un mob peut avoir un propriétaire, un joueur ou toute autre entité vivante. Ses propres attaques ne blessent jamais son propriétaire : ses coups, les projectiles qu'il tire et l'explosion d'un creeper sont annulés. Les effets de potion ne le sont pas, ni rien de ce qu'un comportement fait au propriétaire par c.overlay.owner.
  • Lorsque le temps est écoulé ou que quelque chose retire la substitution, le mob retrouve sa propre IA. Un zombie chasse de nouveau les joueurs et une poule se promène.
  • La substitution reste sur le mob malgré les déchargements de chunks, les redémarrages du serveur et /fmm reload. Une substitution limitée dans le temps continue de compter pendant que le mob est déchargé, et a disparu si son temps s'est écoulé entre-temps. Les mémoires d'un comportement repartent vides lorsque le mob revient.
  • Elle se termine d'elle-même lorsque son temps est écoulé, lorsque le mob meurt, lorsque le mob se transforme en un autre mob, comme un villageois en sorcière, ou lorsqu'un comportement appelle c.overlay:finish().

Commandes​

Toutes nécessitent la permission freeminecraftmodels.mobbehaviors.admin, que les opérateurs possèdent, et sont réservées aux joueurs.

CommandeRôle
/fmm mobbehavior apply <behaviors> [seconds] [radius]Substitue l'IA du mob dans votre viseur, jusqu'à 32 blocs de distance, par les comportements nommés, et fait de vous son propriétaire. Avec un rayon, elle prend à la place tous les mobs qui ne sont pas à plus de ce nombre de blocs de vous sur chacun des trois axes
/fmm mobbehavior applywild <behaviors> [seconds] [radius]Pareil, sans propriétaire
/fmm mobbehavior clearRend sa propre IA au mob dans votre viseur
/fmm mobbehavior clear allRend sa propre IA à chaque mob substitué et chargé. Un mob dans un chunk déchargé garde sa substitution et la reprend au chargement
/fmm mobbehavior listListe les comportements chargés et le nombre de mobs qui en exécutent un
  • behaviors est un seul nom, ou plusieurs séparés par des virgules sans espaces, comme coward,wander.
  • seconds est la durée de la substitution. Omettez-le, ou mettez 0, et elle dure jusqu'à ce qu'on la retire.
  • Un mob n'attaque ni ne craint jamais son propriétaire. Pour essayer hostile ou coward sur vous-même, utilisez applywild.
  • hostile et coward ne ciblent pas les joueurs en mode créatif ou spectateur : testez donc en survie. Un joueur en créatif qui frappe le mob est quand même combattu ou fui pendant 10 secondes.
/fmm mobbehavior apply guardian
/fmm mobbehavior applywild hostile 30
/fmm mobbehavior applywild coward,wander 0 12

Avec la première, le creeper que vous regardez vous suit et vous défend. La deuxième pousse une poule à vous attaquer pendant 30 secondes. La troisième fait fuir devant vous tous les mobs situés à 12 blocs ou moins jusqu'à ce que vous exécutiez clear all.

Comportements fournis​

NomCe que fait le mob
guardianReste près de son propriétaire et combat quiconque blesse son propriétaire, quiconque celui-ci blesse, et quiconque le blesse lui-même
hostileAttaque le joueur le plus proche, ou ce que nomme son réglage targets
cowardFuit le joueur le plus proche, ou ce que nomme son réglage fears
wanderSe promène lorsque rien d'autre ne le déplace

Un mob substitué a perdu sa propre promenade avec le reste de son IA : sans wander, il reste immobile chaque fois que ses autres comportements n'ont rien à faire. Ajoutez wander à la liste, comme dans coward,wander. Sa place dans la liste n'a pas d'importance : c'est la priority d'un comportement qui décide lequel déplace le mob.

Un mob qui tire donne un coup de mêlée au lieu de tirer lorsque sa cible est à portée de reach.

Les vitesses multiplient la vitesse de déplacement propre au mob : 1 est donc sa marche normale. Les distances sont en blocs et les durées en ticks.

guardian​

Il suit son propriétaire dès que celui-ci est à follow_distance et s'arrête à follow_stop de lui. Il combat d'abord l'agresseur du propriétaire, puis le sien, puis la cible du propriétaire. Chacun est retenu pendant 10 secondes après le coup. Sans propriétaire, il ne fait que se défendre.

RéglagePar défautSignification
follow_distance6À quelle distance le propriétaire doit s'éloigner avant que le mob vienne le rejoindre
follow_stop3À quelle distance il s'approche
follow_speed1.2Vitesse pendant le suivi
chase_speed1.3Vitesse pendant le combat
reach2.2À quelle distance il s'approche pour frapper
fuse_distance3Un creeper allume sa mèche à moins de cette distance de sa cible
fuse_escape7La mèche d'un creeper s'éteint lorsque la cible atteint cette distance, ou sort de sa vue
shoot_distance12Un mob qui tire le fait à moins de cette distance, tant qu'il voit la cible
attack_ticks20Temps entre deux coups ou deux tirs
assisttrueCombat aussi quiconque le propriétaire blesse
defend_itselftrueCombat aussi quiconque le blesse

hostile​

Il attaque quiconque l'a blessé au cours des 10 dernières secondes, sinon la cible la plus proche à portée de range. Il cherche une nouvelle cible tous les 10 ticks. Avec un propriétaire, il l'épargne ainsi que les autres mobs à son service.

RéglagePar défautSignification
targetsplayerplayer, hostile, passive, living, ou un type d'entité comme zombie
range16À quelle distance il remarque les cibles
damage0Ce qu'inflige un coup. 0 laisse faire l'attaque propre au mob, qui vaut 2 pour une espèce qui n'en a pas, comme une poule
chase_speed, reach, fuse_distance, fuse_escape, shoot_distance, attack_tickscomme guardianComme dans guardian

coward​

Il se met à fuir lorsque ce qu'il craint arrive à portée de range, et s'arrête une fois la menace à safe_distance. Il fuit aussi quiconque l'a blessé au cours des 10 dernières secondes, tant que cet agresseur est à portée de range, ou de safe_distance une fois qu'il court. Chaque fuite planifie un chemin d'une dizaine de blocs en s'éloignant de la menace. Dans une pièce ou un enclos sans issue aussi longue, il recule jusqu'au mur du fond.

RéglagePar défautSignification
fearsplayerplayer, hostile, passive, living, ou un type d'entité comme wolf
range10À quelle distance une menace s'approche avant qu'il fuie
safe_distance16À quelle distance il cesse de fuir
speed1.5Vitesse pendant la fuite
cornered_distance6De combien il essaie de reculer là où il ne trouve aucune issue

wander​

Il choisit un endroit jusqu'à radius blocs de distance, s'y rend à pied, puis se repose. Tous les autres comportements fournis lui prennent le mob aussitôt.

RéglagePar défautSignification
radius8La distance d'une promenade
speed1Vitesse pendant la promenade
rest_ticks60Repos après une promenade
rest_random_ticks120Un nombre aléatoire de 0 à ce nombre de ticks, moins un, ajouté à chaque repos
walk_ticks200Une promenade qu'il ne peut pas terminer s'arrête après cette durée

Depuis un script Lua​

Dans chaque script Lua que FreeMinecraftModels exécute, la table d'entité d'un mob possède trois membres de plus. Les tables de joueurs ne les ont pas.

MembreRenvoieDescription
mob:override_ai(behaviors, options?)true, ou false et la raisonSubstitue l'IA du mob. behaviors est un nom ou une liste de noms. Un mob qui a déjà une substitution reçoit celle-ci à la place
mob:restore_ai()boolRend sa propre IA au mob. true s'il avait une substitution
mob.ai_overriddenboolIndique si le mob exécute une substitution en ce moment

options est une table, et chaque clé est facultative :

CléSignification
ownerUne table d'entité ou une chaîne UUID. Omettez-la pour un mob qui ne sert personne
durationLa durée de la substitution, en ticks. Omettez-la et elle dure jusqu'à ce qu'on la retire
settingsUne table de tables de réglages par nom de comportement, avec les valeurs qui remplacent les valeurs par défaut de chaque comportement
local ok, why = mob:override_ai({ 'guardian', 'wander' }, {
owner = player,
duration = 600,
settings = { guardian = { chase_speed = 1.6, assist = false } }
})

override_ai renvoie false avec la raison lorsqu'un nom de comportement n'a pas été chargé, ou lorsque l'entité ne peut pas être substituée. Une liste vide, ou un owner qui n'est ni une table d'entité ni un UUID, lève une erreur. Un réglage que le comportement n'a pas, ou une valeur du mauvais type, est signalé dans la console et la valeur par défaut reste.

Depuis les scripts EliteMobs​

À partir de la version d'EliteMobs postérieure à la 10.9.14, la table d'entité d'un mob possède les mêmes trois membres dans les scripts EliteMobs aussi, pouvoirs de boss compris, lorsque FreeMinecraftModels est installé. FreeMinecraftModels exécute toujours les comportements, depuis son propre dossier mob_behaviors.

  • Les élites, les boss et les PNJ d'EliteMobs y sont refusés, et override_ai renvoie false avec la raison. Un boss peut faire des mobs qui l'entourent ses gardiens, mais ne peut pas être substitué lui-même.
  • Le owner peut être le boss : owner = context.boss.
  • Donnez une duration à la substitution. Elle survit au boss qui l'a lancée.
  • Sans FreeMinecraftModels, ou avec une version antérieure aux comportements de mob, override_ai renvoie false avec la raison.
mob:override_ai('guardian', { owner = context.boss, duration = 600 })

Depuis un autre plugin​

Un plugin accède aux comportements de mob en Java par com.magmaguy.freeminecraftmodels.api.MobBehaviorAPI. overrideAI(mob, behaviors, owner, durationTicks, settings) renvoie null, ou la raison du refus. restoreAI(mob) et isAIOverridden(entity) renvoient un booléen, et behaviors() liste les noms chargés. Chaque paramètre est un type simple de Java ou de Bukkit, si bien qu'un plugin compilé contre un FreeMinecraftModels plus ancien peut retrouver les méthodes par leur nom. Appelez-les sur le thread du serveur.

Quels mobs​

  • N'importe quel mob peut être substitué, quelle que soit son origine. Les joueurs et les porte-armures ne le peuvent pas.
  • Cela est conçu pour les mobs qui marchent le long de chemins : zombies, squelettes, creepers, pillards, vaches, poules et leurs semblables. Jusqu'ici, cela a été testé sur des husks, des creepers et des poules.
  • Les mobs qui ne marchent pas le long de chemins peuvent mal se déplacer ou pas du tout sous une substitution. Cela concerne les slimes, les cubes de magma, les ghasts, les fantômes, les lapins, les calmars et les poissons.
  • Les familiers et les autres mobs qui exécutent déjà un programme de comportement, comme un boss EliteMobs avec un behavior, ne peuvent pas être substitués.
  • Un élite EliteMobs sans programme de comportement est un mob ordinaire pour FreeMinecraftModels et accepte une substitution, mais cette combinaison n'a pas encore été testée.

Fichiers​

  • Les comportements se trouvent dans plugins/FreeMinecraftModels/mob_behaviors/, dans ce dossier ou dans n'importe quel sous-dossier. Chaque fichier .lua qui s'y trouve est un comportement.
  • Le nom d'un comportement est son nom de fichier sans .lua. Il ne peut contenir que des lettres minuscules, des chiffres, ., _ et -.
  • Son id doit être fmm:mob/ suivi de son nom : mob_behaviors/scared_of_cats.lua déclare donc id = 'fmm:mob/scared_of_cats'. Un fichier dont l'id ne correspond pas à son nom est écarté avec un avertissement.
  • Lorsque deux fichiers portent le même nom, celui dont le chemin se classe en premier est chargé et la console avertit à propos de l'autre.
  • FreeMinecraftModels écrit chacun de ses quatre comportements lorsque mob_behaviors/ ne contient aucun fichier de ce nom directement dans le dossier. Un comportement supprimé revient au prochain démarrage ou à /fmm reload. Un fichier que vous avez modifié n'est jamais écrasé. Si vous en déplacez un dans un sous-dossier, la version par défaut revient à côté de lui, et seul celui dont le chemin se classe en premier est chargé.
  • /fmm reload relit chaque fichier. Les substitutions en cours s'arrêtent et redémarrent avec les nouveaux fichiers.

Écrire un comportement​

Un fichier de comportement est un module de comportement de familier avec un autre préfixe d'id : ai.module avec settings, memories, behaviors et sensors. Les règles communes figurent dans les Programmes de comportement d'EliteMobs. Partez du fichier fourni qui se rapproche le plus de ce que vous voulez, copiez-le sous un nouveau nom, et changez son id, ses ids de comportement et ses noms de mémoire pour qu'ils commencent par le nouveau nom.

Ce comportement fait fuir un mob devant les chats :

-- 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
}
}
}
  • Le nombre priority le plus bas passe en premier et prend les contrôles qu'il liste à un comportement en cours dont le nombre est plus élevé. Les comportements fournis utilisent 5 pour coward et pour le combat de guardian, 10 pour hostile, 20 pour le suivi de guardian et 40 pour wander.
  • probe_interval est la fréquence, en ticks, à laquelle on demande can_start à un comportement arrêté. tick_interval est la fréquence à laquelle un comportement en cours exécute can_continue et tick. Les deux valent 1 par défaut et comptent comme 200 au-delà.
  • Deux comportements sur un même mob ne peuvent pas partager un id de comportement, un id de capteur ou un nom de mémoire. override_ai et la commande refusent une telle paire et en donnent la raison.

Ce que reçoit un callback​

NomCe que c'est
c.overlayLa place du mob dans la substitution. Voir c.overlay
c.settingsLes réglages de ce comportement pour ce mob : ses valeurs par défaut, avec par-dessus celles de la substitution
c.memoryget(name), set(name, value), forget(name) et contains(name) pour les noms de memories. Chaque mob a la sienne
c.tickLe tick de jeu actuel, pour les minuteries
c.entityLa table d'entité du mob, avec current_location, health, entity_type et le reste
c.perception, c.actuatorLe contexte Mind de MagmaCore. Voir Contexte d'un programme Mind

c.overlay​

Les quatre entités sont lues à neuf à chaque fois : gardez-en une dans une variable locale lorsqu'un callback s'en sert plus d'une fois.

MembreCe qu'il donne ou fait
c.overlay.ownerLa table d'entité du propriétaire tant qu'il est vivant dans le monde du mob, sinon nil
c.overlay.owner_attackerQuiconque a blessé le propriétaire au cours des 10 dernières secondes, ou nil
c.overlay.owner_targetQuiconque le propriétaire a blessé au cours des 10 dernières secondes, ou nil
c.overlay.attackerQuiconque a blessé ce mob au cours des 10 dernières secondes, ou nil
c.overlay:nearest(radius, kind?)L'entité vivante la plus proche d'un type donné dans le rayon, ou nil. kind est player, hostile (monstres), passive (animaux), living (par défaut), ou un type d'entité par son nom Bukkit, comme zombie ou iron_golem. Les villageois et les golems ne sont ni hostile ni passive. Le rayon atteint 128 blocs au plus
c.overlay:entity(uuid)L'entité vivante portant cet UUID tant qu'elle est vivante dans le monde du mob, sinon nil. Pour un comportement qui garde l'UUID de sa cible dans une mémoire
c.overlay.remainingLes ticks qu'il reste à la substitution, ou nil si elle n'a pas de fin
c.overlay:finish()Termine la substitution une fois ce tick écoulé, et le mob retrouve sa propre IA

owner_attacker, owner_target, attacker et nearest ne donnent jamais le propriétaire du mob ni un autre mob qui sert le même propriétaire. nearest ignore aussi les joueurs en mode créatif et spectateur, et les porte-armures.

Se déplacer et combattre​

Ces appels de c.actuator font le travail. Chacun exige que son comportement liste le contrôle indiqué.

AppelContrôleCe qu'il fait
c.actuator:move_to(location, speed)moveY marche le long d'un chemin
c.actuator:flee(location, speed)movePlanifie un chemin d'une dizaine de blocs en s'éloignant de la position et le suit. false lorsque le mob ne trouve aucune issue ou ne peut pas planifier de chemins. Appelez-le tous les quelques ticks, pas à chaque tick
c.actuator:stop_moving()moveS'arrête
c.actuator:look_at(location)lookTourne la tête vers cet endroit pendant les deux ticks suivants
c.actuator:attack(target)attackLe coup propre à l'espèce : un coup qui inflige les dégâts d'attaque du mob, ou 2 pour une espèce qui n'en a pas. Un creeper gonfle à la place, tant que l'appel vient à chaque tick, et explose une fois complètement gonflé. Au premier tick sans l'appel, il se dégonfle
c.actuator:attack(target, damage)attackUn coup qui inflige ces dégâts
c.actuator:shoot(target)attackLe tir propre à l'espèce : la flèche d'un squelette, l'arbalète d'un pillard, la potion d'une sorcière, le crachat d'un lama. false pour une espèce qui n'en a pas

flee, shoot et attack avec des dégâts sont nouveaux avec les comportements de mob, et fonctionnent aussi dans les modules de comportement de familier, où flee exige un corps qui planifie des chemins et shoot un corps dont l'espèce tire.

Règles​

  • N'appelez l'actionneur que depuis le start, le tick ou le stop d'un comportement, dans un comportement qui liste le contrôle dont il a besoin.
  • Gardez l'état propre à chaque mob dans c.memory, déclaré sous memories, avec des noms qui commencent par le nom du comportement.
  • Gardez les callbacks courts. Les comportements de mob s'exécutent sous les mêmes limites que les modules de comportement de familier, et partagent avec eux les 10 ms par tick.

Quand quelque chose ne va pas​

Rien ici n'arrête le serveur ni les autres mobs. Cherchez dans la console, sans tenir compte de la casse, mob behavior.

  • Un comportement ne se charge pas. Un fichier qui ne compile pas, dont l'id ne correspond pas à son nom de fichier, ou dont le nom contient d'autres caractères est écarté avec un avertissement qui nomme le fichier et la raison. Tous les autres fichiers se chargent quand même.
  • La commande ou override_ai refuse. Elle en donne la raison : un nom de comportement qui n'a pas été chargé, avec ceux qui l'ont été, ou une entité qui ne peut pas être substituée.
  • Le mob reste immobile. Ses comportements n'ont rien à faire. Ajoutez wander, ou vérifiez que vous êtes en survie et que vous n'êtes pas le propriétaire du mob.
  • Un callback échoue pendant que des mobs s'exécutent. Il est consigné une fois par callback et par type d'échec jusqu'au prochain rechargement. Le comportement est arrêté, ou n'est pas démarré, et interrogé de nouveau à sa prochaine vérification de probe_interval.
  • Un mob n'a pas pu reprendre sa substitution. Lorsque son chunk se charge et que l'un de ses comportements n'existe plus, la console l'indique et le mob garde sa propre IA. La substitution revient une fois le fichier de retour et /fmm reload exécuté : aussitôt sur les mobs chargés, et sur les autres lorsqu'ils se chargent.

Après une correction, exécutez /fmm reload.