wow-retail-backport

An Agent Skill + Python toolkit that backports any retail World of Warcraft item, transmog set, weapon or whole expansion to a WotLK 3.3.5a (build 12340) client - fitted to every race of that client, with measured rules and self-verifying gates.

Give it to Claude Code, Codex, OpenCode, Copilot or any agent that reads Agent Skills, point it at your 3.3.5a client, name what you want (“every Midnight set”, “Hallowfall Plate Armor with all its colourways”, “this one weapon”), and it runs a fixed, verified pipeline: retail tables and files in, a patch MPQ + client/server tables + server SQL out.

---

Contents

• What it does
• What a stock client can show
• Install the skill
• Quick start
• The pipeline
• Recipes
• How it fits any client and any race
• How it verifies itself
• Physics
• Repository layout
• Credits and data sources
• Legal

---

What it does

Retail WoW describes an item with database tables (which model each race and sex wears, which textures paint it, which body parts show, which hair a helm hides) and stores it in file formats a 3.3.5a client cannot read. This kit:

1. Reads retail - its DB2 tables and files at ONE pinned build, from wago.tools.
2. Reads your client - its archives in the client’s own priority, its races and body models, its tables, its free ids, its other patches. Stock, HD-patched or a custom realm client.
3. Converts every model, animation, texture, particle and table row with measured rules (each rule cites a retail table field, a wow.exe 12340 address or a measurement, and has a test).
4. Measures your client’s bodies (where each race wears a helm, which body geosets exist) and fits every item to them.
5. Writes the result - one patch MPQ (split automatically when large), the three extended client tables (also for the server), and item_template SQL for AzerothCore or TrinityCore.
6. Gates everything - crash, white, green, black, floating, vanishing, flying parts, missing files - and draws contact sheets you must look at.

Everything you add lives under a private folder and new ids above the client’s own: nothing of the client, the server or another patch is ever replaced.

What a stock client can show (Tier 1 vs Tier 2)