在UE4VoxelTerrain中实时修改体素地形4种挖掘模式圆坑/方块/填充/圆柱实战教程【免费下载链接】UE4VoxelTerrainUnreal Engine 4: Smooth voxel terrian example项目地址: https://gitcode.com/gh_mirrors/ue/UE4VoxelTerrainUE4VoxelTerrain 是一个基于 Unreal Engine 4 的体素地形示例项目核心亮点是游戏运行时实时修改体素地形拿起铲子就能挖出圆坑、方块洞、圆柱隧道也能用球形工具回填地形全部修改即时生效无需进入编辑器。本文是一份面向新手的体素地形挖掘实战教程带你快速掌握 4 种挖掘模式的切换与用法。⚡ 快速上手如何运行 UE4VoxelTerrain 体素地形项目运行环境要求安装Unreal Engine 4.27主分支在 Windows 10 UE4.27.1 下测试通过安装MS Visual Studio 2022克隆仓库注意是递归克隆项目使用了 git submodulePlugins目录不能为空git clone --recursive https://gitcode.com/gh_mirrors/ue/UE4VoxelTerrain按官方说明把游戏素材Content 资源包解压到Content文件夹再用 UE4.27 打开UE4VoxelTerrain/UE4VoxelTerrain.uproject首次启动会编译体素地形着色器Transvoxel 风格的地形管线等待片刻即可进入游戏⚠️ 小提示UE4 版本已停止更新官方建议新项目使用 UE5 版本但想学习运行时体素地形修改的实现思路UE4 版本的代码结构非常清晰非常适合入门。️ 挖掘操作键位一览按键功能V切换视角俯视 / 第三人称鼠标左键俯视视角下移动角色到目标点鼠标右键使用当前工具执行挖掘/填充1~7切换工具栏中的工具选到铲子才能挖地形WASD第三人称视角下移动角色P循环切换 4 种挖掘模式键位映射定义在 DefaultInput.ini其中鼠标右键绑定为AltAction使用工具P键绑定为Test动作用于触发挖掘模式切换。更多操作说明见项目自带的 controls.md。⛏️ 4 种挖掘模式详解挖掘逻辑全部封装在AMiningTool类中UE4VoxelTerrain/Source/UE4VoxelTerrain/MiningTool.cpp。核心是一个 0~3 的模式计数器每次按下切换键就1并取模 4实现四种模式的无限循环void ToggleToolMode() { DiggingToolMode; DiggingToolMode DiggingToolMode % 4; };四种模式各自调用地形控制器上不同的修改接口对照表如下模式效果调用接口关键参数0圆坑挖掘 ️DigTerrainRoundHole半径 801方块挖掘 DigTerrainCubeHole边长 110网格吸附 1002球形填充 FillTerrainRound半径 60材质 ID 1泥土3圆柱挖掘 ️DigCylinder半径 100长度 100沿朝向模式 0圆坑挖掘默认模式瞄准地面按鼠标右键会在命中点挖出一个半径 80 的球形坑。这是最直观的打洞操作适合挖水坑、坑洞等自然地貌。模式 1方块挖掘网格吸附挖掘位置会先经过SnapToGrid函数对齐到 100 单位的整数网格上再挖一个边长 110 的立方体洞。对齐网格的意义在于挖出的洞口边缘整齐、体积固定方便后续搭建方块建筑或放置预制物件是体素建筑玩法的基础。模式 2球形填充与挖掘相反这个模式以半径 60 的球体向地形中填充泥土材质 ID 1可以用来填平自己挖的坑、隆起小山丘实现先挖后填的地形改造闭环。模式 3圆柱挖掘这是最有挖矿感的模式以半径 100、长度 100 的圆柱体沿着角色朝向挖出一条隧道。代码通过HelpDigCylinder根据角色当前旋转方向计算出圆柱的两端点再调用DigCylinder完成切割。配合V键切换视角可以边看边挖出地下通道。 挖掘体验细节实时预览框与材质音效好的挖掘手感离不开即时反馈这个 Demo 做了两件小事半透明预览框鼠标悬停在地形上时OnTracePlayerActionPoint会实时画出挖掘范围的调试图形——圆坑/填充显示球体、方块显示对齐网格的 Box、圆柱显示方向一致的 Cylinder颜色区分挖掘白色与填充绿色材质音效挖掘时程序会读取命中面的材质 ID判定是岩石还是土壤分别播放DiggingRockSound/DiggingSoilSound两种音效挖石头和挖泥土的手感完全不同这两段代码都在UE4VoxelTerrain/Source/UE4VoxelTerrain/MiningTool.cpp中非常适合作为学习地形修改 视觉反馈的实现范例。️ 进阶玩法挖洞直通地下洞穴项目内置了程序化生成的地下洞穴系统当角色 Z 坐标低于 -500 时AUE4VoxelTerrainPlayerController::PlayerTick会自动切换SetCaveMode(true)进入洞穴光照与氛围。实用技巧用**模式 3圆柱挖掘**在地面朝下钻一个竖井就能从地表一路挖进洞穴层再用模式 1 把洞口修齐用模式 2 回填多余的碎土——一套完整的地表-地下地形编辑流程。 核心源码导航想深入理解实现建议按这个顺序阅读模块路径说明挖掘工具UE4VoxelTerrain/Source/UE4VoxelTerrain/MiningTool.cpp4 种挖掘模式、网格吸附、预览框、音效挖掘工具声明UE4VoxelTerrain/Source/UE4VoxelTerrain/MiningTool.hToggleToolMode模式切换逻辑玩家控制器UE4VoxelTerrain/Source/UE4VoxelTerrain/UE4VoxelTerrainPlayerController.cpp右键使用工具、洞穴模式判定键位配置UE4VoxelTerrain/Config/DefaultInput.ini输入动作映射地形插件UE4VoxelTerrain/Plugins/UnrealSandboxTerrainDigTerrainRoundHole等地形修改接口git submodule地形生成UE4VoxelTerrain/Source/UE4VoxelTerrain/TerrainGenerator.cpp程序化地形生成入口❓ 常见问题Q为什么按右键没有反应确认当前选中的是铲子工具按1选择且鼠标指向的是地形而不是天空或建筑。Q方块模式挖出来的洞位置不对方块模式会吸附到 100 单位网格命中点离网格中心较远时挖出的位置会跳到最近的格点上这是SnapToGrid的预期行为。Q修改后的地形会保存吗本 Demo 侧重运行时实时修改的演示地形数据保存在内存中适合学习体素地形修改的管线挖除 → 局部重建网格 → 更新碰撞。从挖一个圆坑到钻一条地下隧道UE4VoxelTerrain 用不到 200 行的挖掘工具代码完整演示了 UE4 体素地形实时修改的核心流程。动手试试 4 种模式的组合玩法你会发现在体素世界里当建筑工远比自己想象的有趣 ⛏️【免费下载链接】UE4VoxelTerrainUnreal Engine 4: Smooth voxel terrian example项目地址: https://gitcode.com/gh_mirrors/ue/UE4VoxelTerrain创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考