Generate2dmap
App-builder / Grok 環境
| 項目 | 值 |
|---|---|
| 技能目錄 / 指令稿 | .grok/skills/generate2dmap/,以 python3 .grok/skills/generate2dmap/scripts/<script>.py … 執行 |
| 圖像工具 | imagine_text_to_image / imagine_image_to_image(基於路徑;請參閱 imagine);使用 read_file 檢查 PNG 路徑的輸出(非 Codex view_image) |
| 生成圖像路徑 | imagine_text_to_image → 沙箱 file_path → 複製到 assets/map/;Pillow 已預先安裝 |
預設 engine_target | 此 TanStack 瀏覽器沙箱使用 raw_canvas 或 Phaser——僅在使用者明確要求匯出至 Godot/Unity/Tiled 時才使用 |
| 相關技能 | generate2dsprite(角色/特效精靈;道具包仍使用此技能的提取指令稿)、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——模組化房間/區塊:Rogue-like 地下城、銀河戰士惡魔城網路、程序化組合。baked_scene_mode——僅限明確為平面、不可遊玩的場景:標題/選單畫面、戰鬥背景、視覺小說場景、概念藝術。
當使用者提供參數時使用;否則根據現有遊戲、攝影機、碰撞需求、地圖規模和編輯需求推斷最精簡的可遊玩管線。當模式和軸線不一致時,以模式的可遊玩/可編輯合約為準。類型路由、各模式軸線預設值、預設集以及升級啟發式規則均在 references/map-strategies.md 中——當選擇不明顯時請務必閱讀。
可遊玩地圖絕非一張烤好的單一圖像。 對於任何暗示可遊玩地圖、關卡、舞台、房間、原型或引擎場景的請求,交付成果必須將遊戲邏輯幾何和物件以獨立的圖層、道具、圖塊/物件資料、碰撞、區域或引擎原生的場景節點形式公開。烤好的單一圖像可能是背景、參考或預覽成品——但絕非執行時期地圖——除非使用者明確要求僅有平面背景。
僅限場景和地圖。 請勿在此產生角色、敵人、頭目、NPC、玩家、投射物或動畫精靈;這些屬於 $generate2dsprite。地圖攜帶場景鉤子(生成標記、巡邏/遭遇區域、競技場入口、閘門、出口、攝影機觸發器)作為元數據,而非繪製的美術。
美術來自圖像生成,且由您編寫提示詞
imagine_text_to_image是基礎地圖、視差圖層、參考圖、道具表和圖塊美術的預設美術來源。預設art_style為clean_hd(手繪高畫質、形狀清晰銳利、紋理噪音低、無粗大像素);僅在要求時才使用pixel_inspired或retro_pixel。- 親自撰寫每個創意提示詞。 指令稿可能負責組合、切割、去背、裁剪、驗證、組成預覽以及產生 JSON/引擎檔案——絕不編寫創意提示詞或繪製最終美術。僅在使用者明確要求佔位符、固定裝置、偵錯地圖或腳手架時才使用程序化/佔位符美術。對於圖塊引擎目標,先產生圖塊美術,然後指令稿僅負責處理圖層、碰撞、區域和場景接線。
- 每當執行時期創建新的視覺資產時,將每個提示詞儲存在其資產旁邊,命名為
<asset>.prompt.txt(或明確的清單欄位)。 - 參考交接是一個檔案路徑,而非一句話。 要在先前的圖像基礎上構建,請將其沙箱
file_path傳遞給imagine_image_to_image(並使用read_file以查看它),然後指名要保留的具體特徵:攝影機取景、地平線、道路/水域形狀、地形邊界、入口/出口、地標。僅有檔名、「基於該地圖」,或僅僅是在對話中看到該圖像並非交接——請停止並傳遞路徑。
將執行時期物件排除在基礎圖層之外
首先生成的基礎/背景/底圖圖像只能包含穩定、不可互動的基礎美術——地面材質、路徑、道路、水域、懸崖、地板圖案、車道標記和建造平台;對於側視圖則包含天空、遠/中景景物、剪影、氛圍;對於圖塊地圖則包含作為可編輯圖層的圖塊美術。它不得包含高大的道具、建築物、樹木、岩石、板條箱、標誌、門、閘門、拾取物、寶箱、檢查點、危險物、陷阱、砲塔、梯子、前景遮擋物、可破壞物、角色、敵人、NPC、UI、標籤,或任何需要碰撞、互動、重複使用、Y軸排序、動畫或自有渲染順序的東西——請重新生成僅有基礎的圖像,或將此類圖像降級為參考成品。
參考模型是檢查點,而非最終交付物
帶有裝飾的參考(俯視圖)和關卡參考(側視圖)用於規劃遊戲世界中的放置:自然的遊戲世界物件或微妙的區塊幾何,最多9個不同的可見物件候選(重複計算一次,然後在放置元數據中重複出現),無註釋圖形(圓圈、箭頭、輪廓、標籤、文字、標註、圖例、測量線),且無非視覺元數據——生成點、觸發器、巡邏提示、攝影機範圍稍後將作為場景鉤子寫入。
產生了一個之後,請不要就此停止。 繼續進行 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:只有緊湊型道具可以共享一個方形道具包;平台、地板、橋樑、閘門、建築物以及任何與碰撞對齊的物件需要逐一處理,作為平台條、自訂寬包或圖塊/物件圖層。 - 參數、逐步工作流程以及
extract_prop_pack.py/compose_layered_preview.py指令 →references/pipeline.md。 - 每個管線的交付清單和驗證檢查清單 →
references/deliverables.md;在認定地圖完成前請務必執行這兩項。