|
|
||
|---|---|---|
| .claude | ||
| .vscode | ||
| Assets | ||
| Packages | ||
| ProjectSettings | ||
| Tools | ||
| docs | ||
| openspec | ||
| skills | ||
| 数据表 | ||
| .gitattributes | ||
| .gitignore | ||
| .vsconfig | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| README.md | ||
README.md
VampireLike
这是一个学习项目
VampireLike 是一个基于 Unity 2022.3 LTS 的动作生存类项目,旨在实践以下技术要点:
- GameFramework 框架的组件化设计 — 理解如何通过
GameEntry.<Component>解耦各模块(事件 Entity/UI/Procedure/Resource 等) - UI 架构的分层设计 — 实践 Controller / UseCase / View 三层分离,理解"context"作为数据桥梁的作用
- 数据驱动设计 — 通过 DataTable(DRBullet、DREnemy、DRWeapon 等)实现配置与代码的分离
- 数据导向(Data-Oriented)模拟系统 —
SimulationWorld展示了如何将 ECS 思路应用于 Unity:SimData 结构体 → Job 并行处理 → 结果提交 → 表现层同步 - Entity-Component 模式 — 实体(Player/Enemy/Weapon)与数据(EntityData)分离,配合对象池实现高效Spawn/Despawn
- 技能系统设计 — StatModifier(加减/乘算)的组合、AttackComponent 的技能释放流程
- Target Selector 模式 — 武器通过
ITargetSelector接口支持多种目标选择策略(最近/最低血量/最高血量)
项目结构
Assets/
├── GameFramework/ # 通用框架(来自 GameFramework.cn)
│ └── Scripts/Runtime/ # Event/Entity/UI/Procedure/Resource 等组件
├── GameMain/ # 游戏业务代码
│ ├── Scripts/
│ │ ├── Base/ # GameEntry 入口
│ │ ├── Components/ # 游戏组件(Movement/Attack/Health/Stat...)
│ │ ├── CustomEvent/ # 自定义事件
│ │ ├── DataTable/ # DR* 数据行定义
│ │ ├── Definition/ # 枚举、结构体、常量
│ │ ├── Entity/ # 实体逻辑与数据
│ │ ├── Procedure/ # 流程状态机
│ │ ├── Simulation/ # 数据导向模拟层
│ │ ├── UI/ # UI(Controller/UseCase/View 分离)
│ │ └── CustomComponent/ # 自定义功能组件
│ ├── Scenes/ # Menu/Main/Game 场景
│ └── DataTables/ # 数据表资源
├── Launcher.unity # 启动场景
├── Plugins/ # 第三方插件(DOTween)
└── Tests/ # 单元测试
技术栈
- Unity 2022.3.62f3c1 LTS
- Input System(
com.unity.inputsystem) - Universal Render Pipeline(
com.unity.render-pipelines.universal) - TextMeshPro(
com.unity.textmeshpro) - DOTween(动画)
- Unity Test Framework(NUnit)
- Newtonsoft.Json(配置序列化)
运行方式
- Unity Hub 打开项目根目录
- 确认 Unity 版本为
2022.3.62f3c1 - 打开
Assets/Launcher.unity并 Play
CLI 方式:
Unity -projectPath .
代码规范
- C# 4 空格缩进,K&R 大括号风格
- 单文件单主类型,文件名与类型名一致
PascalCase公有成员,camelCase局部变量- Inspector 暴露用
[SerializeField] private - 保持
.meta文件与资源同步
测试
# EditMode 测试
Unity -batchmode -projectPath . -runTests -testPlatform editmode -quit -logFile Logs/editmode-tests.log
测试目录:Assets/Tests/、Assets/Tests/Simulation/EditMode/、Assets/Tests/Simulation/PlayMode/
协作
- 提交信息使用简短祈使句,建议包含模块上下文(如
UI: Fix shop item refresh logic) - PR 包含变更摘要、测试说明、关联任务/Issue
- UI/视觉改动附上截图或录屏