东方 Project 同人弹幕射击游戏（Taisei Project）

WarsmashModEngine（常称 Warsmash）是一个用 Java 与 LibGDX 编写的《魔兽争霸 III》模拟引擎，面向模组作者和想研究该游戏运行方式的技术用户，并非普通玩家开箱即用的重制版。README 开宗明义地说明，项目不包含《魔兽争霸 III》的任何素材；要运行这个模拟器，用户必须先从动视暴雪购买一份有效的《魔兽争霸 III》，再通过配置让 Warsmash 使用这些素材。项目同时澄清了 2022 年的一则传闻：有新闻网站和社交媒体称 Warsmash 因动视暴雪的停止函而被下架，但事实并非如此；混淆来自一个 YouTube 恶搞视频，该视频几乎立刻被删除。README 还表示，未经证实的下架谣言传播速度远超任何正当技术讨论，并呼吁支持者不要因此攻击动视，而是去热爱《魔兽争霸 III》模组社区。

Warsmash 的使用入口是 warsmash.ini 配置文件。无论用户想从 IDE 编辑、从命令行运行，还是构建二进制发布版本，都会遇到这个文件。README 用较长篇幅解释其设计来源：作者自 2012 年起维护 Retera Model Studio，早期资产加载工具通过 Windows 注册表自动检测“唯一正确的《魔兽争霸 III》安装位置”；但 2017 至 2019 年间，暴雪连续发布补丁大幅改动游戏结构，注册表键被移除或更换，部分《冰封王座》版本甚至不记录安装位置，2018 年文件又被重组进新的内容分发归档，因此自动检测不再可靠。2019 年作者把自动检测改为让用户手动指定。移植到 Warsmash 后，这一思路扩展为允许用户为不同配置分别记录多个 INI 文件，再用同一个 Warsmash 二进制从任意一套配置启动。

核心特性

warsmash.ini 中的 [DataSources] 块描述一个虚拟文件系统，由一层或多层“查找位置”叠加而成；可以加载许多归档，解析某个路径时会从新到旧逐个归档查找。这个虚拟文件系统完全由用户搭建，但一旦搭好，Warsmash 就能从该文件系统接受并运行多种版本的游戏。README 按补丁列出了作者测试过的情况：Frozen Throne 1.22 至 1.28 使用 MPQ 文件加 Warsmash 的 resources 文件夹，[Emulator] 需要 MaxPlayers=16；1.29 仍用 MPQ，但 War3Patch.mpq 已不存在，需要从列表移除，MaxPlayers=28；1.30 需要手动解出 CASC 内的文件夹，这些文件夹扩展名是 .mpq 但并不是 MPQ 归档，还要加入 resources；1.31 对应扩展名为 .w3mod 的文件夹；1.32 可以直接使用 CASC，INI 中用“Prefixes”指定要加载哪些 .w3mod。若想显示 Reforged 高清单位模型，可加入 war3.w3mod_hd.w3mod 以及 war3.w3mod_hd.w3mod_locales\enus.w3mod 这类语言前缀。

README 也坦白列出兼容性限制。Warsmash 的 CASC 解析器目前只对 1.32.10 及以后版本有效；1.30 和 1.31 已有一年左右没有在 Warsmash 上测试，可能因较新的代码改动出现意外问题；从 1.32 起，部分声音数据表被重新格式化，Warsmash 尚未完整读取新的表格式和文件位置，可能只有音乐和战斗攻击音效可用，单位语音因 Reforged 的口型同步改动而暂时无法加载，即使使用“经典”画面并避免加载 _hd.w3mod 也一样。纹理方面，从该补丁起所有纹理资源改为 DDS 格式而非 BLP，这引入 sRGB 计算差异；历史上曾出现把 BLP 的 sRGB 修正误用于 DDS 纹理、导致部分纹理极暗的问题，README 认为该问题可能已修复，但仍提醒用户留意。部分玩家还指出“经典”画面下的 DDS 压缩伪影与历史 BLP 版本观感不同，例如英雄光效。

技术要点

技术上，Warsmash 建立在 LibGDX 之上，使用 Java 编写，资产解析逻辑与 Retera Model Studio 一脉相承；它需要处理 MPQ、CASC、多版本目录结构、BLP/DDS 纹理和声音表等多层兼容问题，因此更像一个模拟器与引擎项目，而不是一款独立游戏。README 给出 Discord 邀请链接用于社区交流，并提供一段 YouTube 实机演示视频，帮助用户直观了解运行效果。对于学习者，这个项目展示了如何用虚拟文件系统隔离不同游戏版本的资产、如何让用户可配置地定位商业游戏资源、以及如何在 LibGDX 中处理老游戏的模型、纹理和音频数据。

平台与构建方面，README 没有给出完整的官方平台支持表，只说明可以配合 IDE、命令行或二进制发布使用，并从 warsmash.ini 启动。由于项目依赖正版《魔兽争霸 III》素材，国内用户需要自行解决游戏购买与资源路径配置；Java 与 LibGDX 的依赖通常通过 Maven 或 Gradle 获取，README 中的 Discord、YouTube 链接在国内网络环境下可能无法直接访问，具体版本与构建步骤待核验。总体而言，Warsmash 的价值在于为《魔兽争霸 III》模组开发提供一个可配置、可调试的模拟运行环境，但它不适合期待“下载即玩”的用户，也不应被视为对原作资源的替代分发。