Communityコーディング&開発github.com

フォトリアル3Dゲーム

コードからプレイ可能なフォトリアリスティックな3Dゲームを構築するための手順書。WebGL、WebGPU、Three.js、Unity、Unrealなど、任意のエンジンと低コストモデルに対応し、実行可能な検証ハーネスによって品質を保証します。

フォトリアル3Dゲーム とは?

このスキルは、コード生成された3Dシーンをプレイ可能なフォトリアリスティックなゲームに仕上げるための、エンジンに依存しない体系的な手順です。1.4MBのシングルファイルシューター「Saltline」の制作手法を、低コストモデル(DeepSeek V4.1 Flashなど)でも再現できるよう、検証可能なゲート(検査項目)としてパッケージ化しています。シューターに限らず、運搬、修理、ステルス、探索、運転、経営など、あらゆるジャンルに適用可能です。ワークフローは、製品(シェルとコンテンツ)→ アートディレクション → キット(寸法、パーツ、デカール)→ サーフェス(アルベド/粗さ/法線)→ ライト(位置と照明器具)→ ループ(動詞/システム/フィードバック/失敗/テスト)の順に6つのテーブルを埋めることで進行し、各ラウンドで1つの変更のみを行い、すべてのゲートがパスすることを要求します。付属のハーネス(Node.js 22+、Python 3.10+、Chrome/Chromium必須)により、ゲートを実行可能にし、弱いモデルでも一貫した品質を達成できるよう設計されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NorwinYu/photoreal-game/tree/HEAD

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

コードからのフォトリアル3Dゲーム作成手順

コード生成された3Dシーンを、短時間でプレイ可能な、写真のようにリアルなゲームに変えるための手順です。目標はゲームであり、静止画やテクニカルデモ、ウォークスルーではありません。プレイヤーには動詞があり、それに応答するシステムがあり、勝利条件と敗北条件が存在します。

ここでは特定のジャンルを前提としません。主題が動詞を決定します。コンテナヤードはシフト終了前に荷物を運ぶことを示唆し、作業場は機械の修理を示唆し、階段室は見つからずに脱出することを示唆します。シューターは数ある具体例の一つであり、この手順は主題がシューターを要求した場合にのみそれを生成します。

この手順はツールに依存しません。ファイルの編集、コマンドの実行、画像の検査ができるエージェントを前提とします。特定のエンジン、ライブラリバージョン、もしくはベンダー製品に依存するものはありません。

起源と重要性 このスキルは、Saltline — 外部アセットが一切なく、Claude Fable 5.2で作られた1,423,668バイトのシングルファイルブラウザシューター — が提起した問いに答えるために存在します。興味深い点はサイズではなく、モデル自体が生成プログラムを書いたことです。このスキルは、その制作規律を実行可能なゲートとしてパッケージ化し、低コストモデル(DeepSeek V4.1 Flashなど)でも同じ基準を満たせるようにします。結果として同じゲームができるわけではありませんが、同じ規律が適用されます。その証拠はリポジトリのケーススタディに記録されています。

バンドルされたハーネスはオプションですが推奨されます。ゲートを「理想」から「実行可能」にします。Node.js 22+、Pillowを備えたPython 3.10+、およびChrome/Chromiumバイナリ(標準の場所にない場合はCHROME_PATHを設定)が必要です。スキルテキスト自体には依存関係はありません。

低コストモデルでこれを実行する方法

このスキルは、弱いモデルでも実行できるように書かれています。重要な判断はすべてチェックに委譲され、モデルの仕事はテーブルを埋め、最適な修正を適用することです。以下のルールに文字通り従ってください。

  1. アーキテクチャを設計しないでください。 既に以下のものが含まれているスケルトンから始めてください。レンダリングハーネス、ページコントラクト(__READY、__STATS、__SCENE、__AUDIT、__COLLIDERS、__BOUNDS、__TESTMOVE、__TEST、__PRODUCT)、ポストチェーン、完成ゲームシェル(タイトル、設定、ポーズ、セーブ、タッチ、HUDマーカー)、そして空のキットテーブル。それをコピーし、テーブルを埋めてください。実行ごとにアーキテクチャを発明することは、弱いモデルが失敗する原因です。
  2. 発明せず、埋めてください。 成果物は6つのテーブルです。プロダクト(シェル+コンテンツ)、アートディレクション、キット(寸法+パーツ+デカール)、サーフェス(アルベド/粗さ/法線)、ライト(位置+照明器具)、ループ(動詞/システム/フィードバック/失敗/テスト)です。
  3. 製品が先、見た目は後。 product → census → lights → collide → playtest → mobile → look。設定がなく、敵役が2番目になく、目標マーカーやタッチパスがない美しいフレームは、完成ラウンドではありません。
  4. 1ラウンドにつき1つの変更、その後すべてのゲートを実行。 ラウンドは、どのゲートも後退しない場合にのみ有効です。製品やループを壊す視覚的な改善は元に戻されます。
  5. 自己評価しないでください。 ゲートがあなたの意見と異なる場合、ゲートが優先されます。ゲートが間違っている場合は、反例を使ってゲートを修正してください。決してバイパスしないでください。
  6. 予算またはプラトー(頭打ち)のいずれか早い方で停止し、最悪のカメラと失敗したゲートのリストを報告してください。

