392 lines
9.1 KiB
Markdown
392 lines
9.1 KiB
Markdown
|
# NLD项目架构文档
|
|||
|
|
|
|||
|
|
## 1. 项目概述
|
|||
|
|
|
|||
|
|
### 1.1 游戏类型
|
|||
|
|
- 即时制战棋游戏
|
|||
|
|
- 多系统交互的复杂游戏架构
|
|||
|
|
- 支持单人剧情、PVP对战和军团合作玩法
|
|||
|
|
|
|||
|
|
### 1.2 技术栈
|
|||
|
|
- 开发引擎：Unity
|
|||
|
|
- 开发语言：C#
|
|||
|
|
- AI框架：Behavior Designer (行为树)
|
|||
|
|
- 网络：支持多人在线对战
|
|||
|
|
|
|||
|
|
### 1.3 核心玩法
|
|||
|
|
- 即时战棋对战
|
|||
|
|
- 军团协作系统
|
|||
|
|
- 营地建设养成
|
|||
|
|
- PVP竞技对战
|
|||
|
|
- 剧情故事体验
|
|||
|
|
|
|||
|
|
## 2. 系统架构
|
|||
|
|
|
|||
|
|
### 2.1 核心系统关系
|
|||
|
|
```mermaid
|
|||
|
|
graph TD
|
|||
|
|
A[Game Core] --> B[Battle System]
|
|||
|
|
A --> C[Story System]
|
|||
|
|
A --> D[Camp System]
|
|||
|
|
A --> E[Legion System]
|
|||
|
|
A --> F[PVP System]
|
|||
|
|
|
|||
|
|
B --> B1[Unit System]
|
|||
|
|
B --> B2[Area System]
|
|||
|
|
B --> B3[Skill System]
|
|||
|
|
B --> B4[Battle UI]
|
|||
|
|
|
|||
|
|
C --> C1[Timeline Track]
|
|||
|
|
C --> C2[Story Manager]
|
|||
|
|
C --> C3[I18N]
|
|||
|
|
|
|||
|
|
D --> D1[Camp Building]
|
|||
|
|
D --> D2[Camp Units]
|
|||
|
|
D --> D3[Camp Edit]
|
|||
|
|
|
|||
|
|
E --> E1[Legion Manager]
|
|||
|
|
E --> E2[Mercenary]
|
|||
|
|
E --> E3[Legion Data]
|
|||
|
|
|
|||
|
|
F --> F1[PVP Manager]
|
|||
|
|
F --> F2[Team Prepare]
|
|||
|
|
F --> F3[Defender System]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 3. 核心系统详解
|
|||
|
|
|
|||
|
|
### 3.1 战斗系统
|
|||
|
|
战斗系统是游戏的核心玩法系统，采用即时制战棋玩法。战斗系统通过事件驱动机制与其他系统交互，支持多种单位类型（角色、载具、建筑等）的即时战斗。
|
|||
|
|
|
|||
|
|
主要特点：
|
|||
|
|
- 即时制战斗：所有单位同时行动，不受回合限制
|
|||
|
|
- 六边形网格：基于TGS(TerrainGridSystem)的地形系统
|
|||
|
|
- AI控制：使用Behavior Designer实现的行为树AI
|
|||
|
|
- 状态机：使用FSM管理战斗、准备等不同状态
|
|||
|
|
|
|||
|
|
关键类：
|
|||
|
|
- LevelStateBattle: 战斗状态管理
|
|||
|
|
- GameUnitManager: 单位管理
|
|||
|
|
- AreaManager: 区域管理
|
|||
|
|
- SkillManager: 技能管理
|
|||
|
|
|
|||
|
|
#### 3.1.1 单位系统
|
|||
|
|
```mermaid
|
|||
|
|
graph TD
|
|||
|
|
A[GameUnitManager] --> B[PrepareUnits]
|
|||
|
|
A --> C[InfightUnits]
|
|||
|
|
A --> D[DeadUnits]
|
|||
|
|
A --> E[CharacterManager]
|
|||
|
|
A --> F[VehicleManager]
|
|||
|
|
A --> G[SummonManager]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
主要职责：
|
|||
|
|
- 单位生命周期管理
|
|||
|
|
- 战斗中的单位状态同步
|
|||
|
|
- 单位类型的差异化处理
|
|||
|
|
- AI行为控制
|
|||
|
|
|
|||
|
|
#### 3.1.2 区域系统
|
|||
|
|
```mermaid
|
|||
|
|
graph TD
|
|||
|
|
A[AreaManager] --> B[MoveArea]
|
|||
|
|
A --> C[AttackArea]
|
|||
|
|
A --> D[SkillArea]
|
|||
|
|
A --> E[BoardView]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
主要职责：
|
|||
|
|
- 六边形网格管理
|
|||
|
|
- 移动区域计算
|
|||
|
|
- 攻击范围显示
|
|||
|
|
- 技能影响区域
|
|||
|
|
|
|||
|
|
#### 3.1.3 技能系统
|
|||
|
|
- 技能配置管理
|
|||
|
|
- 技能效果实现
|
|||
|
|
- 技能目标选择
|
|||
|
|
- 技能动画表现
|
|||
|
|
|
|||
|
|
### 3.2 军团系统（Legion System）
|
|||
|
|
```mermaid
|
|||
|
|
graph TD
|
|||
|
|
A[Legion System] --> B[Legion Management]
|
|||
|
|
A --> C[Mercenary System]
|
|||
|
|
A --> D[Legion Battle]
|
|||
|
|
B --> B1[Member Management]
|
|||
|
|
B --> B2[Resource Management]
|
|||
|
|
B --> B3[Task System]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
主要职责：
|
|||
|
|
- 军团成员管理
|
|||
|
|
- 军团任务系统
|
|||
|
|
- 军团战玩法
|
|||
|
|
- 佣兵系统
|
|||
|
|
- 资源管理
|
|||
|
|
|
|||
|
|
### 3.3 营地系统（Camp System）
|
|||
|
|
营地系统提供了玩家基地建设和资源管理的功能。使用网格化的布局系统，支持建筑放置和升级。
|
|||
|
|
|
|||
|
|
关键特性：
|
|||
|
|
- 网格布局：自由的建筑布置系统
|
|||
|
|
- 建筑功能：不同建筑提供不同的功能和加成
|
|||
|
|
- 资源管理：管理各类资源的产出和消耗
|
|||
|
|
- 营地防守：设置防守布局，应对PVP挑战
|
|||
|
|
|
|||
|
|
数据管理：
|
|||
|
|
- Camp：核心管理类，负责营地数据和逻辑
|
|||
|
|
- CampManager：管理所有玩家营地
|
|||
|
|
- CampUnit：营地内的功能单位
|
|||
|
|
```mermaid
|
|||
|
|
graph TD
|
|||
|
|
A[Camp System] --> B[Building Management]
|
|||
|
|
A --> C[Unit Arrangement]
|
|||
|
|
A --> D[Resource Production]
|
|||
|
|
B --> B1[Building Types]
|
|||
|
|
B --> B2[Building Functions]
|
|||
|
|
C --> C1[Unit Placement]
|
|||
|
|
C --> C2[Unit Functions]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
主要职责：
|
|||
|
|
- 建筑建造与升级
|
|||
|
|
- 单位布置管理
|
|||
|
|
- 资源产出系统
|
|||
|
|
- 营地编辑功能
|
|||
|
|
|
|||
|
|
### 3.4 PVP系统（Player VS Player）
|
|||
|
|
PVP系统实现了玩家之间的对战功能。包括排位赛、匹配系统等竞技玩法。
|
|||
|
|
|
|||
|
|
关键模块：
|
|||
|
|
- 匹配系统：基于分数的玩家匹配
|
|||
|
|
- 战斗准备：队伍编组、战术布置
|
|||
|
|
- 排位系统：段位划分和奖励发放
|
|||
|
|
- 录像回放：战斗记录和回放功能
|
|||
|
|
|
|||
|
|
实现细节：
|
|||
|
|
- PrepareTeamManager：队伍准备管理
|
|||
|
|
- PVPManager：核心玩法控制
|
|||
|
|
- PVPDefenderData：防守数据管理
|
|||
|
|
```mermaid
|
|||
|
|
graph TD
|
|||
|
|
A[PVP System] --> B[Match Making]
|
|||
|
|
A --> C[Battle Preparation]
|
|||
|
|
A --> D[Defense Setup]
|
|||
|
|
B --> B1[Rank System]
|
|||
|
|
B --> B2[Reward System]
|
|||
|
|
C --> C1[Team Formation]
|
|||
|
|
C --> C2[Strategy Setting]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
主要职责：
|
|||
|
|
- 匹配系统
|
|||
|
|
- 排位系统
|
|||
|
|
- 防守阵容设置
|
|||
|
|
- 战斗准备
|
|||
|
|
- 奖励发放
|
|||
|
|
|
|||
|
|
### 3.5 剧情系统（Story System）
|
|||
|
|
剧情系统使用Timeline实现剧情演出，支持分支剧情和多语言。
|
|||
|
|
|
|||
|
|
关键特性：
|
|||
|
|
- Timeline控制：使用Unity Timeline管理剧情演出
|
|||
|
|
- 多语言支持：完整的I18N系统
|
|||
|
|
- 分支系统：支持剧情分支选择
|
|||
|
|
- 过场动画：CG和过场动画的播放控制
|
|||
|
|
|
|||
|
|
关键类：
|
|||
|
|
- StoryManager：剧情管理器
|
|||
|
|
- TimelineTrackWrapper：Timeline轨道封装
|
|||
|
|
- DialogueSystem：对话系统
|
|||
|
|
|
|||
|
|
实现机制：
|
|||
|
|
- 使用ScriptableObject存储剧情数据
|
|||
|
|
- 事件驱动的剧情触发系统
|
|||
|
|
- 支持存档和读档功能
|
|||
|
|
```mermaid
|
|||
|
|
graph TD
|
|||
|
|
A[Story System] --> B[Story Timeline]
|
|||
|
|
A --> C[Dialogue System]
|
|||
|
|
A --> D[Cutscene System]
|
|||
|
|
B --> B1[Event Trigger]
|
|||
|
|
B --> B2[Story Progress]
|
|||
|
|
C --> C1[Character Dialogue]
|
|||
|
|
C --> C2[Choice System]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
主要职责：
|
|||
|
|
- 剧情进度管理
|
|||
|
|
- 对话系统
|
|||
|
|
- 剧情动画
|
|||
|
|
- 过场演出
|
|||
|
|
- 多语言支持
|
|||
|
|
|
|||
|
|
### 3.6 UI系统
|
|||
|
|
```mermaid
|
|||
|
|
graph TD
|
|||
|
|
A[UI System] --> B[Battle Related]
|
|||
|
|
A --> C[Character Related]
|
|||
|
|
A --> D[System Related]
|
|||
|
|
|
|||
|
|
B --> B1[LevelFight]
|
|||
|
|
B1 --> B11[BattleUI]
|
|||
|
|
B1 --> B12[FightReady]
|
|||
|
|
B1 --> B13[FightSceneUI]
|
|||
|
|
|
|||
|
|
C --> C1[Team]
|
|||
|
|
C --> C2[Character]
|
|||
|
|
C --> C3[Vehicle]
|
|||
|
|
|
|||
|
|
D --> D1[Common]
|
|||
|
|
D --> D2[Settings]
|
|||
|
|
D --> D3[Shop]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
主要职责：
|
|||
|
|
- 战斗界面管理
|
|||
|
|
- 系统界面控制
|
|||
|
|
- 角色相关界面
|
|||
|
|
- 商店系统界面
|
|||
|
|
- 通用UI组件
|
|||
|
|
|
|||
|
|
## 4. 系统交互
|
|||
|
|
|
|||
|
|
### 4.0 事件系统（Event System）
|
|||
|
|
事件系统是整个游戏的核心通信机制，采用观察者模式实现。
|
|||
|
|
|
|||
|
|
关键特性：
|
|||
|
|
- 事件注册与分发
|
|||
|
|
- 支持异步事件
|
|||
|
|
- 事件优先级管理
|
|||
|
|
- 自动事件清理
|
|||
|
|
|
|||
|
|
实现方式：
|
|||
|
|
```csharp
|
|||
|
|
// 事件注册
|
|||
|
|
EventManager.Instance.Register(EventName.INFIGHT_UNIT_DEAD, OnUnitDead);
|
|||
|
|
|
|||
|
|
// 事件发送
|
|||
|
|
EventManager.Instance.Send(EventName.INFIGHT_UNIT_DEAD, deadUnit);
|
|||
|
|
|
|||
|
|
// 事件清理
|
|||
|
|
EventManager.Instance.Unregister(EventName.INFIGHT_UNIT_DEAD, OnUnitDead);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.1 战斗流程
|
|||
|
|
|
|||
|
|
#### 4.1.1 战斗初始化
|
|||
|
|
```mermaid
|
|||
|
|
sequenceDiagram
|
|||
|
|
participant L as LevelManager
|
|||
|
|
participant U as UnitManager
|
|||
|
|
participant A as AreaManager
|
|||
|
|
participant E as EventSystem
|
|||
|
|
|
|||
|
|
L->>U: 初始化单位
|
|||
|
|
U->>A: 注册单位位置
|
|||
|
|
A->>A: 计算区域
|
|||
|
|
E->>L: 通知战斗开始
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 4.1.2 即时战斗循环
|
|||
|
|
```mermaid
|
|||
|
|
sequenceDiagram
|
|||
|
|
participant GM as GameManager
|
|||
|
|
participant UM as UnitManager
|
|||
|
|
participant AI as AISystem
|
|||
|
|
participant ES as EventSystem
|
|||
|
|
|
|||
|
|
loop Every Frame
|
|||
|
|
GM->>UM: LogicUpdate
|
|||
|
|
UM->>UM: UpdateUnits
|
|||
|
|
UM->>AI: UpdateAI
|
|||
|
|
AI->>ES: 发送行为事件
|
|||
|
|
ES->>UM: 更新单位状态
|
|||
|
|
end
|
|||
|
|
```
|
|||
|
|
```mermaid
|
|||
|
|
sequenceDiagram
|
|||
|
|
participant P as Player
|
|||
|
|
participant BU as BattleUI
|
|||
|
|
participant BS as Battle System
|
|||
|
|
participant ES as Event System
|
|||
|
|
|
|||
|
|
P->>BU: 选择单位
|
|||
|
|
BU->>ES: 发送单位选择事件
|
|||
|
|
ES->>BS: 通知战斗系统
|
|||
|
|
BS->>ES: 更新状态
|
|||
|
|
ES->>BU: 更新UI显示
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.2 系统间数据流
|
|||
|
|
|
|||
|
|
#### 4.2.1 存档系统
|
|||
|
|
- 战斗数据序列化
|
|||
|
|
- 玩家进度保存
|
|||
|
|
- 营地状态保存
|
|||
|
|
- 军团数据同步
|
|||
|
|
|
|||
|
|
#### 4.2.2 网络同步
|
|||
|
|
- 战斗状态同步
|
|||
|
|
- PVP数据传输
|
|||
|
|
- 军团数据更新
|
|||
|
|
- 排行榜刷新
|
|||
|
|
```mermaid
|
|||
|
|
graph TD
|
|||
|
|
A[Player Progress] --> B[Camp Development]
|
|||
|
|
A --> C[Legion Contribution]
|
|||
|
|
A --> D[Battle Records]
|
|||
|
|
A --> E[Story Progress]
|
|||
|
|
B --> F[Resource System]
|
|||
|
|
C --> F
|
|||
|
|
F --> G[Game Economy]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 5. 代码规范
|
|||
|
|
|
|||
|
|
### 5.1 目录结构
|
|||
|
|
- Assets/Code/Scripts/Gameplay：游戏核心逻辑代码
|
|||
|
|
- 按功能模块分类：AI、Area、Battle、UI等
|
|||
|
|
- 每个模块下按照职责划分子文件夹
|
|||
|
|
|
|||
|
|
### 5.2 命名规范
|
|||
|
|
- 类名：PascalCase
|
|||
|
|
- 方法名：PascalCase
|
|||
|
|
- 私有变量：_camelCase
|
|||
|
|
- 公有变量：camelCase
|
|||
|
|
- 常量：UPPER_CASE
|
|||
|
|
|
|||
|
|
### 5.3 代码组织
|
|||
|
|
- 使用命名空间管理代码
|
|||
|
|
- 单一职责原则
|
|||
|
|
- 接口优先
|
|||
|
|
- 组件化设计
|
|||
|
|
|
|||
|
|
## 6. 总结
|
|||
|
|
|
|||
|
|
### 6.1 系统特点
|
|||
|
|
- 采用事件驱动的架构设计
|
|||
|
|
- 高度模块化的系统划分
|
|||
|
|
- 清晰的数据流转路径
|
|||
|
|
- 完善的扩展性支持
|
|||
|
|
|
|||
|
|
### 6.2 优势分析
|
|||
|
|
- 即时战斗系统的实现既保证了策略性，又提供了实时性
|
|||
|
|
- 事件系统使各个模块解耦，便于维护和扩展
|
|||
|
|
- 完整的军团和PVP系统提供了丰富的多人玩法
|
|||
|
|
- 营地系统为玩家提供了个性化发展路线
|
|||
|
|
|
|||
|
|
### 6.3 注意事项
|
|||
|
|
- 战斗系统的性能优化需要特别关注
|
|||
|
|
- 网络同步的延迟处理要做好容错
|
|||
|
|
- 存档系统需要考虑向后兼容
|
|||
|
|
- AI行为树的配置需要经常调优
|
|||
|
|
|
|||
|
|
### 6.4 后续开发建议
|
|||
|
|
- 进一步优化战斗系统的即时性表现
|
|||
|
|
- 强化AI系统的决策能力
|
|||
|
|
- 扩展军团玩法的深度
|
|||
|
|
- 增加更多的社交互动功能
|