TG_ARPG/README.md

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