跳至主要內容

生物行為

生物行為是一個 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_distance6主人離多遠時,生物會跟上去
follow_stop3它會靠多近
follow_speed1.2跟隨時的速度
chase_speed1.3戰鬥時的速度
reach2.2它靠多近才會攻擊
fuse_distance3苦力怕在距離其目標這個範圍之內時開始引信
fuse_escape7目標離開到這個距離,或不在視線內時,苦力怕的引信會熄滅
shoot_distance12會射擊的生物,在目標位於這個距離之內且看得見時射擊
attack_ticks20兩次攻擊或射擊之間的時間
assisttrue也對付主人所傷害的人
defend_itselftrue也對付傷害它的人

hostile​

它攻擊過去 10 秒內傷害過它的人,否則攻擊 range 之內最近的目標。它每 10 個 tick 尋找一次新目標。有主人時,它會放過主人以及其他為主人效力的生物。

設定預設值意義
targetsplayerplayer、hostile、passive、living,或實體類型,例如 zombie
range16它能察覺目標的距離
damage0一次攻擊造成的傷害。0 表示交給生物自己的攻擊,對於沒有攻擊的種類(例如雞)則是 2
chase_speed、reach、fuse_distance、fuse_escape、shoot_distance、attack_ticks與 guardian 相同同 guardian

coward​

當它所害怕的東西進入 range 之內,它就開始逃跑,並在離該東西 safe_distance 遠時停下。它也會從過去 10 秒內傷害過它的人逃開,條件是該攻擊者在 range 之內,或在它已開始逃跑後處於 safe_distance 之內。每次逃跑都會規劃一條遠離驚嚇來源、約十個方塊的路徑。若身處沒有那麼長出路的房間或圍欄,它會退到最遠的牆邊。

設定預設值意義
fearsplayerplayer、hostile、passive、living,或實體類型,例如 wolf
range10驚嚇來源靠多近它才會跑
safe_distance16跑到多遠才會停下
speed1.5逃跑時的速度
cornered_distance6在找不到出路的地方,它會試著後退多遠

wander​

它挑選一個最遠 radius 個方塊的地點,走過去,然後休息。其他每個內附行為都會立刻從它手中接走生物。

設定預設值意義
radius8一次閒逛走多遠
speed1閒逛時的速度
rest_ticks60閒逛之後的休息時間
rest_random_ticks120每次休息再加上隨機的 0 到(這個數字減一)個 tick
walk_ticks200無法走完的閒逛會在這麼久之後結束

從 Lua 腳本使用​

在 FreeMinecraftModels 執行的每個 Lua 腳本中,生物的實體表多出三個成員。玩家表沒有它們。

成員回傳說明
mob:override_ai(behaviors, options?)true,或 false 加上原因覆寫生物的 AI。behaviors 是一個名稱或名稱清單。已有覆寫的生物會改用這一個
mob:restore_ai()bool讓生物取回自己的 AI。若它有覆寫則為 true
mob.ai_overriddenbool生物現在是否正在執行覆寫

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.actuatorMagmaCore 的 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。