游戏状态管理系统设置指南

本指南将帮助你在Cocos Creator中正确设置游戏状态管理系统，实现血量监控和胜利失败UI显示功能。

📋 前置条件

确保你的场景中已经有以下节点结构：

Canvas/
├── GameLevelUI/
│   ├── HeartNode/
│   │   └── HeartLabeld (Label组件，显示血量)
│   ├── EnemyController (挂载EnemyController脚本)
│   └── GameManager (挂载增强版GameManager脚本)
├── GameSuccess (游戏成功UI，初始设为不激活)
└── GameDefeat (游戏失败UI，初始设为不激活)

🔧 设置步骤

1. 配置增强版GameManager组件

在 Canvas/GameLevelUI/GameManager 节点的Inspector面板中设置以下属性：

原GameManager属性：

Ball Controller: 拖入BallController节点
Block Selection UI: 拖入BlockSelectionUI节点
Game Area: 拖入GameArea节点
Enemy Manager: 拖入EnemyController节点

游戏状态管理属性：

Heart Label Node: 拖入 Canvas/GameLevelUI/HeartNode/HeartLabeld 节点
Game Success UI: 拖入 Canvas/GameSuccess 节点
Game Defeat UI: 拖入 Canvas/GameDefeat 节点

游戏配置属性：

Wall Health: 设置墙体初始血量（如1200）
Initial Health: 设置初始血量（如100）
Check Interval: 设置检查间隔（建议1.0秒）

2. 设置成功失败UI按钮

GameSuccess UI 按钮结构

Canvas/GameSuccess/
├── NextLevelBtn (Button组件)
├── RestartBtn (Button组件)
├── MainMenuBtn (Button组件)
└── ShopBtn (Button组件)

GameDefeat UI 按钮结构

Canvas/GameDefeat/
├── RestartBtn (Button组件)
├── MainMenuBtn (Button组件)
├── ShopBtn (Button组件)
└── ReviveBtn (Button组件)

注意: 按钮节点名称必须严格按照上述命名，脚本会根据名称自动查找和绑定事件。

3. 初始化其他管理器

确保场景中有以下管理器节点：

LevelManager: 在某个持久节点上挂载 LevelManager 脚本
ShopManager: 在某个持久节点上挂载 ShopManager 脚本
ConfigManager: 在某个持久节点上挂载 ConfigManager 脚本

🎮 工作流程

血量监控流程

GameManager 每秒检查 HeartLabeld 的文本内容
从文本中提取数字作为当前血量
当血量降为0时，自动触发游戏失败

敌人检测流程

GameManager 通过 EnemyController 获取当前敌人数量
当敌人数量为0时，自动触发游戏成功

UI交互流程

游戏结束时显示对应的成功/失败UI
GameManager 处理所有按钮点击事件
按钮功能包括：下一关、重新开始、返回主菜单、商店、复活等

🔍 调试功能

GameManager调试方法

// 在控制台或其他脚本中调用
const gameManager = find('Canvas/GameLevelUI/GameManager').getComponent('GameManager');

// 强制触发游戏成功
gameManager.forceGameSuccess();

// 强制触发游戏失败
gameManager.forceGameDefeat();

// 手动设置血量
gameManager.setHealth(50);

// 造成伤害
gameManager.takeDamage(20);

⚠️ 注意事项

节点路径: 确保所有节点路径与代码中的路径完全一致
组件依赖: GameManager依赖EnemyController，确保EnemyController正常工作
UI初始状态: GameSuccess和GameDefeat节点初始应设为不激活状态
按钮命名: UI按钮的节点名称必须与代码中的查找名称一致
管理器实例: LevelManager和ShopManager需要正确初始化为单例
脚本位置: 增强版GameManager脚本位于 LevelSystem/GameManager.ts

🎯 扩展功能

你可以根据需要扩展以下功能：

音效支持: 在胜利失败时播放音效
动画效果: 添加UI显示动画
得分计算: 实现更复杂的得分系统
星级评定: 根据表现给出星级评价
成就系统: 集成成就解锁功能

🐛 常见问题

Q: 血量检测不工作？ A: 检查HeartLabeld节点路径和Label组件是否正确设置

Q: 按钮点击无响应？ A: 检查按钮节点命名是否正确，Button组件是否添加

Q: 敌人检测不准确？ A: 确保EnemyController的getCurrentEnemyCount方法正常工作

Q: 管理器获取失败？ A: 检查LevelManager和ShopManager是否正确初始化为单例

Q: 找不到GameManager脚本？ A: 确保使用的是 LevelSystem/GameManager.ts 中的增强版GameManager

GameStateSetupGuide.md 4.5 KB Verlauf Originalformat