Godot用スプライトシートの作り方
Godot 4でスプライトシートを作成、インポート、アニメーション化するために必要な流れをまとめています。XML TextureAtlas付きのスプライトシートを生成し、AnimatedSprite2D、SpriteFrames、AnimationPlayerに接続できます。
画像をここにドロップ（PNG, JPG, WebP, SVG）
またはクリックして参照
Godot のパイプライン
Godot 4でのスプライトシート
Godotにはスプライトシートを扱う複数の方法があります。プロジェクトに最適なアプローチを選びましょう。
AnimatedSprite2D + SpriteFrames
最もシンプルなアプローチ。SpriteFramesリソースを作成し、スプライトシートをインポートして、フレーム範囲でアニメーションを定義します。シンプルなキャラクターアニメーションやエフェクトに最適。
Sprite2D + AnimationPlayer
より強力で柔軟。Sprite2DのRegionを有効にしてスプライトシートの領域を参照します。AnimationPlayerがregion_rectプロパティをキーフレーム化。可変タイミングの複雑なアニメーションに最適。
AtlasTextureリソース
スプライトシートの領域を参照するAtlasTextureリソースを作成します。AnimatedSprite2Dと組み合わせるか、コードで直接使用。GodotがUVマッピングを自動処理します。
XML TextureAtlasインポート
当ツールからPNG + XMLファイルをインポート。GodotはXML TextureAtlasフォーマットを解析できます。各SubTextureがコードやエディタで参照できる名前付き領域になります。
ステップバイステップ：Godot用スプライトシートの作成とインポート
スプライトシートの作成からGodot 4でのアニメーション化までの完全なワークフロー。
ステップ1：スプライトシートを作成
Sprite Sheet Makerにフレーム画像をアップロード。Gridレイアウトを選択し、適切なパディング（1〜2px）を設定、エクスポートフォーマットとしてXML TextureAtlasを選択。ZIPをダウンロードします。
ステップ2：Godotにインポート
PNGとXMLファイルをGodotプロジェクトのres://フォルダに配置。GodotがPNGをTexture2Dとして自動インポートします。XML座標を使ってスプライト領域を参照できます。
ステップ3：AnimatedSprite2Dの設定
AnimatedSprite2Dノードを追加。新しいSpriteFramesリソースを作成。手動でリージョンを設定するか、XMLを読み取るインポートプラグインを使ってスプライトシートからフレームを追加します。
ステップ4：アニメーションを作成
アニメーション名を定義（idle、walk、attack）。アニメーションごとのフレームを設定し、FPSを調整、ループの有効/無効を切り替え。Godotエディタのプレビューボタンで直接テストできます。
Godot ノード選択の目安
仕様と制限
マーケティング文句ではなく、実際の事実。
トラブルシューティング：AnimatedSprite2D が再生されない
Godot にスプライトシートを読み込めてもアニメーションが動かない場合、まず PNG ではなく SpriteFrames リソースを確認します。多くの原因は、フレーム未登録、アニメーション名の不一致、速度 0、または非ループアニメーションを繰り返す前提にあります。
フレームが SpriteFrames に入っている
ノードにテクスチャを置くだけでは不十分です。SpriteFrames リソースを作成または開き、各アニメーションフレームを追加します。
グリッド数がシートと一致している
シートから追加する場合、横と縦のフレーム数を実際のグリッドに合わせます。数が違うと空白や重複フレームができます。
アニメーション名がコードと一致している
play("run") は SpriteFrames に run という名前のアニメーションがある場合だけ動きます。大文字小文字も一致させます。
Autoplay または play() を使っている
フレームが存在しても自動では開始しません。Inspector の Autoplay を設定するか、コードで $AnimatedSprite2D.play("idle") を呼びます。
速度とフレーム数が有効
speed_scale が 0 ではないこと、アニメーション FPS が 0 より大きいこと、2 フレーム以上あることを確認します。
ループ設定が期待と一致している
非ループアニメーションは最後のフレームで止まります。idle や walk を繰り返すなら Loop を有効にします。
Godotスプライトシートのよくある質問
Godot対応スプライトシートを作成
Godot 4向けのXML TextureAtlas付きスプライトシートを生成し、必要に応じて総合ガイドや関連ツールも参照できます。