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.15.1(1mo ago)010↓50%MITPHPPHP ^8.3CI passing

Since Jun 28Pushed 1mo agoCompare

[ 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 2w ago

READMEChangelog (4)Dependencies (3)Versions (26)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

40

—

FairBetter than 86% of packages

Maintenance91

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

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

25

Last Release

41d 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

[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k832.6k54](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.3M49](/packages/tencentcloud-tencentcloud-sdk-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

353.6k](/packages/eslazarev-wildberries-sdk)[flarum-lang/russian

Russian language pack for Flarum.

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

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

1941.0k](/packages/flarum-lang-french)

PHPackages © 2026

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