說明文件

總覽

Numivo 是一套關卡設計專用的編輯器工具組，由三個部分組成：桌面服務（管理你的資產庫與預設集）、引擎外掛（虛幻引擎或 Unity），以及連結兩者的共用核心。

最重要的原則是：Numivo 在執行階段完全隱形。你擺放的一切都會烘焙成引擎原生資產：實例化網格、植被、標準材質。你的建置版本不含任何 Numivo 相依。

安裝

從安裝頁面下載適用你作業系統的安裝程式。它會設定桌面服務，並可自動安裝引擎外掛。

在 Unity 中透過 Package Manager 以 Git URL 手動安裝：

// Unity → Window → Package Manager → “+” → Add package from git URL
https://github.com/numivo/com.numivo.leveldesign.git#v1.4.0

在虛幻引擎中，你也可以手動把外掛複製到引擎的 plugin 資料夾，並於 Edit → Plugins 啟用。

快速上手：5 分鐘完成你的第一個場景

安裝完成後，開啟 Numivo 面板（Window → Numivo）。最快種出一片場景的路徑如下：

1. 從內容瀏覽器拖 3–5 個樹木資產，建立一個名為「Trees」的物種。
2. 把密度設為約 60 %，並將坡度限制在 0–35°。
3. 用滑鼠滾輪選好筆刷大小，然後在地形上塗刷。
4. 建立第二個物種「Rocks」，並給它 Avoid：Trees 規則（半徑 2 公尺）。
5. 按下 B 進入混合模式，讓岩石融進地形裡。

地表散佈

散佈工具會以物理上合理的方式把資產放置在表面上。每個物種（資產群組）都有自己的規則：密度、坡度與高度遮罩、群聚程度，以及與其他物種之間的關係。

主要參數如下：

塗刷方式：滑鼠左鍵散佈，Shift + 拖曳為擦除，滑鼠滾輪調整筆刷大小。所有筆畫合併為單一復原步驟。

網格混合

混合讓網格在視覺上與地形融為一體。它不會改變任何幾何：過渡效果是在材質中依地形高度與貼圖計算出來的，並在烘焙時寫入標準材質。

選取一個網格，按下 B 並拖曳混合距離滑桿。衰減曲線決定過渡消退的柔和程度。「預覽接縫」會以熱區圖疊加顯示過渡區域。

格線

格線工具會以規則圖樣分佈資產：矩形、圓形、多邊形（邊數可調，6 邊即為六角形）以及自由樣條單元格。

每個單元格都能以固定角度遞增旋轉（「spin」）、隨機位移並投影到表面上。遮罩會俐落地裁切單元格，非常適合廣場、墓園、太陽能電廠或果園。

測量

測量工具（M）可做點對點測量、連續鏈式測量，或量出兩個物件之間的最短距離。吸附功能會鎖定頂點、邊線與格線。

測量結果會以命名方式存放在測量清單中，並可匯出成 CSV。離開工具時所有輔助線都會消失，場景中不留任何痕跡。

內容瀏覽器

瀏覽器會在本機（SQLite）建立資產庫索引，即使超過一百萬筆項目也依然流暢：結果採用虛擬化呈現，縮圖則由背景管線產生。

搜尋支援名稱、路徑，並在啟用 AI 標記後支援「長滿青苔的岩壁」這類自由描述。AI 標記為選用功能；不啟用時，任何資產都不會離開你的電腦。

物種與預設集

物種把資產和規則綁在一起。物種之間的關係決定它們如何共存：Avoid 保持距離，Attract 追求靠近。蘑菇因此會長在樹幹旁，而路徑依然保持淨空。

一整套設定可以存成預設集並分享出去，那是一個能在虛幻引擎與 Unity 之間互通的 JSON 檔：

{
  "species": [{
    "name": "Pine",
    "density": 0.6,
    "slope": [0, 35],
    "clustering": 0.7,
    "relations": [{ "type": "avoid", "target": "Rocks", "radius": 2.0 }]
  }]
}

快速鍵

疑難排解

面板找不到桌面服務。

服務在本機的 47615 埠監聽。請確認防火牆是否封鎖了本機連線，並從系統匣圖示重新啟動服務。

引擎更新後外掛不見了。

引擎更新會安裝到新的資料夾。請再次執行 Numivo 安裝程式，它會偵測到新版本並把外掛複製進去。

縮圖一直是灰色的。

縮圖管線以低優先權執行。資產庫非常龐大時，第一輪處理可能需要一段時間；進度會顯示在瀏覽器底部。

散佈結果在建置版本中與編輯器裡不一樣。

請確認建置前已經完成烘焙（Bake to Native）。未烘焙的預覽實例只存在於編輯器中。