WulaFallenEmpireRW/Documentation/ExplosiveBeamWeapons/测试说明.md

爆炸射线武器测试说明

已实现的功能

1. 核心功能

• ✅ 继承自原版 Verb_ShootBeam 的所有功能
• ✅ 可配置的爆炸触发间隔
• ✅ 可配置的爆炸伤害、范围、类型
• ✅ 可配置的音效和特效
• ✅ 可配置的爆炸后效果（生成物品、气体等）

2. 配置选项

• enableExplosion: 爆炸开关
• explosionShotInterval: 爆炸间隔（每x发触发一次）
• explosionRadius: 爆炸半径
• explosionDamageDef: 爆炸伤害类型
• explosionDamage: 爆炸伤害值
• explosionSound: 爆炸音效
• chanceToStartFire: 点燃概率
• postExplosionSpawnThingDef: 爆炸后生成物品

3. 示例武器

已创建三个示例武器：

1. CLa-15"蓝爆"轻型: 每发都爆炸，火焰伤害
2. CLa-16"蓝爆"重型: 每3发爆炸，炸弹伤害+燃料污渍
3. CLa-17"蓝毒": 每2发爆炸，毒气伤害+毒气云

测试步骤

1. 编译测试

dotnet build "Source\WulaFallenEmpire\WulaFallenEmpire.csproj"

✅ 编译成功

2. 游戏内测试准备

1. 启动RimWorld
2. 启用开发者模式 (Options -> Dev mode)
3. 加载包含此模组的存档或创建新游戏
4. 按 ~ 键打开开发者控制台

3. 生成测试武器

使用以下命令生成测试武器：

Thing.Spawn WULA_RW_Fractal_AR 1
Thing.Spawn WULA_LightExplosiveBeam 1
Thing.Spawn WULA_HeavyExplosiveBeam 1
Thing.Spawn WULA_ToxicExplosiveBeam 1

4. 功能验证清单

基础射线功能

• 射线正常发射和显示
• 射线宽度和颜色正确
• 射线伤害正常造成
• 音效和视觉效果正常

爆炸功能

• 爆炸按配置间隔触发
• 爆炸位置在射线命中点
• 爆炸半径和伤害正确
• 爆炸音效正常播放
• 爆炸视觉效果正常

特殊效果

• 点燃效果正常工作
• 爆炸后生成物品（燃料污渍等）
• 毒气云正常生成和扩散
• 护甲穿透计算正确

5. 性能测试

• 连续射击时帧率稳定
• 多个单位同时使用时无卡顿
• 内存使用正常，无内存泄漏

6. 平衡性测试

• 武器伤害与成本匹配
• 爆炸威力不会过于强大
• AI正确使用武器
• 友伤风险合理

测试场景

场景1：单目标测试

1. 生成一个敌对的人形目标
2. 装备测试武器
3. 射击并观察：
   • 射线效果
   • 爆炸触发时机
   • 伤害数值
   • 特殊效果

场景2：群体目标测试

1. 生成多个敌对目标（5-10个）
2. 测试爆炸范围伤害
3. 观察连锁效果（点燃、毒气扩散等）

场景3：建筑物测试

1. 建造一些墙壁和家具
2. 测试爆炸对建筑物的影响
3. 验证射线穿透和爆炸破坏

场景4：友军测试

1. 在友军附近使用武器
2. 验证友伤机制
3. 测试AI的使用策略

常见问题排查

问题1：爆炸不触发

• 检查 enableExplosion 是否为 true
• 检查 explosionShotInterval 设置
• 确认射击确实命中目标

问题2：爆炸位置错误

• 检查射线的 InterpolatedPosition 计算
• 确认目标位置在地图范围内

问题3：音效不播放

• 检查 explosionSound 定义是否正确
• 确认音效文件存在

问题4：特效不显示

• 检查 explosionEffecter 定义
• 确认特效资源文件存在

调试工具

开发者命令

# 生成特定武器
Thing.Spawn [武器DefName] [数量]

# 生成敌对目标
Pawn.Spawn Raider 5

# 治疗所有伤害
Heal.All

# 清除所有火焰
Fire.Clear

日志监控

监控游戏日志文件中的错误信息：

• Player.log (Windows)
• 搜索 "WulaFallenEmpire" 相关错误

报告问题

如果发现问题，请记录：

1. 具体的复现步骤
2. 预期行为 vs 实际行为
3. 相关的日志错误信息
4. 游戏版本和模组版本
5. 其他加载的模组列表