生物行為
生物行為是一個 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 腳本(包括首領能力)中也有同樣的三個成員。行為仍由 FreeMinecraftModels 執行,來自它自己的 mob_behaviors 資料夾。
- 菁英、首領和 EliteMobs 的 NPC 在那裡會被拒絕,
override_ai會回傳false與原因。首領可以把周圍的生物變成自己的守衛,但它自己無法被覆寫。 owner可以是首領:owner = context.boss。- 請為覆寫指定一個
duration。即使發起它的首領不在了,覆寫仍會持續。 - 沒有 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 首領,無法被覆寫。 - 沒有行為程式的 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。