FreeMinecraftModelsのアニメーション
FreeMinecraftModels は .bbmodel と .fmmodel からアニメーションをインポートします。このページでは予約名、アニメーションのブレンド、フレームのタイミング、補間、ループモード、インバースキネマティクス(IK)、モデルの旋回を説明します。
ボーンの命名規則やインポート規約の残りの部分については、モデル作成の注意事項を参照してください。
ステートアニメーション
FreeMinecraftModelsは、以下の6つの小文字のアニメーション名と、後述する遊泳と騎乗の4つの名前を、自動的なランタイムステートに紐付けます。モデル内のそれ以外のものはすべてカスタムアニメーションです。
| アニメーション名 | ループ | 再生タイミング |
|---|---|---|
spawn | しない | モデル生成時に1回。終了すると、エンティティが移動中ならwalk、そうでなければidleへ切り替わります |
idle | する | エンティティに水平方向の速度がない間。X または Z の速度が0でなくなるとwalkへクロスフェードします |
idle.long | しない | モデルがidleを表示し、ほかに何も再生されない状態が、longIdleMinSecondsからlongIdleMaxSecondsまでのランダムな秒数(デフォルトは15〜30秒)続いたあとに1回。その後モデルはidleへクロスフェードで戻り、待機がやり直されます |
walk | する | エンティティの X または Z の速度が0でない間。両方が0になるとidleへクロスフェードします |
attack | しない | トリガーされたとき。idleまたはwalkの上に重ねて1回再生され、その後終了します |
death | しない | removeWithDeathAnimation()が呼ばれたとき。現在のポーズからフェードインします。終了するとモデルは20ティックかけて縮小して消え、削除されます |
FMM が自分でattackをトリガーするのは Evoker だけで、Evoker が召喚した牙がその2ブロック以内に現れたときです。ほかのプラグインは API を通じて攻撃をトリガーします。EliteMobs はattack.meleeとattack.rangedを再生します。attack.で始まる名前はすべて攻撃であり、attackと同じように再生されます。
idle.longは、Blockbenchのループ設定にかかわらず1回だけ再生されます。移動、攻撃やその他のアクション、ベースレイヤー上のカスタムアニメーション、プレイヤーがモブを乗り物として操縦することは、いずれも待機をやり直させ、同じことが再生中のidle.longも途中で打ち切ります。idle.longのないモデルは待機しません。idle.longにはFreeMinecraftModels 2.15.0以降が必要で、それより前のバージョンはこれをカスタムアニメーションとして扱います。
さらに4つのベースアニメーションは、モデルがそれらを持っていれば、モブが泳いでいる間やプレイヤーが乗っている間にwalkとidleの代わりに再生されます:
- 騎乗。 騎乗中のペットや
/fmm mountの乗り物のように、鞍を付けた馬の上のモデルをプレイヤーが操縦している間、移動中はwalkの代わりにrideを、立ち止まっている間はidleの代わりにidle.rideを再生します。ペットファイルではriding.animationとriding.idleAnimationで別のアニメーションを指定できます。騎乗を参照してください。プラグインはgetAnimationComponent().setRiddenAnimation(name)とsetRiddenIdleAnimation(name)を呼び、nullを渡すとそれぞれを無効にします。rideのないモデルは乗り手を乗せたまま歩き、idle.rideのないモデルはidleを再生します。 - 遊泳。 モブが泳いでいる、つまり水中にいて地面から離れているモデルは、移動中は
walkの代わりにswimを、静止している間はidleの代わりにidle.swimを再生します。ペットファイルではswimming.animationとswimming.idleAnimationで別のアニメーションを指定できます。遊泳を参照してください。プラグインはgetAnimationComponent().setSwimAnimation(name)とsetIdleSwimAnimation(name)を呼び、nullを渡すとそれぞれを無効にします。swimのないモデルは水中で歩き、idle.swimのないモデルは静止している間idleを再生します。プレイヤーが操縦する乗り物は、水中でも騎乗アニメーションを再生します。
4つともFreeMinecraftModels 2.15.0以降が必要です。
命名
アニメーション名は小文字です。ドットは一般的な名前とより具体的な名前を区切り、アンダースコアは1つの部分の中で単語をつなぎます。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があればそれ、なければidleです。どちらも持たないモデルは、歩き始めるか何かのアニメーションが再生されるまで、静止ポーズのままです。 - モデル内に存在するアニメーションだけが使われます。
walkはあるがidleがないモデルは、動きが止まった後も歩き続けます。 - idle/walk の切り替えは、基となるエンティティの水平速度を読み取ります。垂直移動だけでは歩行を開始しません。静的エンティティとプレイヤーディスガイズには、この用途の基となるエンティティがなく、静止したプロップにも水平移動はありません。追加のアニメーションはスクリプト、API、FMM のディスガイズコントローラーで制御します。
jumpステートはありません通常のモデル化されたエンティティには jump ステートがありません。jumpという名前のアニメーションは、ほかのカスタムアニメーションと同じように振る舞い、名前を指定して再生する必要があります。プレイヤーディスガイズは例外で、別のコントローラーがプレイヤーのジャンプ時にjumpを再生します。
アニメーションのブレンド
FMM は、モデルのアニメーションを2つのレイヤーで再生し、毎ティック1つのポーズに混ぜ合わせます。Java でも Bedrock でも同じです。
| レイヤー | 再生されるもの |
|---|---|
| ベース | spawn、idle、idle.long、walk、騎乗と遊泳のアニメーション、death、およびblendをfalseにして再生したカスタムアニメーション(ポーズ全体を置き換えます) |
| アクション | attackと、attack.meleeやattack.rangedなどのすべてのattack.の名前、damaged、およびblendをtrueにして再生したカスタムアニメーション。アクションはベースレイヤーの上に重ねて再生されるため、モデルは歩きながら攻撃できます |
ベースのアニメーションがキーを打っていないボーンは、静止ポーズに戻ります。アクションがキーを打っていないボーンは、ベースのポーズを維持します。
フェード
| 切り替え | フェード |
|---|---|
idle、idle.long、walk、騎乗と遊泳のアニメーションの間 | idleWalkBlendTicks(デフォルトは5ティック)かけてクロスフェードします。フェード中は両方のアニメーションが再生され続けます |
任意のアニメーションからdeathへ | 前のティックにモデルが見せていたポーズ(アクションも含む)から、deathBlendTicks(デフォルトは4ティック)かけてフェードします |
| それ以外のすべての切り替え | 即座に切り替わります |
フェードは一定の速さではなく、イーズインとイーズアウトで進みます。フェードの最中に新しい idle/walk の切り替えが割り込むと、次のフェードはモデルが見せていたポーズから始まります。アクションはフェードなしで開始・終了します。
オーバーライドとブレンドウェイト
FMM は、Blockbench の各アニメーションのプロパティから2つの設定を読み取ります。
| 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はすべてに割り込みます。- 新しいアクションは再生中のアクションを置き換えます。そのため、2回目の攻撃は攻撃をやり直し、
blendをtrueにして再生したカスタムアニメーションは、再生中の攻撃を置き換えます。 blendをfalseにして再生したカスタムアニメーションは、現在のアクションを終了させます。- カスタムアニメーションがベースレイヤーを占有している間も、FMM は裏で idle と walk の追跡を続けます。カスタムアニメーションがベースレイヤーを占有すると、進行中の
spawnやidle.longは終了します。1回だけ再生するカスタムアニメーションが終了すると、モデルは移動状態に合うidleまたはwalkへ即座に切り替わります。idleまたはwalkの明示的な要求は、ループするカスタムアニメーションをただちに終了させ、1回だけ再生するカスタムアニメーションの場合は、その終了後に表示されます。 - 1回だけ再生するアクションは、最後のフレームの後に終了します。ベースレイヤーに表示するものがない場合、たとえば
spawnもidleのアニメーションもないプロップでは、アクションは代わりに最後のフレームを保持するため、この方法で開けたドアは開いたままになります。ベースレイヤーで1回だけ再生するカスタムアニメーションも、戻り先のidleやwalkがないモデルでは最後のフレームを保持します。
プレイヤーディスガイズは別のセットを使用します
プレイヤーディスガイズは、同じ再生エンジンにアニメーションを要求するティック単位のコントローラーを追加します。5つの予約名は 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は、Blockbench の Override とブレンドウェイトを適用して、idleまたはwalkの上のアクションレイヤーで再生します。falseはベースレイヤーを与えるため、ポーズ全体を置き換え、現在のアクションを終了させます。アニメーションのブレンドを参照してください。 - 要求はキューに入り、モデルの次のティックの開始時に順番に適用されます。すべての要求が実行され、後の要求がキュー内の前の要求を取り消すことはありません。
- **
loop**はカスタムアニメーションとdamagedに適用されます。組み込みの名前はblendとloopの両方を無視します。idleとwalkは常にループし、spawn、death、攻撃は1回だけ再生されます。名前を指定して再生したidle.longは、ほかと同じカスタムアニメーションです。 - 組み込みの名前と攻撃の名前は、大文字と小文字を区別せずに一致します。それ以外の名前では、FMM はまず正確な名前を探し、次にその小文字形、次に名前が変わったものの古い綴り、最後にドット付きの名前の一般的な部分を探します(命名を参照)。
hasAnimationはplayAnimationが再生するのと同じ名前を見つけます。組み込みステートが動作するには、モデルに小文字の名前が含まれている必要があります。 damagedは、blendの指定にかかわらず、常にアクションレイヤーで再生されます。playAnimationは、モデルにない名前と、deathが要求された後のすべての要求に対してfalseを返します。trueは要求がキューに入ったことを意味し、フレームが再生されたことは意味しません。実行中のカスタムアニメーションによって、攻撃が破棄されることもあります。stopCurrentAnimations()は、すべてのカスタムアニメーションとアクションを終了し、モデルをidleに切り替えます。idleがない場合は静止ポーズに切り替えます。- 死亡は終端です。
deathが要求されると、新しい再生要求はfalseを返し、キュー内の要求は無視され、stopCurrentAnimations()は何も行いません。
タイミングと再生時間
- Blockbench はアニメーションの長さを秒で保存します。FMM は
ceil(seconds x 20)で変換するため、再生時間は常に整数ティックとなり、短いアニメーションも切り上げられます。 - 数値だけでキーを打ったチャンネルは、インポート時にティックごとのフラットなフレーム配列にベイクされ、再生ではティックごとに1フレームを読み取ります。MoLangキーフレームを含むチャンネルは、代わりにエンティティごとにティックごとにサンプリングされます。MoLangキーフレームを参照してください。
- 再生中の各アニメーションは独自のティックカウンターを持つため、ベースレイヤー、アクションレイヤー、フェード中のアニメーションはそれぞれ独立して進みます。ループするアニメーションは
counter % durationでインデックスを取り、ループしないものは最終フレームでクランプされます。 - キーフレームの時刻は小数のティック位置を保持します(
20 x time、丸めなし)。0.37秒のキーフレームもティック間の補間に寄与します。フレームは整数ティックの0からduration - 1でサンプリングするため、宣言された終了時刻ちょうどのキーフレームは補間に影響しても、それ自体はサンプリングされません。表示フレームで最終ポーズに到達させる必要がある場合は、この境界より前に配置してください。 - 同じチャンネル上の2つのキーフレームがまったく同じ時刻に位置する場合、ファイル順で後のものが優先されます。
- 時刻が有限でないキーフレームはそのトラックを中断させ、アニメーションごとに1回だけ
Malformed animation timeline for model ...という警告を出しますが、モデルの他のアニメーションは変換され続けます。
長さ0のアニメーションは有効です
長さが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の4種類の補間タイプのいずれかを持ちます。このセット以外のものは解析に失敗し、不正なタイムラインとして報告されます。
FMMは、2つのキーフレームの間の区間を、両方のキーフレームのタイプから、Blockbenchのプレビューと同じ方法で、次の順に判定して再生します:
stepキーフレームは、次のキーフレームまでその値を保ちます。linearキーフレームの次がlinearまたはstepのキーフレームなら、直線的にブレンドします。- どちらかのキーフレームが
catmullromの場合、区間は、区間の前のキーフレーム、区間の2つのキーフレーム、区間の後のキーフレームを通るCatmull-Romカーブに従うため、動きは各キーフレームで止まらずに流れます。隣のキーフレームがない場合は、区間自身の端点を繰り返します。Blockbenchのループモードがloopで、チャンネルに3つ以上のキーフレームがあるアニメーションでは、最後のキーフレームを再び最初のキーフレームとして扱い、カーブはループをまたいで続きます。 - それ以外の場合は一方が
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、Bezierのキーフレームを持つモデルは、更新後に動きが変わり、作者がBlockbenchで見たものに近づきます。
アニメーションされるチャンネル
ボーンごとに3つのチャンネル、回転、位置、スケールがベイクされます。オーサリング時に重要となる注意点:
- 位置の値は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キーフレームを参照してください。 - 2つのデータ値を持つキーフレーム、つまりBlockbenchのpreとpostの個別値は、最初の値で到達し、2番目の値から出ていきます。補間タイプを参照してください。
MoLangキーフレーム
math.sin(query.anim_time * 360) * 10のようにMoLang式で記述されたキーフレームの値は、アニメーションの再生中にエンティティごとに評価されます。
- MoLangキーフレームを1つ以上持つチャンネル(1つのボーンの回転、位置、スケール、またはIKコントローラーの位置)はベイクされません。各エンティティが毎ティックそれをサンプリングし、補間と単位変換はベイク済みのチャンネルと同じです。そのチャンネル上の数値キーフレームは値を保ちます。
- 次のクエリが使えます。短い
q.プレフィックスでも使えます。
| クエリ | 値 |
|---|---|
query.anim_time | このアニメーションの開始からの秒数。ループするアニメーションはループのたびに0から始まり直します |
query.life_time | モデルが作成されてからの秒数 |
query.modified_distance_moved | エンティティが水平方向に移動したブロック数 |
query.is_moving | エンティティが水平方向に移動している間は1、それ以外は0 |
- それ以外のクエリと未知の変数は
0として読み取られます。v.変数は、そのエンティティ上で評価の合間も値を保持し、temp.(t.)の値は1つの式の間だけ続きます。 - 式はパーティクルのMoLangと同じ演算子と数学関数を使います。
returnのない複数の文からなるプログラムは、Blockbenchのプレビューと同様に、最後の行の値になります。v.a = 10; v.b = v.a * 3; v.b + 5は35として再生されます。最後の行が代入の場合、値は0です。パーティクルのMoLangはBedrockの規則を保ち、returnのないプログラムの値は0です。- FMMが解析できない式は、読み込み時に1回、
Failed to parse the keyframe expression '<expression>' in animation <animation> for model <model>: <reason>. That value plays as 0.をログに出力します。 - 有限の数値でない結果は
0として再生されます。 - 滑らかな区間は、カーブの形を決めるために両隣のキーフレームも評価します。それらの評価では、代入した変数は一切保持されないため、キーフレームの代入が反映されるのは、そのキーフレームが始点または終点となる区間のティックだけです。
Bedrockプレイヤーはこれらのチャンネルを自分のクライアントで評価します。Bedrockエクスポートは、そのチャンネルのキーフレームを記述されたとおりに書き出します。Bedrockエクスポートを参照してください。
アニメーションされないもの
hitboxボーン。これを対象とするアニメーショントラックは完全にスキップされます。- Blockbenchのエフェクトトラックにあるサウンドとタイムラインインストラクションのキーフレーム。FMMがエフェクトトラックからインポートするのはパーティクルのキーフレームだけです。パーティクルを参照してください。サウンドは代わりにLuaスクリプトや独自のプラグインから再生してください。
- 名前で解決できなかったボーン。存在しないボーンを指すトラックは
Failed to get bone <name> from model <model>!をログに出力してスキップされます。
インバースキネマティクス(IK)
Blockbenchのnullオブジェクトは、IKコントローラーとして機能します。FMMはランタイムでチェーンをFABRIK(Forward And Backward Reaching Inverse Kinematics)により解き、最大10回の反復と0.001の許容誤差で打ち切ります。
構成要素の関係:
ik_source(ルートボーン)とik_target(末端ボーンまたはロケーター)を持つ null オブジェクトがチェーンを定義します。階層に加え、兄弟ボーンや子孫方向も検索します。ルート階層の兄弟ターゲットでは、ソースボーンだけのチェーンになります。- IK を制御するのは null オブジェクトの位置キーフレームだけです。フレームごとのオフセットを、ターゲットのボーンまたはロケーターの静止位置に加算します。ソルバーは保存されたコントローラーの静止位置を基準にしません。回転とスケールは IK を制御しません。
- 毎ティック、各チェーンは、それを制御している再生中のアニメーションのうち最上位のものに従います。順に、アクション、ベースのアニメーション、フェードアウト中のアニメーションです。そのアニメーションのゴールオフセットを適用してチェーンを解きます。再生中のどのアニメーションにも制御されていないチェーンはクリアされるため、IK を使わないアニメーションに IK のポーズが持ち越されることはありません。
lock_ik_target_rotationは読み取って保存しますが、現在のソルバーでは適用しません。
解決できなかったチェーンは、名前付きのコンソール警告とともにスキップされます。正確なメッセージとオーサリング上の制約については、モデル作成の注意事項を参照してください。
Bedrockエクスポート
変換された各モデルは、生成されるバンドル内のanimations/<model_id>.animation.jsonにBedrock用アニメーションファイルも書き出します:
- アニメーション識別子は
animation.fmm.<model_id>.a_<hex>です。<hex>はアニメーション名のUTF-8バイト列を16進数で表したものです。そのため、Bedrockで使えない文字だけが異なる2つの名前にも、別々の識別子が割り当てられます。 animation_lengthは秒単位の再生時間で、最小値は0.05です。これにより1ティックのアニメーションも有効なままになります。- ループモードはループモードの表の通りにマッピングされます。
- アニメーションがまったくないモデルにも、Bedrockのエンティティ定義が有効であり続けるよう、何もしない
idleエントリが1つ生成されます。 - ジオメトリからは
hitbox、生成されたfmm_nametag_bone_*ネームタグボーン、m_マウントポイントを除外し、作成者のtag_アンカーは残します。アニメーション出力は同じ表示ボーンのフィルターを適用せずにベイク済みトラックを書き出します。除外されたマウントボーンを動かしても、表示ジオメトリが現れるわけではありません。 - Bedrock のアニメーション出力は、ベイク済みのボーンの回転・位置・スケールを使います。ランタイム IK ソルバーの回転はトラックに焼き込まれないため、IK に依存するモデルは Bedrock でも個別に確認してください。
- MoLangキーフレームを持つボーンのチャンネルは、式も数値も記述されたとおりに書き出され、Bedrockクライアントが評価します。複数の文からなるプログラムは、BedrockでもJavaと同じ値が再生されるよう、最後の行の前に
returnを付けて書き出されます。2.14.2からは、Bedrockが要求する終端の;も付きます。そのキーフレームは、記述された補間に関係なく、Bedrockでは線形にブレンドされ、pre値だけが書き出されます。format_versionが5以降のモデルでは、X・Y回転とX位置は符号を反転して出力されます。数値はその負の値、プログラムは返す値を反転したものになるため、BedrockでもJavaと同じポーズが再生されます。 - エクスポートされたモデルは、キューブの中央を支点とする
freeminecraftmodels_leanボーンから吊り下げられます。これにより、Bedrockプレイヤーにも移動方向への傾きとボディへの中心合わせが、4つの整数のエンティティプロパティfreeminecraftmodels:lean_x、lean_y、lean_z、body_offsetを通じて表示されます。saddleまたはfishボーンを隠すために生成されたアニメーションも数えて、アニメーションが672を超えるモデルには、これらのプロパティを置く余地がなく、傾きボーンは付かず、Bedrockでは足で直立したままになります。 - アニメーションごとに1つのアニメーションコントローラーが生成され、エンティティプロパティによって切り替えられます。これがFMMがBedrockクライアント上で特定のアニメーションを再生する仕組みです。FMM は、Java のレイヤーに合わせて、ベースのアニメーションとアクションの両方で切り替えます。
saddleという名前のボーンを(大文字小文字を問わず)持つモデルには、自身のアニメーションの後に、アニメーションfreeminecraftmodels_hide_saddleがもう1つ追加されます。fishという名前のボーンを持つモデルには、その後にfreeminecraftmodels_hide_fishが追加されます。それぞれ、そのボーンとその下のボーンを大きさゼロに縮め、サーバーがそのボーンを隠している間だけ再生されます。乗れるペットの鞍は鞍を付けられるまで、釣りをするペットの魚は獲物を持ち帰るまで隠されます。FreeMinecraftModels 2.15.0以降が必要です。- Override がオンのアニメーションは
"override_previous_animation": true付きで書き出され、1以外のブレンドウェイトは"blend_weight"として書き出されます。ベースのアニメーションであるidle、walk、spawn、deathはエンティティのアニメーションリストの先頭に置かれるため、アクションはそれらの上に重なります。 - コントローラーの
blend_transitionには Java のフェード時間が反映されます。idleとwalkはidleWalkBlendTicksかけてフェードイン・フェードアウトし、deathはdeathBlendTicksかけてフェードインし、idle.longと騎乗および遊泳のアニメーションも含め、それ以外のアニメーションはすべて即座に切り替わります。この時間はパックの生成時に書き込まれるため、設定を変更した場合、Bedrock プレイヤーに反映されるのはパックが再生成された後です。 - パーティクルのキーフレームはアニメーションの
particle_effectsタイムラインになるため、Bedrockクライアントはそれをネイティブに再生します。パーティクルを参照してください。
これらにはFreeMinecraftModels 2.16.0が必要です。
- 生成された非表示アニメーションも数えたうえで、傾きボーンが付かなくなる境界が672ではなくアニメーション532超になります。
- キーフレームのX・Y回転とX位置は、BedrockでもJavaと同じように再生されます。2.8.0から2.15.0では、すべてのモデルのベイクされたトラックと、
format_versionが5以降のモデルのMoLangチャンネルで、これらの軸が反転して出力されていました。0を中心に均等に振れる動きは同じに見えましたが、片側に保たれたポーズは、Bedrockでは逆に曲がって見えました(たとえば肘が後ろに曲がるなど)。パックが再生成され、クライアントが新しいパックを取得すると、Bedrockのプレイヤーにも修正が反映されます。
バンドルがディスク上のどこに配置されるかについては、リソースパック出力を参照してください。
旋回の慣性
weightedTurningがオン(デフォルト)の場合、モブ上のモデルは、モブの向きに瞬時に合わせるのではなく、慣性をつけて向きを追います。旋回速度は毎ティック最大で加速度の分だけ変化し、速度の上限を超えません。また、新しい向きにちょうど止まれるよう、早めに減速します。モブ自体はこれまでどおり向きを変えて歩きます。モデルのボーン、ヒットボックス、ロケーター、Bedrock の表示は、すべてモデルの向きを使います。
どちらの上限もモデルのサイズに依存します。
- サイズは、
hitboxボーンの体積(幅 x 奥行き x 高さ、ブロック単位)の立方根に、モブのscale属性を掛けたものです。hitboxボーンがないモデルは、代わりにモブ自身のバウンディングボックスの立方根を使います。0.25未満のサイズは0.25として扱われます - 最高速度は、
turnSpeedCapをサイズの平方根で割ったもので、1ティックあたり90度を超えることはありません - 加速度は、
turnAccelerationをサイズで割ったものです
デフォルトのturnSpeedCap: 30とturnAcceleration: 6では、次のようになります。
| ヒットボックス | サイズ | 最高速度(度/ティック) | 加速度(度/ティック、毎ティック) |
|---|---|---|---|
| 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 | 進行方向に完全に揃う毎秒ブロック数。2つの値の間では部分的に傾きます |
maxTilt | 180 | 傾きの最大値(度)。0から180 |
turnSpeed | 180 | 傾きが変化できる毎秒あたりの度数 |
- 傾きは、向きとアニメーションの適用後に、キューブの中央を軸にモデル全体を回転させるため、すべてのボーン、ロケーター、マウントポイントがそれに追従します。
- 速度はエンティティの移動から求められ、数ティックにわたって平滑化されます。1ティックで2.5ブロックを超える移動はテレポートとして扱われ、モデルを傾けません。
- モブが泳いでいる、つまり水中にいて地面から離れている間は、モデルが別の傾き方をすることもあります。ペットは
swimming.orientationで設定し(遊泳を参照)、プラグインはDynamicEntity#setSwimOrientation(TravelOrientation)で設定します。nullは陸上と同じ傾き方です。泳いでいる間、傾きは平滑化された速度ではなくモブ自身の速度にただちに従い、turnSpeedでのみ抑えられるため、泳ぐ生き物の鼻先は、上昇中は上を、下降中は下を向きます。FreeMinecraftModels 2.15.0以降が必要です。 - モデルは、停止したとき、死亡中、プレイヤーが乗っている間、移動の同期がオフの間、緩やかに直立へ戻ります。
- Bedrockプレイヤーには、エクスポートされた傾きボーンを通じて傾きが表示されます(Bedrockエクスポートを参照)。クライアント側の平滑化はなく、サーバーのティックレートで段階的に変化します。傾きボーン付きでパックが最初に再生成された後は、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 をオンにして、それらのボーンが攻撃のポーズを取るようにするか、キーを打つボーンを減らしてください。オーバーライドとブレンドウェイトを参照してください。
モデルの idle と walk の切り替わりが遅すぎる、または急すぎます。
idleWalkBlendTicksを変更してください。0なら即座に切り替わります。
idle.longの再生が多すぎる、少なすぎる、またはまったく再生されません。
longIdleMinSecondsとlongIdleMaxSecondsを変更してください。待機が数えられるのは、モデルが通常のidleを表示している間だけです。移動、攻撃、カスタムアニメーション、騎乗者は待機をやり直させます。longIdleMaxSeconds: 0でidle.longはオフになります。
滑らか、step、Bezierのアニメーションが、更新後に違う動きをします。 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 式を数値に置き換えてください。
アニメーションは再生されるのに何も動きません。 アニメーションの長さを確認してください。長さ0のアニメーションは静止ポーズとして扱われ、仕様として警告なしにスキップされます。
Bedrockでは、Javaでは再生されるのに、idleを含むモデルのすべてのアニメーションが止まります。
Bedrockは、;や代入を含むMoLangプログラムが;で終わっていないと拒否し、拒否されたキーフレームが1つあるだけでそのエンティティのすべてのアニメーションが止まります。FreeMinecraftModels 2.13.0から2.14.1は、そのようなプログラムを終端の;なしで書き出し、2.14.2ではこれが付きます。更新するか、それらのバージョンではBlockbenchでキーフレームのプログラムを自分で;で終えてください。Javaでも同じように再生されます。
MoLangキーフレームが0のまま動きません。
コンソールでFailed to parse the keyframe expressionを確認してください。最後の行が代入のプログラムの値は0になります。望む値、またはreturnで終わらせてください。MoLangキーフレームに挙げた4つ以外のクエリは0として読み取られます。
回転が反転しています。
.bbmodel内のmeta.format_versionを確認してください。FMMはフォーマットバージョン5以降でX・Y回転の符号を反転します。あるバージョンを宣言しながら別バージョンの形式のデータを持つファイルは、反転した状態で出力されます。
コンソールにMalformed animation timeline for model ...と表示されます。
そのアニメーション内の1つのトラックが読み取りまたは補間できませんでした。警告はアニメーションごとに1回発生し、関係するボーンまたはIKコントローラー名を示します。モデルの他のアニメーションは引き続き変換されます。
Blockbenchのタイムラインに置いたサウンドが何も起きません。 サウンドのキーフレームはインポートされません。サウンドはLuaスクリプトまたは独自のプラグインからトリガーしてください。パーティクルのキーフレームはインポートされます。表示されない場合はパーティクルを参照してください。