bbGuild WoW is the World of Warcraft plugin for bbGuild, a guild management extension for phpBB with roots in bbDKP and EQdkp. It brings WoW guild management into your forum, connecting to Blizzard’s Battle.net API to synchronize guild rosters, character profiles, specializations, equipment, and portraits. With support for Retail and Classic editions, plus an integrated achievement browser and guild activity feed, it helps your community keep track of its characters and progress in one place.
- 2.1.1 (requires bbGuild core >= 2.1.0)
Documentation: avatharbe.github.io/bbguildwow
- WoW Classes - All 14 playable classes (Warrior, Paladin, Hunter, Rogue, Priest, Death Knight, Shaman, Mage, Warlock, Monk, Druid, Demon Hunter, Evoker) with color codes and level ranges
- WoW Races - 15 playable races across Alliance and Horde factions, including Pandaren
- WoW Factions - Alliance and Horde with faction-based guild styling
- WoW Classic Support - Retail, Classic Era, Classic Progression, and Classic Anniversary editions with edition-aware API namespaces
- Battle.net API - OAuth 2.0 guild roster sync, character profiles, specializations, armory links, and portrait images
- Achievement Browser - 3-level drill-down: category cards with SVG progress rings, achievement lists, and detail modals via AJAX
- Gear Tooltips - Equipped items render through bbTips' item-anchor builder, with captured enchant/gem/bonus IDs so tooltips reflect a character's actual itemization, not just the base item
- Per-Character Sync - Implements bbGuild core's character-sync scheduler contract, so a background cron keeps specs/equipment/portraits fresh incrementally alongside the existing manual full-sync buttons
- Guild News - Activity feed portal module showing recent loots, achievement completions, and (via the Battle.net Guild Activity API) roster/guild events
- Localization - Class and race names in English, French, German, Italian, Spanish, Dutch, and Polish
- phpBB >= 3.3.0
- PHP >= 8.1.0
- PHP cURL extension
- bbGuild core (
avathar/bbguild) must be installed and enabled
- Ensure bbGuild core (
avathar/bbguild) is installed and enabled. - Download the latest release of
bbguildwow. - Copy the
bbguildwowfolder to/ext/avathar/bbguildwow/. - Navigate in the ACP to
Customise -> Manage extensions. - Look for
bbGuild - World of Warcraftunder Disabled Extensions and clickEnable. - Go to ACP > bbGuild > Games and install the World of Warcraft game.
See the Installation Guide for detailed setup instructions including Battle.net API configuration.
- Navigate in the ACP to
Customise -> Extension Management -> Extensions. - Find
bbGuild - World of Warcraftunder Enabled Extensions and clickDisable. - To permanently uninstall, click
Delete Dataand then delete the/ext/avathar/bbguildwowfolder.
Note: Disabling the extension does not delete existing guild or player data from the database. Your roster and player records remain intact in bbGuild core. Only the WoW installer, API integration, and game-specific images become unavailable.
This extension integrates with the Blizzard Battle.net API for:
- Automatic guild member synchronization with AJAX batch processing, plus an incremental per-character background sync (specs, equipment, portraits) via bbGuild core's cron scheduler
- Character profile data (level, class, race, specialization, achievements)
- Character equipment detail (enchants, gems, bonus IDs, set pieces) for accurate bbTips tooltips
- Character portraits via Character Media API (batch sync)
- Guild emblem generation (stored in phpBB's
files/directory) - Guild activity feed (roster/guild events surfaced as guild news)
- Achievement category and progress synchronization
- Edition-aware API namespaces for WoW Classic support
The API client uses OAuth 2.0 Client Credentials Grant with the modern api.blizzard.com endpoints and supports all five regions (US, EU, KR, TW, SEA). See the Battle.net API Reference for details.
Full documentation site: avatharbe.github.io/bbguildwow
- Installation Guide - Step-by-step setup
- Battle.net API Reference - API integration details and known issues
- FAQ - Frequently asked questions
- Changelog - Version history
- Architecture - How the plugin system works
This extension serves as the reference implementation for bbGuild game plugins. If you want to create a plugin for another game, see the Architecture page for the plugin contract and structure.