Game plugin that adds World of Warcraft support to bbGuild.
- WoW Classes - All 13 playable classes (Warrior, Paladin, Hunter, Rogue, Priest, Death Knight, Shaman, Mage, Warlock, Monk, Druid, Demon Hunter) 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
- Battle.net API - Guild roster sync, character profiles, armory links, and portrait images
- Localization - Class and race names in English, French, German, and Italian
- phpBB >= 3.3.0
- PHP >= 7.4.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
bbguild_wow. - Copy the
bbguild_wowfolder to/ext/avathar/bbguild_wow/. - 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 docs/INSTALL.md 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/bbguild_wowfolder.
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
- Character profile data (level, class, race, achievements)
- Character portraits and armory links
- Guild emblem generation
The API client uses OAuth 2.0 Client Credentials Grant with the modern api.blizzard.com endpoints. See docs/BATTLENET_API.md for details.
- 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 docs/ARCHITECTURE.md for the plugin contract and structure.