1. 从“37”这个编号说起Modeling Tools 到底解决了谁的痛点如果你在 UE5 里做过硬表面道具、建筑模块或者需要频繁迭代的关卡原型大概率经历过这样的循环在 DCC 软件里改一版模型导出 FBX切回引擎重新导入替换资产调整材质槽发现法线错了再回去改。一个简单的倒角调整来回折腾十几分钟。Modeling Tools 这套东西就是冲着这个循环来的。它本质上是把一套轻量级的建模工具直接塞进了引擎编辑器里。你不需要离开 UE5就能对静态网格体做挤出、倒角、布尔、雕刻、简化、UV 调整这些操作。更关键的是从 UE5.1 开始这套工具和Geometry Script打通了——你可以用蓝图或者 Python 脚本去程序化地生成和修改网格体这就从“手动改模型”升级到了“用代码批量造模型”。这篇文章适合三类人看一是经常在引擎里做白模和原型关卡的关卡设计师二是需要批量处理网格体资产的 TA技术美术三是想搞清楚 Geometry Script 到底能干什么的程序向开发者。我会从工具集的整体设计思路讲起然后拆解核心编辑操作的实操要点再重点讲 Geometry Script 的联动玩法最后把我踩过的坑和排查经验整理出来。内容基于 UE5.3 到 UE5.5 的实测不同版本菜单位置可能有细微差异但核心逻辑是一致的。2. Modeling Mode 工具集的整体设计与选型逻辑2.1 为什么是“模式”而不是“插件面板”UE5 把建模功能做成了一个独立的Modeling Mode而不是像以前那样散落在各种右键菜单里。你选中一个静态网格体 Actor按 Shift5 就能进入这个模式整个编辑器左侧的工具面板会切换成建模专用的工具集。这个设计选择背后有明确的考量。传统的建模插件往往是“面板式”的你打开一个窗口里面堆满按钮操作对象是“当前选中的资产”。但 Modeling Mode 是“上下文式”的——你进入模式后选中的网格体会进入一种可编辑状态工具直接作用于它操作完点 Accept 就写回资产点 Cancel 就丢弃。这种交互更接近 Blender 或 Maya 的建模模式对有过 DCC 经验的人来说上手很快。更重要的是这种模式化设计让工具集有了统一的撤销栈和预览机制。你在做布尔运算或者动态细分的时候可以实时看到结果不满意直接取消不会污染原始资产。这一点在快速迭代场景里非常关键。2.2 工具集的三大分类左侧面板里的工具看起来很多但按功能可以分成三大类理解这个分类能帮你快速找到需要的工具分类代表工具核心作用适用场景形状创建Box、Cylinder、Sphere、PolyExtrude从零生成基础几何体白模搭建、碰撞体制作网格编辑Boolean、Remesh、Smooth、Displace修改已有网格体的拓扑和形状硬表面细节、地形起伏属性调整UV Editor、Normal Editing、Transform调整 UV、法线、变换贴图适配、光照修正这个分类不是官方文档里的是我自己用下来觉得最顺手的归类方式。新手最容易犯的错是一上来就用 Boolean 去切复杂模型结果拓扑乱成一团。正确的顺序应该是先用形状创建搭出大体块再用网格编辑做细节最后用属性调整收尾。2.3 动态网格编辑的核心非破坏性与可逆性Modeling Mode 里大部分操作都是非破坏性的。什么意思你做一个布尔减法原始网格体并没有被真正“挖掉”而是生成了一个带操作历史的新网格体。你可以随时回到之前的步骤调整参数。这个机制依赖的是 UE5 的Dynamic Mesh动态网格系统。传统静态网格体是一堆固定的顶点和三角形改了就改了。动态网格体则维护了一套可变的拓扑结构支持实时的顶点增删、面片重建。这也是为什么 Modeling Tools 能在编辑器里实时预览布尔运算结果——它操作的就是动态网格。但要注意非破坏性是有代价的。动态网格体的内存占用比静态网格体高不少而且一旦你 Accept 了操作写回成静态网格体历史就丢失了。所以我的习惯是在原型阶段大胆用动态编辑确定最终形态后再 Accept 并做一次 Remesh 优化。3. 核心编辑操作的实操要点与避坑指南3.1 Boolean 布尔运算参数怎么调才不出错Boolean 是 Modeling Tools 里用得最多、也最容易出问题的工具。它的原理很简单两个网格体做并集、交集或差集。但实际操作中网格体的法线方向、是否封闭、面片重叠情况都会影响结果。我总结了一套 Boolean 的操作流程按这个顺序来基本不会翻车检查法线方向选中两个网格体在 Modeling Mode 里用 Normal 工具查看法线是否朝外。法线朝内的网格体做布尔会得到完全错误的结果。确保网格体封闭Boolean 对开放网格体有洞的处理很差。用 Inspector 工具检查是否有边界边有的话先用 Fill Holes 补上。调整重叠区域两个网格体的相交面不要完全重合稍微错开一点否则布尔算法可能产生退化面。选择运算类型Union并集用于合并Difference差集用于挖洞Intersection交集用于保留重叠部分。Accept 后检查拓扑布尔结果的拓扑通常很乱用 Remesh 做一次统一细分再用 Smooth 稍微平滑一下。注意Boolean 的 Difference 操作被减去的网格体法线方向决定了是“挖洞”还是“保留”。如果结果和你预期的相反把减法对象的法线翻转一下再试。3.2 Remesh 与动态细分什么时候该用哪个Remesh 和 Subdivide 都能增加网格体密度但用途完全不同。Remesh是重新生成拓扑它会把网格体变成均匀的三角形分布适合在布尔运算后清理烂拓扑。Remesh 有几个模式Uniform均匀、Voxel体素、Simplification简化。Voxel 模式适合有机形状Uniform 适合硬表面。Subdivide是在现有拓扑基础上增加细分级别保持原有形状特征。它适合在需要更多顶点做细节雕刻时使用但不会修复烂拓扑。我的经验是布尔之后用 Remesh 的 Uniform 模式目标边长设成原网格体平均边长的 0.5 到 0.7 倍这样既能清理拓扑又不会让面数爆炸。如果是做雕刻前的准备用 Subdivide 更合适。3.3 UV 与法线容易被忽视但影响巨大的环节Modeling Mode 里的 UV Editor 和 Normal Editing 工具很多人做完模型就直接 Accept 了结果贴图拉伸、光照诡异。UV Editor 的核心功能是自动展 UV和手动调整 UV 岛。自动展 UV 对简单形状效果不错但复杂模型还是需要手动调整。我的做法是先用 Auto Unwrap 生成基础 UV然后在 UV 视图里检查是否有重叠和拉伸重点调整接缝位置。Normal Editing 工具可以手动调整顶点法线这在做硬表面倒角的时候特别有用。比如你做了一个 45 度倒角但光照看起来还是硬的可以用 Normal 工具把倒角处的法线平滑一下视觉上就有圆角效果了而且不增加面数。实操心得法线编辑后一定要用 Recompute Normals 检查一遍有时候手动调整会引入错误法线导致光照出现黑斑。4. Geometry Script 联动用代码批量造模型4.1 Geometry Script 是什么为什么它很重要Geometry Script 是一套蓝图和 Python 可调用的函数库它把动态网格编辑的能力暴露成了编程接口。你可以用它在运行时生成网格体、批量修改资产、做程序化建模。举个例子你需要在一个关卡里摆放 200 个不同尺寸的箱子每个箱子都有倒角和不同的开孔位置。手动做的话一下午就没了。用 Geometry Script写一个循环每次生成一个 Box应用倒角根据参数挖孔然后摆放到指定位置。整个过程几秒钟跑完。这就是 Geometry Script 的价值把重复性的建模工作自动化。它和 Modeling Tools 的关系是Modeling Tools 是手动操作界面Geometry Script 是同一套底层能力的编程接口。4.2 蓝图里调用 Geometry Script 的基本流程在蓝图里使用 Geometry Script核心节点是Construct Geometry Script和Dynamic Mesh相关的操作节点。基本流程如下创建一个 Actor 蓝图添加一个 Dynamic Mesh Component。在 Construction Script 或 BeginPlay 里用Create Dynamic Mesh节点初始化一个动态网格体。用Append Box、Append Cylinder等节点生成基础形状。用Apply Mesh Boolean节点做布尔运算。用Apply Mesh Remesh节点优化拓扑。最后用Copy Mesh To Static Mesh节点把结果写回静态网格体资产。这里有个关键点Geometry Script 的操作是链式的每一步的输出是下一步的输入。你需要维护一个 Dynamic Mesh 的引用在所有操作完成后统一写回。# Python 版本的示例在 UE5 的 Python 环境里运行 import unreal # 创建一个动态网格体 dynamic_mesh unreal.DynamicMesh() # 生成一个立方体 unreal.GeometryScriptLibrary.create_box(dynamic_mesh, 100, 100, 100) # 应用倒角 unreal.GeometryScriptLibrary.apply_mesh_bevel(dynamic_mesh, 5.0, 2) # 写回静态网格体 static_mesh unreal.GeometryScriptLibrary.copy_mesh_to_static_mesh(dynamic_mesh, MyGeneratedMesh)上面这段 Python 代码展示了最基本的流程。实际项目中你会把参数抽出来做成配置表然后循环生成。4.3 程序化建模的实战案例批量生成建筑模块我之前做过一个项目需要生成一套模块化的建筑墙体每面墙有不同数量的窗户开口。手动做的话每种规格都要单独建模。用 Geometry Script我写了一个函数输入墙体长宽高、窗户数量、窗户尺寸。逻辑先生成一个 Box 作为墙体然后循环生成窗户的 Box用 Boolean Difference 从墙体上挖掉。输出一个静态网格体资产。这个函数跑一次生成一种规格改个参数再跑一次就是另一种规格。整个建筑套件 20 多种规格半小时全部生成完毕而且规格统一不会出现手动建模时的尺寸偏差。注意事项Geometry Script 生成的网格体默认没有 UV。如果需要贴图要在生成后调用Apply Mesh UVs节点自动展 UV或者手动指定 UV 投影方式。4.4 Geometry Script 与 Modeling Tools 的协作方式这两者不是替代关系而是互补的。我的工作流通常是用 Modeling Tools 手动做一个“模板”模型确定形状和比例。用 Geometry Script 读取这个模板分析它的尺寸参数。基于参数批量生成变体。比如做栏杆我先手动做一个标准栏杆段然后用 Geometry Script 读取它的包围盒尺寸沿着一条曲线批量复制并调整间距。这样既保证了单个模型的质量又实现了批量布置的效率。5. 常见问题与排查技巧实录5.1 布尔运算后网格体消失或变成碎片这是最常见的问题。原因通常有三个法线方向不一致、网格体不封闭、或者两个网格体完全没有重叠。排查步骤先用 Inspector 工具检查两个网格体的法线确保都朝外。然后检查是否有边界边开放边有的话用 Fill Holes 补上。最后确认两个网格体确实有重叠区域哪怕只有一点点。如果以上都没问题但还是出错尝试把两个网格体稍微放大或缩小一点有时候是浮点精度导致的退化。5.2 Remesh 后模型变形严重Remesh 的 Voxel 模式对有机形状效果好但对硬表面会“融化”掉锐利的边角。如果你做的是硬表面模型用 Uniform 模式并且把目标边长设小一点。另一个原因是原始网格体有非流形几何比如两个面共享一条边但方向相反。这种几何在 Remesh 时会被错误处理。用 Clean 工具先清理一遍再 Remesh。5.3 Geometry Script 在打包后不工作Geometry Script 的部分功能依赖编辑器模块打包后可能不可用。如果你需要在运行时生成网格体确保使用的是Runtime版本的 Geometry Script 节点并且在项目设置里启用了相应的运行时模块。另外动态网格体在运行时生成后需要手动调用Update来刷新碰撞和渲染数据否则你看不到生成的模型。5.4 性能问题动态网格体太多导致卡顿动态网格体的内存和计算开销比静态网格体大。如果你在场景里放了大量动态网格体编辑器会明显变卡。解决办法在编辑完成后用Accept把动态网格体转成静态网格体。如果需要在运行时保留动态性控制同时活跃的动态网格体数量远处的用静态版本替代。问题现象可能原因解决方法布尔结果错误法线方向不一致用 Normal 工具统一法线Remesh 后变形使用了 Voxel 模式处理硬表面改用 Uniform 模式Geometry Script 打包后失效使用了编辑器专用节点替换为 Runtime 版本节点编辑器卡顿动态网格体数量过多Accept 转静态或减少数量UV 拉伸严重未展 UV 或展 UV 方式不当用 Auto Unwrap 后手动调整5.5 版本差异带来的坑UE5.3 到 UE5.5 之间Modeling Tools 的菜单结构和部分参数名称有变化。比如 5.3 里叫 “Remesh” 的工具在 5.5 里可能被拆分成了 “Remesh” 和 “Simplify” 两个。如果你跟着旧教程操作找不到对应工具先检查引擎版本。Geometry Script 的 API 也在持续增加新版本会多出一些节点。建议在项目里锁定引擎版本不要频繁升级否则脚本可能需要重写。6. 我在实际项目中的工作流总结经过几个项目的磨合我现在处理网格体资产的流程基本固定下来了。拿到一个建模需求先判断是“一次性”的还是“批量”的。一次性的直接用 Modeling Tools 手动做批量性的先写 Geometry Script 脚本。手动做的时候我的顺序是形状创建搭大体块Boolean 做主要开口Remesh 清理拓扑Subdivide 增加细节密度最后 UV 和法线调整。每一步都先预览再 Accept不确定的参数先用小数值试。写脚本的时候我会先把参数抽成结构体或数据表这样改规格不用改代码。生成后的网格体统一做一次 Remesh 和 UV 处理保证资产规范一致。还有一个小技巧Modeling Mode 里的操作可以录制宏。如果你发现自己反复做同一套操作把它录下来下次一键执行。虽然不如 Geometry Script 灵活但胜在不用写代码。这套工具集最让我满意的地方是它把建模的门槛降低了。以前不会 Maya 的人做不了模型现在在引擎里拖拖拽拽就能出白模。但工具再方便拓扑意识和 UV 意识还是得有的否则做出来的东西看着能用一进光照就露馅。
安装traefik2.5：用TaoToken统一Key打通CRD与RBAC配置)
