108 lines
2.6 KiB
Markdown
108 lines
2.6 KiB
Markdown
# 系统架构
|
||
|
||
## 整体架构
|
||
|
||
项目采用组件化架构，基于 Cocos Creator 3.8.7 的实体组件系统（ECS）设计。
|
||
|
||
## 核心模块
|
||
|
||
### 1. 寻路系统
|
||
- **TiledMapPathfinder** (`assets/scripts/TiledMapPathfinder.ts`)
|
||
- 瓦片地图寻路管理器
|
||
- 负责世界坐标与瓦片坐标转换
|
||
- 集成A*算法进行路径计算
|
||
- 提供路径平滑功能
|
||
|
||
- **AStarPathfinding** (`assets/scripts/AStarPathfinding.ts`)
|
||
- 纯A*算法实现
|
||
- 支持8方向移动
|
||
- 包含对角线移动的墙角检测
|
||
- 可配置的移动代价
|
||
|
||
### 2. 玩家控制系统
|
||
- **PlayerController** (`assets/scripts/PlayerController.ts`)
|
||
- 核心游戏逻辑控制器（1455行）
|
||
- 处理触摸输入和玩家移动
|
||
- 管理动画状态切换
|
||
- 实现战斗逻辑
|
||
- 处理道具收集和升级系统
|
||
- UI弹窗管理
|
||
|
||
### 3. 相机系统
|
||
- **CameraFollow** (`assets/scripts/CameraFollow.ts`)
|
||
- 平滑相机跟随
|
||
- 地图边界限制
|
||
- 可配置的跟随速度和偏移
|
||
- 支持初始焦点设置
|
||
|
||
### 4. 游戏管理
|
||
- **Manager** (`assets/scripts/Manager.ts`)
|
||
- 游戏初始化管理
|
||
- 组件间协调
|
||
- 地图信息管理
|
||
|
||
- **Start** (`assets/scripts/Start.ts`)
|
||
- 资源分包加载
|
||
- 场景跳转管理
|
||
|
||
### 5. 辅助组件
|
||
- **Shadow2D** (`assets/scripts/Shadow2D.ts`)
|
||
- 2D阴影效果渲染
|
||
- **PathfindingTest** (`assets/scripts/PathfindingTest.ts`)
|
||
- 寻路系统测试工具
|
||
|
||
## 数据流
|
||
|
||
```
|
||
用户触摸输入 → PlayerController → TiledMapPathfinder → AStarPathfinding
|
||
↓
|
||
动画系统 → 相机跟随 → UI更新
|
||
↓
|
||
碰撞检测 → 战斗逻辑 → 游戏状态更新
|
||
```
|
||
|
||
## 关键设计模式
|
||
|
||
### 1. 组件模式
|
||
- 利用Cocos Creator的组件系统实现模块化
|
||
- 每个功能独立封装为组件
|
||
|
||
### 2. 观察者模式
|
||
- 碰撞事件监听
|
||
- 动画完成事件处理
|
||
|
||
### 3. 状态模式
|
||
- 玩家动画状态管理
|
||
- 游戏状态控制
|
||
|
||
## 关键实现路径
|
||
|
||
### 寻路流程
|
||
1. 触摸输入转换世界坐标
|
||
2. 世界坐标转瓦片坐标
|
||
3. A*算法计算路径
|
||
4. 路径平滑处理
|
||
5. 瓦片坐标转世界坐标
|
||
6. 执行移动动画
|
||
|
||
### 战斗流程
|
||
1. 碰撞检测触发
|
||
2. 玩家对齐到攻击位置
|
||
3. 播放攻击动画
|
||
4. 比较生命值
|
||
5. 执行胜负逻辑
|
||
6. 更新游戏状态
|
||
|
||
### 升级流程
|
||
1. 击败特定怪物触发
|
||
2. 道具飞行动画
|
||
3. 播放升级特效
|
||
4. 切换动画资源
|
||
5. 更新玩家状态
|
||
|
||
## 性能考虑
|
||
|
||
- 寻路算法使用开放列表和关闭列表优化
|
||
- 动画切换避免重复播放
|
||
- 对象池管理（待实现）
|
||
- 资源分包加载减少初始加载时间 |