免费开源的Rust魔兽世界客户端:benilla如何用Bevy从零复刻完整1.12.1
免费开源的Rust魔兽世界客户端:benilla如何用Bevy从零复刻完整1.12.1
benilla 是一个完全开源、免费的《魔兽世界》1.12.1 客户端:用 Rust 和 Bevy 游戏引擎从零实现,不含任何原版客户端代码,也不打包任何游戏资产。它能连接标准 1.12.1 私服,从你自己的客户端目录读取全部游戏数据,跑起原版界面和经典插件,完整支持任务、副本、战场、公会、邮件与拍卖行——一个真正意义上的"可玩"客户端。
它能做什么:一个"完整"的客户端 🎮
benilla 不是演示或原型,而是一个功能闭环的 1.12.1 客户端,覆盖经典旧世的主要内容:
- 角色与成长:角色创建、转职、专精、天赋、专业技能
- 世界玩法:任务、副本与团队副本、战场与荣誉系统
- 社交与经济:组队、公会、交易、邮件、拍卖行、银行、旅店
- 原版界面 + 插件:直接运行你 1.12.1 安装目录里的 FrameXML,Questie、pfUI、Bagnon、Bartender2 等主流 1.12 插件都可以跑
一个关键细节:项目不带任何暴雪内容(无美术、模型、声音、地图、MPQ 内容、FrameXML),全部数据在运行时从你自己的合法 1.12.1 客户端读取,且安装目录只读、从不写入。
为什么选 Rust + Bevy:架构上的"两个干净切分"
benilla 的代码组织有一个很讲究的切分:格式解析与 UI 引擎核心是纯 Rust(不含 Bevy),世界渲染器不依赖游戏逻辑就能独立运行。这带来两个好处:
- 解析器(MPQ、BLP、DBC、ADT……)可以脱离渲染独立测试,上千个测试直接对着真实客户端数据校验;
- 世界引擎可以"空跑"(无游戏附着),方便开发者单独调试渲染。
每个 crate 的职责在 docs/MAP.md 里有完整映射(该文档由代码自动生成,与实现永不脱节)。应用本体则按 Bevy 插件分层加载,入口见 crates/benilla-app/src/lib.rs,启动器 crates/benilla/src/main.rs 只负责打上一个构建戳,保证小改动只需重新链接而不是全量重编。
核心 crate 地图:每种游戏格式一个解析器
| Crate | 职责 |
|---|---|
| benilla-mpq | 只读 MPQ 补丁链归档读取器 |
| benilla-blp | BLP2 纹理解码 |
| benilla-dbc | WDBC(客户端数据表)读取 |
| benilla-adt / benilla-wdt / benilla-wmo | ADT 地形块 / WDT 地图瓦片表 / WMO 建筑 |
| benilla-m2 | M2(MD20)角色与生物模型 |
| benilla-movie | 开场动画:AVI 读取 + MPEG-4 Part 2 解码器 |
| benilla-protocol | SRP6 认证 + 世界线协议 |
| benilla-srp | SRP6 客户端与世界会话加密 |
| benilla-lua | Lua 解释器(5.1.5,按 1.12.1 客户端语法实现) |
| benilla-ui | FrameXML / TOC 解析、模板、锚点、z-order |
| benilla-world | 世界渲染:地形流送、水体、天空、天气、光照、碰撞 |
| benilla-assets | 基于 MPQ 补丁链的 Bevy 资产源 |
| benilla-app | 游戏主体:战斗、法术、网络会话、全部 UI 子系统 |
值得留意的是 benilla-lua:它不是嵌入一个现成的 Lua 库,而是按 1.12.1 客户端的语法与行为自写了解释器(含词法、编译、GC、热重载),语法细节见 crates/benilla-lua/GRAMMAR.md。界面侧的 benilla-ui 则是无引擎依赖的 UI 核心,负责把原版 1.12 的 FrameXML 逐字节加载进这个 Lua 虚拟机。
从登录到进游戏:网络是怎么通的 🔌
benilla 走的是原版 1.12 协议,因此可以直接对接任何 1.12.1 服务端:
- SRP6 安全认证(benilla-srp)登录服务器;
- 进入世界后,会话切到世界加密,所有包按原版线格式编解码(benilla-protocol);
- 服务器下发的对象数据经"对象镜像"进入 ECS 实体,驱动移动、战斗、法术、组队等全部玩法;
- 双向网络移动:服务端授予的各种移动模式(慢落、定身……)都能响应。
服务端默认 localhost:3724(标准认证端口),开发环境对接 vmangos,cMaNGOS 等其他 1.12.1 核心同样可用。注意:benilla 不响应 Warden(防作弊),开启 Warden 强制校验的服务器会在超时后断开会话。
快速上手:三步跑起一个 Rust 魔兽客户端 🚀
前置条件(macOS / Linux / Windows 均支持):
- 一份你自己的 1.12.1 客户端(build 5875,任意语言版本)
- 一个 1.12.1 服务端(如 vmangos)
- 稳定版 Rust 工具链 + C 编译器(部分依赖需要:macOS 装 Xcode 命令行工具,Linux 装 ALSA/udev 开发包与 pkg-config)
第一步:获取代码
git clone https://gitcode.com/gh_mirrors/be/benilla
第二步:指向你的客户端数据并运行
WOW_DATA=/path/to/WoW/Data cargo run --release -p benilla
Windows(PowerShell):
$env:WOW_DATA="C:\path\to\WoW\Data"; cargo run --release -p benilla
第三步:登录
在登录界面输入账号密码,或通过环境变量跳过:
| 环境变量 | 作用 |
|---|---|
WOW_DATA |
1.12.1 安装的 Data 目录(必须) |
WOW_HOST |
服务器地址,默认 localhost:3724 |
WOW_USER / WOW_PASS |
免手输的登录凭据 |
配置文件、截图与插件都放在仓库根目录的 benilla-config/(插件放 benilla-config/AddOns/)。登录界面右上角的 Realmlist 按钮也可以设置并记住服务器地址。
对 1.12.1 的"信仰级"还原:偏差也是被管理的 📏
benilla 的核心纪律是:参考客户端(真实 1.12.1)就是规格说明书。每一处与 1.12.1 的行为差异都必须被记录并说明理由,且全部由代码自动生成、逐提交再生成:
- docs/DEVIATIONS.md:汇集所有"故意不同"的地方(如默认天气密度、选项窗口沿用 1.15 时代的界面布局),每条都带代码位置与理由;
- docs/METHOD.md:开发方法论——先看参考实现再动手、用仪器而非肉眼验证、小步提交;
- reference/:内嵌了 benilla-re(1.12.1 客户端逆向工程)的校验表(Lua 全局、事件、CVar、消息等),测试直接对着这些表跑,见 reference/README.md。
这种"偏差可审计"的工程方式,是它作为基础平台可信的关键。
如何参与:贡献规则与二次开发 🛠️
- 贡献入口:docs/CONTRIBUTING.md。能被接受的改动只有两类——修 bug、或让 benilla 更贴近 1.12.1(附参考实现证据)。1.12.1 没有的功能不进主干,而是"建在 benilla 之上"。
- 二次开发示例:通过
benilla_app::run_with注册自己的 Bevy 插件,官方示例见 crates/benilla-app/examples/extended_launcher.rs;扩展会拥有独立的配置目录,不污染主客户端的 CVar 表。 - 许可:代码为 MIT 或 Apache-2.0 双许可(LICENSE-MIT / LICENSE-APACHE),"双许可"本身即一份来源声明——无原版代码、无捆绑资产。
- 不计划:其他资料片或客户端版本、Warden。需要打包版、特定服务器改动或 1.12.1 没有的东西?去做 fork,官方欢迎。
结语
benilla 展示了现代 Rust 生态复刻经典游戏客户端的完整路径:用 crate 切分把"格式解析、协议、脚本引擎、渲染、应用逻辑"各归其位,用自动化文档(MAP / DEVIATIONS)和对照逆向表的测试把"还原度"变成可验证的指标。无论你是想体验经典旧世、研究 WoW 文件格式与协议、还是找一个高质量 Bevy + ECS 的大型实践样本,这个免费开源的 Rust 魔兽世界客户端都值得放进你的学习清单。