RGX-Framework

Overview

RGX-Framework is a modern, shared WoW addon framework for Retail, WoW Forever, Classic Era, TBC, Wrath/Titan, Cataclysm, and Mists. One dependency provides events, timers, hooks, slash commands, saved-variable helpers, fonts, colors, textures, dropdowns, UI controls, minimap buttons, options panels, aura helpers, combat callbacks, sound, and more without LibStub embedding. It is not a player-facing addon: it loads silently and exposes an API.

Current Release

• Current release: v2.7.14
• Retail: 120100
• WoW Forever (beta): 16001
• Classic Era: 11509
• TBC: 20506
• Wrath/Titan: 38002
• Cataclysm: 40402
• Mists: 50504

What It Provides

• Lifecycle — OnReady, OnLogin, module readiness tracking
• Events & Messages — Blizzard event registration, internal message bus, module-local emitters
• Timers — After, Every, CancelTimer on a native OnUpdate driver
• Hooks — safe post-hooks via hooksecurefunc
• Slash Commands — RegisterSlashCommand, no raw SLASH_ boilerplate
• Combat Queue — QueueForCombat, SafeShow, SafeHide, SafeSetPoint
• Fonts — 40 bundled + 4 WoW defaults, style objects, grouped dropdowns
• Colors — named palette, class/quality/power colors, color math, picker integration
• Textures — statusbar registry, LibSharedMedia import
• Dropdowns & UI — nested menus, sliders, toggles, color pickers, tabbed options panels with WoW Settings integration
• Minimap — circular-drag buttons with persistent angle
• Design — static brand palette and visual building blocks
• DataBroker — LibDataBroker-compatible proxy data sources
• Game Modules — Combat, Reputation, Achievement, LevelUp, Collectibles, Loot, Quest, Honor, Delves, Housing, TradingPost, Prey, PetBattles, Sound, SharedMedia. Availability is capability-gated per client; Retail-only features are not promised on Classic or Forever.

Quick Start

## RequiredDeps: RGX-Framework
## SavedVariables: MyAddonDB

RGXAddon "MyAddon" {
  slash = "myaddon",
  minimap = true,
  db = { enabled = true },
  options = {
    General = {
      { toggle = "enabled", label = "Enable addon" },
    },
  },
}

This declaration creates profile-aware saved settings, a tabbed options panel with a bound enable control, a slash command, and a minimap button. Consumers can use the chat-output API; the framework itself has no startup announcement. Individual systems are also available à la carte through RGX:RegisterEvent, RGX:After, RGX:GetFonts(), RGX:GetColors(), RGX:CreateMinimapButton, and friends.

Font Coverage

44 registered fonts: 40 bundled (30 selectable across Sans/UI, Serif, Monospace, Display, Pixel, and Fantasy families) plus 4 WoW defaults (Friz Quadrata, Arial Narrow, Morpheus, Skurri). Font pack addons can extend the registry at runtime with Fonts:RegisterFontPack(). Attribution for all bundled fonts lives in Font Sources & Licenses.

Documentation & Support

• Full Wiki — Super Simple Integration · Migration Guide
• API Reference · Architecture · Declarative API · Troubleshooting
• Fonts · Dropdowns · Theming & Design · Changelog
• GitHub Issues · Discord: https://discord.gg/N7kdKAHVVF

Distribution

RGX-Framework publishes one runtime-only addon product. The GitHub release contains RGX-Framework-v2.7.14.zip plus release.json automation metadata. Source documentation, schemas, tests, and tooling are not included in player installs. Framework code is licensed under the MIT License; bundled fonts retain their own open licenses.