Comportamentos de mobs
Um comportamento de mob é um ficheiro Lua que assume a IA de um mob que o FreeMinecraftModels não fez aparecer: um creeper gerado naturalmente, uma galinha, um pillager de uma invasão. Enquanto a substituição dura, o mob faz o que o ficheiro diz. Depois, volta a ter a sua própria IA e comporta-se como antes.
O plugin inclui quatro comportamentos. Um creeper pode seguir um jogador e explodir sobre quem atacar esse jogador, uma galinha pode virar-se contra os jogadores e os pillagers podem fugir de medo. Põe-se um comportamento num mob com um comando ou a partir de um script Lua, durante um tempo definido ou até que algo o retire.
Os comportamentos de mobs precisam da versão do FreeMinecraftModels posterior à 2.15.0 e do Minecraft 1.21.4 ou mais recente.
O que faz uma substituição
- Os objetivos e o Brain do próprio mob param, pelo que ele não faz nada por si. Só os comportamentos o movem, o viram e o fazem atacar.
- Mantém tudo o resto: a vida, o equipamento, a velocidade de movimento e o nome, e a luz do sol continua a queimá-lo.
- Continua a desaparecer quando nenhum jogador está a menos de 128 blocos, a menos que algo já o tivesse feito ficar. O desaparecimento mais lento, ao acaso, de um mob que fica parado a entre 32 e 128 blocos dos jogadores não acontece enquanto está substituído.
- Move-se e luta como o seu tipo. Um creeper incha e explode, um esqueleto dispara flechas, um zombie bate.
- Um mob pode ter um dono, um jogador ou qualquer outra entidade viva. Os ataques do próprio mob nunca ferem o dono: os seus golpes, os projéteis que dispara e a explosão de um creeper são cancelados. Os efeitos de poção não são, nem o que um comportamento faz ao dono através de
c.overlay.owner. - Quando o tempo acaba ou algo retira a substituição, o mob volta a ter a sua própria IA. Um zombie volta a caçar jogadores e uma galinha volta a vaguear.
- A substituição mantém-se no mob durante descarregamentos de chunks, reinícios do servidor e
/fmm reload. Uma com tempo continua a contar enquanto o mob está descarregado, e desaparece se o tempo acabou entretanto. As memórias de um comportamento começam vazias quando o mob volta. - Termina por si quando o tempo acaba, quando o mob morre, quando o mob se transforma noutro mob, como um aldeão numa bruxa, ou quando um comportamento chama
c.overlay:finish().
Comandos
Todos precisam da permissão freeminecraftmodels.mobbehaviors.admin, que os operadores têm, e são só para jogadores.
| Comando | Finalidade |
|---|---|
/fmm mobbehavior apply <behaviors> [seconds] [radius] | Substitui a IA do mob na sua mira, até 32 blocos de distância, pelos comportamentos indicados, e faz de si o dono dele. Com um raio, abrange em vez disso todos os mobs a no máximo esse número de blocos de si em cada eixo |
/fmm mobbehavior applywild <behaviors> [seconds] [radius] | O mesmo, sem dono |
/fmm mobbehavior clear | Devolve ao mob na sua mira a sua própria IA |
/fmm mobbehavior clear all | Devolve a sua própria IA a todos os mobs substituídos que estão carregados. Um mob num chunk descarregado mantém a substituição e retoma-a quando carrega |
/fmm mobbehavior list | Lista os comportamentos que carregaram e quantos mobs executam um |
behaviorsé um nome, ou vários separados por vírgulas sem espaços, comocoward,wander.secondsé quanto tempo dura a substituição. Se o omitir, ou usar0, dura até ser retirada.- Um mob nunca ataca nem teme o seu dono. Para experimentar
hostileoucowardem si, useapplywild. hostileecowardnão escolhem jogadores em modo criativo ou espectador, por isso teste em sobrevivência. Um jogador em criativo que bata no mob continua a ser combatido ou evitado durante 10 segundos.
/fmm mobbehavior apply guardian
/fmm mobbehavior applywild hostile 30
/fmm mobbehavior applywild coward,wander 0 12
O primeiro faz o creeper para o qual está a olhar segui-lo e defendê-lo. O segundo faz uma galinha atacá-lo durante 30 segundos. O terceiro põe todos os mobs até 12 blocos de si a fugir de si até executar clear all.
Comportamentos incluídos
| Nome | O que o mob faz |
|---|---|
guardian | Fica perto do dono e combate quem magoa o dono, quem o dono magoa e quem magoa o próprio mob |
hostile | Ataca o jogador mais próximo, ou o que a sua definição targets indicar |
coward | Foge do jogador mais próximo, ou do que a sua definição fears indicar |
wander | Passeia quando mais nada o move |
Um mob substituído perdeu os seus passeios próprios com o resto da IA, por isso, sem wander, fica parado sempre que os outros comportamentos não têm nada a fazer. Acrescente wander à lista, como em coward,wander. O seu lugar na lista não importa: a priority de um comportamento decide qual deles move o mob.
Um mob que dispara usa o seu golpe corpo a corpo em vez de disparar quando o alvo está dentro de reach.
As velocidades multiplicam a velocidade de movimento do próprio mob, pelo que 1 é o seu passo normal. As distâncias são em blocos e os tempos em ticks.
guardian
Segue o dono quando este está a follow_distance de distância e para a follow_stop dele. Combate primeiro quem atacou o dono, depois quem o atacou a ele, depois o alvo do dono. Cada um é recordado durante 10 segundos depois do golpe. Sem dono, só se defende a si próprio.
| Definição | Predefinição | Significado |
|---|---|---|
follow_distance | 6 | A que distância fica o dono antes de o mob ir atrás dele |
follow_stop | 3 | A que distância chega |
follow_speed | 1.2 | Velocidade ao seguir |
chase_speed | 1.3 | Velocidade ao combater |
reach | 2.2 | A que distância chega para bater |
fuse_distance | 3 | Um creeper acende o pavio a esta distância do alvo |
fuse_escape | 7 | O pavio de um creeper apaga-se quando o alvo se afasta até esta distância, ou sai da vista |
shoot_distance | 12 | Um mob que dispara fá-lo a esta distância, enquanto vê o alvo |
attack_ticks | 20 | Tempo entre dois golpes ou disparos |
assist | true | Combate também quem o dono magoa |
defend_itself | true | Combate também quem o magoa |
hostile
Ataca quem o magoou nos últimos 10 segundos, senão o alvo mais próximo dentro de range. Procura um novo alvo a cada 10 ticks. Com dono, poupa-o a ele e aos outros mobs que o servem.
| Definição | Predefinição | Significado |
|---|---|---|
targets | player | player, hostile, passive, living, ou um tipo de entidade como zombie |
range | 16 | A que distância repara em alvos |
damage | 0 | O que um golpe causa. 0 deixa isso ao ataque do próprio mob, que é 2 para um tipo que não tem nenhum, como a galinha |
chase_speed, reach, fuse_distance, fuse_escape, shoot_distance, attack_ticks | como em guardian | Como em guardian |
coward
Começa a fugir quando algo que teme chega a menos de range, e para assim que isso fica a safe_distance. Foge também de quem o magoou nos últimos 10 segundos, enquanto esse atacante estiver dentro de range, ou dentro de safe_distance depois de começar a fugir. Cada fuga planeia um caminho de cerca de dez blocos para longe do susto. Numa sala ou num cercado sem saída tão longa, recua até à parede do fundo.
| Definição | Predefinição | Significado |
|---|---|---|
fears | player | player, hostile, passive, living, ou um tipo de entidade como wolf |
range | 10 | A que distância chega um susto antes de ele fugir |
safe_distance | 16 | A que distância deixa de fugir |
speed | 1.5 | Velocidade ao fugir |
cornered_distance | 6 | Quanto tenta recuar onde não encontra saída |
wander
Escolhe um sítio até radius blocos de distância, caminha até lá e descansa. Todos os outros comportamentos incluídos tiram-lhe o mob de imediato.
| Definição | Predefinição | Significado |
|---|---|---|
radius | 8 | A que distância vai um passeio |
speed | 1 | Velocidade ao passear |
rest_ticks | 60 | Descanso depois de um passeio |
rest_random_ticks | 120 | Um valor aleatório de 0 a este número de ticks, menos um, somado a cada descanso |
walk_ticks | 200 | Um passeio que não consegue terminar acaba depois deste tempo |
A partir de um script Lua
Em todos os scripts Lua que o FreeMinecraftModels executa, a tabela de entidade de um mob tem mais três membros. As tabelas de jogadores não os têm.
| Membro | Devolve | Descrição |
|---|---|---|
mob:override_ai(behaviors, options?) | true, ou false e o motivo | Substitui a IA do mob. behaviors é um nome ou uma lista de nomes. Um mob que já tem uma substituição fica com esta no lugar da anterior |
mob:restore_ai() | bool | Devolve ao mob a sua própria IA. true quando tinha uma substituição |
mob.ai_overridden | bool | Se o mob executa agora uma substituição |
options é uma tabela, e todas as chaves são opcionais:
| Chave | Significado |
|---|---|
owner | Uma tabela de entidade ou um texto UUID. Omita-a para um mob que não serve ninguém |
duration | Quanto tempo dura a substituição, em ticks. Se a omitir, dura até ser retirada |
settings | Uma tabela de tabelas de definições por nome de comportamento, com os valores que substituem as predefinições de cada comportamento |
local ok, why = mob:override_ai({ 'guardian', 'wander' }, {
owner = player,
duration = 600,
settings = { guardian = { chase_speed = 1.6, assist = false } }
})
override_ai devolve false com o motivo quando o nome de um comportamento não carregou, ou quando a entidade não pode ser substituída. Uma lista vazia, ou um owner que não seja uma tabela de entidade nem um UUID, gera um erro. Uma definição que o comportamento não tem, ou um valor do tipo errado, é comunicado na consola e a predefinição mantém-se.
A partir de scripts do EliteMobs
A partir da versão do EliteMobs posterior à 10.9.14, a tabela de entidade de um mob tem os mesmos três membros também nos scripts do EliteMobs, incluindo os poderes de boss, quando o FreeMinecraftModels está instalado. O FreeMinecraftModels continua a executar os comportamentos, a partir da sua própria pasta mob_behaviors.
- Os elites, os bosses e os NPCs do EliteMobs são aí recusados, e
override_aidevolvefalsecom o motivo. Um boss pode fazer dos mobs à sua volta os seus guardiões, mas não pode ser ele próprio substituído. - O
ownerpode ser o boss:owner = context.boss. - Dê uma
durationà substituição. Ela dura mais do que o boss que a iniciou. - Sem o FreeMinecraftModels, ou com uma versão anterior aos comportamentos de mobs,
override_aidevolvefalsecom o motivo.
mob:override_ai('guardian', { owner = context.boss, duration = 600 })
A partir de outro plugin
Um plugin acede aos comportamentos de mobs em Java através de com.magmaguy.freeminecraftmodels.api.MobBehaviorAPI. overrideAI(mob, behaviors, owner, durationTicks, settings) devolve null, ou o motivo da recusa. restoreAI(mob) e isAIOverridden(entity) devolvem um booleano, e behaviors() lista os nomes carregados. Todos os parâmetros são tipos simples de Java ou de Bukkit, pelo que um plugin compilado contra um FreeMinecraftModels mais antigo pode procurar os métodos pelo nome. Chame-os na thread do servidor.
Que mobs
- Qualquer mob pode ser substituído, seja qual for a origem. Jogadores e suportes de armadura não podem.
- Foi feito para mobs que andam por caminhos: zombies, esqueletos, creepers, pillagers, vacas, galinhas e afins. Até agora foi testado em husks, creepers e galinhas.
- Os mobs que não andam por caminhos podem mover-se mal ou nada sob uma substituição. Isso inclui slimes, magma cubes, ghasts, phantoms, coelhos, lulas e peixes.
- As mascotes e outros mobs que já executam um programa de comportamento, como um boss do EliteMobs com um
behavior, não podem ser substituídos. - Um elite do EliteMobs sem programa de comportamento é um mob normal para o FreeMinecraftModels e aceita uma substituição, mas essa combinação ainda não foi testada.
Ficheiros
- Os comportamentos ficam em
plugins/FreeMinecraftModels/mob_behaviors/, nessa pasta ou em qualquer subpasta. Todos os ficheiros.luaaí são comportamentos. - O nome de um comportamento é o nome do seu ficheiro sem
.lua. Só pode usar letras minúsculas, dígitos,.,_e-. - O seu
idtem de serfmm:mob/seguido do seu nome, pelo quemob_behaviors/scared_of_cats.luadeclaraid = 'fmm:mob/scared_of_cats'. Um ficheiro cujo id não corresponda ao nome é ignorado com um aviso. - Quando dois ficheiros têm o mesmo nome, carrega aquele cujo caminho vem primeiro por ordem e a consola avisa sobre o outro.
- O FreeMinecraftModels escreve cada um dos seus quatro comportamentos quando
mob_behaviors/não tem diretamente nela um ficheiro com esse nome. Um eliminado volta no arranque seguinte ou em/fmm reload. Um ficheiro que editou nunca é substituído. Mover um para uma subpasta traz a predefinição de volta ao lado dele, e só carrega aquele cujo caminho vem primeiro. /fmm reloadvolta a ler todos os ficheiros. As substituições em curso param e recomeçam com os novos ficheiros.
Escrever um comportamento
Um ficheiro de comportamento é um módulo de comportamento de mascotes com outro prefixo de id: ai.module com settings, memories, behaviors e sensors. As regras partilhadas estão nos Programas de comportamento do EliteMobs. Comece pelo ficheiro incluído mais próximo do que pretende, copie-o com um novo nome e altere o seu id, os ids dos seus comportamentos e os nomes das suas memórias para que comecem pelo novo nome.
Este comportamento faz um mob fugir de 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
}
}
}
- O número de
prioritymais baixo vai primeiro e tira os controlos que lista a um comportamento em execução com um número mais alto. Os comportamentos incluídos usam5paracowarde para o combate deguardian,10parahostile,20para o seguimento deguardiane40parawander. probe_intervalé a frequência, em ticks, com que a um comportamento parado é perguntadocan_start.tick_intervalé a frequência com que um em execução executacan_continueetick. Ambos são1por predefinição e contam como200acima disso.- Dois comportamentos no mesmo mob não podem partilhar um id de comportamento, um id de sensor nem um nome de memória.
override_aie o comando recusam um par assim e dizem porquê.
O que recebe um callback
| Nome | O que é |
|---|---|
c.overlay | O lugar do mob na substituição. Consulte c.overlay |
c.settings | As definições deste comportamento para este mob: as suas predefinições com os valores da substituição por cima |
c.memory | get(name), set(name, value), forget(name) e contains(name) para os nomes em memories. Cada mob tem a sua |
c.tick | O tick atual do jogo, para temporizadores |
c.entity | A tabela de entidade do mob, com current_location, health, entity_type e o resto |
c.perception, c.actuator | O contexto Mind do MagmaCore. Consulte Contexto de um programa Mind |
c.overlay
As quatro entidades são lidas de novo de cada vez, por isso guarde uma numa variável local quando um callback a usa mais de uma vez.
| Membro | O que dá ou faz |
|---|---|
c.overlay.owner | A tabela de entidade do dono enquanto está vivo no mundo do mob, senão nil |
c.overlay.owner_attacker | Quem magoou o dono nos últimos 10 segundos, ou nil |
c.overlay.owner_target | Quem o dono magoou nos últimos 10 segundos, ou nil |
c.overlay.attacker | Quem magoou este mob nos últimos 10 segundos, ou nil |
c.overlay:nearest(radius, kind?) | A entidade viva mais próxima de um tipo dentro do raio, ou nil. kind é player, hostile (monstros), passive (animais), living (a predefinição), ou um tipo de entidade pelo seu nome Bukkit, como zombie ou iron_golem. Aldeões e golems não são hostile nem passive. O raio chega a 128 blocos no máximo |
c.overlay:entity(uuid) | A entidade viva com esse UUID enquanto está viva no mundo do mob, senão nil. Para um comportamento que guarda o UUID do seu alvo numa memória |
c.overlay.remaining | Os ticks que faltam à substituição, ou nil quando não tem fim |
c.overlay:finish() | Termina a substituição quando este tick acabar, e o mob volta a ter a sua própria IA |
owner_attacker, owner_target, attacker e nearest nunca dão o dono do mob nem outro mob que sirva o mesmo dono. nearest também ignora jogadores em modo criativo e espectador, e suportes de armadura.
Mover e combater
Estas chamadas de c.actuator fazem o trabalho. Cada uma exige que o seu comportamento liste o controlo indicado.
| Chamada | Controlo | O que faz |
|---|---|---|
c.actuator:move_to(location, speed) | move | Caminha até lá por um caminho |
c.actuator:flee(location, speed) | move | Planeia um caminho de cerca de dez blocos para longe da posição e segue-o. false quando o mob não encontra saída ou não consegue planear caminhos. Chame-a a cada poucos ticks, não a cada tick |
c.actuator:stop_moving() | move | Para |
c.actuator:look_at(location) | look | Vira a cabeça para lá durante os dois ticks seguintes |
c.actuator:attack(target) | attack | O golpe próprio do tipo: uma pancada que causa o dano de ataque do mob, ou 2 para um tipo que não tem nenhum. Um creeper incha em vez disso, enquanto a chamada vier a cada tick, e explode quando está completamente inchado. Um tick sem a chamada e ele esvazia |
c.actuator:attack(target, damage) | attack | Uma pancada que causa esse dano |
c.actuator:shoot(target) | attack | O disparo próprio do tipo: a flecha de um esqueleto, a besta de um pillager, a poção de uma bruxa, a cuspidela de um llama. false para um tipo que não tem nenhum |
flee, shoot e attack com um dano são novos com os comportamentos de mobs, e funcionam também nos módulos de comportamento de mascotes, onde flee precisa de um corpo que planeie caminhos e shoot de um corpo cujo tipo dispare.
Regras
- Chame o atuador apenas a partir de
start,tickoustopde um comportamento, num comportamento que liste o controlo de que precisa. - Guarde o estado de cada mob em
c.memory, declarado emmemories, com nomes que comecem pelo nome do comportamento. - Mantenha os callbacks curtos. Os comportamentos de mobs funcionam sob os mesmos limites que os módulos de comportamento de mascotes e partilham com eles os 10 ms por tick.
Quando algo corre mal
Nada disto para o servidor nem os outros mobs. Pesquise na consola, sem distinguir maiúsculas, por mob behavior.
- Um comportamento não carrega. Um ficheiro que não compila, cujo id não corresponde ao nome do ficheiro, ou cujo nome tem outros caracteres, é ignorado com um aviso que indica o ficheiro e o motivo. Todos os outros ficheiros continuam a carregar.
- O comando ou
override_airecusa. Diz porquê: um nome de comportamento que não carregou, com os que carregaram, ou uma entidade que não pode ser substituída. - O mob fica parado. Os seus comportamentos não têm nada a fazer. Acrescente
wander, ou verifique que está em sobrevivência e que não é o dono do mob. - Um callback falha durante a execução. É registado uma vez por callback e tipo de falha até ao próximo reload. O comportamento é parado, ou não é iniciado, e é perguntado de novo na verificação seguinte de
probe_interval. - Um mob não conseguiu retomar a sua substituição. Quando o seu chunk carrega e um dos seus comportamentos já não existe, a consola di-lo e o mob fica com a sua própria IA. A substituição volta quando o ficheiro voltar e
/fmm reloadtiver sido executado: de imediato nos mobs carregados, e nos outros quando carregarem.
Depois de uma correção, execute /fmm reload.