怪物行为
怪物行为是一个 Lua 文件,它接管一只并非由 FreeMinecraftModels 生成的怪物的 AI:自然生成的苦力怕、一只鸡、袭击中的掠夺者。接管持续期间,怪物按文件所写行事。之后它取回自己的 AI,行为恢复如前。
插件自带四种行为。苦力怕可以跟随一名玩家,并对攻击他的人引爆自己;鸡可以攻击玩家;掠夺者可以惊恐逃跑。你可以用命令或Lua 脚本给怪物加上行为,持续一段设定的时间,或直到被清除。
怪物行为需要 2.15.0 之后的 FreeMinecraftModels 版本,以及 Minecraft 1.21.4 或更高版本。
接管会做什么
- 怪物自己的目标和 Brain 停止,所以它自己什么都不做。只有这些行为会让它移动、转向和攻击。
- 其他一切都保留:它的生命值、装备、移动速度和名字,阳光仍会灼烧它。
- 一旦 128 个方块内没有玩家,它仍会消失,除非已经有什么让它留了下来。原版中,在距玩家 32 到 128 个方块之间闲置的怪物过一段时间会随机消失;被接管期间,这种较慢的消失不会发生。
- 它按自己种类的方式移动和战斗。苦力怕膨胀并爆炸,骷髅射箭,僵尸挥击。
- 怪物可以有一个主人,即玩家或任何其他生物实体。它自己的攻击绝不会伤害它的主人:它的击打、它射出的投射物和苦力怕的爆炸都会被取消。药水效果不会被取消,行为通过
c.overlay.owner对主人所做的任何事也不会。 - 时间到了或有东西清除了接管后,怪物取回自己的 AI。僵尸再次追猎玩家,鸡四处游荡。
- 接管在区块卸载、服务器重启和
/fmm reload之后仍留在怪物身上。有时限的接管在怪物未加载期间继续计时,如果期间时间已用完,它就消失了。行为的记忆在怪物回来时从空开始。 - 它会自行结束:时间到了,怪物死亡,怪物变成另一种怪物(例如村民变成女巫),或某个行为调用了
c.overlay:finish()。
命令
所有命令都需要权限 freeminecraftmodels.mobbehaviors.admin(OP 拥有它),并且仅限玩家使用。
| 命令 | 用途 |
|---|---|
/fmm mobbehavior apply <behaviors> [seconds] [radius] | 用指定的行为接管你准星所指、最远 32 个方块内那只怪物的 AI,并让你成为它的主人。指定半径时,则改为接管以你为中心、每个轴向上该半径个方块以内的所有怪物 |
/fmm mobbehavior applywild <behaviors> [seconds] [radius] | 同上,但没有主人 |
/fmm mobbehavior clear | 把你准星所指怪物自己的 AI 还给它 |
/fmm mobbehavior clear all | 把自己的 AI 还给每一只已加载的被接管的怪物。位于未加载区块中的怪物保留其接管,并在区块加载时重新接上 |
/fmm mobbehavior list | 列出已加载的行为,以及有多少只怪物在运行其中之一 |
behaviors是一个名称,或用逗号连接、不带空格的多个名称,例如coward,wander。seconds是接管持续多久。省略它或用0,则持续到被清除为止。- 怪物绝不会攻击或害怕它的主人。要在自己身上试
hostile或coward,请用applywild。 hostile和coward不会选中创造或旁观模式的玩家,所以请在生存模式下测试。创造模式的玩家如果打了怪物,怪物仍会在 10 秒内与其战斗或躲避他。
/fmm mobbehavior apply guardian
/fmm mobbehavior applywild hostile 30
/fmm mobbehavior applywild coward,wander 0 12
第一条让你注视的苦力怕跟随并保卫你。第二条让一只鸡攻击你 30 秒。第三条让 12 个方块内的每只怪物从你身边逃跑,直到你运行 clear all。
自带行为
| 名称 | 怪物做什么 |
|---|---|
guardian | 待在主人附近,并与伤害主人的人、主人伤害的人以及伤害它自己的人战斗 |
hostile | 攻击最近的玩家,或其 targets 设置所指定的对象 |
coward | 从最近的玩家身边逃跑,或从其 fears 设置所指定的对象身边逃跑 |
wander | 在没有别的东西驱动它时四处闲逛 |
被接管的怪物连同其余 AI 一起失去了自己的闲逛,所以如果没有 wander,每当它的其他行为无事可做时,它就站着不动。把 wander 加进列表,例如 coward,wander。它在列表中的位置无关紧要:由行为的 priority 决定哪个行为来驱动怪物。
会射击的怪物,在目标处于 reach 之内时改用近战击打,而不是射击。
速度是对怪物自身移动速度的倍数,所以 1 就是它的正常行走速度。距离以方块为单位,时间以 tick 为单位。
guardian
主人离开 follow_distance 远时它开始跟随,离主人 follow_stop 远时停下。它先与主人的攻击者战斗,再与自己的攻击者战斗,然后才是主人的目标。每个都在被击打后记住 10 秒。没有主人时,它只保卫自己。
| 设置 | 默认值 | 含义 |
|---|---|---|
follow_distance | 6 | 主人走多远时怪物会跟上去 |
follow_stop | 3 | 它靠得多近 |
follow_speed | 1.2 | 跟随时的速度 |
chase_speed | 1.3 | 战斗时的速度 |
reach | 2.2 | 它靠多近才出手击打 |
fuse_distance | 3 | 苦力怕在离目标这个距离之内开始点燃引信 |
fuse_escape | 7 | 目标离开这么远,或离开视线时,苦力怕的引信熄灭 |
shoot_distance | 12 | 会射击的怪物在这个距离之内、能看见目标时射击 |
attack_ticks | 20 | 两次击打或射击之间的时间 |
assist | true | 也与主人伤害的人战斗 |
defend_itself | true | 也与伤害它自己的人战斗 |
hostile
它攻击最近 10 秒内伤害过它的人,否则攻击 range 之内最近的目标。它每 10 个 tick 寻找一次新目标。有主人时,它会放过主人以及其他为同一主人效力的怪物。
| 设置 | 默认值 | 含义 |
|---|---|---|
targets | player | player、hostile、passive、living,或像 zombie 这样的实体类型 |
range | 16 | 它能注意到目标的距离 |
damage | 0 | 一次击打造成的伤害。0 表示交给怪物自己的攻击,对没有攻击的种类(例如鸡)是 2 |
chase_speed、reach、fuse_distance、fuse_escape、shoot_distance、attack_ticks | 与 guardian 相同 | 与 guardian 中相同 |
coward
当它害怕的东西进入 range 之内时,它开始逃跑,离开 safe_distance 远时停下。它也会从最近 10 秒内伤害过它的人身边逃跑,条件是该攻击者在 range 之内,开始逃跑后则在 safe_distance 之内。每次逃跑都规划一条远离惊吓源、约十个方块长的路径。在没有那么长的出路的房间或围栏里,它退到最远的墙边。
| 设置 | 默认值 | 含义 |
|---|---|---|
fears | player | player、hostile、passive、living,或像 wolf 这样的实体类型 |
range | 10 | 惊吓源靠多近它就会逃跑 |
safe_distance | 16 | 离多远它停止逃跑 |
speed | 1.5 | 逃跑时的速度 |
cornered_distance | 6 | 在找不到出路的地方它试图后退多远 |
wander
它挑选一个最远 radius 个方块外的地点,走过去,然后休息。其他每个自带行为都会立即从它手中夺走怪物。
| 设置 | 默认值 | 含义 |
|---|---|---|
radius | 8 | 一次闲逛走多远 |
speed | 1 | 闲逛时的速度 |
rest_ticks | 60 | 闲逛之后的休息时间 |
rest_random_ticks | 120 | 每次休息再加上一个随机的 0 到这个数减一的 tick 数 |
walk_ticks | 200 | 它无法走完的一次闲逛在这么久之后结束 |
通过 Lua 脚本
在 FreeMinecraftModels 运行的每个 Lua 脚本中,怪物的实体表多了三个成员。玩家表没有它们。
| 成员 | 返回 | 描述 |
|---|---|---|
mob:override_ai(behaviors, options?) | true,或 false 及原因 | 接管怪物的 AI。behaviors 是一个名称或名称列表。已有接管的怪物会用这一个取代原来的 |
mob:restore_ai() | bool | 把怪物自己的 AI 还给它。当它有接管时为 true |
mob.ai_overridden | bool | 怪物现在是否在运行接管 |
options 是一个表,每个键都是可选的:
| 键 | 含义 |
|---|---|
owner | 一个实体表或一个 UUID 字符串。对不为任何人效力的怪物请省略 |
duration | 接管持续多久,以 tick 为单位。省略则持续到被清除为止 |
settings | 一个按行为名称索引的设置表的表,其中的值取代每个行为的默认值 |
local ok, why = mob:override_ai({ 'guardian', 'wander' }, {
owner = player,
duration = 600,
settings = { guardian = { chase_speed = 1.6, assist = false } }
})
当某个行为名称没有加载,或该实体无法被接管时,override_ai 返回 false 及原因。空列表,或既不是实体表也不是 UUID 的 owner,会抛出错误。行为没有的设置,或类型错误的值,会在控制台报告,默认值保持不变。
通过 EliteMobs 脚本
从 10.9.14 之后的 EliteMobs 版本起,在安装了 FreeMinecraftModels 时,怪物的实体表在 EliteMobs 脚本(包括 Boss 能力)中也有同样的三个成员。行为仍由 FreeMinecraftModels 运行,来自它自己的 mob_behaviors 文件夹。
- 精英、Boss 和 EliteMobs 的 NPC 在那里会被拒绝,
override_ai返回false及原因。Boss 可以把周围的怪物变成自己的守卫,但它自己不能被接管。 owner可以是 Boss:owner = context.boss。- 请给接管指定一个
duration。即使发起它的 Boss 不在了,接管仍会持续。 - 没有 FreeMinecraftModels,或其版本早于怪物行为时,
override_ai返回false及原因。
mob:override_ai('guardian', { owner = context.boss, duration = 600 })
通过其他插件
插件在 Java 中通过 com.magmaguy.freeminecraftmodels.api.MobBehaviorAPI 使用怪物行为。overrideAI(mob, behaviors, owner, durationTicks, settings) 返回 null,或拒绝的原因。restoreAI(mob) 和 isAIOverridden(entity) 返回布尔值,behaviors() 列出已加载的名称。每个参数都是普通的 Java 或 Bukkit 类型,因此针对较旧的 FreeMinecraftModels 编译的插件可以按名称查找这些方法。请在服务器线程上调用它们。
哪些怪物
- 任何怪物都可以被接管,不论它由什么生成。玩家和盔甲架不行。
- 它是为沿路径行走的怪物构建的:僵尸、骷髅、苦力怕、掠夺者、牛、鸡以及类似的怪物。到目前为止只在尸壳、苦力怕和鸡上测试过。
- 不沿路径行走的怪物在接管下可能移动不佳或根本不动。这包括史莱姆、岩浆怪、恶魂、幻翼、兔子、鱿鱼和鱼。
- 宠物以及其他已经运行行为程序的怪物,例如带有
behavior的 EliteMobs Boss,不能被接管。 - 没有行为程序的 EliteMobs 精英对 FreeMinecraftModels 来说是普通怪物,可以被接管,但这种组合尚未测试过。
文件
- 行为存放在
plugins/FreeMinecraftModels/mob_behaviors/中,在该文件夹或任何子文件夹里。那里的每个.lua文件都是一个行为。 - 行为的名称是去掉
.lua的文件名。它只能使用小写字母、数字、.、_和-。 - 它的
id必须是fmm:mob/后跟它的名称,所以mob_behaviors/scared_of_cats.lua声明id = 'fmm:mob/scared_of_cats'。id 与名称不匹配的文件会被忽略并给出警告。 - 当两个文件同名时,路径排序靠前的那个会加载,控制台会对另一个给出警告。
- 当
mob_behaviors/中直接没有某个同名文件时,FreeMinecraftModels 会写入它自带的四个行为中对应的那个。被删除的行为会在下次启动或/fmm reload时回来。你编辑过的文件绝不会被覆盖。把一个文件移进子文件夹,会让默认文件回到它旁边,并且只有路径排序靠前的那个会加载。 /fmm reload会重新读取每个文件。正在运行的接管会停止,并用新文件重新开始。
编写行为
行为文件是一个宠物行为模块,只是 id 前缀不同:ai.module,带有 settings、memories、behaviors 和 sensors。共享的规则在 EliteMobs 的行为程序中。从最接近你需求的自带文件开始,把它复制为一个新名称,并把它的 id、它的行为 id 和它的记忆名称改成以新名称开头。
这个行为让怪物从猫身边逃跑:
-- 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
}
}
}
priority数字较小的先行,并会从数字较大的、正在运行的行为手中夺取它所列出的控制权。自带行为中,coward和guardian的战斗使用5,hostile使用10,guardian的跟随使用20,wander使用40。probe_interval是询问一个已停止的行为can_start的频率,以 tick 为单位。tick_interval是一个正在运行的行为运行can_continue和tick的频率。两者默认都是1,大于200时按200计。- 同一只怪物上的两个行为不能共用同一个行为 id、传感器 id 或记忆名称。
override_ai和命令会拒绝这样的一对并说明原因。
回调能得到什么
| 名称 | 它是什么 |
|---|---|
c.overlay | 怪物在接管中的位置。参见 c.overlay |
c.settings | 该行为针对这只怪物的设置:它的默认值,加上接管给出的值叠在上面 |
c.memory | 针对 memories 中名称的 get(name)、set(name, value)、forget(name) 和 contains(name)。每只怪物各有自己的 |
c.tick | 当前的游戏 tick,用于计时器 |
c.entity | 怪物的实体表,包含 current_location、health、entity_type 等 |
c.perception、c.actuator | MagmaCore 的 Mind 上下文。参见 Mind 程序上下文 |
c.overlay
这四个实体每次都会重新读取,所以回调多次使用某一个时,请把它存进局部变量。
| 成员 | 它给出什么或做什么 |
|---|---|
c.overlay.owner | 主人在怪物所在世界中存活时,给出主人的实体表,否则为 nil |
c.overlay.owner_attacker | 最近 10 秒内伤害过主人的人,或 nil |
c.overlay.owner_target | 主人在最近 10 秒内伤害过的人,或 nil |
c.overlay.attacker | 最近 10 秒内伤害过这只怪物的人,或 nil |
c.overlay:nearest(radius, kind?) | 半径之内某个种类最近的生物实体,或 nil。kind 是 player、hostile(怪物)、passive(动物)、living(默认),或按 Bukkit 名称给出的实体类型,例如 zombie 或 iron_golem。村民和傀儡既不是 hostile 也不是 passive。半径最多达到 128 个方块 |
c.overlay:entity(uuid) | 具有该 UUID 的生物实体在怪物所在世界中存活时给出它,否则为 nil。供在记忆中保存其目标 UUID 的行为使用 |
c.overlay.remaining | 接管还剩的 tick 数,没有终点时为 nil |
c.overlay:finish() | 在本 tick 结束后结束接管,怪物取回自己的 AI |
owner_attacker、owner_target、attacker 和 nearest 绝不会给出怪物的主人,或为同一主人效力的另一只怪物。nearest 还会跳过创造和旁观模式的玩家以及盔甲架。
移动与战斗
这些 c.actuator 调用完成实际工作。每个都需要其行为列出所指明的控制权。
| 调用 | 控制权 | 它做什么 |
|---|---|---|
c.actuator:move_to(location, speed) | move | 沿路径走到那里 |
c.actuator:flee(location, speed) | move | 规划一条远离该位置、约十个方块长的路径并沿其前进。怪物找不到出路或无法规划路径时为 false。请每隔几个 tick 调用一次,而不是每个 tick |
c.actuator:stop_moving() | move | 停下 |
c.actuator:look_at(location) | look | 在接下来的两个 tick 把头转向那里 |
c.actuator:attack(target) | attack | 该种类自己的击打:造成怪物攻击伤害的一次挥击,对没有攻击的种类则是 2。苦力怕则改为膨胀,只要每个 tick 都调用就持续膨胀,完全膨胀后爆炸。有一个 tick 没有调用,它就会缩回原状 |
c.actuator:attack(target, damage) | attack | 造成该数值伤害的一次挥击 |
c.actuator:shoot(target) | attack | 该种类自己的射击:骷髅的箭、掠夺者的弩、女巫的药水、羊驼的唾沫。对没有射击的种类为 false |
flee、shoot 和带伤害的 attack 是随怪物行为一起新增的,在宠物行为模块中同样可用,其中 flee 需要能规划路径的身体,shoot 需要其种类会射击的身体。
规则
- 只能在行为的
start、tick或stop中调用执行器,并且该行为要列出它所需的控制权。 - 把每只怪物的状态保存在
c.memory中,在memories下声明,名称以该行为的名称开头。 - 保持回调简短。怪物行为与宠物行为模块受同样的限制,并与它们共享每个 tick 的 10 毫秒。
出问题时
这里的任何问题都不会让服务器或其他怪物停止。在控制台中搜索 mob behavior,忽略大小写。
- 行为没有加载。 无法编译、id 与文件名不匹配,或名称含有其他字符的文件会被忽略,并给出一条指明文件和原因的警告。其他每个文件仍会加载。
- 命令或
override_ai拒绝了。 它会说明原因:某个行为名称没有加载(并列出加载了的那些),或某个实体无法被接管。 - 怪物站着不动。 它的行为无事可做。请添加
wander,或检查你是否处于生存模式且不是怪物的主人。 - 回调在怪物运行时失败。 每种回调和每种失败类型在下次重载之前只记录一次。该行为被停止或不启动,并在下一次
probe_interval检查时被再次询问。 - 怪物无法重新接上它的接管。 当它的区块加载而它的某个行为已不存在时,控制台会这样说明,怪物保留自己的 AI。一旦文件回来并且运行了
/fmm reload,接管就会回来:已加载的怪物立即恢复,其他怪物在加载时恢复。
修复之后,运行 /fmm reload。