《魔兽争霸 III》模组模拟引擎 Warsmash（Java/LibGDX）

关于“下架”传闻的澄清

README 专门设置了 “In the News” 一节，用于澄清 2022 年部分新闻网站与社交媒体所称“Warsmash 因 Activision Blizzard 的停止侵权函而被下架”的说法。作者指出这一事件并未发生，混淆源自一个 YouTube 上的恶搞视频，该视频几乎在上线后立刻被撤下。若对该话题仍有疑问，README 建议加入 Warsmash 的 Discord 服务器直接询问。

作者同时表达了对传播环境的无奈：未经证实的下架谣言传播速度远超任何正常的技术讨论，而项目与作者缺乏同等量级的发声渠道来还原事实。README 给出的态度是——如果想支持 Warsmash，不必去攻击 Activision，而是去热爱《魔兽争霸 III》的模组创作。

玩法与演示

README 提供了一个 Gameplay Example 小节，以 YouTube 视频缩略图链接的形式展示实际运行画面，读者可点击跳转观看。除此之外，README 未以文字形式罗列具体的玩法系统清单，因此这里不对战斗、单位、技能等细节做额外推断。

配置核心：warsmash.ini

无论你打算从 IDE 编辑运行、从命令行启动，还是构建二进制发行版，都会遇到 warsmash.ini 配置文件的问题。README 用较长篇幅解释了这一设计的由来：作者自 2012 年起维护 Retera Model Studio，并在《魔兽争霸 III：重制版》发布前的岁月里持续跟进暴雪的版本变化。2017 至 2019 年间，游戏经历了一系列大幅改动补丁（从 1.27 开始），有时每个补丁都会带来全新的目录结构，却并未挂上“重制版”的名号。

早期 Retera Model Studio 通过 Windows 注册表自动探测“唯一正确的《魔兽争霸 III》安装位置”，但后来注册表键被更换，部分《冰封王座》版本甚至不记录安装路径；2018 年起游戏文件又被重组进新的内容分发归档格式。于是 2019 年作者把“自动探测”改为“用户手动指定”，让用户自己掌控资源定位，也便于自行修复问题。

这一思路被继承到 Warsmash 并加以扩展：[DataSources] 段描述的是一个由多层“查找位置”构成的虚拟文件系统，可以加载多个归档，解析某个文件时按从新到旧的顺序逐个归档查找。配置权完全在用户手中。README 列出了作者曾测试过的组合，包括：

• 《冰封王座》1.22–1.28：使用 MPQ 文件加 Warsmash 自带 resources 文件夹，[Emulator] 需设 MaxPlayers=16。
• 1.29：同上，但 War3Patch.mpq 已移除，需从列表中删掉；MaxPlayers=28。
• 1.30：使用手动解出的 CASC 内容文件夹（名为 .mpq 但并非 MPQ 归档），仍需包含 resources 文件夹；Warsmash 的 CASC 解析器目前仅支持 1.32.10 及以后，但会探测 1.30 特有的地形文件夹名；该补丁约一年未测试，可能因代码变动出现问题。
• 1.31：使用手动解出的 .w3mod 文件夹，同样需 resources 文件夹；约一年未测试。
• 1.32：可直接使用 CASC，INI 中以 “Prefixes” 记法指定加载哪些 .w3mod；若要显示重制版高清单位模型，可加入 war3.w3mod\_hd.w3mod 与对应语言包前缀（示例见 ./core/assets/warsmashRF.ini）。该补丁起部分声音数据表格式变更，Warsmash 尚未完整读取新格式，可能只有音乐与战斗攻击音效可用，单位语音暂不能加载；纹理改为 DDS 格式，涉及 sRGB 计算差异，曾出现贴图过暗的问题；音频改为 FLAC，LibGDX 不原生支持，Warsmash 借助开源 FLAC 解析器在内存中转为 WAV，转换存在精度损失，声音可能偏“薄”。
• 1.33 及以后：不支持。该补丁起 3D 模型格式彻底改变，Warsmash 不解析新格式；用 1.32.10 资源保存的地图或许仍能打开。

学习建议

• 这是一个偏“引擎/工具”方向的项目，适合想了解游戏资源归档格式（MPQ、CASC、.w3mod）、虚拟文件系统分层解析、以及如何在 LibGDX 之上重建既有游戏运行环境的开发者。
• 阅读顺序建议：先看 warsmash.ini 的 [DataSources] 设计理解资源解析模型，再看 Gradle 构建入口，最后按需深入具体子系统。
• 注意版本敏感性：不同游戏补丁的目录结构与资源格式差异极大，遇到资源加载失败时优先核对补丁版本与 INI 配置是否匹配。
• 项目涉及第三方游戏素材，使用前请确认自身拥有合法授权。