samwhosung/benilla

Worth a look if you run a 1.12.1 private server or want to study a full game client rebuilt in the open; it is not a drop-in replacement for a retail install.

The problem

Playing vanilla World of Warcraft on a private server normally means running the original 2006 executable, which was never meant to be portable or modifiable, and whose internals are closed. If you want to understand how the client actually reads MPQ archives, speaks the world protocol, or renders terrain, you have no readable source to learn from — only decompiled guesswork. benilla rewrites that client from scratch and points it at the data you already own. The workflow changes at the launch step: instead of the stock binary, you build benilla and give it your Data folder and a server address.

What's different

The stated scope is the whole client, not a viewer: character creation, questing, professions, dungeons, raids, battlegrounds, groups, guilds, trade, mail and the auction house, plus a FrameXML/Lua engine that runs the stock interface and third-party 1.12 addons such as Questie, pfUI, Bagnon and Bartender2. Asset readers (MPQ patch chain, BLP, DBC, ADT, WDT, WDL, M2, WMO) and the networking stack from SRP6 auth through world-session crypto are written from scratch with no original code, no third-party WoW crates and no bundled assets; the reverse-engineering notes live in a separate companion repo.

The useful consequence is inspectability. Format readers and the UI engine core are plain Rust without Bevy, the renderer runs without a game attached, and the project publishes a crate-and-subsystem map plus a list of every deviation from 1.12.1, both generated from the code. That makes it plausible material for people writing tools or servers, not just players. The trade-off: it deliberately diverges in places — the options window and ESC menu follow Classic Era rather than 1.12 — and it will not chase other expansions or client versions.

Who should try it

Good fit: someone already running a 1.12.1 core such as vmangos who wants an alternative client, or a developer who wants a readable reference implementation of WoW's formats and protocol. Poor fit: anyone who wants a packaged download — there are none, and the author explicitly pushes server-specific changes into forks — or who needs anticheat compatibility, since Warden is not planned and a server that enforces it will disconnect the session.

Requirements and limitations

You must own a 1.12.1 client (build 5875) in some locale for the game data; benilla only reads it and displays text in that client's language. You also need a 1.12.1 server, with WOW_HOST/WOW_USER/WOW_PASS or the login screen pointing at it. Building requires stable Rust and a C compiler, plus platform packages on Linux (ALSA, udev, pkg-config); the contributing guide covers tests and the player build. Settings, screenshots and addons live in benilla-config/, so addon installation is a folder drop rather than the original client's directory layout.

"Complete and fully playable" is the author's status claim; the remaining work is described as a long tail of small features, plus ongoing addon, options and performance work tracked in issues. Since there are no prebuilt artifacts, each release means checking out a tag and building, and the main branch is a development tip. Nothing in the supplied material reports performance or compatibility testing across servers beyond vmangos development.

HotRepo's take

HotRepo recorded one daily-board appearance: 2026-10-26, when the repo showed 819 stars and +13 that day. That single dated snapshot cannot establish whether interest persists — the evidence is insufficient, and the repository is only 94 days old. Before committing, read the deviations document for the specific 1.12.1 behaviour you depend on, especially interface and addon details.