Godot 標準の AnimationPlayer と組み合わせることで、SSPlayer のアニメーション再生を Godot の強力なタイムライン機能やステートマシン機能と連携させることができます。
これにより、攻撃判定（Hitbox）の同期、効果音（SE）の再生タイミング、カメラの揺らし、カットシーンの作成などが、ノーコードで視覚的に行えるようになります。
SSPlayer を AnimationPlayer で制御するためには、まず対象の .ssab に含まれるすべてのアニメーション（walk, attack など）を Godot が読み込める AnimationLibrary（_anims.res）に変換する必要があります。
- Godot エディタ上で、ファイルシステムから
.ssabファイルを選択します。 - インスペクタの下部にある 「Gen AnimLib (AnimationPlayer用ライブラリを生成)」 ボタンをクリックします。
- 成功すると、同じフォルダに
[元のファイル名]_anims.resというファイルが生成されます。
Note
生成された _anims.res の中には、元の SpriteStudio アニメーションと同じ名前の「Value Track（値トラック）」が自動生成されています。このトラックは対象ノードの current_animation（アニメーション名）と frame_no（再生ヘッド）を制御します。
生成されたライブラリを実際にシーンへ適用する手順です。
- ノードの準備シーン上に
SpriteStudioPlayer2Dノードを配置し、対象の.ssabをSsabにセットしておきます。 - AnimationPlayer の追加シーン内に
AnimationPlayerノードを追加します。 - ターゲットの指定（重要！）
追加した
AnimationPlayerノードを選択し、インスペクタ内のRoot Nodeを、手順1のSpriteStudioPlayer2Dノード に設定します。 ※自動生成されたアニメーションは「対象ノード自身のcurrent_animationとframe_noを制御する」ようになっているため、Root Node を対象ノードに向ける必要があります。 - ライブラリの読み込みエディタ下部の「アニメーション (Animation)」パネルを開き、「アニメーション」メニュー ＞ 「アニメーションを管理... (Manage Animations)」 をクリックします。出てきたウィンドウのフォルダアイコン（ライブラリをロード）を押し、生成された
_anims.resを読み込みます。
これで AnimationPlayer のドロップダウンに、SpriteStudio で作成したアニメーション一覧が表示されるようになります！
AnimationPlayer と連携できるようになると、以下のような高度な制御が可能になります。
AnimationPlayer のタイムライン上で「トラックを追加」し、Call Method Track や Audio Playback Track を追加します。「剣を振り下ろしたフレーム」に合わせて効果音を鳴らしたり、GDScript の enable_hitbox() 関数を呼び出したりするタイミングを、目で見ながら完璧に合わせることができます。
シーンに AnimationTree ノードを追加し、Anim Player に上記の AnimationPlayer を割り当てます。
Tree Root に AnimationNodeStateMachine を設定することで、Idle（待機）→ Walk（歩き）→ Attack（攻撃）といった状態遷移を、コードではなくノード同士を矢印で繋ぐUI（ステートマシン）で構築できるようになります。
カメラ (Camera2D) の位置を動かすトラックや、背景の色を変えるトラックなどを追加することで、キャラクターの動きと完全に連動したイベントシーン（カットシーン）をひとつのタイムライン上で作成できます。