tanqiu/assets/data/TestGuide.md

武器和敌人系统测试指南

🚀 快速开始

1. 基础设置

步骤1: 确保配置文件存在

确保以下文件存在并正确配置：

• ✅ assets/data/weapons.json - 武器配置
• ✅ assets/data/enemies.json - 敌人配置
• ✅ assets/scripts/ConfigManager.ts - 配置管理器

步骤2: 创建测试场景

在Cocos Creator中创建新场景，命名为 TestScene

🎯 武器方块测试

场景结构设置

Canvas
├── ConfigManager (挂载 ConfigManager.ts)
├── TestScene (挂载 WeaponBlockTestScene.ts)
└── WeaponTest
    ├── WeaponBlockExample (挂载 WeaponBlockExample.ts)
    └── BlockContainer (空节点)

预制体创建

武器方块预制体 (WeaponBlock.prefab)

1. 创建新节点，命名为 WeaponBlock
2. 添加组件：
   • Sprite (显示武器图标)
   • UITransform (设置尺寸 100x100)
   • Button (可选，用于点击交互)
3. 保存为预制体

组件配置

WeaponBlockExample 组件配置

• Block Prefab: 拖入 WeaponBlock 预制体
• Block Container: 拖入 BlockContainer 节点

运行测试

1. 播放场景

2. 观察控制台输出：

   === 武器方块测试场景启动 ===
   ✅ 配置管理器已加载
   📋 可用武器列表:
    - 毛豆射手 (pea_shooter) - common
    - 尖胡萝卜 (sharp_carrot) - common
    ...
   

3. 观察生成的5个武器方块，不同稀有度显示不同颜色

预期结果

• 🟢 5个武器方块自动生成
• 🟢 方块显示对应的植物图标
• 🟢 稀有度颜色正确显示
• 🟢 控制台输出详细信息

👹 敌人生成器测试

场景结构设置

Canvas
├── ConfigManager (挂载 ConfigManager.ts)
├── TestScene (挂载 EnemySpawnerTestScene.ts)
└── EnemyTest
    ├── EnemySpawner (挂载 EnemySpawnerExample.ts)
    └── EnemyContainer (空节点)

预制体创建

敌人预制体 (Enemy.prefab)

1. 创建新节点，命名为 Enemy
2. 添加组件：
   • Sprite (显示敌人图标)
   • RigidBody2D (物理移动)
   • Collider2D (碰撞检测，如BoxCollider2D)
3. 设置RigidBody2D属性：
   • Type: Dynamic
   • Linear Damping: 0
   • Angular Damping: 0
4. 保存为预制体

组件配置

EnemySpawnerExample 组件配置

• Enemy Prefab: 拖入 Enemy 预制体
• Enemy Container: 拖入 EnemyContainer 节点
• Spawn Interval: 2.0 (生成间隔2秒)
• Max Enemies: 10 (最大敌人数量)

EnemySpawnerTestScene 组件配置

• Enemy Spawner: 拖入 EnemySpawner 节点上的 EnemySpawnerExample 组件

键盘控制测试

运行场景后，使用以下键盘控制：

按键	功能	说明
1	生成普通敌人	白色/灰色敌人
2	生成稀有敌人	黄色敌人
3	生成史诗敌人	橙色敌人
B	生成BOSS	红色大型敌人
R	生成随机敌人	随机类型
C	清除所有敌人	清空场景
P	暂停/恢复生成	切换自动生成
W	下一波次	增加波次等级
S	显示状态信息	查看当前状态

预期结果

• 🟢 敌人自动从右侧生成
• 🟢 敌人向左移动
• 🟢 不同稀有度显示不同颜色
• 🟢 键盘控制响应正常
• 🟢 敌人移出屏幕后自动销毁

🔧 常见问题排查

问题1: 配置加载失败

症状: 控制台显示 "配置管理器未准备好" 解决方案:

1. 检查 assets/data/weapons.json 和 enemies.json 是否存在
2. 确保JSON格式正确
3. 检查ConfigManager是否正确挂载到Canvas上

问题2: 武器图标不显示

症状: 方块生成但没有图标 解决方案:

1. 检查植物图标文件是否存在于 assets/resources/images/植物图标/
2. 确保图片已正确导入到Cocos Creator
3. 检查资源路径是否正确

问题3: 敌人不移动

症状: 敌人生成但静止不动 解决方案:

1. 确保敌人预制体有RigidBody2D组件
2. 检查RigidBody2D的Type设置为Dynamic
3. 确保场景有物理世界设置

问题4: 键盘控制无响应

症状: 按键没有反应 解决方案:

1. 确保EnemySpawnerTestScene正确挂载
2. 检查EnemySpawner组件是否正确配置
3. 确保场景获得焦点

📊 测试检查清单

武器系统测试

• 配置管理器加载成功
• 8种武器类型全部显示
• 武器图标正确加载
• 稀有度颜色正确
• 控制台信息完整

敌人系统测试

• 配置管理器加载成功
• 12种敌人类型可生成
• 敌人自动移动
• 键盘控制响应
• 波次系统工作
• 敌人清理正常

集成测试

• 武器和敌人配置互不冲突
• 资源路径映射正确
• 特效配置可用
• 系统性能正常

🚀 进阶测试

1. 性能测试

• 同时生成大量敌人 (按住R键)
• 观察帧率和内存使用
• 测试敌人清理机制

2. 配置测试

• 修改武器属性值
• 测试新的敌人类型
• 验证稀有度权重

3. 集成测试

• 与现有游戏系统集成
• 测试碰撞检测
• 验证子弹发射系统

📝 测试报告模板

测试日期: ____
测试环境: Cocos Creator ____

武器系统测试结果:
- 配置加载: ✅/❌
- 图标显示: ✅/❌
- 稀有度系统: ✅/❌
- 性能表现: ✅/❌

敌人系统测试结果:
- 配置加载: ✅/❌
- 敌人生成: ✅/❌
- 移动系统: ✅/❌
- 键盘控制: ✅/❌
- 波次系统: ✅/❌

发现的问题:
1. ____
2. ____

建议改进:
1. ____
2. ____

🎯 下一步

测试完成后，可以：

1. 集成到主游戏场景
2. 添加音效和特效
3. 实现武器-敌人交互
4. 优化性能和用户体验