Saltar para o conteúdo principal

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.

Disponibilidade por versão

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.

ComandoFinalidade
/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 clearDevolve ao mob na sua mira a sua própria IA
/fmm mobbehavior clear allDevolve 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 listLista os comportamentos que carregaram e quantos mobs executam um
  • behaviors é um nome, ou vários separados por vírgulas sem espaços, como coward,wander.
  • seconds é quanto tempo dura a substituição. Se o omitir, ou usar 0, dura até ser retirada.
  • Um mob nunca ataca nem teme o seu dono. Para experimentar hostile ou coward em si, use applywild.
  • hostile e coward nã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​

NomeO que o mob faz
guardianFica perto do dono e combate quem magoa o dono, quem o dono magoa e quem magoa o próprio mob
hostileAtaca o jogador mais próximo, ou o que a sua definição targets indicar
cowardFoge do jogador mais próximo, ou do que a sua definição fears indicar
wanderPasseia 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çãoPredefiniçãoSignificado
follow_distance6A que distância fica o dono antes de o mob ir atrás dele
follow_stop3A que distância chega
follow_speed1.2Velocidade ao seguir
chase_speed1.3Velocidade ao combater
reach2.2A que distância chega para bater
fuse_distance3Um creeper acende o pavio a esta distância do alvo
fuse_escape7O pavio de um creeper apaga-se quando o alvo se afasta até esta distância, ou sai da vista
shoot_distance12Um mob que dispara fá-lo a esta distância, enquanto vê o alvo
attack_ticks20Tempo entre dois golpes ou disparos
assisttrueCombate também quem o dono magoa
defend_itselftrueCombate 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çãoPredefiniçãoSignificado
targetsplayerplayer, hostile, passive, living, ou um tipo de entidade como zombie
range16A que distância repara em alvos
damage0O 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_tickscomo em guardianComo 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çãoPredefiniçãoSignificado
fearsplayerplayer, hostile, passive, living, ou um tipo de entidade como wolf
range10A que distância chega um susto antes de ele fugir
safe_distance16A que distância deixa de fugir
speed1.5Velocidade ao fugir
cornered_distance6Quanto 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çãoPredefiniçãoSignificado
radius8A que distância vai um passeio
speed1Velocidade ao passear
rest_ticks60Descanso depois de um passeio
rest_random_ticks120Um valor aleatório de 0 a este número de ticks, menos um, somado a cada descanso
walk_ticks200Um 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.

MembroDevolveDescrição
mob:override_ai(behaviors, options?)true, ou false e o motivoSubstitui 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()boolDevolve ao mob a sua própria IA. true quando tinha uma substituição
mob.ai_overriddenboolSe o mob executa agora uma substituição

options é uma tabela, e todas as chaves são opcionais:

ChaveSignificado
ownerUma tabela de entidade ou um texto UUID. Omita-a para um mob que não serve ninguém
durationQuanto tempo dura a substituição, em ticks. Se a omitir, dura até ser retirada
settingsUma 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_ai devolve false com 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 owner pode 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_ai devolve false com 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 .lua aí 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 id tem de ser fmm:mob/ seguido do seu nome, pelo que mob_behaviors/scared_of_cats.lua declara id = '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 reload volta 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 priority mais 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 usam 5 para coward e para o combate de guardian, 10 para hostile, 20 para o seguimento de guardian e 40 para wander.
  • probe_interval é a frequência, em ticks, com que a um comportamento parado é perguntado can_start. tick_interval é a frequência com que um em execução executa can_continue e tick. Ambos são 1 por predefinição e contam como 200 acima 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_ai e o comando recusam um par assim e dizem porquê.

O que recebe um callback​

NomeO que é
c.overlayO lugar do mob na substituição. Consulte c.overlay
c.settingsAs definições deste comportamento para este mob: as suas predefinições com os valores da substituição por cima
c.memoryget(name), set(name, value), forget(name) e contains(name) para os nomes em memories. Cada mob tem a sua
c.tickO tick atual do jogo, para temporizadores
c.entityA tabela de entidade do mob, com current_location, health, entity_type e o resto
c.perception, c.actuatorO 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.

MembroO que dá ou faz
c.overlay.ownerA tabela de entidade do dono enquanto está vivo no mundo do mob, senão nil
c.overlay.owner_attackerQuem magoou o dono nos últimos 10 segundos, ou nil
c.overlay.owner_targetQuem o dono magoou nos últimos 10 segundos, ou nil
c.overlay.attackerQuem 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.remainingOs 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.

ChamadaControloO que faz
c.actuator:move_to(location, speed)moveCaminha até lá por um caminho
c.actuator:flee(location, speed)movePlaneia 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()movePara
c.actuator:look_at(location)lookVira a cabeça para lá durante os dois ticks seguintes
c.actuator:attack(target)attackO 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)attackUma pancada que causa esse dano
c.actuator:shoot(target)attackO 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, tick ou stop de um comportamento, num comportamento que liste o controlo de que precisa.
  • Guarde o estado de cada mob em c.memory, declarado em memories, 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_ai recusa. 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 reload tiver sido executado: de imediato nos mobs carregados, e nos outros quando carregarem.

Depois de uma correção, execute /fmm reload.