最后同步日期：2026-04-15 | Godot 官方原文 — CSGBox3D
继承链：Node → Node3D → VisualInstance3D → GeometryInstance3D → CSGShape3D → CSGBox3D
| 类型 | 名称 | 说明 |
|---|
| 属性 | Operation | 布尔运算类型（合并 / 减去 / 相交） |
| 属性 | Snap | 网格捕捉单位 |
| 属性 | UseCollision | 是否生成碰撞形状 |
| 类型 | 名称 | 说明 |
|---|
| 属性 | MaterialOverride | 材质覆盖 |
| 属性 | CastShadow | 阴影投射模式 |
| 属性 | VisibilityRangeBegin | 可见距离起始 |
| 属性 | Transparency | 透明度模式 |
| 类型 | 名称 | 说明 |
|---|
| 属性 | Layers | 渲染层（可视层掩码） |
| 属性 | SortingOffset | 排序偏移 |
| 类型 | 名称 | 说明 |
|---|
| 属性 | Position | 本地位置（X / Y / Z） |
| 属性 | GlobalPosition | 全局位置 |
| 属性 | Rotation | 旋转角度（欧拉角，弧度） |
| 属性 | Scale | 缩放比例 |
| 属性 | TopLevel | 是否脱离父节点的变换 |
| 方法 | LookAt() | 朝向目标点 |
| 方法 | ToGlobal() | 本地坐标转全局坐标 |
| 方法 | ToLocal() | 全局坐标转本地坐标 |
| 方法 | RotateX/Y/Z() | 绕指定轴旋转 |
| 类型 | 名称 | 说明 |
|---|
| 属性 | Name | 节点名称 |
| 属性 | ProcessMode | 处理模式（始终 / 暂停时 / 仅编辑器） |
| 属性 | ProcessPriority | 处理优先级，数字越小越先执行 |
| 信号 | ready | 节点进入场景树并准备就绪 |
| 信号 | tree_entered | 节点进入场景树 |
| 信号 | tree_exited | 节点完全离开场景树 |
| 方法 | GetNode<T>() | 按路径获取子节点 |
| 方法 | AddChild() | 添加子节点 |
| 方法 | RemoveChild() | 移除子节点 |
| 方法 | QueueFree() | 帧结束后释放节点 |
| 方法 | GetParent() | 获取父节点 |
CSGBox3D 是 CSG 立方体，快速原型搭建。
使用频率：★★★ 一般常用。
- 用构造实体几何（CSG）快速创建立方体形状，适合关卡原型搭建和布尔运算
| 属性 | 类型 | 默认值 | 继承自 | 说明 |
|---|
| TODO | TODO | TODO | — | TODO |
