# 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*