PHPackages                             ernestdefoe/armory - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. ernestdefoe/armory

ActiveFlarum-extension[Authentication &amp; Authorization](/categories/authentication)

ernestdefoe/armory
==================

Armory for Flarum 2 — Battle.net sign-in + a full World of Warcraft character armory: class-colored character cards on profiles and a tabbed character page (gear with item tooltips + 3D render, stats, talents, Mythic+, raids, professions, PvP, reputations, achievements). Dependency-free Battle.net OAuth + the official Blizzard WoW API.

v0.2.1(3d ago)01↑2900%MITPHPPHP ^8.3CI passing

Since Jun 28Pushed todayCompare

[ Source](https://github.com/ernestdefoe/armory)[ Packagist](https://packagist.org/packages/ernestdefoe/armory)[ Docs](https://github.com/ernestdefoe/armory)[ RSS](/packages/ernestdefoe-armory/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (1)Versions (4)Used By (0)

Armory
======

[](#armory)

A **World of Warcraft armory** for [Flarum 2](https://flarum.org). 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](https://convoro.co) build shares the same data engine.

Features
--------

[](#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](https://github.com/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
-----

[](#setup)

1. Install: ```
    composer require ernestdefoe/armory
    php flarum migrate
    php flarum cache:clear
    ```
2. Create a Battle.net API client at [develop.battle.net/access/clients](https://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
------------

[](#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
-------

[](#license)

[MIT](LICENSE) © ernestdefoe

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance100

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

3d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c9978664264055711c21fbcf73c937f758df771d9cb40f6a25370b10123e7abc?d=identicon)[ernestdefoe](/maintainers/ernestdefoe)

---

Top Contributors

[![ernestdefoe](https://avatars.githubusercontent.com/u/24905286?v=4)](https://github.com/ernestdefoe "ernestdefoe (20 commits)")

---

Tags

wowbattle.netwarcraftflarumflarum-extensionarmory

### Embed Badge

![Health badge](/badges/ernestdefoe-armory/health.svg)

```
[![Health](https://phpackages.com/badges/ernestdefoe-armory/health.svg)](https://phpackages.com/packages/ernestdefoe-armory)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1938.7k](/packages/flarum-lang-french)[fof/oauth

Allow users to log in with GitHub, Facebook, Google, Discord, GitLab, LinkedIn, and more!

50131.1k45](/packages/fof-oauth)[maicol07/flarum-ext-sso

SSO for Flarum

468.7k](/packages/maicol07-flarum-ext-sso)[fof/doorman

Create invite codes for users to sign up and be assigned to a group

2540.1k2](/packages/fof-doorman)[fof/terms

Ask users to accept terms of use before using the forum

1378.0k1](/packages/fof-terms)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
