Quick WoW Talents Addon

Offline World of Warcraft addon for Quick WoW Talents import strings.

The addon bundles current recommended talent import strings from Quick WoW Talents and shows the best match for your current specialization in-game. It does not call Warcraft Logs, Quick WoW Talents, or any external service from inside WoW.

What it does

Run:

/qwt

The addon detects your current specialization and opens a small selector with:

• mode dropdown: Mythic+ or Heroic Raid
• encounter dropdown:
  • Mythic+: dungeon selector plus Best Overall
  • Raid: current Heroic raid boss selector
• copyable Blizzard talent import string

When you enter a supported Mythic+ dungeon and the bundle has a build for your current specialization, the addon automatically opens the matching dungeon recommendation once. It waits briefly after zoning so WoW's instance APIs can settle, never opens during combat, and will not keep reopening after you close it for the current instance context.

The addon only chooses between bundled strings. You still copy the string and import it through Blizzard's normal Talent Loadout UI.

Extra commands:

/qwt info
/qwt hide
/qwt auto status
/qwt auto on
/qwt auto off

Automatic opening is enabled by default. Use /qwt auto off if you prefer fully manual /qwt behavior.

Install

1. Download the latest QuickWoWTalents-<version>.zip from the GitHub releases page.

2. Extract the zip into your retail AddOns directory:

   World of Warcraft/_retail_/Interface/AddOns/
   

3. Confirm the folder structure looks like this:

   World of Warcraft/_retail_/Interface/AddOns/QuickWoWTalents/QuickWoWTalents.toc
   World of Warcraft/_retail_/Interface/AddOns/QuickWoWTalents/QuickWoWTalents.lua
   World of Warcraft/_retail_/Interface/AddOns/QuickWoWTalents/QuickWoWTalentsData.lua
   

4. Restart WoW or run:

   /reload
   

5. Run:

   /qwt
   

Updating

Install the newest zip from Releases over the existing QuickWoWTalents folder.

Automated release checks are scheduled daily at 15:30 UTC, after the public Quick WoW Talents cache should be warm. A new release is published only when the bundled recommendation data actually changes.

Data source and privacy

• Source data comes from cached Quick WoW Talents recommendations.
• The generated addon data is bundled into QuickWoWTalentsData.lua.
• The addon is fully static/offline in-game.
• No in-game network calls are made.
• No player data is uploaded by the addon.
• Automatic Mythic+ opening only reads local WoW client context APIs such as current specialization, instance state, and current challenge map.

Known limitations

• Import strings can become stale after Blizzard talent-tree or interface changes. Update to the latest release first if an import fails.
• The addon displays/copies import strings; it does not directly create or modify talent loadouts.
• Current bundled recommendations focus on Quick WoW Talents' supported public recommendation set.
• Automatic opening currently targets Mythic+ only. Raid recommendations remain available through the manual selector because exact boss context is not reliably known before pull.
• Automatic Mythic+ matching depends on the current season's client dungeon IDs. Unsupported or future dungeons simply fall back to manual /qwt behavior.

Repository layout

The addon source files live at the repository root on purpose:

QuickWoWTalents.toc
QuickWoWTalents.lua
QuickWoWTalentsData.lua

This matches established CurseForge-packaged addon repositories and lets CurseForge automatic packaging put those files into the final QuickWoWTalents/ addon folder via .pkgmeta.

Local development

Requirements:

• Node.js 20+
• zip or macOS ditto for packaging

Install dependencies:

npm install

Run tests:

npm test

Download the product-side generated addon data artifact:

npm run build:data:download

Generate data from individual cached public build payloads instead:

npm run build:data

Quick small test export for one spec:

node scripts/build-data.mjs --spec "Warlock:Demonology" --delay-ms 1200

Package a release zip:

npm run package

Creates:

dist/QuickWoWTalents-<package-version>.zip

Daily release pipeline

GitHub Actions runs .github/workflows/daily-release.yml every day at 15:30 UTC and can also be started manually with Run workflow.

Manual runs default to a fast dry-run that generates one spec, runs checks, and packages locally without committing, tagging, or publishing. Set dry_run=false only when intentionally publishing a manual full release.

The pipeline:

1. downloads QuickWoWTalentsData.lua from the product-side addon data artifact at quickwowtalents.com
2. skips publishing if the bundled recommendation data is unchanged
3. bumps the addon patch version in package.json and QuickWoWTalents.toc when a release is needed
4. moves CHANGELOG.md Unreleased notes into the new version and adds commit subjects since the previous release tag
5. writes CURSEFORGE_CHANGELOG.md with only the new version's notes for CurseForge automatic packaging
6. verifies scripts and tests
7. packages the addon zip
8. commits the generated data/version/changelog bump to main
9. creates a matching Git tag and GitHub release with the zip asset and versioned changelog notes

No GitHub secrets are required beyond the built-in GITHUB_TOKEN.

Support

Please open an issue with:

• addon version
• WoW client version
• class/spec
• what /qwt info shows
• the import error or behavior you saw

License

Copyright (c) 2026 Darragh. All rights reserved.