HsMod英雄皮肤映射机制深度解析与Bug修复

HsMod英雄皮肤映射机制深度解析与Bug修复

HsMod Hearthstone Modify Based on BepInEx 项目地址: https://gitcode.com/gh_mirrors/hs/HsMod

背景介绍

HsMod是一个针对炉石传说的游戏修改工具，其中英雄皮肤映射功能允许玩家自定义游戏中的英雄外观。近期发现该功能存在一个关键问题：当尝试将英雄皮肤映射到冒险模式英雄牌或可收集英雄牌时，只有英雄技能发生变化，而英雄原画却保持不变。

问题分析

经过深入的技术调查，我们发现问题的根源在于HsMod的英雄替换判定逻辑存在缺陷。具体表现为：

1. 判定条件过于严格：当前代码仅当英雄卡属于CardHero类型且cardId前缀为"HERO_"时才会触发替换机制，这导致许多非标准英雄牌无法正常替换。

2. 技能替换与英雄替换分离：技能替换逻辑先于英雄卡替换执行，且技能卡是从英雄卡反推得出的，因此技能可以正常变更，但英雄外观却保持不变。

3. 数据库查询限制：Utils.CheckInfo.IsHero()方法通过读取CacheHeroes（来自dbf.CARDHERO）判断dbid是否为英雄，而这个JSON文件仅包含可收藏英雄，排除了冒险模式等特殊英雄。

技术细节

现有机制工作原理

1. 皮肤映射配置：通过HsSkins.cfg文件定义，格式为"当前使用皮肤ID:对应英雄牌/冒险boss牌ID"。

2. 替换流程：

   • 首先加载皮肤映射配置到HeroesMapping内部映射表
   • 对局开始时尝试进行英雄替换
   • 技能替换先于英雄外观替换执行

3. 判定逻辑：

   • 检查卡牌是否为CardHero类型
   • 验证cardId是否以"HERO_"开头
   • 通过Utils.CheckInfo.IsHero()确认dbid有效性

问题复现

以"黑锋骑士乌瑟尔"（dbid=52235）为例：

• 技能成功替换：因为技能替换不依赖完整英雄判定
• 外观替换失败：Utils.CheckInfo.IsHero(52235)返回false，导致跳过cardID赋值

解决方案

经过多次调试和代码分析，我们实施了以下修复措施：

1. 扩展英雄判定逻辑：

   • 在Utils.IsHero方法中添加elseif分支
   • 基于cardId获取tag进行二次验证
   • 处理传统对战模式的特例情况

2. 空值安全处理：

   • 增加对translatedbidtocardid可能返回null的情况处理
   • 确保代码鲁棒性

3. 酒馆战旗特殊处理：

   • 识别到酒馆战旗英雄牌（如TB_BaconShop_HERO_前缀）
   • 采用不同的替换策略

实现考量

在修复过程中，我们面临了几个技术挑战：

1. 代码历史债务：原有代码结构复杂，存在多个相互依赖的判定层级，修改可能引发连锁反应。

2. 游戏模式差异：需要同时支持传统对战、酒馆战旗和佣兵模式等不同游戏模式的英雄替换。

3. 性能影响：新增的判定逻辑需要考虑执行效率，避免影响游戏流畅度。

最终效果

修复后的版本（6.5.1.0）实现了：

• 冒险模式英雄牌正常替换外观
• 可收集英雄牌完整替换
• 保持原有皮肤映射功能的稳定性
• 兼容各类游戏模式

开发者建议

对于希望进一步开发HsMod的贡献者，建议：

1. 深入理解游戏内部卡牌数据结构
2. 注意不同游戏模式的特殊处理
3. 编写健壮的null检查逻辑
4. 考虑使用C#语法糖优化代码
5. 充分测试各种边界情况

这次修复不仅解决了具体的功能问题，也为HsMod的英雄替换机制奠定了更健壮的基础，为未来的功能扩展提供了更好的支持。

HsMod Hearthstone Modify Based on BepInEx 项目地址: https://gitcode.com/gh_mirrors/hs/HsMod