1. 项目准备与环境搭建
在开始构建水下运动系统之前，我们需要先准备好基础环境。打开UE5.2创建一个空白项目，建议选择第三人称模板作为起点。这里有个小技巧：我习惯在创建项目时就勾选"包含初学者内容包"，这样后续查找测试资源会更方便。
进入编辑器后，第一步是激活Water插件。很多新手会忽略这个步骤，导致后面找不到水体相关功能。具体操作路径是：编辑→插件→搜索"Water"→勾选启用。重启编辑器后，记得点击"将项目条目添加到DefaultEngine.ini"这个选项，这是确保水体功能正常工作的关键。
场景搭建时，我建议先删除默认地面，然后使用地形工具创建15x15四边形的基础地形。把"Water Body Lake"拖入场景后，一定要设置碰撞预设为"WaterBodyCollision"。实测中发现，如果漏掉这个设置，后续的角色碰撞检测会出问题。
关于角色资源，Mixamo是个不错的选择。我们需要准备四种基础动画：
- Idle（站立待机）
- Running（陆地奔跑）
- Swimming（游泳动作）
- Treading（水中踩水）
导入时有个细节要注意：当导入动画序列时，记得取消勾选"导入网格体"选项，这样可以避免重复导入角色模型。我遇到过因为勾选这个选项导致骨骼错乱的情况，排查了半天才发现问题所在。
2. 角色移动系统实现
2.1 创建混合空间
首先为角色创建两个关键的混合空间：
- BS1D_Idle_Run：控制陆地移动
- BS1D_Tread_Swim：控制水中运动
设置BS1D_Idle_Run时，建议将水平坐标命名为Speed，范围设为0-200。这里有个实用技巧：权重速度设为4可以让动画过渡更平滑。把站立动画放在最左侧（Speed=0），跑步动画放在最右侧（Speed=200），这样就能根据角色速度自动混合两种状态。
水中混合空间的设置略有不同。我发现将最大轴值设为300效果更好，因为游泳动作通常比跑步更快。如果觉得游泳动画速度不合适，可以直接双击动画资源，在详情面板调整"比率范围"参数。这个参数我一般设为1.5-2之间，具体取决于动画本身的速度。
2.2 动画蓝图配置
创建动画蓝图ABP_Character时，关键是要正确获取角色引用和速度值。我习惯在"事件开始播放"时就获取角色引用，然后在"更新动画"时持续获取速度值。这里有个易错点：一定要记得将引用转换为有效引用，否则运行时可能会报空指针错误。
在动画图表中，我们需要根据角色状态决定使用哪个混合空间。我的做法是：
- 获取角色速度→传给BS1D_Idle_Run
- 获取游泳状态→决定是否切换到BS1D_Tread_Swim
最后别忘了在角色蓝图中指定动画蓝图类。我遇到过好几次忘记设置，结果调试半天发现动画没生效的情况。
3. 游泳系统实现
3.1 水体交互逻辑
首先创建蓝图接口BPI_Swiming，定义EnterWater和ExitWater两个函数。这个设计模式可以让水体与角色的交互更清晰。为水体创建专属蓝图BP_WaterBodyLake，在其中实现重叠事件检测：
OnActorBeginOverlap → 调用EnterWater OnActorEndOverlap → 调用ExitWater在角色蓝图中，需要添加几个关键变量：
- IsInWater（布尔）：是否在水中
- WaterDepthZ（浮点）：当前水深
- SwimSpeed（浮点）：游泳速度，建议设为500
实现EnterWater逻辑时，我通常会做三层判断：
- 完全在水中：设置物理体积为水，运动模式为游泳
- 部分浸入：保持行走但应用水的物理效果
- 完全出水：恢复默认设置
3.2 游泳动画调整
很多新手会遇到角色在水中位置不对的问题。解决方法其实很简单：打开Treading_Water动画序列，调整"导入平移"参数后重新导入。我建议一边微调参数一边实时预览，直到角色浮在水面的位置看起来自然为止。
在动画蓝图中，需要添加游泳状态判断逻辑。获取角色移动组件的"正在游泳"状态，将其转换为变量后用于控制动画切换。这里有个细节：游泳状态变化时最好添加一个短暂的混合过渡，这样看起来会更自然。
4. 潜水与上浮功能
4.1 输入控制设置
复制原有的移动输入映射，创建两个新映射：
- IA_SwimmingUp（上浮）
- IA_SwimmingDown（下潜）
建议使用布尔型输入，这样可以通过按键状态直接控制上下移动。在默认输入映射上下文(IMC_Default)中添加这两个新映射，我习惯将它们绑定到键盘的PageUp/PageDown键。
4.2 物理实现
在角色蓝图中实现潜水逻辑时，关键是要控制好Z轴移动。我的做法是：
- 检测下潜输入→给角色施加向下的力
- 检测上浮输入→施加向上的力
- 同时考虑水的浮力影响
这里有个常见问题：角色会不受控地浮出水面。解决方法是在颈部骨骼添加插槽，然后向上发射射线检测水面位置。具体步骤：
- 在颈部骨骼添加插槽
- 创建新的碰撞通道Swimming
- 每帧从插槽位置向上发射50cm射线
- 如果检测到水面则禁止继续上浮
4.3 水体碰撞设置
别忘了在水体蓝图BP_WaterBodyLake中设置碰撞响应。将碰撞预设设为Custom后，确保Swimming通道的响应设置为"阻挡"。这样射线检测才能正确工作。调试阶段可以开启线条绘制，方便观察检测结果。
5. 系统优化与问题排查
5.1 性能优化
当角色在水中时，可以适当降低一些非关键功能的更新频率。比如：
- 减少水中时的动画更新频率
- 优化射线检测的间隔
- 简化水中的物理计算
我发现在角色蓝图中添加一个"水中状态"的事件分发器很有用，其他系统可以监听这个事件来调整自己的行为。
5.2 常见问题解决
浮力不稳定：检查角色质量设置和水的浮力参数是否匹配。我一般会把角色质量设为80kg左右，水的密度保持默认。
游泳速度异常：确认角色移动组件的"制动游泳速度"设置是否正确。实测500-600是比较合理的范围。
动画切换卡顿：检查动画蓝图中的混合时间设置。0.2-0.3秒的混合时间通常效果不错。
5.3 扩展功能建议
完成基础功能后，可以考虑添加这些增强体验的功能：
- 水中呼吸系统（氧气量显示）
- 不同深度的水压效果
- 游泳时的水花粒子效果
- 水下视角的视觉效果（如光线折射）
这些年在做水下系统时，最大的体会是一定要亲自多测试。每个水域场景的特性都不同，需要根据实际效果反复调整参数。特别是在处理角色与水面交互时，细微的参数变化都可能影响最终体验。建议先在简单场景中验证核心功能，再逐步扩展到复杂环境。
