Community影像github.com

asset-forge

在本地免費生成遊戲素材——概念圖、UI 圖示、插圖以及可直接用於遊戲的 3D 模型(含 PBR 紋理的 .glb 檔案),只需文字提示或一張圖片即可。當使用者要求建立、生成、重新生成或修復遊戲素材、3D 模型、道具、角色模型、圖示或概念圖,或檢查 .glb 檔案時使用。

asset-forge 是什麼?

Asset Forge 是一個完全在本機 GPU 上運行的遊戲素材生成技能,底層使用 ComfyUI 並自動啟動,無需任何付費服務。它能將文字或圖片轉換為高品質的 2D 圖像(概念圖、圖示、插圖)以及可直接用於遊戲的 3D 模型(.glb 格式,附帶 PBR 紋理),特別適合獨立開發者或小型團隊在開發過程中快速迭代素材。支援多種平台,但設計上以命令列和 MCP 工具(如 `generate_image`、`generate_asset`)為主要介面。 技能的核心工作流程強調「先批准 2D 圖像,再生成 3D 模型」,以確保最終素材符合預期。它提供多種預設(presets)來控制品質與速度,例如 `fast` 用於佔位素材、`standard` 為預設平衡選項、`max` 用於高細節主角素材。此外,風格預設(`realistic_pbr`、`hand_painted`、`toon` 等)能保持系列素材的一致性。 對於 3D 生成,任務是非同步的,使用者需透過輪詢 `get_job` 取得結果,並在最終檢查預覽與網格品質。若輸出標記為 `failed_check`,技能提供具體的修復建議(如調整參數或重新生成圖片)。 整體而言,Asset Forge 將複雜的 3D 素材生成流程包裝成簡單的工具呼叫,讓 AI 代理能自動化執行「素材建立-檢查-迭代」的循環,大幅提升遊戲開發效率。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Noamcelermajer/comfyui-text-to-3d-mcp/tree/main/skills/asset-forge

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 = 錯誤。

工作流程

  1. 選擇設定檔:使用 list_profiles。圖片設定檔用於生成圖片(concept_prop、concept_character、icon、illustration);資產設定檔則用於生成 3D 模型,每個模型有三種預設(見下方)。使用 prop_native_trellis2 處理道具,character_native 處理角色(約需一分鐘);省略設定檔則使用道具預設。prop_lowpoly / character_lowpoly 是較慢的 UltraTex 管線,作為 12 GB 以下顯示卡的備用方案——僅在使用者要求或 GPU 記憶體較小時使用。標記為 experimental 的設定檔未在此機器上驗證——若使用請告知使用者。
  2. 務必傳入遊戲專案資料夾(project_dir / --project)。其中的 assetforge.json 提供了美術風格、輸出資料夾與每個設定檔的參數,使素材保持一致。如果專案沒有此檔案,建議建立一個(forge.py init <dir>)。
  3. 對於 3D,先批准圖片。 使用 image_only: true 呼叫 generate_asset(約需一分鐘),檢視圖片後,再在不加 image_only 的情況下呼叫一次(使用預設設定檔約需一分鐘,使用 UltraTex 則需 4-8 分鐘)。第二次呼叫會重複使用已批准的圖片,無需提示詞。
  4. 3D 任務是非同步的。 generate_asset 會返回一個任務 ID;重複呼叫 get_job 並設定 wait_seconds: 50,直到狀態不再是 queued 或 running。一次只執行一個資產任務——因為只有一個 GPU。
  5. 檢視結果。 完成的任務會返回渲染預覽(正面與四分之三視角)以及網格檢查。在未檢視預覽前,不得報告成功。

預設

將 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 的資源。下載檔案較大——請先詢問使用者再安裝。

相關技能