これら6つのルールに従うモデルは、低コストで同等の出力を生成します。ルール5をスキップするモデルは、もっともらしく見える後退を生み出します。

成果物コントラクト

実行は、以下の成果物が存在し、すべてのゲートが緑色の場合にのみ完了と見なされます。

成果物チェック
1つの自己完結型HTML、ネットワーク要求なしネットワークを無効にしてロード
ページコントラクトが公開されている(__READY、__STATS、__SCENE、__AUDIT、__COLLIDERS、__BOUNDS、__TESTMOVE、__TEST、__GAME、__PRODUCT)ハーネスが読み取る
完成ゲームシェルメニュー、設定、ポーズ、セーブ、タッチ、HUD階層、終了/再開
コンテンツの幅≥2の敵/インタラクト可能ロール、≥2のツール、≥1の目標チェーン、≥3のビート
センサスレポートカバレッジ = 100%、失敗ゼロ
ライト監査すべてのライトが照明器具に固定されている
衝突レポート貫通ゼロ、範囲外ゼロ、コライダーパリティ100%
プレイテストループが完了可能、失敗パスに到達可能、再開が動作
モバイルレポート390×844レイアウト、水平オーバーフローなし、タッチコントロールあり
3~6の主題オブジェクトのボックスレポート各メトリックが参照値の0.8以上
フレームスコア報告されるが、ゲートを上書きするために使用してはならない

完成品コントラクト

プレイ可能なフレームは完成したゲームではありません。ループゲートは動作を保護し、プロダクトゲートはシェル、コンテンツの幅、および第一印象を保護します。以下の内容をページで宣言し、harness/product.mjsがモデルの意図を読まなくてもチェックできるようにします。

成果物最小要件
画面メニュー、プレイ中、ポーズ中、設定、敗北、勝利
タイトル画面ロード時に表示、HUDは非表示、タイトル、前提、スタート、設定/コントロール
設定感度、音量、FOV、Y軸反転、品質(または同等のセット)
永続化1つのキーがリロード後も保持される(最高スコア/進行状況/設定)
入力キーボード + マウス + タッチ、ポインターロック失敗時のフォールバックエイム
目標≥1のチェーン、≥3のビート、ワールドマーカー/コンパス
ロール≥2の敵/障害物/インタラクト可能ロール(単なる色変えではない)
ツール≥2:プライマリ動詞とセカンダリ動詞(武器/ツール/アビリティ)
HUD目標+進捗、生存、武器/弾薬、コンテキストプロンプト、コンパス/マーカー、字幕
オーディオミュート機能 + ≥6の状態変化イベント
カメラヒーローカメラとクローズアップ静止カメラを__PRODUCT.camerasに含める
パフォーマンスコール数/トライアングル数/ライト数の宣言された予算、開始後に測定
モバイル水平オーバーフローなしの390×844、タッチコントロールに到達可能

バーティカルスライスのコンテンツ予算

アートパスの前にこれを埋めてください。バーティカルスライスとは、1つの完全な目標チェーン、2つのロール、1つの特徴的なシステム、および設計されたシェルを備えた、3~8分の1セッションです。デモリールよりは小さく、テクニカルデモよりは大きいものです。

スロットバーティカルスライス完成した小規模ゲーム
目標1チェーン、3ビート1~3チェーン、5~8ビート
敵/インタラクト可能ロール23~5 + クライマックス
武器/ツール2(プライマリ+セカンダリ)3~5
プレイヤー動詞移動、照準、発射、リロード+ しゃがむ/ジャンプ/インタラクト/アビリティ
ワールド1つの場所、3つの奥行きレイヤー2~3の接続された空間
シェルタイトル、ポーズ、設定、終了+ セーブ、品質、タッチ
セッション3~8分10~30分

