BallController配置表说明.md 4.5 KB
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秒
- 说明: 状态检查的时间间隔
- 调整建议: 影响系统检查的频率
使用建议
难度调整
- 简单难度: baseSpeed=40, maxReflectionRandomness=0.1
- 普通难度: baseSpeed=60, maxReflectionRandomness=0.2
- 困难难度: baseSpeed=100, maxReflectionRandomness=0.3
- 地狱难度: baseSpeed=150, maxReflectionRandomness=0.4
关卡设计
- 早期关卡建议使用较低的球速和较强的防围困机制
- 后期关卡可以适当提高球速，减弱防围困机制
- 特殊关卡可以调整物理参数创造独特体验
注意事项
- 性能考虑: 过低的冷却时间可能影响性能
- 平衡性: 极端数值可能破坏游戏平衡
- 测试建议: 每次调整后都应进行充分测试
- 备份: 修改前请备份原始配置
更新日志
- 2024-01-XX: 初始版本创建
- 包含20个核心配置参数
- 支持完整的球控制器功能配置