bbGuild - World of Warcraft

Game plugin that adds World of Warcraft support to bbGuild.

Features

• 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
• Guild News - Activity feed portal module showing recent loots and achievement completions
• Localization - Class and race names in English, French, German, Italian, Spanish, Dutch, and Polish

Requirements

• phpBB >= 3.3.0
• PHP >= 7.4.0
• PHP cURL extension
• bbGuild core (avathar/bbguild) must be installed and enabled

Installation

1. Ensure bbGuild core (avathar/bbguild) is installed and enabled.
2. Download the latest release of bbguild_wow.
3. Copy the bbguild_wow folder to /ext/avathar/bbguild_wow/.
4. Navigate in the ACP to Customise -> Manage extensions.
5. Look for bbGuild - World of Warcraft under Disabled Extensions and click Enable.
6. 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.

Uninstall

1. Navigate in the ACP to Customise -> Extension Management -> Extensions.
2. Find bbGuild - World of Warcraft under Enabled Extensions and click Disable.
3. To permanently uninstall, click Delete Data and then delete the /ext/avathar/bbguild_wow folder.

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.

Battle.net API

This extension integrates with the Blizzard Battle.net API for:

• Automatic guild member synchronization with AJAX batch processing
• Character profile data (level, class, race, specialization, achievements)
• Character portraits via Character Media API (batch sync)
• Guild emblem generation (stored in phpBB's files/ directory)
• 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 docs/BATTLENET_API.md for details.

Documentation

• 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

For Developers

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.

License

GNU General Public License v2

Links

• bbGuild Core
• Support Forum
• Issue Tracker