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

【実録#13・UI実装】HTMLモックをGodotに「目分量ゼロ」で移植する CSSを掛け算でGDScriptに変換した話

    ---

    UIが、いつも「なんか惜しい」で止まる

    ゲームを作っていて、いちばん消耗するのがUIの作り込みです。

    デザインのモック(完成見本)はある。それを見ながらGodotで実装する。できた画面を見ると……「なんか惜しい」。フォントが少し大きい、余白が詰まりすぎ、枠線が太い、カードの角丸が浅い。一つずつ直すたびに別の場所がズレる。気づけば半日、見た目の微調整に溶けている。

    原因は分かっていました。目分量で作っているからです。

    モックの「だいたいこんな感じ」を頭の中で再現しようとすると、必ずどこかが基準からズレる。そしてズレに気づくのは、全部組んだ後。だから手戻りが大きい。

    今作っているダークファンタジーのカードゲームでも、最初は同じ沼にハマっていました。そこで作り方を変えました。「目分量ゼロ」でモックに寄せるやり方です。記憶画面・デッキ構築画面を、この方法でHTMLモックから忠実にGodot 4へ移植しました。

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

    • GodotやUnityで、デザインモック通りにUIを組みたい人

    • 「なんか惜しい」の微調整で毎回時間を溶かしている人

    • AIにUI実装を任せたいが、見た目の品質が安定しない人

    ---

    考え方:モックHTML/CSSを「設計仕様書」として使う

    最初の発想の転換はこれです。デザインモックを、見て真似る「絵」ではなく、数値が書かれた「仕様書」として扱う。

    うちのモックはHTML/CSSで作っています(ブラウザで開けば動く単一ファイル)。HTML/CSSの良いところは、見た目を構成する数値がすべてテキストで書いてあることです。

    .card{
      width:78px; height:108px;
      border-top:3px solid var(--atk);
      padding:8px 6px;
    }
    .card .cnm{ font-size:11px; text-align:center; line-height:1.25 }
    .card .cost{
      position:absolute; top:-9px; left:-7px;
      width:23px; height:23px; border-radius:50%;
    }
    

    カードの幅は78px、角の上に3pxの色ライン、内側の余白は上下8px・左右6px、名前のフォントは11px、左上に飛び出すコストの丸は直径23px——全部、数字で書いてある。

    つまりモックは「だいたいこんな感じ」ではなく、ピクセル単位の指示書です。これをそのままGodotに移せばいい。問題は、ブラウザのpxとゲーム画面のpxが、そのままでは一致しないことです。

    ---

    目分量を消す:CSS値を「掛け算」でGDScriptに変換する

    ここが今回のいちばんの肝です。

    モックのCSSは「フレーム幅880px」を前提に描いています。一方、ゲームの実画面は1920px幅で描画している。つまり、モックとゲームでは縮尺が違う。だから、CSSの数値をそのままGDScriptに書くと、すべてが小さすぎる仕上がりになります。

    解決はシンプルで、スケール係数(倍率)を一度だけ計算して、全部の数値にそれを掛けること。

    スケール係数 = ゲームの描画幅 ÷ モックのフレーム幅
    

    このデッキ画面なら、1920 ÷ 880 = 約2.18倍。別の画面(フレーム幅が違う)なら1.92倍のこともあります。画面ごとに係数を最初に1回だけ出すのがコツです。あとはCSSの数値に機械的に掛けるだけ。頭で「だいたいこのくらい」と考えないので、ズレようがありません。

    実際の変換例を出します。モックのコストバブル(カード左上に飛び出す丸)はこうでした。

    .card .cost{ width:23px; height:23px; border-radius:50%; font-size:12px; }
    

    これを係数約1.9倍で機械変換すると、GodotのGDScriptはこうなります。

    # 23px × 1.9 ≒ 44 → 枠外に出すので offset で表現
    bubble.offset_left = -18.0; bubble.offset_top    = -18.0
    bubble.offset_right =  26.0; bubble.offset_bottom =  26.0   # 幅 26-(-18)=44
    # border-radius:50%(半径≒11px)× 1.9 ≒ 22
    bsty.set_corner_radius_all(22)
    # font-size:12px × ≒2 → 24
    cl.add_theme_font_size_override("font_size", 24)
    

    width:23px が幅44pxに、border-radius:50% が角丸22に、font-size:12px がフォント24に。すべて係数を掛けただけです。「いい感じの数字」を探す作業が消えました。

    この変換ルールは表にして手元に置いています。CSSのどのプロパティがGodotのどれに対応するか(後述の有料部にチートシートとして全部載せました)。

    ちなみに行間(line-height)だけは少し計算が要ります。Godotのline_separationは「行の間に足す余白」なので、CSSのline-heightから基準分を引きます。

    line_separation = (line-height倍率 − 1.2) × フォントサイズ
    

    ここまでが「変換側」。でも、変換が正しくてもズレは出ます。だから検証が要ります。

    ---

    検証:画面をPNGに撮って、モックと突き合わせる

    ここが「PNGを撮ってAIが判断するやつ」、今回いちばん効いた仕組みです。

    人間の目で「合ってるかな?」と確認すると、見落とします。だから機械化しました。流れはこうです。

    1. 実装する(CSS→GDScript変換でUIを組む)
    2. PNGに撮る(Godotで各画面を1920×1080で描画してPNG保存するスクリプトを用意)
    3. モックと照合する(撮ったPNGとモックを並べ、色・フォント・サイズ・余白・配置のズレを洗い出す)
    4. 直す → もう一度撮る(ズレがなくなるまでループ)

    撮影は専用のスクリプトにしてあります。各シーンをオフスクリーンのSubViewport(1920×1080)に描画して、res://_shots/ にPNGを吐くだけ。コマンド一発で全画面を撮り直せます。

    var vp := SubViewport.new()
    vp.size = Vector2i(1920, 1080)
    vp.render_target_update_mode = SubViewport.UPDATE_ALWAYS
    # 各シーンを vp にぶら下げて描画 → vp.get_texture().get_image().save_png(...)
    

    そして照合〜修正のループは、専任のAIエージェントに回させています。「実装→スクショ→モック照合→修正→再スクショ」を、ズレが許容範囲に入るまで繰り返す担当。色・フォント・サイズ・余白・グラデ・配置の不一致を許さない、という1点だけに集中させると、人間がやるより粘り強く詰めてくれます。

    人間がやると「もういいか」となるところを、機械は妥協しません。「目分量ゼロ」で変換し、「妥協ゼロ」で照合する。この2段構えで、初めてモック通りの画面が安定して出るようになりました。

    ---

    Godotで踏んだ罠(ここで時間を溶かした)

    変換と照合の仕組みができても、Godot固有の落とし穴で何度も止まりました。同じところでハマる人が必ずいると思うので、実際に踏んだものを残します。

    1. Panel と PanelContainer は別物
    PanelはStyleBoxのcontent_marginを子要素に効かせてくれません。CSSのpaddingのつもりで余白を期待すると、子が枠いっぱいに広がります。余白を効かせたいならPanelContainerを使うか、VBoxContainerのoffsetで代替します。

    2. HBox内のColorRectが勝手に縦に伸びる
    横並びの中に色帯(ColorRect)を置くと、デフォルトで縦いっぱいに伸びます。size_flags_verticalをSHRINK_CENTERにして止めます。

    3. Buttonのdisabledスタイルを未設定にすると消える
    ボタンの無効時スタイル(disabled stylebox)を設定しないと、Godot標準の地味なスタイルが当たって、押せないボタンが見えなくなります。状態ごとにスタイルを明示します。

    4. グラデーションが見えない(stretch_mode)
    GradientTexture2DをKEEP_ASPECT_CENTEREDで配置すると、元テクスチャが小さいまま中央に置かれてグラデが見えません。stretch_modeはSCALEにして引き伸ばす必要があります。

    5. 数字だけ大きくしたいができない
    「コスト24・単位は小さく」のような混在フォントサイズは、1つのLabelでは作れません。HBoxContainerでLabelを分割して、それぞれにフォントサイズを当てます。

    どれも「言われれば当たり前」ですが、CSSの感覚で組むと必ず一度はぶつかります。罠の全リストは有料部にまとめました。

    ---

    まとめと次回

    📌 今回やったこと

    • UIの微調整地獄の原因は「目分量で作っていること」だと特定した

    • モックHTML/CSSを「絵」ではなく「数値の仕様書」として扱う

    • スケール係数(ゲーム幅÷モック幅)を1回出し、CSS値に機械的に掛けてGDScriptへ変換

    • 実装→PNGスクショ→モック照合→修正のループを専任AIエージェントで回す

    • Panel vs PanelContainer など、Godot固有の罠を踏み抜いた

    UIは「センスで詰める」ものだと思っていました。でも実際は、モックに数値が全部書いてある以上、掛け算と照合の作業でした。そこはAIがいちばん得意な領域です。人間は「どの画面をどう見せたいか」を決め、変換と照合は機械に任せる。これで見た目の品質が、気分や疲労に左右されなくなりました。

    📌 有料部には、すぐ流用できる3点を置いています。

    • 共通カードウィジェット card_widget.gd の全文(コストバブル・タイプカラー・StyleBox一式)

    • CSS→Godot 変換チートシート(プロパティ対応表・係数の出し方・line_separationの式)

    • 画面を一括PNG撮影する shot.gd の要点

    次回は、別のアプリを実機で初めて動かしたときに起きたこと(エミュレーターでは出なかった実機特有の問題)を書く予定です。

    ---

    ◀ 前回: 【実録#12】noteに勝手なハッシュタグが付く原因と対処法|犯人はCSSの#だった

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

    💡 ここから先は有料です(¥500)

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

    あなたへのおすすめ