メインコンテンツへスキップ
見出し画像

AI生成の歩行モーションをGodotで動かすと踏む4つの罠【実録#30・スプライト当て込み】

    idle は 276×688。歩行の正面は 320×736、背面は 310×736、左右は 314×736。

    これ、同じキャラの「全身モーション素材一式」に入っていたスプライトシートの、1コマのサイズです。全部バラバラでした。しかも walk_left.png の中身は右向きに歩いていました。

    AIでキャラのモーション素材を作るのは、もう簡単になりました。私も AI生成サービス(Ludo.ai系)で「idle+歩行4方向」のスプライトシート一式を数分で手に入れています。問題はそこからです。素材をゲームエンジンに"当て込む"工程で、地味な罠を連続で踏みました。

    この記事は、こういう人に向けて書いています。

    • AIでキャラ素材は作れたけど、Godotに載せたら表示が崩れた人

    • 複数キャラのスプライトを並べたら身長がバラバラになって困っている人

    • 「素材生成」の記事は多いのに「組み込み」の記事が少なくて詰まっている人

    私はITエンジニア9年目。副業でnoteをやりながら、個人開発でGodot 4.6製の2D見下ろしゲームを作っています。素材の生成側の話は実録#22に書いたので、今回はその続き、「生成した素材をゲームに載せる」側の実録です。

    読み終わるころには、AI生成モーション素材を組み込むときに何をチェックすべきか、身長をそろえる正規化をどう設計するかが分かる状態になります。

    前提:素材とゲーム側の構成

    章扉カード01

    📌 まず状況を整理します。

    • 素材:AI生成の全身モーション。idle(正面)+歩行4方向(front/back/left/right)のスプライトシートPNG+アトラスJSON(TexturePacker hash形式)のセット

    • 対象キャラ:2体(プレイヤーと相棒キャラ)。それぞれ別々に生成した素材

    • ゲーム側:Godot 4.6。既存の戦闘画面はキャラや地形を _draw で直接描画する構成

    従来この画面のキャラは、正面歩行1方向だけのシート1枚でした。どの方向に歩いても常にこちらを向いて歩く、昔のRPGみたいな状態です。これを「移動方向に応じて4方向に歩き分ける」ように差し替えるのが今回の作業でした。

    作業自体は1日仕事のつもりでした。実際は、素材の中身が想像と違うことによる罠を4つ踏むことになります。

    あなたなら、AI生成のスプライトシートを受け取ったら、まず何を確認しますか?

    罠①:同じキャラなのに1コマのサイズが全部違う

    章扉カード02

    最初の想定はこうでした。「全身モーション一式なんだから、1コマのサイズは全シート共通だろう。定数で FRAME_W/FRAME_H を持てばいい」。

    現実は冒頭のとおりです。相棒キャラの素材で、実際の1コマはこうでした。

    • idle:276×688(4列16枚)

    • front:320×736(5列25枚)

    • back:310×736(5列25枚)

    • left / right:314×736(6列36枚)

    サイズも、列数も、枚数も、シートごとに全部違います。 さらにコマ間隔(duration)まで違いました。idleは68ms、frontは58ms、backは43ms、left/rightは42〜45ms。もう1体のプレイヤー素材は全シート4×4の16枚でしたが、やはりコマのサイズは idle 288×666 から back 370×864 までバラバラでした。

    対処:付属JSONだけを信じる

    答えはシンプルで、素材に付属するアトラスJSONの frame.w / frame.h を、シートごとに個別に読むことです。「全シート共通の定数」という発想を捨てます。

    もうひとつ注意点があります。シートのピクセルサイズは「列数×コマ幅」で割り切れませんでした。パディングなしで詰められているためで、コマ位置の計算はJSONのx/yステップが正になります。画像サイズから逆算してコマ幅を求めるアプローチは、この素材では破綻します。

    コマ間隔も同様に、fps = 1000 / duration をシートごとに持たせました。これを共通fpsで再生すると、方向を変えるたびに歩行テンポが不自然に変わります。

    ✅ 教訓:AI生成素材の「一式」は、規格がそろっている保証がゼロ。 メタデータを1シートずつ読むデータ駆動にしておくと、この揺れを全部吸収できます。

    罠②:walk_left の中身が右向きに歩いている

    章扉カード03

    これが一番意地の悪い罠でした。

    組み込んで動かしてみると、相棒キャラだけ左に移動しているのに右を向いて歩く。コードの向き判定を3回見直しても間違っていない。まさかと思って素材のPNGを開いて拡大したら——

    walk_left.png の中身が右向き、walk_right.png の中身が左向きでした。 ファイル名と中身が逆です。

    さらにタチが悪いことに、これは相棒キャラの素材だけでした。プレイヤー素材の左右は正常。同じサービスで生成した素材なのに、片方だけ逆。つまり「このサービスは左右が逆になる」という一律のルールですらなく、素材ごとのガチャです。

    対処:ファイル名ではなく中身を目視する

    対処は原始的ですが、これしかありません。シートの頭部を拡大して、顔と(このキャラの場合)銃が向いている側を目視で確認し、その結果でコードに割り当てます。

    私のコードでは、右移動に walk_left.png のテクスチャを、左移動に walk_right.png を割り当てるという、一見バグにしか見えない対応になりました。こういう箇所には必ずコメントで理由を書いておきます。書いておかないと、未来の自分が「修正」して壊します。

    💡 左右対称のキャラなら flip_h で済む話ですが、銃を片手に持つような非対称キャラは反転が使えず、左右それぞれの素材が必要です。だからこそ、この左右逆問題が直撃します。

    罠③:2キャラ並べたら身長がまるで違う

    章扉カード04

    罠①②を越えて、2キャラとも4方向に歩くようになりました。並べてみると——身長が全然違う。 しかも同じキャラでも、歩く向きを変えるたびに微妙に背が伸び縮みします。

    原因は「フレーム高さで表示サイズを決めていた」ことです。

    コマのサイズ(フレーム)とキャラの絵の大きさは別物です。素材ごとにフレーム内の余白のとり方が違うので、フレーム高さを画面上の同じ高さに揃えても、中に描かれたキャラの身長は揃いません。736pxのフレームいっぱいにキャラが描かれたシートと、864pxのフレームに余白多めで描かれたシートでは、同じ倍率で縮めたときのキャラの大きさが変わってしまう。

    対処:「キャラ実体の高さ」で正規化する

    発想を変えます。フレームではなく、キャラの実体(不透明ピクセル部分)の高さを基準に正規化します。

    手順はこうです。

    1. 各シートについて、全コマのアルファチャンネルから不透明部分のバウンディングボックスを取る
    2. その高さ・下端Y・中心Xの中央値を事前計測して、シートのメタデータとして焼き込む
    3. 描画時は「実体の高さが目標ピクセル(例:64px)になる倍率」でフレーム全体を拡縮する
    4. アンカーは実体の下端中央を接地点に合わせる

    中央値を使うのは、歩行アニメで手足が伸びるコマに引っ張られないためです。これで、余白のとり方がバラバラな素材同士でも、画面上の身長と足元の接地ラインがピタリと揃いました。

    体格差はこの上に係数1つで付けられます。私はプレイヤー(ベテラン設定)を相棒の1.15倍にしました。

    失敗談:体格差の付け方で一往復

    実は最初、体格差を「相棒を0.88倍に縮める」方向で付けました。結果は「小さすぎて弱そう」という即却下。相棒は1.0のまま、プレイヤーを1.15倍にする方向に変えたら自然になりました。

    同じ「差」でも、どちらを基準にするかで印象が変わります。こういう調整は必ず往復が発生するので、@export 変数にしてエディタから数値をいじれるようにしておくと、修正のたびにコードを触らずに済みます。

    あなたのプロジェクトでは、キャラのサイズは何を基準に決めていますか?

    罠④:確認のたびにGodotのGUIを開いていた

    章扉カード05

    最後の罠は素材ではなく、検証の段取りです。

    この手の組み込みは「数値を1つ直しては表示を確認」の繰り返しになります。毎回GodotエディタのGUIを開いてシーンを実行していたら、それだけで日が暮れます。私は途中からGUIを一度も開かない検証3点セットに切り替えました。

    1. 素材のインポート:godot --headless --import で .import と .ctex を生成。新しいPNGを置いたらこれ1発
    2. スクリプト全体の検証:godot --headless --editor --quit-after 3。プロジェクト全体をロードしてコンパイルエラーを検出
    3. 実画面の確認:godot scenes/battle.tscn --autostart --write-movie out/f.png --fixed-fps 60 --quit-after 150 でPNG連番として実プレイ画面を録画。ffmpeg不要で、150フレーム分の静止画が残る

    とくに3つ目が効きました。歩行アニメの確認は静止画1枚では無理ですが、PNG連番なら「12フレーム目で足が滑っている」まで特定できます。

    ⚠️ 1つだけ注意。スクリプト検証に --check-only --script 単体ファイル を使うと、autoload(シングルトン)が未解決になり、実際には正しいコードが誤エラーになります。プロジェクトごとロードする --editor --quit-after 方式が正解でした。

    仕組みの全体像(ここまでが無料で全部です)

    章扉カード06

    まとめると、今回の組み込みはこういう構造になりました。

    • AnimatedSprite2D は使わない。既存の _draw 描画に draw_texture_rect_region で統合(理由は有料部で詳述)

    • 各シートの諸元(テクスチャ・コマ幅高・列数・枚数・fps・実体高さ・実体下端・実体中心X)を9要素のデータとして焼き込み、シート選択関数が返す

    • 共通描画関数が「実体高さ→目標px」の正規化と接地アンカーを一手に引き受ける

    • 方向は移動速度の支配軸で front/back/left/right を選択。左右は別素材なので flip 不要

    考え方はこれで全部です。「理解」に必要な情報は上に全部書きました。 ここから先は「自分のプロジェクトで再現する」ための実データとコードです。

    • 1. 設計判断:AnimatedSprite2D を捨てた理由と、捨てなくていい人の条件

    • 2. データ設計:9要素配列に何をどう焼き込むか

    • 3. 実測値の全公開:2キャラ×全シートの実体寸法テーブル(そのまま検算に使えます)

    • 4. コード一式:共通描画関数/方向判定の雛形/実体寸法の事前計測スクリプト(Python)

    • 5. カスタマイズの勘所3点

    なお「斜め見下ろし視点で壁を立ち上げる」話は本記事から切り出して実録#29に書いています。視点まわりで詰まっている人はそちらをどうぞ。

    私はこの当て込みで、左右逆の原因特定・身長正規化の設計・検証環境の整備に丸1日を溶かしました。有料部分には、その試行錯誤を飛ばして自分のGodotプロジェクトに移植できるコード一式と、素材検品のチェックリスト、計測済みの実数値を全部置いておきます。

    ◀ 前回: 2Dトップダウンを「斜め見下ろし」に変える最小実装【実録#29・疑似アイソメ】

    📚 シリーズ全話はまとめマガジンへ

    https://note.com/lazy_engineer/m/m03a726b1673c

    💡 ここから先は有料です(¥500)
    AI生成スプライトの検品〜正規化描画〜ヘッドレス検証までを、コピペ移植できる形で全部持ち帰れます。

     
     
    ITエンジニア9年目 / AI自動化 / note副業実録 AIを使えば、もっと楽できると気づいた。 noteで月10万円を目指す過程を、売上スクショ付きで全部公開します。 うまくいかない月も、ちゃんと出します。 「重い副業はしたくない」エンジニア・IT系の人に届けたい。

    あなたへのおすすめ