Skip to content
This repository was archived by the owner on Nov 1, 2026. It is now read-only.
GREYsaurusPublic archive

About

Retired — development has moved to Questwarden: https://github.com/GREYsaurus/Questwarden. Formerly a free 1-70 leveling and talent guide add-on for WoW TBC Classic Anniversary.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

TBCGuide has been retired

TBCGuide is no longer maintained. Development has moved to Questwarden, the successor project encompassing both TBCGuide and ForeverGuide.

Please use Questwarden for current documentation, development, bug reports, and feature requests.

Questwarden includes TBCGuide's TBC Classic Anniversary data and 1-70 routes (from TBCGuide 0.9.5). Do not run TBCGuide and Questwarden at the same time: both would act on the same quests and NPCs.

This repository is retained for historical reference. The documentation below describes the retired project and may no longer be current.


Legacy documentation

TBCGuide

A free leveling guide and talent add-on for World of Warcraft: The Burning Crusade Classic (Anniversary realms, client 2.5.6, interface 20506).

Everything is in the base install. There are no guide packs, accounts, subscriptions or downloads after installing.

  • Level 1-70 guides for every race/class combination. There are 54 guides with 4,204 steps and 1,222 distinct quests, covering all 10 racial starts (including Draenei and Blood Elf), 32 Azeroth zones and all 7 Outland leveling zones. Every one of the 52 race/class combinations has a validated route from 1 to 70: the route audit walks all 52 and finds no impossible quest order, no quest-log overflow and no pickup that is never turned in (see docs/ROUTE_OPTIMIZATION.md).

  • Bundled TBC quest database, derived from QuestieDB: 6,648 quests, 7,302 NPCs, 1,325 objects and 3,919 items. It provides quest names, objectives, prerequisites, givers and coordinates. You do not need to install Questie.

  • Automatic progression from the quest log, quest-completion flags, level, hearthstone bind location and flight-path messages. Every step can also be completed or skipped by hand, so you never get stuck.

  • Navigation: a built-in arrow, a world-map pin, and optional TomTom waypoints.

  • Talent guide and calculator for all nine classes. Trees come straight from the 2.5.6 client data. There are 21 builds (leveling and level 70: tank, healer and DPS), each checked point by point for tier gating, prerequisites and the 61-point budget. You can compare a build with your real talents (your own class) or with a simulated allocation (any class).

  • Class leveling tips for every class.

  • Quest automation (new in 0.2.0): accepts and turns in the quests of your active guide. Escort quests are never auto-accepted, and you always choose your own reward. Hold Shift to skip it once.

  • Junk selling (new in 0.2.0, off by default): sells grey items at vendors, with protected items and categories, and quest items always kept.

  • Orphaned quests (new in 0.2.0): an Orphaned button on the quest log lists quests your route will never turn in, and abandons the ones you pick after a confirmation.

  • Maximum-speed route option: hides optional side quests.

  • Raid markers (new in 0.3.0): /tbcg mark skull, a marker bar, and guide steps that mark their quest NPC or kill target. Only NPCs the step names are marked, matched by NPC ID, and markers you or others set are never overwritten. See docs/RAID_MARKERS.md.

  • Settings window and profiles (new in 0.5.0): every option on tabs, with per-character profiles, plus flight, inn and gossip automation, junk tools, drowning and low-health warnings, a targeting macro and more. See docs/SETTINGS.md.

  • New in 0.9.0, our biggest update yet: a first-login setup, BoE and junk markers in Bagnon, AdiBags and Baganator, better support for non-English clients, class trainer suggestions on train steps, talent suggestions in the default talent window, an auction house Upgrades tab, window scale settings, and tidier 1-60 routes. See docs/TRAINER.md, docs/TALENTS.md, docs/BAGS.md and docs/AUCTION.md.

  • New in 0.7.0: opt-in automatic gear upgrades for your spec (never Bind-on-Equip items), BoE upgrade markers in bags, active item and target windows, flight timers, a leveling tracker with level splits, party announcements, single-dungeon selection, map pins for elites and treasures, and a new flat look. See docs/AUTO_EQUIP.md and docs/SETTINGS.md.

  • Gear scoring (new in 0.4.0): item tooltips show how an item compares with what you wear, and quest rewards are ranked in chat (you still choose). Scores use stat weights researched from TBC sources, with confidence shown. Specs and levels without published numbers get a stat-by-stat comparison instead of an invented score. See docs/GEAR_SCORING.md.