マニフェストは主張です。ゲートはDOMの動作と宣言されたカウントをチェックします。ページが実行しないことを宣言しないでください。

window.__PRODUCT = {
  title: { name: 'ゲームタイトル', start: '#start', hud: '#hud', hudHiddenOnTitle: true },
  screens: ['menu', 'playing', 'paused', 'settings', 'lost', 'won'],
  ui: { start: '#start', hud: '#hud', pause: '#pause', settings: '#settings', end: '#end', touch: '#touch' },
  settings: ['sensitivity', 'volume', 'fov', 'invertY', 'quality'],
  persistence: ['game.best'],
  input: { keyboard: true, mouse: true, touch: true },
  content: {
    objectives: [{ id: 'objective-1', title: '目標', steps: 3 }],
    roles: ['role-a', 'role-b'],
    tools: ['tool-a', 'tool-b'],
    beats: ['intro', 'contact', 'mid', 'climax', 'win'],
  },
  hud: ['objective', 'compass', 'health', 'ammo', 'prompt', 'subtitles'],
  audio: { events: 10, mute: true },
  perf: { maxCalls: 700, maxTris: 400000, maxLights: 14 },
  cameras: [
    { name: 'hero', cam: [0.5, 1.7, 10, -2.6, 1.3, -10] },
    { name: 'close', cam: [-6.4, 1.4, 5.2, -9.9, 1.0, 2.2] },
  ],
  test: { start: 'start', pause: 'pause', resume: 'resume', settings: 'openSettings', save: 'save' },
};

標準の__TESTアクション(追加アクションは許可):start、pause、resume、openSettings、closeSettings、save、state。これらはポインターロックなしで動作し、JSON安全なスナップショットを返さなければなりません。タイトル画面はHUDを非表示にし、開始するとHUDを表示し、設定、ポーズ、終了画面はDOM検査可能でなければなりません。

使用すべき時

  • シーンは幾何学的に正しいが、平坦で、プラスチックのように見え、または「生成された」ように見える場合。
  • レンダリング結果を参照写真、コンセプト、またはアートディレクションに合わせる必要がある場合。
  • 照明、マテリアル、または構図を制御された方法で改善する必要がある場合。
  • 長い生成プロセスで、多くのイテレーションにわたって一貫性を保つ必要がある場合。

使用すべきでない時

  • 意図的にスタイライズされた出力(フラットシェーディング、セルルック、図式的、UI風)。これらには一貫した抽象化が必要であり、物理的な妥当性は必要ありません。手順は転用可能ですが、フォトリアルプロファイルとルックゲートをスタイル一貫性のあるものに置き換えてください。スタイライズされたシーンを写真プロファイルで測定すると、品質の問題ではなく、設計上必然的に低評価になります。
  • 精度が求められるタスク(CAD、工学図面)で、読みやすさがリアリズムよりも優先される場合。
  • カメラのないシーン:データ可視化、ノードグラフ、UI。

問題のモデル

知覚されるリアリズムは5つのレバーから生じます。この順序で適用してください。リストを下るにつれて、努力に対する効果は急激に減少します。

  1. 光 — 方向、色、仰角が定義された単一の支配的な光源と、反射とフィルライトのための環境。
  2. マテリアル — 色だけでなく、粗さ、法線、汚れのバリエーション。
  3. 構図と密度 — 複数のスケールと奥行きのオブジェクト、明確な焦点と読み取り可能なスケールの手がかり。
  4. 画像形成 — アンチエイリアシング、トーンマッピング、ブルーム、グレイン、ビネット。
  5. 幾何学の詳細 — 最後の手段であり、それが画面上の数ピクセルに残る場合にのみ使用。

明示的に述べる価値のある2つの結果:

  • およそ2ピクセルより小さい詳細はアンチエイリアシングによって除去され、画像に寄与しません。そのスケールでポリゴン数を増やすのは無駄です。
  • シーンは適切な露出を持っていても、空っぽに見えることがあります。空っぽさは階調の問題ではなく、密度の問題です。

