Armory

A World of Warcraft armory for Flarum 2. Members sign in

with Battle.net, and the extension pulls their characters straight from the

Blizzard API — gear with hover tooltips, stats, talents, Mythic+/raid progress,

professions, PvP ratings, reputations and collections — on a tabbed, theme-aware

character page that looks at home in light or dark mode.

Free and open source (MIT). The companion Convoro build

shares the same data engine.

Features

• Battle.net OAuth — one click to connect; characters sync automatically.

• Full character page at /armory with tabs:

  • Gear — every slot with a big 3D character render and Wowhead-style item tooltips (item level, stats, sockets, set bonuses, sell price).

  • Stats — primary + secondary stats, defenses and resources.

  • Talents — active spec, talents, and the in-game loadout import string.

  • PvE — Mythic+ rating and best weekly runs, plus raid progress.

  • Professions — primary and secondary, with tier skill.

  • PvP — honor level and rated 2v2 / 3v3 / RBG ratings.

  • Reputations and Achievements / Collections (points, mounts, pets).

• Roster sidebar to switch between your characters; pick a main, hide alts.

• Role-Play tie-in — if ernestdefoe/roleplay is installed, an Add to Role-Play button imports a WoW character as a playable Role-Play character: a combat sheet (HP + might/agility/wits/heart scaled from item level and primary stats) plus a deck of signature class ability cards whose damage dice scale with item level. Re-run after a gear upgrade to rescale.

• Theme-aware — colors follow your forum's light/dark scheme.

• Caching — character data is cached so the page stays fast and stays well

  under Blizzard's rate limits.

Setup

1. Install:

   
   php flarum migrate
   php flarum cache:clear   ```

2. Create a Battle.net API client at

   develop.battle.net/access/clients.

   Set the Redirect URL to https://YOUR-FORUM/auth/battlenet/callback.

3. In Admin → Armory, paste the Client ID and Client Secret, and

   choose your default region (Americas / Europe / Korea / Taiwan).

4. Members open Armory from the navigation and click Connect Battle.net.

How it works

Public character data (gear, stats, raids, …) is fetched with an app-level

client-credentials token, so refreshes never require the member to sign in

again. The member's wow.profile token is used only once — to discover which

characters belong to them.

License

MIT © ernestdefoe