158 lines
4.6 KiB
Markdown
158 lines
4.6 KiB
Markdown
# TG_ARPG
|
||
|
||
一个基于虚幻引擎5（UE5）开发的第三人称动作角色扮演游戏（ARPG）项目。
|
||
|
||
## 项目概述
|
||
|
||
- **引擎版本**: UE5（使用源码引擎）
|
||
- **项目类型**: 第三人称ARPG
|
||
- **渲染特性**: Lumen全局光照、虚拟阴影贴图、DX12
|
||
- **网络**: Steam在线子系统支持
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
TG_ARPG/
|
||
├── Binaries/ # 编译生成的二进制文件
|
||
├── Config/ # 配置文件
|
||
│ ├── DefaultEngine.ini # 引擎配置
|
||
│ ├── DefaultGame.ini # 游戏配置
|
||
│ ├── DefaultInput.ini # 输入配置
|
||
│ └── DefaultGameplayTags.ini # Gameplay标签配置
|
||
├── Content/ # 游戏内容资源
|
||
│ ├── Blueprint/ # 蓝图资源
|
||
│ ├── Characters/ # 角色资源
|
||
│ ├── Maps/ # 关卡地图
|
||
│ ├── UI/ # 用户界面
|
||
│ ├── Art/ # 美术资源
|
||
│ ├── Audio/ # 音频资源
|
||
│ ├── VFX/ # 视觉特效资源
|
||
│ └── ... # 其他资源目录
|
||
├── Plugins/ # 插件目录
|
||
├── Source/ # C++源代码
|
||
│ ├── TG_ARPG/ # 主游戏模块
|
||
│ ├── KawaiiPhysics/ # 物理模拟插件
|
||
│ └── KawaiiPhysicsEd/ # 物理模拟编辑器扩展
|
||
├── Saved/ # 运行时保存数据
|
||
├── Intermediate/ # 中间编译文件
|
||
└── DerivedDataCache/ # 派生数据缓存
|
||
```
|
||
|
||
## 核心模块
|
||
|
||
### 主游戏模块 (TG_ARPG)
|
||
|
||
位于 `Source/TG_ARPG/`，包含游戏核心逻辑：
|
||
|
||
- **能力系统组件**: `TGAbilitySystemComponent` - GAS能力系统
|
||
- **属性集**: `TGAttributeSet` - 角色属性管理
|
||
- **游戏能力**: `TGGameplayAbility` - 技能/能力基类
|
||
- **控制器**: `TG_ControllerBase` - 玩家控制器基类
|
||
- **敌人基类**: `TG_ARPGEnemyBase` - 敌人角色基类
|
||
- **UI系统**: `TGCommonActivatableWidget`, `TGHUDLayout` - CommonUI集成
|
||
|
||
### 集成的插件
|
||
|
||
#### 官方插件
|
||
- **GameplayAbilities** - 游戏能力系统（GAS）
|
||
- **CommonUI** - 通用UI框架
|
||
- **CommonGame** - 游戏框架扩展
|
||
- **CommonUser** - 用户管理
|
||
- **TargetingSystem** - 目标锁定系统
|
||
- **AudioModulation** - 音频调制
|
||
|
||
#### 第三方插件
|
||
- **TengenLibs** - 天元工具库
|
||
- **DBTween** - 动画缓动库
|
||
- **ElectronicNodes** - 蓝图节点美化
|
||
- **AsyncLoadingScreen** - 异步加载屏幕
|
||
- **CommonLoadingScreen** - 通用加载屏幕
|
||
- **ModelContextProtocol** - 模型上下文协议
|
||
|
||
#### 自定义插件
|
||
- **KawaiiPhysics** - 可爱物理（布料/头发模拟）
|
||
- **AdvancedSessions** - 高级会话管理
|
||
- **AdvancedSteamSessions** - Steam会话管理
|
||
- **ViveMocapKit** - 动作捕捉
|
||
- **VFXToolbox** - 特效工具箱
|
||
|
||
## 技术特性
|
||
|
||
### 渲染设置
|
||
- **全局光照**: Lumen
|
||
- **反射**: Lumen反射
|
||
- **阴影**: 虚拟阴影贴图（VSM）
|
||
- **抗锯齿**: TSR（Temporal Super Resolution）
|
||
- **图形API**: DirectX 12 (SM6)
|
||
|
||
### 输入系统
|
||
- **输入框架**: Enhanced Input + CommonInput
|
||
- **支持设备**: 键盘鼠标、手柄（PS4/PS5/Xbox/Switch）
|
||
|
||
### 网络功能
|
||
- **在线子系统**: Steam
|
||
- **网络驱动**: Steam网络连接
|
||
- **会话管理**: 支持Steam多人游戏
|
||
|
||
### 碰撞配置
|
||
自定义碰撞通道：
|
||
- **NPC** - 非玩家角色
|
||
- **Missile** - 投射物
|
||
- **Raidar** - 雷达检测
|
||
- **RaidarTrace** - 雷达追踪
|
||
|
||
## 开发工具
|
||
|
||
### 脚本工具
|
||
- `启动TG_ARPG.bat` - 项目启动脚本
|
||
- `UE插件版本更新工具.ps1` - 插件版本更新
|
||
- `UE插件版本自动同步工具.ps1` - 插件版本同步
|
||
|
||
### IDE配置
|
||
- `.vsconfig` - Visual Studio配置
|
||
- `.vscode/` - VS Code配置
|
||
- `.idea/` - JetBrains IDE配置
|
||
|
||
## 插件升级须知
|
||
|
||
1. 插件编译必须使用**源码引擎**
|
||
2. Dll文件需添加到项目Plugins目录下
|
||
|
||
## 项目配置
|
||
|
||
### 默认地图
|
||
- **游戏默认地图**: Login
|
||
- **编辑器启动地图**: Entry
|
||
- **过渡地图**: Transition_Level
|
||
- **服务器默认地图**: Login
|
||
|
||
### 游戏模式
|
||
- **默认游戏模式**: TG_GameModeMainMenu
|
||
- **游戏实例类**: TG_GameInstance
|
||
|
||
## 资源组织结构
|
||
|
||
### 美术资源
|
||
- **角色**: Paragon系列角色（Aurora, Fey, Greystone等）
|
||
- **环境**: TokyoStylizedEnvironment, NewYorkCity
|
||
- **特效**: 多个VFX包（Niagara效果集合）
|
||
- **动画**: Frank系列动画包
|
||
|
||
### 音频资源
|
||
- 音效库
|
||
- 背景音乐
|
||
|
||
### UI资源
|
||
- CommonUI输入配置
|
||
- 平台特定控制器数据
|
||
- 材质和贴图
|
||
|
||
## 版本控制
|
||
|
||
- 使用Git进行版本控制
|
||
- `.gitignore` 已配置UE项目标准忽略规则
|
||
|
||
---
|
||
|
||
*最后更新: 2026-05-17*
|