Community影像github.com

Blender 遊戲套件 (模型來自程式碼)

從 Blender 中的 Python 腳本構建遊戲就緒模型,適用於任何遊戲——模組化關卡套件(牆壁、地板、門廊、樓梯、平台、天花板)、道具和簡單角色——將程序化材質烘焙為紋理、製作廉價的 LOD 副本,並匯出可直接放入 Unity 或其他引擎的 FBX 檔案。每當使用者想要從 Blender 獲得 3D 模型或關卡、提到「Blender MCP」、「製作模組化套件」、「建模房間/地牢/房子/走廊/道具」、「匯出到 Unity」、「三角形太多」,或想要可從程式碼重新生成的藝術品而非手動建模時,即可使用。

Blender 遊戲套件 (模型來自程式碼) 是什麼?

Blender 遊戲套件是一個 AI 代理技能,可讓使用者直接從 Blender 內的 Python 腳本生成遊戲就緒的 3D 資產和關卡。此技能的核心概念是以網格為基礎進行設計,透過定義如「牆模組 4.0 米寬」等模組尺寸來實現精準對齊與快速迭代,而無需手動建模數小時。它支援兩種運作模式:「即時 Blender」模式(透過 Blender MCP 附加元件,適合視覺探索與資產搜尋),以及「無頭模式」(使用 blender -b --factory-startup -P 命令,適合可重複的遊戲匯出)。此技能還包含一個完整的流程:從輔助函式(box()、cyl()、assign()、finish())開始,為每個幾何變化建立單一函式,將零件合併為單一網格以減少繪製呼叫,將程序化材質烘焙為 Unity 兼容的紋理(BaseColor、Normal、MetalSmooth、Emission),並使用 Unity 的軸設定匯出 FBX。三角形預算管理是另一個關鍵面向,提供分析工具來識別高面數區域(例如,一個場景中兩個毫米的導角就佔了所有三角形的 38.6%),並建立「_Lite」副本以優化遠距離或重複物件的效能。該技能也強調與 Unity 的無縫銜接,提供匯入設定建議、將烘焙紋理綁定至 URP 材質,並建議將 .blend 檔案和腳本保留在版本控制中,而將 FBX 視為建構產物。其檔案結構預期包含 scripts/、references/ 目錄和 build_kit.py 腳本。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Maimuzamilhu/claude-code-gamedev-pipeline/tree/HEAD/skills/blender-game-kit

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

在你喜歡的 AI 中提問

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

說明文件

Blender 遊戲套件 (模型來自程式碼) 是做什麼的?

透過在 Blender 中執行的 Python 腳本來構建遊戲世界。一個地牢、一棟房子、一個太空站、一個街區:全部都是網格上的模組加上道具。修改只需編輯並重新執行,無需花費數小時重新建模。

範例(HOLD STILL): 整個兩層樓工廠(牆壁、地板、門、樓梯、實驗室傢俱、機器人、碎片)來自大約 20 個 Blender 腳本。

代理如何執行 Blender

  • 即時 Blender(Blender MCP 附加元件): 在使用者開啟的 Blender 中執行 Python,查看視埠,搜尋並匯入 Poly Haven / Sketchfab 資產。最適合探索和檢查外觀。
  • 無頭模式(用於實際匯出): blender -b --factory-startup -P build_kit.py。每次執行結果相同,沒有 UI 狀態滲入。用於遊戲出貨的任何內容。

依照類型查詢著色器節點,絕不依賴名稱(名稱在其他 UI 語言中會被翻譯): next(n for n in mat.node_tree.nodes if n.type == "BSDF_PRINCIPLED")。

網格即設計

首先選擇模組尺寸,並且永遠不要打破它們。將它們與你的角色匹配:門比玩家膠囊稍寬稍高,階梯低於角色的步高。對於一個真人尺寸的角色來說,一個好的起點(這些是 HOLD STILL 的數值):

零件尺寸
牆壁模組寬 4.0 公尺,厚 0.12 公尺
地板到天花板3.2 公尺
地板瓷磚2.0 公尺
門洞1.1 公尺 x 2.2 公尺
階梯台階上升 0.18 公尺(保持在角色步高以下)

樞軸點設在模組的地板中心,使零件在 Unity 中以整數米為單位對齊。

工作流程

  1. 先使用輔助函式: box()、cyl()、assign(material)、finish()(應用變換、按角度平滑、UV)。請參閱 scripts/modular_kit.py,這是一個可用於起步的小型工作套件。
  2. 每個模組一個函式(build_wall、build_floor、build_doorway)。使用參數處理變體(有或沒有排水溝、危險條紋、窗戶)。
  3. 每個模組一個網格,多個材質插槽。 合併零件。每個模組變成一個物件和一個紋理集:更少的繪製呼叫。
  4. 烘焙程序化材質(噪點、污垢、凹凸)到 BaseColor、Normal、MetalSmooth(R = 金屬度,A = 光滑度)和 Emission。程序化節點無法在 FBX 匯出中存活;不烘焙的話,Unity 只能看到純色。
  5. 匯出 FBX 使用 Unity 的軸向: axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'。
  6. 匯出後寫入驗證檔案:每個模組的三角形數量、邊界框、材質數量。與前次執行比較,以便回歸問題以數字形式顯現。

三角形預算(關鍵因素)

  • 在最佳化之前先統計三角形的分佈。例如:在 HOLD STILL 中,三塊天花板瓷磚佔了場景中所有三角形的 38.6%,原因是 2 毫米的導角,從 2 米下方根本看不見。平面減面(融解近乎共面的面,50 度,按 UV 接縫和材質分隔)大幅削減了它們,且沒有可見變化。請參閱 references/budgets.md。
  • 小導角僅用於近距離的英雄道具,而非重複使用的模組。
  • 為遠處或重複的零件製作 _Lite 副本,而不是編輯原始套件。

交接給 Unity

  • 匯入設定:僅在玩家會碰觸的零件上生成碰撞體;其餘使用簡單的盒狀碰撞體。
  • 將烘焙紋理按名稱綁定到模組的 URP 光暈材質上(一個小型編輯器腳本,讀取與 FBX 相鄰生成的 materials.json)。
  • 將 .blend 檔案和腳本保留在版本控制中。FBX 是一個建構產物。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能