完成したゲームに関するさらに3つの結果:

  • フレームは必要だが十分ではない。製品レイヤー(タイトルキーアート、設定、ポーズ、セーブ、タッチ、目標マーカー、ラジオ/字幕、コンテンツの幅)は、プレイヤーが照明に気づく前に判断されます。
  • 5つのレバーは主題に依存しません。昼間の港、明るい室内、雪原、またはスタイライズされたアリーナにも適用されます。夜間/雨/霧は一つのシナリオであり、デフォルトではありません。
  • フレームスコアは、1つの参照ルックのためのコンパスです。美しいデモと完成したゲームを区別することはできません。

ワークフロー

各ステップには出力があります。次のステップを出力なしで開始しないでください。

ステップ1 — レンダリングを観測可能にする(シーン作業の前に推奨)

フレームをキャプチャして検査するための再現可能な方法を作成します。

出力:画像を返す1つのコマンド、そして理想的にはいくつかの数値。

環境に既にスクリーンショットツールがある場合はそれを使用してください。ない場合は、動作する最小のものを作成してください。

  • ローカルの静的サーバーに対してヘッドレスブラウザを起動します。
  • ページからの準備完了シグナル(下記コントラクト参照)を待ち、キャプチャします。
  • オプションで画像統計(露出ヒストグラム、クリッピング、色数、エッジ密度)を計算します。

キャプチャを決定論的に保つページコントラクト:

window.__READY = true;                      // 数フレームレンダリング後に設定
window.__STATS = { calls, triangles };      // オプションのレンダラーカウンター
// オプションのクエリパラメータ
// ?shot=1            UIを非表示
// ?cam=x,y,z,tx,ty,tz 固定カメラ
// ?seed=N            固定乱数シード

ルール:

  • 比較ごとに固定カメラ、固定シード、固定ビューポート。
  • 各キャプチャをバージョン名で保存し、以前のものを上書きしないでください。
  • メトリクスが利用できない場合は、画像を保存し、並べて比較してください。視覚的な比較で十分です。メトリクスは帰属を迅速にするだけです。

ステップ2 — アートディレクションブリーフを書く

出力:短いテーブル。すべての行は実装可能なほど具体的でなければなりません。

決定事項内容
主題フレームが何についてで、どのスケールか
時間と天候フォグ、反射の強さ、コントラストを決定
キーライト方向、仰角、色温度、強度
空と環境光シャドウフィルの色
マテリアルファミリーどのサーフェスが存在し、どれだけ粗く、どれだけ濡れているか
焦点視線が最初に留まるべき場所
制約表示してはならないもの(例:純白、平坦な地面、晴天)

ガイダンス:

  • 1つの支配的な光のストーリーを選択してください。追加の光源はフィル、バウンス、または実用灯であり、従属的でなければなりません。
  • 詳細を追加する前に主題を制約してください。視覚的な複雑さを減らす条件(夜、雨、霧、ほこり、逆光、産業用または屋内設定)は、手抜きではなく、正当で効果的な選択です。
  • キーの仰角を意図的に選択してください。影の長さは 高さ / tan(仰角) に比例します。低いキーは長い影を生成し、前景全体が陰になる可能性があり、それは「影がない」と解釈されます。中間の仰角(約20~30°)は通常、形状と、コントラストを与えるための明るい領域の両方を提供します。
  • キットの前に照明シナリオを選択してください。詳細の欠如を隠すために、夜間、雨、または産業用屋内をデフォルトにしないでください。夜は一つの選択肢です。逆光の夜明けや明るい室内はより難しく、多くの場合、より説得力があります。
シナリオキーライトフィル/IBL空気特徴的なマテリアル
夜間産業用冷たい中低キー、実用灯空の環境、暖色のプール指数関数的、空の色濡れた地面、発光する照明器具
曇りの昼光広い空のキー、35~60°強いIBL薄い空気遠近法マットコンクリート、水たまり
ゴールデンアワー/逆光被写体の背後にある低い暖色キー冷たい空のフィル長い霞、リム濡れたアスファルト、ガラス、金属
晴れた正午高いキー、硬い影空のフィル+バウンス最小限砂、石、ペンキ
屋内実用灯窓+少数の暖色光源窓/空の環境光線、ほこり木、布、金属
地下/人工光実用灯+発光体低い環境光ボリューメトリック濡れたコンクリート、標識

逆光のシーンは「簡単」ではありません。クリップしたハイライト、色かぶり、弱いシルエットを露呈します。露出とハイライトのロールオフ(圧縮)を修正します。

...

[翻訳のため省略]

関連スキル