-
Notifications
You must be signed in to change notification settings - Fork 1
Interacting with the Blizzard API
This page explains the practical boundary between BLU and Blizzard's WoW API.
BLU uses Blizzard's API to:
- detect gameplay events
- read addon metadata
- load and unload addon modules
- play sound files and sound kits
- interact with the WoW settings and addon environment
BLU does not ship its own external framework for these basics. It relies on the game's API and its own internal systems.
BLU listens for WoW events tied to supported gameplay moments, such as:
- level changes
- quest events
- achievement updates
- reputation gains
- Retail-specific system events
BLU uses WoW sound playback functions to:
- play Blizzard sound kits
- play addon file paths under
Interface\AddOns\ - test custom and external sound files
BLU reads addon metadata to:
- get version information
- detect addon names and compatibility data
- help identify some external sound pack sources
If your addon wants to work with BLU:
- keep your sound files under
Interface\AddOns\YourAddon\... - use valid WoW-readable addon file paths
- register simple packs with
BLU:RegisterExternalSoundPack(...) - register full BLU-compatible 3-variant packs with
BLU:RegisterSoundPack(...)
See BLU Sound Pack Guide for concrete examples.
- WoW API behavior can change between major patches.
- Retail-only systems should not be assumed to exist in Classic.
- Some BLU integrations are intentionally defensive so unsupported or missing addons do not break the UI.
Join the vibrant BLU community to ask questions, share ideas, and contribute to the project’s development.
- BLU Discussions: Connect with other BLU users, ask questions, and share your experiences.
- Report Issues: Found a bug or have a feature request? Report it in the Issues section.
If you find BLU helpful and want to support its continued development, you can contribute in several ways:
- Buy Me a Coffee: Show your appreciation and support the project with a small donation.
- Donate via CashApp: Another option to support BLU financially.
Follow the latest developments and updates to BLU by checking out our changelog and releases. Be sure to star the project on GitHub to show your support and receive notifications on new releases.
Thank you for being a part of the BLU community! This wiki is here to help you make the most of your experience with BLU. If you have any questions or suggestions, feel free to contribute to the discussions or contact the maintainers.