插件设置¶
启用 ModularBuildingSystem 后，打开：
该页面用于配置建筑系统的项目级默认行为。
Note
本页只说明各项设置的用途。
吸附、成本、结构支撑等系统的详细规则，请参阅对应专题文档。
User Interface¶
这些设置只影响插件提供的默认建造界面，不会关闭建造接口、放置逻辑、网络逻辑或项目自行实现的 UI。
| 设置项 | 默认值 | 说明 |
|---|---|---|
UI Handling Mode |
Use Default |
是否由插件创建和管理默认建造 UI。 |
Build Widget Class |
未配置 | 默认建造界面使用的 Widget 类。 |
UI Input Handling Mode |
Game Only |
默认 UI 显示时使用的输入模式。 |
UI Handling Mode¶
| 模式 | 说明 |
|---|---|
Use Default |
创建并管理 Build Widget Class。 |
Disabled |
不创建默认 UI，由项目自行实现界面。 |
UI Input Handling Mode¶
| 模式 | 说明 |
|---|---|
Do Not Modify |
不修改当前输入模式。 |
Game and UI |
游戏和 UI 同时接收输入。 |
Game Only |
仅游戏接收输入。 |
UI Only |
仅 UI 接收输入。 |
默认建造界面的建筑列表配置，请参阅 建筑数据资产。
Input¶
| 设置项 | 默认值 | 说明 |
|---|---|---|
Placement Aim Mode |
Camera Center |
放置或移动建筑预览时使用的瞄准方式。 |
Selection Aim Mode |
Mouse Cursor |
选择已有建筑时使用的瞄准方式。 |
Min Mouse Move Threshold |
0.5 |
两次 Aim 命中世界点的平方距离阈值。 |
Aim Mode¶
| 模式 | 说明 |
|---|---|
Camera Center |
从摄像机或屏幕中心发射射线。 |
Mouse Cursor |
从鼠标光标位置发射射线。 |
Min Mouse Move Threshold 用于减少目标位置变化很小时的重复查询。该值比较的是两次 Aim 命中世界点的平方距离，不是屏幕像素距离。
Visual¶
| 设置项 | 默认值 | 说明 |
|---|---|---|
Visual State Data Index |
1 |
建筑视觉状态写入的自定义数据索引。 |
视觉状态值¶
| 值 | 状态 | 说明 |
|---|---|---|
0 |
Normal |
正常状态。 |
1 |
Highlighted |
选中或高亮状态。 |
2 |
Valid Ghost |
Ghost 位置有效。 |
3 |
Invalid Ghost |
Ghost 位置无效。 |
不同渲染模式使用：
HISM：Per Instance Custom DataActor：Custom Primitive Data
插件创建 HISM Component 时，会自动确保 Num Custom Data Floats 大于 Visual State Data Index。
Collision¶
| 设置项 | 默认值 | 类型 | 说明 |
|---|---|---|---|
Default Ghost Collision Profile |
OverlapAllDynamic |
Collision Profile | Ghost 默认碰撞配置。 |
Placement Obstacle Trace Channel |
Visibility |
Trace Channel | 检测当前位置是否受到阻挡。 |
Building Object Channel |
WorldDynamic |
Object Channel | 查询建筑组件和 HISM Instance。 |
World Support Object Channel |
WorldStatic |
Object Channel | 识别永久世界支撑对象。 |
Support Query Trace Channel |
Visibility |
Trace Channel | 查询建筑结构支撑关系。 |
单个 Building Data Asset 可以覆盖默认 Ghost Collision Profile。
正式项目建议使用专用碰撞通道，具体请参阅 碰撞配置。
Snapping¶
| 设置项 | 默认值 | 说明 |
|---|---|---|
Enable Snapping |
启用 | 是否启用 Socket 吸附。 |
Snap Distance |
50 cm |
候选搜索范围和 Socket 最大接受距离。 |
Snap Direction Tolerance |
-0.9 |
两个 Socket 连接方向 Dot 值的允许上限。 |
Snap Points |
空 | 项目中的吸附点定义。 |
Available Snap Groups |
空 | 项目允许使用的吸附分组。 |
Snap Distance 同时用于两个阶段：
- 以 Aim 命中点为中心搜索候选，并检查 Socket 到 Aim 点的距离。
- 扩展 Ghost Box 查询范围，并检查 Socket 到 Ghost Box 边缘的距离。
Overlap 查询只负责收集附近组件，系统仍会对每个 Socket 执行精确距离检查。
Socket、分组和方向设置请参阅 吸附系统。
Collapse¶
| 设置项 | 默认值 | 说明 |
|---|---|---|
Require World Support Tag Or Interface |
关闭 | 是否要求世界支撑对象额外具有指定 Tag 或支撑接口。 |
World Support Tag |
Building_SupportAnchor |
显式标记有效世界支撑。 |
World Support Excluded Tag |
Building_NoSupport |
显式排除世界支撑。 |
Enable Collapse |
启用 | 是否处理失去有效支撑路径的建筑。 |
World Support Check Distance |
5 cm |
检查建筑与永久世界支撑接触时使用的距离。 |
World Support Excluded Tag 的优先级高于支撑 Tag 和支撑接口。
详细流程请参阅 结构支撑与坍塌。
Placement¶
| 设置项 | 默认值 | 说明 |
|---|---|---|
Max Build Distance |
1500 cm |
建造、选择、移动和编辑建筑的最大距离。 |
Min Build Distance |
100 cm |
Ghost 与建造发起者之间的最小距离。 |
Build Distance Step |
50 cm |
每次调整 Ghost 距离时的移动量。 |
Build Height Step |
0.5 cm |
每次调整 Ghost 高度时的移动量。 |
Safety Gap |
0.5 cm |
位置修正后保留的安全间隙。 |
Ghost Query Clearance Bias |
0.5 cm |
Ghost 空间查询使用的净空偏移。 |
没有出现边缘碰撞或浮点误判时，建议保留默认容差。
Effects¶
| 设置项 | 默认值 | 说明 |
|---|---|---|
Default Effect Set |
None |
建筑没有指定 Effect Set 时使用的默认特效集合。 |
单个 Building Data Asset 可以使用默认特效、覆盖默认特效或禁用特效。
详细配置请参阅 建筑特效。
Cost¶
| 设置项 | 默认值 | 说明 |
|---|---|---|
Default Evaluators |
空 | Cost Type Gameplay Tag 与 Evaluator Class 的映射。 |
Evaluator 按 Cost Type Tag 精确匹配，不会自动匹配父标签或子标签。
详细配置请参阅 建筑成本系统。
Chunk¶
| 设置项 | 默认值 | 说明 |
|---|---|---|
Chunk Size |
1000 cm |
每个建筑 Chunk 的世界空间边长。 |
Warning
Chunk ID 会根据当前世界和建筑位置动态生成，不应作为存档中的稳定标识。
详细说明请参阅 Chunk 系统。
参数速查¶
| 分类 | 设置项 | 默认值 |
|---|---|---|
| User Interface | UI Handling Mode |
Use Default |
| User Interface | Build Widget Class |
未配置 |
| User Interface | UI Input Handling Mode |
Game Only |
| Input | Placement Aim Mode |
Camera Center |
| Input | Selection Aim Mode |
Mouse Cursor |
| Input | Min Mouse Move Threshold |
0.5 |
| Visual | Visual State Data Index |
1 |
| Collision | Default Ghost Collision Profile |
OverlapAllDynamic |
| Collision | Placement Obstacle Trace Channel |
Visibility |
| Collision | Building Object Channel |
WorldDynamic |
| Collision | World Support Object Channel |
WorldStatic |
| Collision | Support Query Trace Channel |
Visibility |
| Snapping | Enable Snapping |
启用 |
| Snapping | Snap Distance |
50 cm |
| Snapping | Snap Direction Tolerance |
-0.9 |
| Snapping | Snap Points |
空 |
| Snapping | Available Snap Groups |
空 |
| Collapse | Require World Support Tag Or Interface |
关闭 |
| Collapse | World Support Tag |
Building_SupportAnchor |
| Collapse | World Support Excluded Tag |
Building_NoSupport |
| Collapse | Enable Collapse |
启用 |
| Collapse | World Support Check Distance |
5 cm |
| Placement | Max Build Distance |
1500 cm |
| Placement | Min Build Distance |
100 cm |
| Placement | Build Distance Step |
50 cm |
| Placement | Build Height Step |
0.5 cm |
| Placement | Safety Gap |
0.5 cm |
| Placement | Ghost Query Clearance Bias |
0.5 cm |
| Effects | Default Effect Set |
None |
| Cost | Default Evaluators |
空 |
| Chunk | Chunk Size |
1000 cm |