Generate2dmap
App-builder / Grok 環境
| 項目 | 値 |
|---|---|
| スキルディレクトリ / スクリプト | .grok/skills/generate2dmap/、python3 .grok/skills/generate2dmap/scripts/<script>.py … で実行 |
| 画像ツール | imagine_text_to_image / imagine_image_to_image(パスベース。imagine を参照)。出力の確認は PNG パスに対して read_file を使用(Codex view_image ではない) |
| 生成画像のパス | imagine_text_to_image → サンドボックス file_path → assets/map/ にコピー。Pillow はプリインストール済み |
デフォルトの engine_target | この TanStack ブラウザサンドボックスでは raw_canvas または Phaser。ユーザーが明示的に希望する場合のみ Godot/Unity/Tiled を使用 |
| 関連スキル | generate2dsprite(キャラクター/FX スプライト。プロップパックではこのスキルの抽出スクリプトを引き続き使用)、building-games、imagine |
最初にパイプラインを決定する
ゲームの要件を満たす最小のプレイ可能なマップバンドルを構築します。まずプロダクトレベルの map_mode を選択し、次に低レベルの軸(visual_model、runtime_object_model、collision_model、engine_target)を決定します。
tile_mode— 編集可能なタイル/グリッドマップ: ポケモンのようなルート、トップダウンRPGの町、プラットフォーマーのタイルマップ、または既にTiled/LDtk/Godot/Unity/Phaserタイルマップを使用しているプロジェクト。scene_mode— 基本ベースと個別のプロップ: タワーディフェンス、サバイバーズのようなアリーナ、居心地の良いトップダウンショーケースマップ。side_scroll_mode— パララックス横スクロールステージ: ロックマンのような、アクションプラットフォーマー、メトロイドヴァニアの部屋、ランナー、ベルトスクロールアクション。grid_mode— ルール重視のグリッド: 戦術RPG、工場/オートメーション、ボード/カードバトラーのビルドグリッド。room_chunk_mode— モジュラー式の部屋/チャンク: ローグライクダンジョン、メトロイドヴァニアネットワーク、プロシージャルアセンブリ。baked_scene_mode— 明示的にフラットでプレイ不可のシーンのみ: タイトル/メニュー画面、戦闘背景、ビジュアルノベルのシーン、コンセプトアート。
ユーザー指定のパラメータがあればそれを使用し、それ以外の場合は既存のゲーム、カメラ、衝突要件、マップスケール、編集要件から最も軽量なプレイ可能パイプラインを推測します。モードと軸が矛盾する場合、モードのプレイ可能/編集可能な契約が優先されます。ジャンルルーティング、モードごとの軸デフォルト、プリセット、およびエスカレーションヒューリスティックについては references/map-strategies.md を参照してください。選択が明白でない場合は必ずこれを読んでください。
プレイ可能なマップは、決して1枚のベイク画像ではありません。 プレイ可能なマップ、レベル、ステージ、部屋、試作品、またはエンジンシーンを示唆するリクエストの場合、成果物はゲームプレイのジオメトリとオブジェクトを個別のレイヤー、プロップ、タイル/オブジェクトデータ、衝突、ゾーン、またはエンジンネイティブのシーンノードとして公開しなければなりません。ベイク画像は背景、参照、またはプレビューのアーティファクトとして使用される場合がありますが、ランタイムマップとしては使用されません。ただし、ユーザーが明示的にフラットな背景のみを要求した場合は除きます。
シーンとマップのみ。 キャラクター、敵、ボス、NPC、プレイヤー、弾丸、アニメーションスプライトはここでは生成しないでください。これらは $generate2dsprite に属します。マップはシーンフック(スポーンマーカー、パトロール/エンカウントゾーン、アリーナ入り口、ゲート、出口、カメラトリガー)を メタデータ として持ちます。描画されたアートとしては持ちません。
アートは画像生成から作成し、プロンプトはあなたが書く
imagine_text_to_imageが、ベースマップ、パララックスプレート、参照、プロップシート、タイルセットアートのデフォルトのアートソースです。デフォルトのart_styleはclean_hd(ハンドペイントHD、シャープで読みやすい形状、低テクスチャノイズ、ドット感なし)。pixel_inspiredまたはretro_pixelは要求された場合のみ使用します。- すべてのクリエイティブなプロンプトはあなた自身が書いてください。 スクリプトはアセンブル、スライス、クロマキー、クロップ、検証、プレビュー合成、JSON/エンジンファイルの出力を行いますが、クリエイティブなプロンプトを書いたり、最終的なアートを描画したりすることは決してありません。プレースホルダー/プロシージャルアートは、ユーザーが明示的にプレースホルダー、備品、デバッグマップ、足場を要求した場合のみ使用します。タイルエンジンをターゲットとする場合、最初にタイルセットアートを生成し、その後スクリプトでレイヤー、衝突、ゾーン、シーンワイヤリングのみを行います。
- 実行時に新しいビジュアルアセットが作成された場合は、各プロンプトをそのアセットの隣に
<asset>.prompt.txtとして保存します(または明示的なマニフェストフィールドに記録します)。 - 参照の受け渡しはファイルパスであり、文章ではありません。 以前の画像をベースに構築するには、そのサンドボックス
file_pathをimagine_image_to_imageに渡し(read_fileで内容を確認できるようにします)、保持する具体的な特徴(カメラフレーミング、地平線、道路/水域の形状、地形の境界、出入り口、ランドマーク)を指定します。ファイル名、「マップに基づく」、または単に会話内で画像が表示されているだけでは 「受け渡し」とはみなされません。その場合は、一旦停止してパスを渡してください。
ランタイムオブジェクトをベースレイヤーに含めない
最初に生成されるベース/背景/基盤画像には、安定した非インタラクティブな基盤アートのみを含めます。すなわち、地面の素材、小道、道路、水、崖、床のパターン、車線、建造パッド、サイドビューの場合は空、遠景/中景の景色、シルエット、雰囲気、タイルマップの場合はタイルセットアートを編集可能なレイヤーとして配置します。そこに 高さのあるプロップ、建物、木、岩、木箱、標識、ドア、ゲート、アイテム、宝箱、チェックポイント、危険物、トラップ、タレット、はしご、前景オクルーダー、破壊可能オブジェクト、アクター、敵、NPC、UI、ラベル、または衝突、インタラクション、再利用、Yソート、アニメーション、個別のレンダリング順序を必要とするものは一切含めてはなりません。そのような画像が生成された場合は、基盤のみのベースを再生成するか、その画像を参照アーティファクトに格下げしてください。
参照モックアップはチェックポイントであり、成果物ではない
ドレスドリファレンス(トップダウン)とステージリファレンス(サイドビュー)は、ワールド内での配置を計画するためのものです。自然なゲームワールドオブジェクトまたは控えめなブロックアウトジオメトリを使用し、最大 9個の識別可能な表示オブジェクト候補(繰り返しは1カウント、配置メタデータで再帰)、注釈グラフィックはなし(丸、矢印、輪郭、ラベル、テキスト、吹き出し、凡例、測定線)、非視覚的メタデータ(スポーン、トリガー、パトロールヒント、カメラ境界)は後でシーンフックとして記述します。
参照モックアップを生成したら、そこで止まらないでください。 references/object-production-gate.md まで進めてください。両方の画像を read_file で再確認し、オブジェクトリストを構築し、最終的な個別オブジェクトを生成し、配置/衝突/シーンフックメタデータを記述し、QAプレビューを合成します。参照のみの出力は、ユーザーが明示的にコンセプトイメージを要求した場合を除き、不完全な実行です。
選択したパイプラインの詳細 — アセット生成前にこれらを開く
- レイヤーラスターマップ →
references/layered-map-contract.md(レイヤータイプ、ベースおよびプロップのプロンプトパターン、プロップメタデータ、レンダリング順序、衝突、QAチェックリスト)。 side_scroll_mode→references/side-scroll-stages.md:stage_canvasの決定、名前付き景観のみのパララックスレイヤー、およびプラットフォーム/オブジェクト作業前の必須のワールド内ステージリファレンス。- プロップまたはシーンオブジェクトの生成 → まず各オブジェクトを分類し、次に
references/prop-pack-contract.mdに従います。コンパクトなプロップのみが正方形のプロップパックを共有できます。プラットフォーム、床、橋、ゲート、建物、および衝突に沿ったものは、1つずつ、プラットフォームストリップ、カスタムワイドパック、またはタイル/オブジェクトレイヤーとして配置します。 - パラメータ、ステップバイステップのワークフロー、
extract_prop_pack.py/compose_layered_preview.pyコマンド →references/pipeline.md。 - パイプラインごとの成果物リストと検証チェックリスト →
references/deliverables.md。マップ完了と判断する前に両方を実行してください。