FreeMinecraftModels 動畫
FreeMinecraftModels 從 .bbmodel 與 .fmmodel 檔案匯入動畫。本頁介紹保留名稱、動畫如何混合、影格時間、插值、循環模式、逆向運動學(IK)以及模型如何轉向。
關於骨骼命名規則與其餘的匯入契約,請參閱模型製作注意事項。
狀態動畫
FreeMinecraftModels 把這六個小寫動畫名稱,以及下文四個游泳與騎乘動畫名稱,綁定到自動的運行時狀態。模型中的其他一切都是自訂動畫。
| 動畫名稱 | 是否循環 | 何時播放 |
|---|---|---|
spawn | 否 | 模型建立時播放一次。結束後,若其實體正在移動,模型會切換到 walk,否則切換到 idle |
idle | 是 | 實體沒有水平速度時。X 或 Z 速度不為零時,以交叉淡入淡出切換到 walk |
idle.long | 否 | 模型在沒有其他動畫播放的情況下顯示 idle,等待隨機的 longIdleMinSeconds 到 longIdleMaxSeconds(預設 15 到 30 秒)後,播放一次。之後模型會交叉淡入淡出回到 idle,並重新開始等待 |
walk | 是 | 實體的 X 或 Z 速度不為零時。兩者皆為零時,以交叉淡入淡出切換到 idle |
attack | 否 | 被觸發時播放。在 idle 或 walk 之上播放一次,然後結束 |
death | 否 | 呼叫 removeWithDeathAnimation() 時。從目前姿勢淡入。結束後,模型會在 20 tick 內縮小消失並被移除 |
FMM 只會對喚魔者自行觸發 attack:當喚魔者召喚的尖牙出現在它兩格範圍內時。其他外掛則透過 API 觸發攻擊。EliteMobs 會播放 attack.melee 與 attack.ranged。每個以 attack. 開頭的名稱都是攻擊,播放方式與 attack 相同。
無論 Blockbench 的循環設定為何,idle.long 都只播放一次。移動、攻擊或其他動作、基礎層上的自訂動畫,以及玩家把生物當作坐騎駕駛,都會讓等待重新開始,同樣的情況也會中斷進行中的 idle.long。沒有 idle.long 的模型永遠不會等待。idle.long 需要 FreeMinecraftModels 2.15.0 或更新版本;更早的版本會把它當作自訂動畫。
另外四個基礎動畫,只要模型有,就會在生物游泳或被玩家騎乘時取代 walk 與 idle 播放:
- 騎乘。 在玩家駕駛、裝有鞍的馬上的模型,例如被騎乘的寵物或
/fmm mount的坐騎,移動時播放ride取代walk,站立時播放idle.ride取代idle。寵物檔案可以用riding.animation與riding.idleAnimation指定其他動畫;請參閱騎乘。外掛呼叫getAnimationComponent().setRiddenAnimation(name)與setRiddenIdleAnimation(name),傳入null則關閉其中一個。沒有ride的模型在騎乘者底下會走路,沒有idle.ride的模型則會閒置。 - 游泳。 其生物正在游泳(即在水中且離地)的模型,移動時播放
swim取代walk,靜止不動時播放idle.swim取代idle。寵物檔案可以用swimming.animation與swimming.idleAnimation指定其他動畫;請參閱游泳。外掛呼叫getAnimationComponent().setSwimAnimation(name)與setIdleSwimAnimation(name),傳入null則關閉其中一個。沒有swim的模型在水中會走路,沒有idle.swim的模型靜止不動時則會閒置。玩家駕駛的坐騎在水中也會播放其騎乘動畫。
四者都需要 FreeMinecraftModels 2.15.0 或更新版本。
命名
動畫名稱一律小寫。點號把通用名稱與較具體的名稱分開,底線則連接同一部分裡的單字:idle.long 是一種 idle,attack.melee 是一種 attack。每個靜止姿勢都是 idle. 加上它所暫停之移動的名稱:
| 移動 | 靜止 | |
|---|---|---|
| 在陸地上 | walk | idle,偶爾 idle.long |
| 在水中 | swim | idle.swim |
| 被騎乘 | ride | idle.ride |
模型缺少帶點的名稱時,FMM 會改為播放該名稱最後一個點號之前的部分:attack.melee 改播 attack,idle.swim 改播 idle。腳本與外掛依名稱播放的動畫也一樣:playAnimation 與 hasAnimation 都遵循此規則。
在此之前製作的模型使用 long_idle、attack_melee 與 attack_ranged。FMM 會以新名稱找到它們,也會以舊名稱找到新名稱,因此較舊的模型與較舊的外掛無須修改即可繼續運作。
帶點的名稱、這套後備機制與舊拼法,需要 FreeMinecraftModels 2.15.0 或更新版本。
由狀態機的建構方式推導出的規則:
- 若模型有
spawn,起始狀態就是spawn,否則為idle。兩者皆無的模型會顯示其靜止姿勢,直到它開始行走或有東西播放動畫。 - 只有模型中實際存在的動畫才會被使用。一個有
walk但沒有idle的模型,停止移動後仍會繼續行走。 - idle/walk 切換讀取底層實體的水平速度;單純的垂直移動不會開始行走。靜態實體與玩家偽裝沒有供此功能使用的底層實體,靜止道具也沒有水平移動。其他動畫透過腳本、API 或 FMM 偽裝控制器驅動。
jump 狀態一般的建模實體沒有 jump 狀態。名為 jump 的動畫表現得跟其他自訂動畫一樣,必須依名稱播放。玩家偽裝是例外:它們獨立的控制器會在玩家跳躍時播放 jump。
動畫混合
FMM 把模型的動畫分成兩層播放,並在每個 tick 把它們混合成同一個姿勢,Java 與 Bedrock 皆是如此。
| 層 | 在這一層播放的內容 |
|---|---|
| 基礎層 | spawn、idle、idle.long、walk、騎乘與游泳動畫,以及 death,或是以 blend 設為 false 播放的自訂動畫,它會接管整個姿勢 |
| 動作層 | attack 與每個 attack. 名稱(例如 attack.melee 與 attack.ranged)、damaged,以及以 blend 設為 true 播放的自訂動畫。動作會疊在基礎層之上播放,因此模型可以邊走邊攻擊 |
基礎動畫沒有設定關鍵影格的骨骼,會回到靜止姿勢。動作沒有設定關鍵影格的骨骼,則保持其基礎姿勢。
淡入淡出
| 切換 | 淡入淡出 |
|---|---|
在 idle、idle.long、walk 以及騎乘與游泳動畫之間切換 | 在 idleWalkBlendTicks(預設 5 tick)內交叉淡入淡出。淡入淡出期間兩個動畫都會持續播放 |
任何動畫切換到 death | 從模型上一個 tick 顯示的姿勢(包含動作)開始淡入,歷時 deathBlendTicks(預設 4 tick) |
| 其他所有切換 | 立即切換 |
淡入淡出是緩入緩出,而不是等速移動。當新的 idle/walk 切換打斷了淡入淡出時,下一次淡入淡出會從模型當時顯示的姿勢開始。動作的開始與結束沒有淡入淡出。
Override 與混合權重
FMM 會從 Blockbench 中每個動畫的屬性讀取兩項設定。
| Blockbench 設定 | 在 FMM 中的效果 |
|---|---|
| Override 開啟 | 在動作層上,該動畫設有關鍵影格的骨骼會採用它的姿勢,並捨棄基礎姿勢 |
| Override 關閉(預設) | 在動作層上,該動畫的旋轉與位置會疊加到它所設關鍵影格之骨骼的基礎姿勢上,其縮放則乘上基礎縮放 |
| Blend Weight | 縮放該動畫的套用強度,兩層皆適用。1(預設)依製作的關鍵影格套用。0.5 只套用每個旋轉與位置的一半,並讓縮放從 1 朝關鍵影格的值移動一半 |
當攻擊所設關鍵影格的骨骼,不論走路循環在做什麼,都必須精確達到所製作的姿勢時,請開啟 Override。若要把攻擊的動作疊加到走路上,例如雙腿持續行走的同時揮動手臂,請保持關閉。在 Java 上,Override 對基礎層動畫沒有作用,基礎層動畫一律取代整個姿勢。
FMM 只把 Blend Weight 當成純數字讀取。Molang 運算式會記錄 Model <model>, animation <animation> has the blend weight '<value>'. FreeMinecraftModels only reads plain numbers and uses 1.。FMM 不支援 Blockbench 的 Start Delay、Loop Delay 與 Anim Time Update。設定了其中任何一項的動畫會記錄警告,並在沒有這些設定的情況下播放。
哪個動畫勝出
- 自訂動畫(包含
damaged)的優先權高於內建動畫。當其中一個在任一層播放時,攻擊請求會被丟棄。death會打斷一切。 - 新的動作會取代正在播放的動作,因此第二次攻擊會重新開始攻擊,而以
blend設為true播放的自訂動畫會取代正在執行的攻擊。 - 以
blend設為false播放的自訂動畫,會結束目前的動作。 - 當自訂動畫占用基礎層時,FMM 會在底下持續追蹤 idle 與 walk。占用基礎層會結束進行中的
spawn或idle.long。單次自訂動畫結束時,模型會瞬間切換到與其移動相符的idle或walk。明確請求idle或walk時,循環的自訂動畫會立即結束;若是單次自訂動畫,則會在它結束後才顯示所請求的動畫。 - 單次動作會在最後一個影格後結束。如果基礎層沒有東西可顯示,例如沒有
spawn或idle動畫的道具,動作會改為停在最後一個影格,因此這樣打開的門會保持開啟。當模型沒有可返回的idle或walk時,基礎層上的單次自訂動畫也會停在最後一個影格。
玩家偽裝使用另一組名稱
玩家偽裝新增逐 tick 控制器,透過相同的播放引擎請求動畫。它的五個保留名稱是 attack、jump、sneak、walk、idle,在單次動畫倒數未執行時依此優先順序檢查。attack 在動作層播放,jump 與 sneak 接管基礎層,而 idle 與 walk 則選擇內建狀態。模型沒有 idle 時會在主控台警告。完整表格與單次動畫的時間限制請參閱玩家偽裝。
自訂動畫
任何名稱不屬於上述狀態名稱之一的動畫,仍可依名稱播放:
modeledEntity.playAnimation("open", /* blend */ true, /* loop */ false);
modeledEntity.stopCurrentAnimations();
boolean exists = modeledEntity.hasAnimation("open");
context.prop:play_animation("open", true, false)
context.prop:stop_animation()
blend決定自訂動畫所在的層。true會在動作層播放它,疊在idle或walk之上,並套用其 Blockbench Override 與混合權重。false則讓它占用基礎層,因此它會取代整個姿勢並結束目前的動作。請參閱動畫混合。- 請求會被排入佇列,並在模型下一個 tick 開始時依序套用。每個請求都會執行;後來的請求不會取消佇列中較早的請求。
loop適用於自訂動畫與damaged。內建名稱會忽略blend與loop:idle與walk一律循環,而spawn、death與攻擊只播放一次。依名稱播放的idle.long與其他自訂動畫一樣。- 內建名稱與攻擊名稱不分大小寫。對其他名稱,FMM 會先尋找精確名稱,再尋找其小寫形式,接著是改名之名稱的舊拼法,最後是帶點名稱的通用部分(請參閱命名)。
hasAnimation找到的名稱與playAnimation播放的名稱相同。模型必須包含小寫名稱,內建狀態才能運作。 damaged一律在動作層播放,不論blend為何。- 對於模型沒有的名稱,以及
death被請求之後的任何請求,playAnimation都回傳false。true表示請求已排入佇列,不代表已經播放了影格:攻擊仍可能被執行中的自訂動畫丟棄。 stopCurrentAnimations()會結束所有自訂動畫與動作,並讓模型瞬間切換到idle,沒有idle時則回到靜止姿勢。- 死亡是終止狀態:一旦請求了
death,新的播放請求會回傳false,排隊的請求會被忽略,stopCurrentAnimations()也不會有任何作用。
時序與長度
- Blockbench 以秒為單位儲存動畫長度。FMM 以
ceil(seconds x 20)轉換它,因此長度一律是整數個 tick,短動畫會無條件進位而非捨去。 - 只用數字設定關鍵影格的通道,會在匯入時被烘焙成一個扁平的逐 tick 影格陣列,播放時每 tick 讀取一個影格。含有 MoLang 關鍵影格的通道則改為每個實體每 tick 取樣;請參閱 MoLang 關鍵影格。
- 每個正在播放的動畫都有自己的 tick 計數器,因此基礎層、動作層與正在淡出的動畫各自獨立前進。循環動畫以
counter % duration取索引;非循環動畫則鉗制在它們的最後一個影格。 - 關鍵影格時間保留小數 tick 位置(
20 x time,不取整),因此 0.37 秒的關鍵影格也參與 tick 之間的插值。影格在0到duration - 1的整數 tick 上取樣;恰好位於宣告結束時間的關鍵影格會影響插值,但本身不會被取樣。如果必須在可見影格達到最終姿勢,請將它放在這個邊界之前。 - 若同一通道上有兩個關鍵影格落在完全相同的時間,檔案順序中較後者勝出。
- 時間為非有限值的關鍵影格會中止該軌道,並針對每個動畫產生一則
Malformed animation timeline for model ...警告,而該模型的其他動畫仍會繼續轉換。
零長度動畫是有效的
長度為 0(或負數)的動畫會被視為刻意的靜態姿勢 —— 這是家具與其他需要一個具名「無動畫」條目的道具常見的製作選擇。它會被靜默略過且不發出警告,也不會貢獻任何影格。
循環模式
Blockbench 的循環設定控制匯出的 Bedrock 動畫:
| Blockbench 循環模式 | Bedrock 匯出 |
|---|---|
loop | "loop": true |
once | "loop": false |
hold | "loop": "hold_on_last_frame" |
Java 播放使用內建狀態的循環規則,或自訂動畫傳入的 loop 參數,不使用這個 Blockbench 欄位決定是否循環。因此設定不一致時,Java 與 Bedrock 的播放可能不同。
插值類型
每個關鍵影格帶有四種插值類型之一:linear、catmullrom(Blockbench 中的 Smooth)、bezier 與 step。超出這組範圍的任何內容都會解析失敗,並被回報為格式錯誤的時間軸。
FMM 依照 Blockbench 預覽的方式,根據兩個關鍵影格的類型播放它們之間的區段,並依以下順序判斷:
step關鍵影格會保持其值,直到下一個關鍵影格。linear關鍵影格後面接linear或step關鍵影格時,以直線混合。- 當任一關鍵影格是
catmullrom時,區段會沿著一條 Catmull-Rom 曲線,通過區段之前的關鍵影格、區段的兩個關鍵影格,以及區段之後的關鍵影格,讓動作流暢地通過每個關鍵影格,而不是在那裡停下。缺少相鄰的關鍵影格時,以該區段自身的端點代替。在 Blockbench 循環模式為loop的動畫中,若該通道至少有三個關鍵影格,曲線會跨越循環繼續,把最後一個關鍵影格再次當作第一個關鍵影格。 - 否則其中之一是
bezier,區段會依離開的關鍵影格的右控制桿與抵達的關鍵影格的左控制桿,在時間與數值上進行。儲存時沒有控制桿的關鍵影格,其控制桿位於兩側各 0.1 秒處,且沒有數值偏移。控制桿的時間會保持在區段之內。
在第一個關鍵影格之前,通道會保持該關鍵影格的值,在最後一個關鍵影格之後則保持最後一個的值。
具有分開的 pre 與 post 值的關鍵影格,以其 pre 值抵達,並從其 post 值離開。在平滑區段上,這樣的關鍵影格也會在它的那一側結束曲線。FMM 無法讀取的 post 值會被忽略。
這些規則適用於烘焙通道、Java 上的 MoLang 通道,以及 Bedrock 匯出的烘焙軌道。它們需要 FreeMinecraftModels 2.15.0 或更新版本。FreeMinecraftModels 2.3.0 到 2.14.2 只依抵達的關鍵影格的類型混合每個區段:catmullrom 在每個關鍵影格緩動到停止,bezier 無論控制桿如何都使用固定的 0.42 與 0.58 控制點,播放起來幾乎是直線,而 step 關鍵影格會在通往它的區段的一半處跳到它的值。分開的 pre 與 post 值會收攏成 pre 值。因此,含有平滑、step 或貝茲關鍵影格的模型在更新後會有不同的動作,更接近作者在 Blockbench 中看到的樣子。
有動畫的通道
每個骨骼會烘焙三個通道:旋轉、位置與縮放。製作時值得注意的事項:
- 位置值會被除以 16(Blockbench 像素轉方塊)。
- 旋轉值會被轉換成弧度。
- Blockbench
format_version5 及以上會翻轉 X 與 Y 旋轉以及 X 位置的正負號。 FMM 會依據宣告的格式版本自動補償,因此請不要手動修正 —— 但也不要把 v5 的宣告與 v4 形式的資料混在一起。 - 某個通道上沒有關鍵影格的骨骼,會在該通道保持其靜止值。基礎層動畫完全沒有設定關鍵影格的骨骼,會被重設為旋轉
0,0,0、位移0,0,0、縮放1,1,1;動作沒有設定關鍵影格的骨骼則保持基礎姿勢。 - 關鍵影格資料點在
.bbmodel中可能被寫成字串。是數字的字串會被讀成該數字,空字串對縮放而言變成1,其他情況變成0。任何其他字串都是 MoLang 運算式;請參閱 MoLang 關鍵影格。 - 具有兩個資料點(即 Blockbench 分開的 pre 與 post 值)的關鍵影格,以第一個抵達,並從第二個離開。請參閱插值類型。
MoLang 關鍵影格
以 MoLang 運算式寫成的關鍵影格值,例如 math.sin(query.anim_time * 360) * 10,會在動畫播放時為每個實體求值。
- 只要通道(也就是單一骨骼的旋轉、位置或縮放,或 IK 控制器的位置)至少有一個 MoLang 關鍵影格,該通道就不會被烘焙。每個實體每 tick 對它取樣,使用與烘焙通道相同的插值和相同的單位轉換。該通道上的數字關鍵影格保留其值。
- 可使用下列查詢,也可使用簡短的
q.前綴:
| 查詢 | 值 |
|---|---|
query.anim_time | 此動畫已播放的秒數。循環動畫每次循環都會從 0 重新開始 |
query.life_time | 自模型建立以來的秒數 |
query.modified_distance_moved | 實體水平移動的方塊數 |
query.is_moving | 實體水平移動時為 1,否則為 0 |
- 其他查詢和未知的變數都讀為
0。v.變數會在該實體的多次求值之間保留其值,而temp.(t.)值只持續一個運算式。 - 運算式使用與粒子 MoLang 相同的運算子和數學函式。
- 沒有
return的多敘述程式,會取最後一行的值,與 Blockbench 預覽的方式相同。v.a = 10; v.b = v.a * 3; v.b + 5播放時為35。最後一行是賦值時,其值為0。粒子 MoLang 維持 Bedrock 的規則,沒有return的程式其值為0。 - FMM 無法解析的運算式,會在載入時記錄一次
Failed to parse the keyframe expression '<expression>' in animation <animation> for model <model>: <reason>. That value plays as 0.。 - 不是有限數字的結果會以
0播放。 - 平滑區段也會對其兩側的關鍵影格求值,以決定曲線的形狀。那些求值不會保留它們所指派的任何變數,因此關鍵影格的指派只會在它開始或結束的區段的 tick 上生效。
Bedrock 玩家會在自己的客戶端上對這些通道求值:Bedrock 匯出會依作者寫的原樣寫入該通道的關鍵影格,請參閱 Bedrock 匯出。
哪些東西不會有動畫
hitbox骨骼。指向它的動畫軌道會被直接略過。- Blockbench 效果軌道中的音效與時間軸指令關鍵影格。FMM 只會匯入效果軌道中的粒子關鍵影格;請參閱粒子。音效請改以 Lua 腳本或你自己的外掛播放。
- 無法依名稱解析的骨骼。指向不存在骨骼的軌道會記錄
Failed to get bone <name> from model <model>!並被略過。
逆向運動學(IK)
Blockbench 的空物件會作為 IK 控制器。FMM 在運行時以 FABRIK(Forward And Backward Reaching Inverse Kinematics)求解鏈,上限為 10 次迭代、容差為 0.001。
各部分如何搭配:
- 同時具有
ik_source(根骨骼)與ik_target(末端骨骼或定位器)的空物件定義骨鏈。偵測會檢查階層,也支援同層級及向下搜尋;根層級的同層目標會產生僅包含來源骨骼的骨鏈。 - 只有空物件的位置關鍵影格驅動 IK。每影格偏移會加到目標骨骼或定位器的靜止位置。執行階段求解器不會使用已儲存的控制器靜止位置作為目標基點,旋轉與縮放軌道也不驅動 IK。
- 每個 tick,每條骨鏈都會跟隨驅動它的最上層播放中動畫:先是動作,再是基礎動畫,最後是正在淡出的動畫。該動畫的目標偏移會被套用,骨鏈隨後求解。沒有任何播放中動畫驅動的骨鏈會被清除,因此 IK 姿勢不會延續到不使用它的動畫。
lock_ik_target_rotation會被解析並儲存,但目前求解器不會套用它。
無法解析的鏈會被略過,並附帶一則具名的主控台警告 —— 確切訊息與製作限制請見模型製作注意事項。
Bedrock 匯出
每個被轉換的模型也會在產生的套件內寫入一份 Bedrock 動畫檔案,位於 animations/<model_id>.animation.json:
- 動畫識別碼為
animation.fmm.<model_id>.a_<hex>,其中<hex>是動畫名稱的 UTF-8 位元組以十六進位寫成的字串。因此,兩個只差在 Bedrock 不允許之字元的名稱,會得到不同的識別碼。 animation_length是以秒為單位的長度,下限為0.05,因此一個 tick 的動畫仍然有效。- 循環模式的對應方式如循環模式表格所示。
- 沒有任何動畫的模型仍會取得一個什麼都不做的
idle條目,讓 Bedrock 實體定義維持有效。 - 幾何體排除
hitbox、產生的fmm_nametag_bone_*名稱標籤骨骼及m_騎乘點,保留作者建立的tag_錨點。動畫匯出器寫入烘焙軌道時,不會套用相同的可見骨骼篩選,因此不要期待被排除的騎乘骨骼在播放動畫後出現可見幾何體。 - Bedrock 動畫匯出使用烘焙的骨骼旋轉、位置及縮放影格,不會將執行階段的 IK 求解結果寫入這些軌道。依賴 IK 的模型需要在 Bedrock 上個別驗證。
- 含有 MoLang 關鍵影格的骨骼通道會改為依作者寫的原樣寫入,運算式和數字都一樣,並由 Bedrock 客戶端求值。由多個敘述組成的程式會在最後一行前面寫上
return,讓 Bedrock 播放與 Java 相同的值。從 2.14.2 起,它也會加上 Bedrock 要求的結尾;。無論作者設定了什麼插值,它的關鍵影格在 Bedrock 上都是線性混合,且只寫入它們的 pre 值。在format_version為 5 或更新的模型上,X 與 Y 旋轉和 X 位置會取負號送出,數字送出其負值,程式則送出其回傳值的負值,讓 Bedrock 播放與 Java 相同的姿勢。 - 匯出的模型掛在一根
freeminecraftmodels_lean骨骼上,其支點位於模型方塊的中央。它透過四個整數實體屬性freeminecraftmodels:lean_x、lean_y、lean_z和body_offset,向 Bedrock 玩家呈現移動朝向傾斜與身體置中。動畫超過 672 個(包含為隱藏saddle或fish骨骼而產生的動畫)的模型沒有空間容納這些屬性,不會有傾斜骨骼,在 Bedrock 上會保持腳部朝下直立。 - 每個動畫都會產生一個動畫控制器,並由實體屬性切換,這就是 FMM 在 Bedrock 客戶端上播放特定動畫的方式。FMM 會同時啟用基礎動畫與動作,與 Java 的分層一致。
- 有一根名為
saddle(不分大小寫)的骨骼的模型,會在自己的動畫之後多得到一個動畫freeminecraftmodels_hide_saddle,有一根名為fish的骨骼的模型則會在其後再得到freeminecraftmodels_hide_fish。每個動畫都會把其骨骼及其下的骨骼縮小到消失,且只在伺服器隱藏該骨骼時播放:可騎乘寵物的鞍在裝上鞍之前,以及釣魚寵物的魚在牠帶著漁獲回家之前。這需要 FreeMinecraftModels 2.15.0 或更新版本。 - 開啟 Override 的動畫會寫成
"override_previous_animation": true,不為1的混合權重則寫成"blend_weight"。基礎動畫idle、walk、spawn與death會排在實體 animate 清單的最前面,因此動作會疊在它們之上。 - 控制器的
blend_transition帶有 Java 的淡入淡出時間:idle與walk在idleWalkBlendTicks內淡入淡出,death在deathBlendTicks內淡入,其他所有動畫則立即切換,包括idle.long以及騎乘與游泳動畫。這些時間在產生資源包時寫入,因此設定的變更要等資源包重新產生後,才會傳到 Bedrock 玩家。 - 粒子關鍵影格會成為該動畫的
particle_effects時間軸,讓 Bedrock 客戶端以原生方式播放。請參閱粒子。
這些需要 FreeMinecraftModels 2.16.0:
- 模型在動畫超過 532 個(而非 672 個)時就不會有傾斜骨骼;此數量仍包含產生的隱藏動畫。
- 有關鍵影格的 X 與 Y 旋轉和 X 位置,在 Bedrock 上的播放方式與 Java 相同。從 2.8.0 到 2.15.0,每個模型的烘焙軌道,以及
format_version為 5 或更新的模型的 MoLang 通道,送出時這些軸是鏡像的。繞零點均勻擺動的動作看起來一樣,但固定偏向一側的姿勢在 Bedrock 上會往另一側彎,例如手肘向後彎。資源包重新產生且 Bedrock 玩家的客戶端採用新資源包後,就能看到修正。
關於該套件在磁碟上的位置,請參閱資源包輸出。
轉向慣性
當 weightedTurning 開啟(預設)時,生物身上的模型會帶著慣性朝生物的面向轉動,而不是瞬間吸附過去。每個 tick 它的轉向速度最多改變一個加速度的量,上限為速度上限,並且會及早減速,剛好停在新的面向上。生物本身仍照常轉向與行走。模型的骨骼、碰撞箱、定位器與 Bedrock 呈現都使用模型的面向。
這兩項限制都取決於模型的大小:
- 大小是
hitbox骨骼體積(寬 x 深 x 高,單位為方塊)的立方根,乘上生物的scale屬性。沒有hitbox骨骼的模型,則改用生物自身邊界框的立方根。小於0.25的大小會視為0.25 - 最高速度是
turnSpeedCap除以大小的平方根,且絕不超過每 tick 90 度 - 加速度是
turnAcceleration除以大小
在預設的 turnSpeedCap: 30 與 turnAcceleration: 6 下:
| 碰撞箱 | 大小 | 最高速度(每 tick 度數) | 加速度(每個 tick 增加的每 tick 度數) |
|---|---|---|---|
| 0.5 x 0.5 x 0.5 | 0.5 | 42.4 | 12 |
| 1 x 1 x 1 | 1 | 30 | 6 |
| 2 x 2 x 2 | 2 | 21.2 | 3 |
| 4 x 4 x 4 | 4 | 15 | 1.5 |
其他規則:
- 當玩家直接騎乘模型的生物,或坐在它的某個
m_座位上時,模型會瞬間轉向,讓騎乘者的視角與模型保持一致。 - 由玩家操控、裝上馬鞍的馬所穿戴的模型,例如來自
/fmm mount的模型,會朝騎乘者面對的方向,且它的頭部保持水平,不會跟著騎乘者的視線上下移動。 h_頭部骨骼會跟隨生物的頭部,並且可以領先較慢的身體最多 75 度。- 正在死亡的模型保持它原本的面向。關閉了移動同步的模型則保持自己的面向。
- 靜態實體、道具與玩家偽裝不使用轉向慣性。
移動朝向
動態模型除了面向其前進方向之外,還可以隨移動而傾斜。步行者保持水平,但飛行和游泳的生物通常不應如此。寵物透過其寵物檔案的 orientation 區段設定這一點。外掛則呼叫 DynamicEntity#setTravelOrientation(TravelOrientation)。模型預設為 UPRIGHT。
| 樣式 | 傾斜 |
|---|---|
UPRIGHT | 無。模型只會面向它前進的方向 |
TOP_FIRST | 頂部領先,像水母一樣:它會傾向前進方向,巡航時側躺,俯衝時倒轉過來 |
FRONT_FIRST | 前方領先,像鳥或魚一樣:爬升和俯衝時會俯仰,轉彎時會側傾,側傾最多 45 度 |
| 設定 | 預設值 | 意義 |
|---|---|---|
startSpeed | 0.6 | 低於此每秒方塊數時,模型保持直立,因此閒置時的漂移和起伏不會使它傾倒 |
fullSpeed | 4.0 | 達到此每秒方塊數時,模型會完全對準它的移動方向。介於兩者之間時只會傾斜一部分 |
maxTilt | 180 | 傾斜的最大角度,單位為度,0 到 180 |
turnSpeed | 180 | 傾斜每秒最多能改變的度數 |
- 傾斜會繞著模型方塊的中央轉動整個模型,發生在面向與動畫之後,因此每根骨骼、定位器和騎乘點都會跟著它。
- 速度來自實體的移動,並在幾個 tick 內平滑化。單一 tick 內移動超過 2.5 個方塊視為傳送,不會使模型傾斜。
- 模型的生物游泳(即在水中且離地)時,模型可以改用另一種傾斜方式。寵物以
swimming.orientation設定(請參閱游泳),外掛則使用DynamicEntity#setSwimOrientation(TravelOrientation),其中null表示像在陸地上那樣傾斜。游泳時,傾斜會立即跟隨生物自身的速度,只受turnSpeed限制,而不是平滑後的速度,因此游泳者上升時鼻端朝上,下潛時朝下。這需要 FreeMinecraftModels 2.15.0 或更新版本。 - 模型停止時、死亡期間、有玩家騎乘期間,以及移動同步關閉期間,都會緩緩恢復直立。
- Bedrock 玩家透過匯出的傾斜骨骼看到傾斜(請參閱 Bedrock 匯出)。它以伺服器的 tick 速率逐步變化,沒有客戶端平滑。資源包第一次帶著傾斜骨骼重新產生後,請重新啟動伺服器一次,讓 Bedrock 橋接註冊新的實體屬性。
身體置中
ModeledEntity#setCenteredOnBody(true) 會把模型方塊的中央畫在實體的中央,而不是讓模型站在實體的腳上。這樣,模型遠大於其隱藏本體的飛行或游泳生物,就會繞著該本體移動、轉向和傾斜。備用名稱標籤、點擊框和碰撞箱會隨模型移動。hitbox 和名稱標籤骨骼不計入中央的計算。
預設為關閉。寵物會對 FLYING 和 AQUATIC 物種開啟它,其 centerOnBody 鍵可以覆寫這一點。Bedrock 玩家也透過同一根傾斜骨骼看到置中的模型。Bedrock 實體自己的碰撞箱仍然從它的腳部開始。
從其他系統播放動畫
| 呼叫端 | 進入點 |
|---|---|
| 外掛(Java) | ModeledEntity#playAnimation(String, boolean blend, boolean loop) / #stopCurrentAnimations() / #hasAnimation(String) |
| 道具 Lua 腳本 | context.prop:play_animation(name, blend, loop) / context.prop:stop_animation() |
| 任何 Lua 實體表 | entity.model:play_animation(name, blend, loop) / entity.model:stop_animations()(當 entity.is_modeled 為 true 時可用) |
相關介面請參閱 API 與開發者指南與 Lua:道具 API。
Lua 預設參數不同:context.prop:play_animation(name) 預設為 blend=true, loop=true,而 entity.model:play_animation(name) 預設為 false, false。如果這個區別會影響行為,請明確傳入兩個布林值。
疑難排解
我的動畫從來不會自動播放。
共用狀態機辨識小寫的 spawn、idle、idle.long、walk、swim、idle.swim、ride、idle.ride、attack 與 death,並把每個 attack. 名稱與 damaged 視為動作。移動驅動 idle/walk 切換,游泳與駕駛中的騎乘者會帶入游泳與騎乘動畫,idle.long 則等待一段安靜的 idle 時間;攻擊與死亡仍需對應的執行階段觸發。請參閱狀態動畫。除了偽裝控制器額外選擇的名稱,其他名稱都需要明確呼叫 playAnimation / play_animation。
我的模型完全沒有動作。
它很可能既沒有 spawn 也沒有 idle 動畫,因此在它行走或有東西播放動畫之前,都只會顯示靜止姿勢。請加上一個 idle。
我的模型走路時,攻擊看起來不對。 Override 關閉時,攻擊會疊加到它所設關鍵影格之每根骨骼的走路姿勢上。請在攻擊的 Blockbench 屬性中開啟 Override,讓這些骨骼採用攻擊的姿勢,或是減少設定關鍵影格的骨骼。請參閱 Override 與混合權重。
我的模型在 idle 與 walk 之間切換得太慢或太突兀。
請調整 idleWalkBlendTicks。0 表示立即切換。
我的 idle.long 播放得太頻繁、太少或從不播放。
請調整 longIdleMinSeconds 與 longIdleMaxSeconds。等待只會在模型顯示單純的 idle 時計時:移動、攻擊、自訂動畫與騎乘者都會讓它重新開始。longIdleMaxSeconds: 0 會關閉 idle.long。
我的平滑、step 或貝茲動畫在更新後動作不同了。 FreeMinecraftModels 2.15.0 及更新版本會依 Blockbench 預覽的方式播放這些關鍵影格;請參閱插值類型。請在 Blockbench 的預覽中檢查動畫:那就是 FMM 現在播放的動作。
我的大型模型轉得太慢。
轉向速度會隨大小下降;請參閱轉向慣性。請調高 turnSpeedCap 與 turnAcceleration,檢查 hitbox 骨骼是否比預期的大,或設定 weightedTurning: false。
主控台顯示 ... FreeMinecraftModels does not support these ... 或 ... has the blend weight ...。
FMM 播放該動畫時不含 Blockbench 的 Start Delay、Loop Delay 與 Anim Time Update,並且只把 Blend Weight 當成純數字讀取。請清除這些欄位,或將 Molang 運算式換成數字。
我的動畫有播放,但什麼都沒動。 請檢查動畫長度。零長度動畫依設計會被視為靜態姿勢並被靜默略過。
在 Bedrock 上,模型的每個動畫(包括待機)都停止了,但 Java 上仍正常播放。
Bedrock 會拒絕含有 ; 或賦值、卻沒有以 ; 結尾的 MoLang 程式,而一個被拒絕的關鍵影格就會讓該實體的所有動畫停止。FreeMinecraftModels 2.13.0 至 2.14.1 寫出這類程式時沒有結尾的 ;,2.14.2 則會加上它。請更新,或在那些版本上自行在 Blockbench 中以 ; 結尾關鍵影格程式。Java 的播放方式相同。
MoLang 關鍵影格停在 0 不動。
請檢查主控台中是否有 Failed to parse the keyframe expression。最後一行是賦值的程式其值為 0;請以你想要的值結尾,或使用 return。MoLang 關鍵影格下列出的四個查詢以外的查詢,都讀為 0。
旋轉是鏡像的。
請檢查 .bbmodel 中的 meta.format_version。FMM 會為格式版本 5 及以上翻轉 X/Y 旋轉的正負號;宣告某個版本卻攜帶另一版本資料的檔案,出來的結果就會是鏡像。
主控台顯示 Malformed animation timeline for model ...。
該動畫中有一條軌道無法被讀取或插值。這則警告在每個動畫只會出現一次,並指出牽涉到的骨骼或 IK 控制器;該模型的其他動畫仍會正常轉換。
我的 Blockbench 時間軸中的音效沒有作用。 音效關鍵影格不會被匯入。請改從 Lua 腳本或你自己的外掛觸發音效。粒子關鍵影格則會被匯入;若粒子沒有顯示,請參閱粒子。