WoW Retail addon (Midnight / 12.x): the all-in-one LFG + Mythic+ companion. One modular addon covering the whole loop — finding a group, managing applicants, queueing, and running keys.
Status: alpha — all modules implemented, undergoing in-game testing. Every Blizzard API surface is probed defensively, so a renamed API degrades quietly instead of erroring.
| Module | What it does | Slash |
|---|---|---|
| Keystones | Own/party/guild/alt keystone registry with live sync (LFGS comms protocol), weekly affixes, keystone bag tooltip, auto-insert at the pedestal (off), auto-open at Lindormi |
/lfgs keys |
| Group Browser | Listing age / key level / leader score tags, double-click signup with remembered roles, refresh keybind | /lfgs refresh |
| Queue & Pop | Queue timer (LFD/LFR/BG), pop sound + flash, "what did I queue for" banner, auto-accept (off) | /lfgs banner |
| Applicants (leader) | Full applicant alerts + lifecycle log window — successor to LFGAlert, with one-command import | /lfgs applicants |
| M+ Timer | Run timer with +2/+3 cutoffs, deaths, affixes, personal bests | /lfgs timer demo |
| Enemy Forces | Forces progress bar + per-mob % on tooltips, community-taught data | /lfgs forces teach |
| Run Summary | End-of-run panel: time vs cutoffs, upgrade result, rating, PB | /lfgs summary |
| Loot Planner | Favorites with tiers, groupmate drop alerts, journal loot browser | /lfgs loot · /lfgs fav |
| Alt Roster | Account-wide alts: rating, ilvl, keys, Great Vault, lockouts | /lfgs roster |
/lfgs lists everything; /lfgs modules shows status; /lfgs config opens settings.
- LFGAlert: the Applicants module goes idle while LFGAlert is enabled (no double alerts).
/lfgs importpulls settings/log/stats, then disable LFGAlert to hand over. - Premade Sort / Premade Groups Filter: Browser defers its age tag to Premade Sort and never fights PGF's filters.
- Raider.IO: used as the preferred score source when installed.
- Details!: no overlap — Run Summary shows run stats, not damage meters.
- Copy the repo folder (containing
LFGSuite.toc) intoWorld of Warcraft\_retail_\Interface\AddOns\asLFGSuite. - Restart WoW. Enable "LFG Suite" in the AddOns list if needed.
/lfgs versionshould report the build;/lfgs moduleslists all modules.
- Architecture:
Core.lua(module registry + shared event bus) →Services.lua(Util / Affixes / Comms) →Modules/*.lua→Options.lua(settings + minimap). Feature roadmaps live in each module header and inPLAN.md. - Lua 5.1, no dependencies, no embedded libraries.
- Lint:
luacheck .(config in.luacheckrc; CI runs it on every push/PR). - Releasing: tag
vX.Y.Zand the BigWigs packager builds the CurseForge zip from.pkgmeta.
osso/wow-ui-sim runs the real Blizzard UI plus this
addon headlessly and renders screenshots. Setup (one-time): unzip the Windows build into
.sim/wow-ui-sim/, junction the repo as Interface\AddOns\LFGSuite inside it, and point
WOW_INSTALL_PATH at your WoW install (used for textures via CASC). Then:
.sim/sim.sh keystones # SOLO scene: only that module enabled + its UI
# (keystones browser queue applicants timer forces
# runsummary loot roster) -> .sim/shots/<module>.png
.sim/sim.sh all # every window in one scene -> .sim/shots/all.png
.sim/sim.sh gui # interactive windowed UI (type /lfgs, click around)
.sim/sim.sh tree # frame-tree dump (also shows print() output)
Edit a module, re-run its solo scene, compare the screenshot - the whole loop
takes seconds and never launches WoW. .sim/ is gitignored.
MIT (see LICENSE). All code is original. Feature inspiration (no code copied — several sources are ARR/GPL) from: Astral Keys, Better Keystone Display, BetterBlizzQueue, Details! Mythic+, IFTL, KeystoneLoot, LFG Inspect, MKS Helper, Mythic Plus Tweaks, Premade Sort, Premade Groups Filter, Premade Regions, WarpDeplete, AlterEgo, MythicPlusCount — and our own LFGAlert, whose applicant tracking + log window this addon succeeds.