Asset Forge
Asset Forge 能將文字轉換為圖像,並在本機 GPU 上將其轉換為可直接用於遊戲的 3D 模型(底層使用 ComfyUI,會自動啟動)。所有資料都不會傳送到付費服務。
如何呼叫
當 asset-forge MCP 工具 可用時,優先使用它們:
list_profiles、generate_image、generate_asset、get_job、check_mesh、models、forge_status。
否則,從 Asset Forge 資料夾中使用命令列;每個命令都會輸出一個 JSON 物件:
python forge.py profiles
python forge.py image <name> "<prompt>" -p icon --project <game folder>
python forge.py asset <name> "<prompt>" -p prop_native_trellis2 --project <game folder>
python forge.py asset <name> --image <picture> -p character_native --project <game folder>
python forge.py check <model.glb>
退出碼 0 = 成功,2 = 完成但網格檢查失敗,1 = 錯誤。
工作流程
- 選擇設定檔:使用
list_profiles。圖片設定檔用於生成圖片(concept_prop、concept_character、icon、illustration);資產設定檔則用於生成 3D 模型,每個模型有三種預設(見下方)。使用prop_native_trellis2處理道具,character_native處理角色(約需一分鐘);省略設定檔則使用道具預設。prop_lowpoly/character_lowpoly是較慢的 UltraTex 管線,作為 12 GB 以下顯示卡的備用方案——僅在使用者要求或 GPU 記憶體較小時使用。標記為experimental的設定檔未在此機器上驗證——若使用請告知使用者。 - 務必傳入遊戲專案資料夾(
project_dir/--project)。其中的assetforge.json提供了美術風格、輸出資料夾與每個設定檔的參數,使素材保持一致。如果專案沒有此檔案,建議建立一個(forge.py init <dir>)。 - 對於 3D,先批准圖片。 使用
image_only: true呼叫generate_asset(約需一分鐘),檢視圖片後,再在不加image_only的情況下呼叫一次(使用預設設定檔約需一分鐘,使用 UltraTex 則需 4-8 分鐘)。第二次呼叫會重複使用已批准的圖片,無需提示詞。 - 3D 任務是非同步的。
generate_asset會返回一個任務 ID;重複呼叫get_job並設定wait_seconds: 50,直到狀態不再是queued或running。一次只執行一個資產任務——因為只有一個 GPU。 - 檢視結果。 完成的任務會返回渲染預覽(正面與四分之三視角)以及網格檢查。在未檢視預覽前,不得報告成功。
預設
將 preset 傳遞給 generate_asset(命令列中使用 --preset)。根據資產的用途選擇,並告知使用了哪一個。
| 預設 | 用途 | 耗時 |
|---|---|---|
fast | 用於草稿、背景雜物、遠處或手機資產:三角形數量最低(道具約 800 個,角色約 4,000 個)。 | 1-2 分鐘 |
standard | 預設值。道具 3,000 個三角形,角色 12,000 個三角形。 | 約 1 分鐘(原生,已測量);4-5 分鐘(UltraTex) |
max | 用於攝影機靠近的主角資產:完整的形狀解析度與最多的紋理細節(道具 8,000 個三角形)。 | 最長;尚未測量 |
原生 fast 與所有 max 的耗時為估算值;原生 standard 已在六個主題上測量。在 16 GB 以下的顯示卡上,某些設定會自動被限制;結果會在 limited_by_vram 下列出。
更改同一個名稱的預設或任何參數會重新生成模型,但會重複使用概念圖片;相同的設定會返回快取結果。
風格預設
為了在系列素材中保持一致的視覺風格,請傳遞 style_preset(ID 在 list_profiles -> styles 中):realistic_pbr、hand_painted、toon、lowpoly_flat、voxel。在整個遊戲的所有素材中使用同一個設定,或一次性地在專案的 assetforge.json 中設定。這些設定是實驗性的;請告知使用者,並檢查預覽。*_native 設定檔支援最多的風格設定;結果中的 style_ignored 會列出設定檔無法應用的風格。
撰寫提示詞
- 只描述主體:它是什麼、材質、顏色、磨損程度、比例。設定檔會自動加入構圖、光線與背景。
- 每個資產只包含一個物體。成對的物體,或一個物體加上零散的碎片,應分別作為獨立的資產。
- 粗壯勝過纖細。細線、籠子、蕾絲、真實的孔洞以及髮絲般的尖刺在 3D 步驟中容易斷裂——請使用粗手柄、實心棒代替鏈條、雕刻痕跡代替孔洞。
- 角色:只包含人物與服裝,不包含手持物品。武器應作為道具來製作。
當結果顯示 failed_check
檔案已寫入,但不宜直接使用。problems 會說明原因。
| 問題 | 修復方式 |
|---|---|
shattered mesh | 薄的部分斷裂了。使用 force: true 與 params: {"thin": 0.9} 重新執行。如果再次失敗,請重新生成圖片,讓零件更粗、更實心。 |
spiky mesh | 使用 force: true 與一個新的 seed 重新執行。 |
decimation failed / mesh collapsed | 使用 force: true 重新執行;如果重複失敗,請提高 tris。 |
flat sheet | 圖片被解讀為平面。請在提示詞中加入「bulky, deep, solid」重新生成圖片。 |
force: true 搭配 prompt 時會一併重新生成圖片;force: true 不加 prompt 則保留圖片,僅重新執行 3D 步驟。
自訂
- 每個專案:編輯
assetforge.json(風格、輸出資料夾、profiles.<id>.params)。 - 每次呼叫:
params,例如{"tris": 5000}。list_profiles會顯示每個設定檔接受的參數。 - 新增設定檔:在專案的
assetforge_profiles/資料夾中放置一個小型 JSON 檔案,該檔案需extends一個現有設定檔。請參閱 Asset Forge 資料夾中的 README。 - 模型與硬體:
models工具會報告每個設定檔所需的資源、缺少的資源以及適合此 GPU 的資源。下載檔案較大——請先詢問使用者再安裝。