
【実録#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)