# 武器和敌人系统测试指南

## 🚀 快速开始

### 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. 优化性能和用户体验