Details and defaults: docs/AUTOMATION.md.

Status: 0.1.0 has been loaded and played in the game client by the author. The 0.2.0 additions (quest automation, junk selling, orphaned quests and the route fixes) pass the offline checks: Lua 5.1 lint, the guide compiler, the content validator, the route audit, and 284 headless tests run under a real Lua 5.1 interpreter. They have not been run in the client yet. The in-game checklist is in docs/COMPATIBILITY.md, and limitations are in docs/KNOWN_LIMITATIONS.md.

Install

  1. Download. Use either:
    • the latest Release (right-hand side of this page): download TBCGuide-<version>.zip. The zip already contains the right folder; or
    • the green Code button, then Download ZIP. This downloads the whole repository.
  2. Close World of Warcraft.
  3. Copy the TBCGuide folder (the one containing TBCGuide.toc) into your AddOns folder:
    World of Warcraft\_anniversary_\Interface\AddOns\TBCGuide\TBCGuide.toc
    
    • If you used Download ZIP, extract it first. The TBCGuide folder is inside TBCGuide-main. Copy only that inner folder, not TBCGuide-main itself, or the game will not find the add-on.
    • The folder must be named exactly TBCGuide.
    • Create Interface\AddOns if it does not exist yet.
  4. Start the game. On the character screen, click AddOns and make sure TBCGuide is ticked. If it shows as out of date, tick Load out of date AddOns.
  5. Log in. The guide window opens with a guide picked for your character. Type /tbcg help for commands.

Optional: install TomTom to get its waypoint arrow as well.

Updating: delete the old Interface\AddOns\TBCGuide folder and copy in the new one. Your progress is kept, because it is saved under WTF\.

Troubleshooting: if the add-on does not appear in the list, check that the path ends in AddOns\TBCGuide\TBCGuide.toc with no extra folder level in between. If you see Lua errors, run /tbcg debug errors and open an issue with the output.

More detail, including building from source, is in INSTALL.md.

Use

Command Action
/tbcg Show/hide the guide window
/tbcg guide Guide browser (filter by faction, race, class, level and chapter; load or restart guides)
/tbcg talents Talent guide and calculator
/tbcg next / /tbcg prev / /tbcg skip Manual step control
/tbcg auto Load the recommended guide for this character
/tbcg nextguide Load the next guide in your route
/tbcg reset Reset the current guide's progress
/tbcg class Class leveling tips
/tbcg options The settings window (also the minimap button: left-click settings, right-click guide window)
/tbcg minimap Show/hide the minimap button
/tbcg automation Quest automation and junk-selling settings
/tbcg orphans Review and abandon quests your route will never turn in
/tbcg protect <item> / unprotect / protected Junk-selling protection list
/tbcg escort add|remove <questID> Extra quests that must never be auto-accepted
/tbcg mark [icon] / unmark Mark your target with a raid icon (skull, cross, ...) or clear it
/tbcg marker <icon> / markbar / markers Default marker, marker bar, raid marker settings
/tbcg gear (or /tbcgear) Equipped gear, empty slots and upgrades in your bags
/tbcg gear profiles / gear profile <id|auto> / gear options List or choose the gear scoring profile; gear settings
/tbcg set <option> on|off Change any on/off setting from chat
/tbcg debug / debug api / debug talents / debug quest <id> Diagnostics
/tbcg help All commands

In the guide window, left-click a step to mark it done and right-click it to skip it.

Licence

TBCGuide is free software under the GNU General Public License v3.0 only (LICENSE, COPYING). The full corresponding source is this repository; the release also ships a -source.zip. It includes the guide sources (guides-src/), the build tools (tools/), tests and docs, so you can inspect, modify, rebuild and redistribute it.

Bundled third-party data and its licensing situation are described in NOTICE.md and THIRD_PARTY_LICENSES.md. In particular, read what the QuestieDB upstream says about historic contributions.

For developers

About

Retired — development has moved to Questwarden: https://github.com/GREYsaurus/Questwarden. Formerly a free 1-70 leveling and talent guide add-on for WoW TBC Classic Anniversary.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages