geometry-nodes

几何节点

可复用的程序化系统。参数化资产。兼顾性能的实例化。

适用场景

• 散布系统（岩石、植被、碎屑）
• 参数化建筑、道路、管道、电缆
• 无需单独建模即可实现程序化变化
• 带随机化的组件组装
• 对大型场景进行非破坏式迭代

工作流

Define Parameters → Build Node Tree → Create Node Group (GN_)
    → Test Variations → Bake/Instance Decision → Export Integration

节点组规范

• 前缀：GN_[System]_[Descriptor]
• 仅公开必要的输入（种子、密度、缩放范围）
• 在组名称或自定义属性中说明输入范围
• 为节点组标注版本：GN_Scatter_Rocks_v02

核心模式

散布系统

Mesh Surface → Distribute Points on Faces → Instance on Points
    → Randomize Rotation (Z) → Randomize Scale → Realize (optional)

建筑生成器

Floor Count (input) → Repeat Mesh → Stack Instances
    → Window Cut Pattern → Material Variation → Output

电缆／管道布线

Curve Input → Curve to Mesh (profile) → Subdivide → Set Material
    → Multiple curves from single path node

岩石群生成

Ico Sphere → Displace (noise) → Decimate → Instance Scatter

随机化

参数	常见范围
缩放	0.8–1.2（均匀或按轴）
Z 轴旋转	0–360°
密度	每平方米 0.1–2.0
种子	用于确保可复现性的整数

始终将种子公开为组输入，以便进行美术指导迭代。

性能规则

场景	方法
游戏导出	实例化为真实几何 → 简化 → 导出网格
背景散布	保持实例化；限制数量
主体程序化资产	烘焙为静态网格，以供引擎使用
视口预览	限制实例数量属性

可复用系统库

组	用途
GN_Scatter_Objects	通用表面散布
GN_Array_Modular	线性模块化重复
GN_Curve_Pipe	沿曲线生成管道／电缆
GN_Wall_Variant	参数化墙体区段
GN_Vegetation_Cluster	树木／灌木群集

MCP 集成

1. 通过 MCP 创建几何节点修改器
2. 通过 MCP 配置组输入
3. 查询实例数量和最终多边形数量
4. 通过 MCP 将几何实例化为真实几何以供导出
5. 将 GN 对象整理到专用集合中

与导出的集成

导出前：

1. 应用几何节点修改器，或
2. 将实例化为真实几何并合并，或
3. 如果引擎支持，则以实例形式导出（Unreal HISM）

记录各目标引擎所采用的方法。

约束

必须做到

• 创建可复用的节点组，而非一次性节点树
• 将种子和密度公开为输入
• 测试参数的最小值和最大值
• 游戏导出前实例化为真实几何／烘焙，除非引擎支持实例
• 组名称使用 GN_ 前缀

禁止事项

• 未制定 LOD／剔除方案就散布百万个实例
• 嵌套执行实例化为真实几何操作（会严重影响性能）
• 将本应作为输入的值硬编码
• 未验证多边形数量就导出程序化资产
• 跳过边界值的变化测试

参考指南

主题	参考资料	加载时机
散布配方	references/scatter-systems.md	环境散布
建筑生成器	references/building-generators.md	建筑程序化生成