167 lines
4.5 KiB
Markdown
167 lines
4.5 KiB
Markdown
# BladeSmith - UE5.5 打铁游戏
|
||
|
||
这是一个基于UE5.5开发的打铁游戏，使用C++实现铁锤击中铁块造成物理形变的效果。
|
||
|
||
## 系统特性
|
||
|
||
### 核心功能
|
||
- **铁块变形系统**: 使用Compute Shader实时计算铁块顶点变形
|
||
- **锤击交互**: 第一人称锤击系统，支持力度和方向检测
|
||
- **物理形变**: 基于冲击力、位置和法线的真实物理变形
|
||
- **材质系统**: 动态材质实例，实时更新变形效果
|
||
|
||
### 技术实现
|
||
- **Compute Shader**: 使用GPU并行计算顶点变形
|
||
- **双缓冲纹理**: 避免读写冲突，确保渲染稳定性
|
||
- **射线检测**: 精确的锤击碰撞检测
|
||
- **动态材质**: 实时更新变形参数
|
||
|
||
## 系统架构
|
||
|
||
### 主要组件
|
||
|
||
1. **AIronBlock** - 铁块Actor
|
||
- 管理变形纹理和Compute Shader
|
||
- 处理锤击碰撞和变形计算
|
||
- 更新动态材质参数
|
||
|
||
2. **UBladeSmithWeaponComponent** - 锤子组件
|
||
- 第一人称锤击交互
|
||
- 射线检测和碰撞处理
|
||
- 音效和动画播放
|
||
|
||
3. **FDeformationCS** - Compute Shader
|
||
- GPU并行变形计算
|
||
- 基于距离的衰减效果
|
||
- 塑性变形模拟
|
||
|
||
### 文件结构
|
||
```
|
||
Source/BladeSmith/
|
||
├── IronBlock.h/cpp # 铁块实现
|
||
├── FDeformComputeShader.h/cpp # Compute Shader
|
||
├── BladeSmithWeaponComponent.h/cpp # 锤子组件
|
||
├── BladeSmithCharacter.h/cpp # 角色类
|
||
└── BladeSmith.Build.cs # 模块配置
|
||
|
||
Shaders/Private/
|
||
└── DeformationCS.usf # Compute Shader源码
|
||
```
|
||
|
||
## 使用方法
|
||
|
||
### 1. 设置输入映射
|
||
在UE编辑器中创建以下输入动作：
|
||
- **HammerAction**: 锤击输入（建议绑定鼠标左键）
|
||
- **MoveAction**: 移动输入（WASD）
|
||
- **LookAction**: 视角输入（鼠标）
|
||
- **JumpAction**: 跳跃输入（空格）
|
||
|
||
### 2. 配置角色蓝图
|
||
1. 打开角色蓝图
|
||
2. 确保HammerComponent已正确附加
|
||
3. 设置锤子网格和动画
|
||
4. 配置输入映射上下文
|
||
|
||
### 3. 放置铁块
|
||
1. 在场景中放置IronBlock Actor
|
||
2. 确保静态网格组件已设置
|
||
3. 系统会自动初始化变形纹理
|
||
|
||
### 4. 创建材质
|
||
创建支持变形的材质，包含以下参数：
|
||
- **PositionTexture**: 顶点位置纹理
|
||
- **LocalBoundsMin/Max**: 本地边界
|
||
- **DeformationStrength**: 变形强度
|
||
|
||
## 技术细节
|
||
|
||
### Compute Shader参数
|
||
```hlsl
|
||
struct Parameters
|
||
{
|
||
float3 ImpactPoint; // 冲击点
|
||
float3 ImpactNormal; // 冲击法线
|
||
float ImpactForce; // 冲击力
|
||
float DeformationRadius; // 变形半径
|
||
float Plasticity; // 塑性系数
|
||
Texture2D InputTexture; // 输入纹理
|
||
RWTexture2D OutputTexture; // 输出纹理
|
||
};
|
||
```
|
||
|
||
### 变形算法
|
||
1. **距离计算**: 计算每个顶点到冲击点的距离
|
||
2. **衰减函数**: 使用高斯衰减模拟真实物理
|
||
3. **变形计算**: 基于法线方向和冲击力计算变形量
|
||
4. **塑性应用**: 应用塑性系数实现永久变形
|
||
|
||
### 性能优化
|
||
- **区域更新**: 只更新受影响的纹理区域
|
||
- **双缓冲**: 避免读写冲突
|
||
- **异步处理**: 在渲染线程中执行Compute Shader
|
||
- **LOD支持**: 根据距离调整计算精度
|
||
|
||
## 编译和运行
|
||
|
||
### 编译要求
|
||
- UE5.5
|
||
- Visual Studio 2022
|
||
- Windows 10/11
|
||
|
||
### 编译步骤
|
||
1. 右键点击.uproject文件
|
||
2. 选择"Generate Visual Studio project files"
|
||
3. 打开生成的.sln文件
|
||
4. 编译项目
|
||
|
||
### 运行步骤
|
||
1. 在UE编辑器中打开项目
|
||
2. 确保所有输入映射已配置
|
||
3. 在场景中放置IronBlock
|
||
4. 运行游戏并测试锤击功能
|
||
|
||
## 故障排除
|
||
|
||
### 常见问题
|
||
|
||
1. **Compute Shader不工作**
|
||
- 检查GPU驱动是否支持Compute Shader
|
||
- 确认纹理格式正确
|
||
- 查看渲染日志中的错误信息
|
||
|
||
2. **变形效果不明显**
|
||
- 调整ImpactForce参数
|
||
- 增加DeformationRadius
|
||
- 检查材质参数设置
|
||
|
||
3. **性能问题**
|
||
- 减少纹理分辨率
|
||
- 缩小更新区域
|
||
- 启用LOD系统
|
||
|
||
### 调试功能
|
||
- 启用调试绘制查看射线检测
|
||
- 使用LogTemp输出调试信息
|
||
- 检查纹理资源是否正确创建
|
||
|
||
## 扩展功能
|
||
|
||
### 可能的改进
|
||
1. **多材质支持**: 不同材质的不同变形特性
|
||
2. **温度系统**: 基于温度影响变形效果
|
||
3. **声音系统**: 更真实的锤击音效
|
||
4. **粒子效果**: 锤击时的火花和灰尘
|
||
5. **工具系统**: 不同类型的锤子和工具
|
||
|
||
### 自定义开发
|
||
- 修改Compute Shader实现不同的变形算法
|
||
- 添加新的物理参数（弹性、硬度等）
|
||
- 实现更复杂的碰撞检测
|
||
- 集成第三方物理引擎
|
||
|
||
## 许可证
|
||
|
||
本项目基于Epic Games的UE5.5开发，遵循相应的许可证条款。
|
||
|