使用文档

总览

Numivo 是一套用于关卡设计的编辑器工具包。它由三部分组成：桌面服务（管理你的资产库与预设）、引擎插件（虚幻引擎或 Unity），以及连接二者的共享内核。

最重要的原则：Numivo 在运行时完全隐形。你摆放的一切都会烘焙成引擎原生资产：实例化网格、植被、标准材质。你的构建版本不依赖 Numivo。

安装

从安装页面下载适配你系统的安装程序。它会配置桌面服务，并可自动安装引擎插件。

在 Unity 中通过包管理器使用 Git URL 手动安装：

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

对于虚幻引擎，你也可以手动把插件复制到引擎插件目录，然后在 Edit → Plugins 中启用它。

快速上手：5 分钟做出你的第一个场景

安装完成后，打开 Numivo 面板（Window → Numivo）。最快铺满一个场景的路径如下：

1. 从内容浏览器把 3–5 个树木资产拖进一个名为“树木”的新物种。
2. 把密度设为约 60%，坡度范围限制在 0–35°。
3. 用鼠标滚轮调整笔刷大小，然后在地形上刷。
4. 再建一个物种“岩石”，给它加上规则 Avoid：树木（半径 2 m）。
5. 按 B 进入融合模式，让岩石融进地形。

地表散布

散布工具以物理上可信的方式把资产摆放在表面上。每个物种（资产分组）都有自己的规则：密度、坡度与高度遮罩、聚簇，以及与其他物种的关系。

关键参数：

绘制方式：鼠标左键散布，Shift + 拖动为擦除，滚轮调整笔刷大小。一次连续笔画只占一步撤销。

网格融合

融合让网格在视觉上与地形浑然一体。它不改动任何几何体：过渡效果由地形高度和贴图在材质中计算得出，烘焙时写入标准材质。

选中一个网格，按 B 并拖动融合距离滑块。衰减曲线控制过渡的柔和程度。“预览接缝”会以热力图形式叠加显示过渡区域。

网格布局

网格布局工具按规则图案分布资产：矩形、圆形、多边形（边数可调，6 边即为六边形）以及自由样条单元格。

每个单元格都可以增量旋转（“spin”）、随机偏移并投影到表面上。遮罩能干净地裁切单元格，非常适合广场、墓园、光伏电站或果园。

测量

测量工具（M）支持点到点、连续链式测量，以及两个物体之间的最小距离测量。吸附可锁定到顶点、边和网格线。

测量结果会以命名条目存入测量列表，并可导出为 CSV。退出工具时，所有辅助线全部消失，场景中不留任何痕迹。

内容浏览器

浏览器在本地为你的资产库建立索引（SQLite），条目超过一百万也依然流畅：结果经过虚拟化处理，缩略图由后台管线生成。

搜索能理解名称、路径，开启 AI 标签后还能理解“长满青苔的岩壁”这类自由描述。AI 标签需手动开启；不开启时，任何资产都不会离开你的机器。

物种与预设

物种把资产和规则打包在一起。物种之间的关系决定它们如何共处：Avoid 保持距离，Attract 靠近彼此。蘑菇因此长在树干旁，而道路始终干净。

一整套配置可以保存并作为预设分享，它是一个 JSON 文件，可在虚幻引擎与 Unity 之间通用：

{
  "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）。未烘焙的预览实例只存在于编辑器中。