1. 项目概述为什么我们需要Realtime CSG如果你在Unity里做过关卡设计或者建筑原型肯定对ProBuilder不陌生。它是个好工具但当你需要快速、精确地“雕刻”出复杂几何体比如在场景里挖个带圆角的门洞、做个非对称的管道连接或者构建一个多层嵌套的复杂掩体时传统的顶点编辑或者布尔运算插件要么效率低下要么结果不可预测网格经常破面。这时候CSGConstructive Solid Geometry构造实体几何的思路就派上用场了。简单说它不是直接编辑网格点而是把三维空间中的基本形状立方体、球体、圆柱体当作“积木”通过并集、交集、差集这些布尔运算来组合或切割生成新的复杂形状。这就像用建模软件里的布尔操作但Realtime CSG后文简称RCSG的强大之处在于它是实时、非破坏性的并且完全在Unity编辑器内运行。我最近在一个快速原型项目中亲测了这款免费的RCSG插件用它搭建一个多层室内场景的效率比传统方法提升了至少三倍。更重要的是它生成的网格是“干净”的——没有重叠顶点没有非法多边形直接就可以用于碰撞体或进一步编辑。这对于需要频繁迭代的关卡设计、建筑可视化甚至是一些特殊的游戏机制比如可破坏地形来说简直是神器。网上关于它的中文教程比较零散很多还停留在老版本。这篇教程我会基于最新的可用版本从核心概念到实际建模手把手带你走一遍并分享几个我踩过坑才总结出来的高效工作流。2. 核心概念与插件安装2.1 CSG到底在做什么在深入操作前理解CSG的工作流和几个核心术语至关重要这能帮你避免后续很多迷惑操作。2.1.1 非破坏性工作流传统3D软件里的布尔运算比如你在Blender里用一个立方体减掉一个球体执行后原来的立方体和球体就没了生成一个新的、不可逆的网格。RCSG则完全不同。它所有的“积木”我们称之为Brush都保留着原始形态和参数。你定义的操作比如“用这个圆柱体在那个立方体上挖个洞”被记录为一个操作序列。Unity会实时计算这个序列的结果并生成最终网格即CSG Model但原始的Brush随时可以调整、移动甚至删除整个模型会立即更新。这带来了巨大的灵活性你可以随时把那个“洞”的直径从1米改成2米或者把挖洞的圆柱体挪个位置而不用从头开始。2.1.2 核心组件解析一个典型的RCSG场景由以下几部分组成Brush笔刷/体素构成模型的基本几何形状。插件自带立方体、圆柱体、球体、棱柱、圆锥等。每个Brush都是一个独立的GameObject。CSG ModelCSG模型这是一个容器和计算器。它管理其下所有Brush的布尔运算关系并负责生成最终的、可渲染/可碰撞的Unity网格Mesh。最终导出到场景或预制体的是这个CSG Model生成的网格而不是那些Brush本身。Operation操作类型定义Brush如何影响最终模型。主要有三种Additive叠加相当于并集Union。将Brush的体积添加到模型中。Subtractive消减相当于差集Subtraction。用Brush的体积从模型中挖去。Intersection交集只保留Brush与现有模型重叠的部分比较少见。2.1.3 材质与表面RCSG允许你为Brush的每个面单独指定材质。在最终生成的CSG Model网格上这些材质信息会被正确保留。这是它比一些简单布尔插件强大的地方你可以直接做出不同材质的墙面、地板。2.2 插件获取与安装2.2.1 获取途径目前最可靠的免费获取方式是通过Unity的官方Package Manager。注意Asset Store上可能有同名或类似插件但我们要用的是开源且持续维护的版本。打开你的Unity项目建议使用2019.4 LTS或更新版本兼容性最好。点击顶部菜单栏Window Package Manager。在Package Manager窗口左上角点击“”号按钮选择Add package from git URL...。在弹出的输入框中粘贴以下Git仓库地址https://github.com/LogicalError/realtime-CSG-for-unity.git点击“Add”。Unity会自动下载、编译并导入这个包。这个过程可能会花一两分钟取决于你的网速。注意直接Clone仓库到项目的Packages文件夹也是一种方式但对于大多数用户Git URL是最简单干净的。安装后你会在Package Manager的“My Registries”或“In Project”列表里看到“CSG Model”这个包。2.2.2 验证安装与界面调出安装成功后你需要在编辑器中调出核心工作窗口。点击顶部菜单栏Window Realtime CSG。你会看到几个子菜单最常用的是CSG Model Editor和CSG Scene Settings。勾选CSG Model Editor一个浮动窗口会出现在编辑器中。建议将它停靠在Scene视图旁边方便操作。安装完成后你的Hierarchy右键菜单和GameObject菜单下也会出现“CSG Model”和“Create Brush”等相关选项。3. 从零开始你的第一个CSG模型理论说再多不如动手做一遍。我们来创建一个简单的“带窗洞的墙壁”。3.1 创建基础墙体在Hierarchy中右键选择3D Object CSG Model。这会在场景中创建一个空白的CSG Model游戏对象。你可以把它重命名为“MyFirstWall”。确保“MyFirstWall”被选中在Inspector面板中你可以看到“CSG Model”组件。保持默认设置即可。现在我们要为这个Model添加第一个Brush墙体。在Hierarchy中右键“MyFirstWall”对象选择Create Brush Cube。一个立方体Brush会作为“MyFirstWall”的子对象出现。选中这个Cube Brush在Inspector中将其Operation设置为Additive默认就是然后调整Scale或直接在Scene视图中拖动到你想要的墙体尺寸例如长10米、高3米、厚0.2米。一个基础的墙板就出现了。3.2 挖出一个窗洞现在我们要在这面墙上挖一个窗户。再次右键“MyFirstWall”选择Create Brush Cube创建第二个立方体Brush。将这个新Brush的Operation设置为Subtractive。这是关键一步它告诉CSG Model用这个Brush的体积去切割已有的模型。将这个Subtractive Brush移动到墙体的中间位置并调整其尺寸比如宽2米、高1.5米、厚度略大于墙厚例如0.3米以确保它能完全穿透墙体。神奇的一幕发生了当你移动或缩放这个Subtractive Brush时墙体上会实时出现一个“洞”。这个洞的形状完全由这个Brush定义。实操心得一Subtractive Brush的尺寸Subtractive Brush的尺寸一定要大于你想切割的Additive Brush的厚度。比如墙厚0.2米你的“切割刀”厚度至少0.21米才能确保完全切穿否则可能会留下薄如纸片的残留面导致光照或碰撞错误。我习惯设置为目标厚度的1.5倍。3.3 优化与网格生成现在你的Hierarchy结构应该是MyFirstWall (CSG Model) ├── Cube (Additive) // 墙体 └── Cube (Subtractive) // 窗洞但此时场景中显示的还是一个“预览”效果。CSG Model需要生成最终的Unity网格。选中顶层的“MyFirstWall”对象。在Inspector的“CSG Model”组件上找到Generate按钮点击它。稍等片刻对于简单模型几乎是瞬间你会看到组件下方多出了一个“Generated Meshes”的折叠栏。同时在Scene视图中模型看起来可能没变但其实已经从一个由Brush定义的逻辑模型变成了一个实实在在的MeshFilter MeshRenderer组成的Unity网格物体。你可以点击“Show Generated Meshes”来查看生成的具体网格资源。重要提示在编辑过程中你可以随时移动、旋转、缩放任何一个Brush然后再次点击Generate来更新最终模型。这就是非破坏性编辑的魅力。生成后的网格也可以被赋予物理材质、参与光照烘焙等和任何普通网格一样。4. 进阶技巧与复杂形状构建掌握了基础操作后我们可以玩点更复杂的。RCSG自带的Brush类型能组合出意想不到的形状。4.1 使用圆柱体与球体创建有机形态假设我们要做一个罗马柱式的门廊柱子。新建一个CSG Model命名为“Pillar”。创建一个CylinderBrushOperation为Additive作为柱身。调整高度和半径。再创建一个SphereBrushOperation为Additive。将它缩放成一个扁椭球体放置在柱身的顶部作为柱头。在柱身底部我们想创建一个带凹槽的基座。这可以用多个Subtractive的Prism棱柱或细长的Cube环绕柱身底部一圈来实现。技巧来了你可以先创建一个Subtractive的细长Cube然后按住CtrlDDuplicate复制它再旋转复制体通过多次复制和旋转快速创建出一圈均匀的凹槽。所有Brush都是实时的你可以随时调整凹槽的深度和宽度。调整满意后点击CSG Model的Generate。实操心得二复杂模型的Brush组织当Brush数量增多时Hierarchy会变得混乱。强烈建议使用空GameObject来分组。例如在“Pillar” CSG Model下创建三个空对象“Base”、“Shaft”、“Capital”然后将对应的Brush拖入各自组内。这样结构清晰便于整体移动或隐藏某一部分进行编辑。CSG Model会递归查找其下所有子节点中的Brush所以分组不影响计算。4.2 斜面与复杂切割棱柱Prism和自定义轮廓RCSG的PrismBrush非常强大它可以创建拥有任意多边形底面并挤出的形状。案例制作一个带坡道的平台创建一个CSG Model添加一个Additive的Cube作为平台主体。现在要添加一个斜坡。创建一个PrismBrushOperation为Additive。选中这个Prism在Inspector中你会发现“Vertices”列表。默认是三角形你可以点击“”号增加顶点数。关键步骤在Scene视图中选择Prism的顶部面或底部面进入顶点编辑模式。你可以拖动这些顶点将矩形截面调整为一个直角三角形截面一个直角边垂直一个直角边水平。这样挤出后就得到了一个三棱柱也就是我们的斜坡。将这个三棱柱Brush移动到平台边缘对齐好。一个带斜坡的平台就初具雏形了。你还可以用一个Subtractive的Cube或Cylinder在斜坡侧面挖出防滑纹路。自定义轮廓Experimental功能在一些社区分支版本中RCSG还支持通过二维样条线Spline定义轮廓然后挤出生成复杂Brush。这需要更深入的探索但原理和3D建模软件中的“放样”类似。对于绝大多数用途基本Brush组合已经足够强大。4.3 材质分配与UV处理为不同面赋予不同材质能让你的CSG模型立刻生动起来。在创建或选中一个Brush后查看其Inspector。你会看到“Surfaces”列表列出了这个Brush的所有面如Top, Bottom, North, South等对应立方体的六个面。点击每个面旁边的圆圈材质选择按钮就可以从项目中选择不同的材质球赋予它。当你点击CSG Model的Generate后生成的最终网格会正确地应用这些材质。注意事项UV与光照贴图RCSG生成的网格其UV是自动生成的。对于简单的Box Mapping立方体贴图通常没问题。但如果你的模型非常复杂或者对纹理有精确对齐要求如砖墙自动生成的UV可能会拉伸。此时你有两个选择在生成后手动调整将生成的网格导出为FBX在专业3D软件中重新展UV。这适用于最终确定的静态模型。依赖光照贴图UV如果你主要使用光照贴图Lightmapping可以在Unity的模型导入设置或光照贴图UV生成设置中处理。确保在CSG Model生成后检查其Mesh Renderer组件的UV是否满足需求。5. 工作流优化与性能考量将RCSG融入你的日常开发流程需要注意以下几点。5.1 高效编辑工作流善用CSG Model Editor窗口这个窗口提供了快速选择Brush类型、切换操作模式Add/Subtract的按钮比在菜单里找快得多。你还可以在这里快速切换Brush的显示模式如线框、实体等。快捷键虽然RCSG没有官方密集的快捷键列表但Unity的标准操作W移动、E旋转、R缩放完全适用。多使用顶点捕捉按住V键拖动顶点来精确对齐Brush。预制件Prefab化将一个完整的、生成好的CSG Model即包含所有Brush和生成的网格做成预制件。这样你可以在多个场景中复用。但请注意预制件实例中的Brush仍然可以独立编辑并重新生成网格这非常强大。分层生成对于超大型场景比如整个建筑不要把所有东西都放在一个CSG Model里。按房间、楼层或功能模块分成多个CSG Model。这能提升编辑时的响应速度也方便多人协作。5.2 性能与导出策略CSG计算是实时的但对于成百上千个Brush的极端复杂模型每次生成都可能带来卡顿。最终化Finalize当某个模型确定不再修改后你可以选择“最终化”它。具体操作是在生成网格后将CSG Model组件从GameObject上移除或者禁用。此时游戏对象上只剩下MeshFilter和MeshRenderer它们引用着已经生成好的静态网格。这样就彻底移除了CSG的运行时开销变成了一个普通网格物体。记得先备份预制件或场景碰撞体CSG生成的网格可以直接用作MeshCollider。对于简单形状如那面带窗洞的墙更优的性能做法是用基本几何体Cube组合成一个近似碰撞体而不是使用复杂的网格碰撞体。你可以在CSG Model下添加一些仅用于碰撞的简单Brush生成一个简化的碰撞网格。LOD多层次细节对于远景中的复杂CSG模型考虑为其生成一个简化版本的低模并配置LOD Group。这需要手动在外部建模软件中完成减面但对于开放世界游戏很重要。5.3 常见问题与排查实录即使工具强大踩坑也在所难免。下面是我遇到的一些典型问题及解决方法。问题现象可能原因排查与解决步骤点击Generate后无反应或模型消失1. Brush全部被Subtractive操作“吃光”。2. Brush之间没有交集Additive操作未产生任何体积。3. CSG Model组件设置问题。1. 检查Hierarchy中是否至少有一个Brush的Operation是Additive。2. 检查Additive Brush之间或与Subtractive Brush之间是否有空间上的重叠。没有重叠就无法进行布尔运算。3. 尝试在CSG Model的Inspector中勾选“Force Update”再点击Generate。生成网格出现破面、闪烁或奇怪阴影1.浮点数精度问题Brush的面与面完全共面或极度接近。2. 网格拓扑结构复杂自动生成的顶点法线有问题。1.这是最常见问题确保两个Brush的面不要完全对齐。例如一面墙和地板接触时让地板Brush的厚度略微嵌入墙体一点点如0.001个单位避免共面。2. 尝试调整CSG Model的“Smoothed”设置在组件的高级设置里或生成后对Mesh使用Unity的“Recalculate Normals”功能。Subtractive Brush挖洞后洞口内部可见/有材质Subtractive Brush自身被赋予了材质且该材质被应用到了“内部”面。确保Subtractive Brush的材质设置为None透明或者一个你希望洞口内部呈现的材质。通常Subtractive Brush不需要指定材质。编辑器运行缓慢场景中CSG Model或Brush数量过多且频繁自动生成。1. 在CSG Scene Settings中关闭“Auto Regenerate CSG Models”。改为手动点击Generate。2. 将暂时不编辑的CSG Model最终化移除组件。3. 使用分层管理隐藏暂时不需要的模型层。生成的网格无法应用光照贴图或UV错乱自动生成的UV不符合光照贴图或自定义纹理需求。1. 对于光照贴图在Unity的Lighting窗口尝试不同的UV生成参数如Pack Margin。2. 对于需要精细纹理的模型考虑将最终网格导出在Blender等软件中重新展UV后导回。最后一点个人体会Realtime CSG不是一个用来替代专业建模软件如Blender、Maya的工具而是一个桥梁和加速器。它最适合在Unity内部进行快速的空间规划、关卡白模搭建、机制原型测试。当你需要高精度、高视觉质量的最终资产时还是需要进到专业软件中细化。但有了RCSG你可以把“想法到可玩原型”的时间压缩到极致并且这个原型本身就是由精确的几何体构成的为后续的美术制作提供了完美的尺寸参考。把它当成你在Unity里的“数字粘土”和“建筑积木”你的关卡设计迭代速度会获得质的飞跃。
