敌人配置表说明文档
概述
本文档说明了基于 enemies.json 文件生成的敌人配置Excel表格的结构和内容。该表格包含了游戏中所有敌人的详细配置信息,分为9个工作表进行组织。
文件信息
文件位置: d:/CocosGame/Pong/assets/resources/data/excel/敌人配置表.xlsx
数据源: d:/CocosGame/Pong/assets/resources/data/enemies.json
动画资源: d:/CocosGame/Pong/assets/resources/Animation/EnemyAni/
工作表详细说明
1. 敌人基础配置
包含所有敌人的基础属性信息:
- 敌人ID: 唯一标识符
- 敌人名称: 显示名称
- 敌人类型: 敌人分类(basic, armored, wanderer, ranged_caster, etc.)
- 稀有度: 稀有程度(common, uncommon, rare, boss)
- 权重: 生成权重值
- 生命值: 生命点数
- 移动速度: 移动速度
- 攻击力: 攻击伤害
- 攻击范围: 攻击距离
- 攻击速度: 攻击频率
- 防御力: 防御数值
- 金币奖励: 击杀奖励
2. 战斗配置
包含敌人的战斗相关配置:
- 敌人ID/名称: 对应的敌人信息
- 攻击类型: 攻击方式(melee, magic_projectile, arrow_projectile, etc.)
- 攻击延迟: 攻击前摇时间
- 攻击冷却: 攻击间隔时间
- 可格挡: 是否可以格挡攻击
- 格挡几率: 格挡成功率
- 武器类型: 武器种类(可选)
- 投射物类型: 投射物类型(可选)
- 投射物速度: 投射物飞行速度(可选)
3. 移动配置
包含敌人的移动行为配置:
- 敌人ID/名称: 对应的敌人信息
- 移动类型: 移动方式(straight, sway)
- 移动模式: 移动轨迹(walk_forward, zigzag_forward)
- 速度变化: 速度随机变化范围
- 摆动幅度: 左右摆动范围(可选)
- 摆动频率: 摆动周期频率(可选)
4. 视觉配置
包含敌人的视觉表现配置:
- 敌人ID/名称: 对应的敌人信息
- 精灵预制体: Spine动画资源路径(如:@EnemyAni/001/001)
- 缩放比例: 显示缩放倍数
- 水平翻转: 是否水平镜像
- 待机动画: 待机状态动画名称
- 行走动画: 移动状态动画名称
- 攻击动画: 攻击状态动画名称
- 死亡动画: 死亡状态动画名称
- 武器道具: 武器道具路径(可选)
- 护甲道具: 护甲道具路径(可选)
- 特殊道具: 特殊道具路径(可选)
5. 音频配置
包含敌人的音效配置:
- 敌人ID/名称: 对应的敌人信息
- 行走音效: 移动时播放的音效
- 攻击音效: 攻击时播放的音效
- 死亡音效: 死亡时播放的音效
- 受伤音效: 受伤时播放的音效(可选)
- 格挡音效: 格挡时播放的音效(可选)
- 隐身音效: 隐身时播放的音效(可选)
- 护甲破碎音效: 护甲破碎时播放的音效(可选)
- 引信音效: 引信燃烧时播放的音效(可选)
- 召唤音效: 召唤时播放的音效(可选)
- 激光音效: 激光发射时播放的音效(可选)
6. 特殊能力配置
包含敌人的特殊技能配置:
- 敌人ID/名称: 对应的敌人信息
- 特殊能力: 特殊技能名称(如:invisibility, armor_break, ranged_attack等)
7. BOSS配置
包含BOSS敌人的特殊配置:
- 敌人ID/名称: 对应的BOSS信息
- 阶段数: 战斗阶段总数
- 阶段血量阈值: 进入下一阶段的血量比例
- 狂暴速度加成: 狂暴状态下的速度倍数(可选)
- 狂暴伤害加成: 狂暴状态下的伤害倍数(可选)
- 狂暴攻速加成: 狂暴状态下的攻击速度倍数(可选)
- 召唤单位类型: 召唤的单位类型(可选)
- 召唤数量: 单次召唤的数量(可选)
- 召唤冷却: 召唤技能的冷却时间(可选)
- 激光伤害: 激光攻击的伤害值(可选)
- 激光射程: 激光攻击的射程(可选)
- 激光充能时间: 激光充能准备时间(可选)
- 激光冷却时间: 激光技能冷却时间(可选)
8. 生成权重配置
包含不同稀有度敌人的生成权重:
- 稀有度: 稀有度等级(common, uncommon, rare, boss)
- 生成权重: 随机生成时的权重值
9. 波次进度配置
包含不同游戏阶段的敌人配置:
- 波次类型: 游戏阶段类型(earlyWaves, midWaves, lateWaves, bossWaves)
- 敌人ID: 该阶段出现的敌人ID
动画资源说明
敌人的视觉表现通过Spine动画系统实现:
- 资源路径:
@EnemyAni/001/001 格式指向 resources/Animation/EnemyAni/001/ 目录
- 文件结构: 每个敌人动画包含
.json、.atlas、.png 文件
- 动画状态: idle(待机)、walk(行走)、attack(攻击)、dead(死亡)等
使用建议
- 策划调整: 可直接在Excel中修改数值,然后导回JSON格式
- 平衡性测试: 通过调整生命值、攻击力、速度等属性进行游戏平衡
- 新敌人添加: 参考现有敌人的配置结构添加新的敌人类型
- 动画资源: 确保
spritePrefab 路径对应的动画资源文件存在
技术说明
- 生成工具: 使用Python脚本
create_enemies_excel.py 自动生成
- 依赖库: pandas、openpyxl
- 中文注释: 每个工作表的第二行包含字段的中文说明
- 数据完整性: 保持与源JSON文件的数据一致性
更新流程
- 修改
enemies.json 文件
- 运行
python create_enemies_excel.py 重新生成Excel表格
- 检查生成的表格内容是否正确
- 根据需要调整脚本或JSON配置