# 敌人属性配置修复说明

## 问题描述

之前的敌人系统存在以下问题：
1. 敌人属性使用硬编码的默认值，而不是从JSON配置文件中读取
2. `EnemyInstance.ts` 中的属性初始化逻辑不正确
3. 配置文件的嵌套结构没有被正确解析

## 修复内容

### 1. 修改 `EnemyInstance.ts`

#### 属性默认值修改
```typescript
// 修改前：硬编码默认值
public health: number = 30;
public maxHealth: number = 30;
public speed: number = 50;
public attackPower: number = 10;
public attackInterval: number = 2;

// 修改后：初始化为0，从配置文件读取
public health: number = 0;
public maxHealth: number = 0;
public speed: number = 0;
public attackPower: number = 0;
public attackInterval: number = 0; // 从配置文件读取
```

#### 配置应用逻辑优化
```typescript
// 修改前：直接从根节点读取属性
this.health = this.enemyConfig.health || 30;
this.speed = this.enemyConfig.speed || 50;
this.attackPower = this.enemyConfig.attack || 10;

// 修改后：从正确的嵌套节点读取属性
// 从stats节点读取基础属性
const stats = this.enemyConfig.stats || {};
this.health = stats.health || 30;
this.maxHealth = stats.maxHealth || this.health;

// 从movement节点读取移动速度
const movement = this.enemyConfig.movement || {};
this.speed = movement.speed || 50;

// 从combat节点读取攻击力
const combat = this.enemyConfig.combat || {};
this.attackPower = combat.attackDamage || 10;
this.attackInterval = combat.attackCooldown || 2.0;
```

#### 初始化逻辑修复
```typescript
// 修改前：总是覆盖攻击间隔
this.attackInterval = 2.0; // 默认攻击间隔

// 修改后：只有在未设置时才使用默认值
if (this.attackInterval <= 0) {
    this.attackInterval = 2.0; // 默认攻击间隔
}
```

### 2. 修改 `EnemyController.ts`

#### 默认值更新
```typescript
// 修改前：不匹配配置文件结构
private defaultAttackPower: number = 10;
private defaultHealth: number = 30;

// 修改后：匹配配置文件中的实际数值
private defaultAttackPower: number = 20; // 对应combat.attackDamage
private defaultHealth: number = 10; // 对应stats.health
```

## JSON配置文件结构

敌人配置文件 `assets/resources/data/enemies.json` 采用嵌套结构：

```json
{
  "enemies": [
    {
      "id": "normal_zombie",
      "name": "普通僵尸",
      "type": "basic",
      "stats": {
        "health": 10,
        "maxHealth": 10,
        "attack": 1,
        "defense": 0,
        "speed": 50.0
      },
      "movement": {
        "speed": 50.0,
        "pattern": "direct",
        "moveType": "straight"
      },
      "combat": {
        "attackDamage": 20,
        "attackRange": 100,
        "attackCooldown": 1.0,
        "attackType": "melee"
      }
    }
  ]
}
```

## 属性映射关系

| EnemyInstance属性 | JSON配置路径 | 说明 |
|------------------|-------------|------|
| `health` | `stats.health` | 当前血量 |
| `maxHealth` | `stats.maxHealth` | 最大血量 |
| `speed` | `movement.speed` | 移动速度 |
| `attackPower` | `combat.attackDamage` | 攻击伤害 |
| `attackInterval` | `combat.attackCooldown` | 攻击冷却时间 |

## 验证结果

通过测试脚本 `test_enemy_config_loading.js` 验证：

✅ **配置文件状态**
- 敌人总数: 11个
- 配置版本: 2.2
- 有效配置: 11/11

✅ **属性数值范围**
- 血量范围: 6 - 120
- 速度范围: 20 - 60
- 攻击范围: 20 - 120

## 修复效果

1. **数据驱动**: 敌人属性现在完全从JSON配置文件中读取
2. **配置灵活**: 可以通过修改JSON文件调整敌人属性，无需修改代码
3. **结构清晰**: 属性按功能分组（stats、movement、combat）
4. **向后兼容**: 保留了默认值机制，确保配置缺失时系统仍能正常运行
5. **类型安全**: 保持了TypeScript的类型检查

## 使用方法

### 添加新敌人
1. 在 `enemies.json` 中添加新的敌人配置
2. 确保包含必要的 `stats`、`movement`、`combat` 节点
3. 系统会自动加载并应用新配置

### 修改现有敌人
1. 直接修改 `enemies.json` 中对应敌人的属性值
2. 重启游戏即可生效

### 调试配置
运行测试脚本验证配置：
```bash
node test_enemy_config_loading.js
```

## 注意事项

1. 修改配置文件后需要重启游戏才能生效
2. 确保JSON格式正确，避免语法错误
3. 属性值应在合理范围内，避免游戏平衡问题
4. 新增敌人时，建议参考现有敌人的配置结构