BallController配置表说明文档

## 概述
本配置表用于配置游戏中小球控制器(BallController)的各项参数，策划可以通过调整这些参数来平衡游戏难度和体验。

## 文件说明
- **文件位置**: `assets/resources/data/excel/BallController配置表.csv`
- **对应脚本**: `assets/scripts/CombatSystem/BallController.ts`
- **格式说明**: 第一行为参数名称，第二行为中文翻译，第三行开始为具体配置数据

## 参数详细说明

### 核心运动参数

#### baseSpeed (基础球速)
- **默认值**: 60
- **推荐范围**: 30-200
- **说明**: 控制小球的基础移动速度，直接影响游戏节奏
- **调整建议**: 
  - 数值越大游戏越快，难度越高
  - 新手关卡建议使用较低数值(30-50)
  - 高难度关卡可使用较高数值(100-200)

#### maxReflectionRandomness (反弹随机偏移角度)
- **默认值**: 0.2
- **推荐范围**: 0-1
- **说明**: 球反弹时的随机偏移最大角度(弧度)，增加游戏随机性
- **调整建议**:
  - 0表示完全规律反弹
  - 0.2-0.5适合大多数情况
  - 过高会导致球运动过于随机

### 防围困机制参数

#### antiTrapTimeWindow (防围困检测时间窗口)
- **默认值**: 5.0秒
- **推荐范围**: 3-10秒
- **说明**: 检测球是否被困的时间窗口
- **调整建议**: 时间越短，防围困机制越敏感

#### antiTrapHitThreshold (防围困撞击阈值)
- **默认值**: 5次
- **推荐范围**: 3-10次
- **说明**: 在时间窗口内连续撞击多少次后触发防围困
- **调整建议**: 次数越少，防围困越容易触发

#### deflectionAttemptThreshold (偏移尝试次数阈值)
- **默认值**: 3次
- **推荐范围**: 1-5次
- **说明**: 偏移尝试次数达到后使用穿透而非偏移
- **调整建议**: 影响防围困的处理方式

#### antiTrapDeflectionMultiplier (防围困偏移强度倍数)
- **默认值**: 3.0
- **推荐范围**: 1.5-5.0
- **说明**: 防围困偏移的强度倍数
- **调整建议**: 数值越大，偏移效果越明显

### 战斗系统参数

#### FIRE_COOLDOWN (子弹发射冷却时间)
- **默认值**: 0.05秒
- **推荐范围**: 0.01-0.2秒
- **说明**: 方块发射子弹的间隔时间
- **调整建议**: 
  - 数值越小，子弹发射越频繁
  - 影响游戏的战斗节奏

### 物理系统参数

#### ballRadius (球半径)
- **默认值**: 25
- **推荐范围**: 15-40
- **说明**: 小球的碰撞半径
- **调整建议**: 影响碰撞检测的精度和游戏难度

#### restitution (弹性系数)
- **默认值**: 1
- **推荐范围**: 0.8-1.0
- **说明**: 碰撞弹性系数，1为完全弹性碰撞
- **调整建议**: 数值越小，球的弹跳越弱

#### linearDamping (线性阻尼)
- **默认值**: 0
- **推荐范围**: 0-0.1
- **说明**: 刚体线性阻尼，0表示无阻尼
- **调整建议**: 通常保持为0以保持球的恒定速度

### 生成系统参数

#### safeDistance (安全距离)
- **默认值**: 20
- **推荐范围**: 10-50
- **说明**: 小球生成时与方块的最小距离
- **调整建议**: 避免球生成时立即碰撞

#### edgeOffset (边缘偏移)
- **默认值**: 20
- **推荐范围**: 10-30
- **说明**: 距离游戏区域边缘的偏移量
- **调整建议**: 避免球生成在边缘位置

#### maxAttempts (最大尝试次数)
- **默认值**: 50
- **推荐范围**: 20-100
- **说明**: 寻找有效生成位置的最大尝试次数
- **调整建议**: 影响生成算法的性能

### 系统参数

#### checkInterval (检查间隔)
- **默认值**: 1.0秒
- **推荐范围**: 0.5-2.0秒
- **说明**: 状态检查的时间间隔
- **调整建议**: 影响系统检查的频率

## 使用建议

### 难度调整
1. **简单难度**: baseSpeed=40, maxReflectionRandomness=0.1
2. **普通难度**: baseSpeed=60, maxReflectionRandomness=0.2
3. **困难难度**: baseSpeed=100, maxReflectionRandomness=0.3
4. **地狱难度**: baseSpeed=150, maxReflectionRandomness=0.4

### 关卡设计
- 早期关卡建议使用较低的球速和较强的防围困机制
- 后期关卡可以适当提高球速，减弱防围困机制
- 特殊关卡可以调整物理参数创造独特体验

## 注意事项

1. **性能考虑**: 过低的冷却时间可能影响性能
2. **平衡性**: 极端数值可能破坏游戏平衡
3. **测试建议**: 每次调整后都应进行充分测试
4. **备份**: 修改前请备份原始配置

## 更新日志

- 2024-01-XX: 初始版本创建
- 包含20个核心配置参数
- 支持完整的球控制器功能配置