Ding

A free, open-source leveling guide for World of Warcraft: Forever (client 1.60). Ding shows what to do next, points the way with its own arrow and moves forward on its own as you accept, complete and turn in quests. It is built from the ground up to be played with a gamepad.

Download on CurseForge

Version 1.1, released during the Forever beta. Alliance 1–60: Human, Dwarf/Gnome and Night Elf starting zones up to level 20, then a common route to 60. Horde 1–60: Orc/Troll, Tauren and Undead starting zones up to level 20, then a common route to 60. Levels 30 to 60 have not been played in game yet (the beta stops at 30): they are checked by the offline tools only. Please report what you find in the issues.

Installation

1. Install QuestieDB first. It is a separate addon, not Questie, and it is not on CurseForge: the CurseForge app does not install it for you, and Ding does not load without it. Download QuestieDB-Forever.zip from the QuestieDB releases and extract it into World of Warcraft/_forever_/Interface/AddOns/ (during the beta: _classic_beta_ instead of _forever_). It must give a folder named exactly QuestieDB (not QuestieDB-master). The full Questie addon is not needed.
2. Install Ding from CurseForge, or copy the Ding/ folder of this repository to the same place.
3. In the game's addon list, check that both QuestieDB and Ding are enabled.

Ding has its own arrow: TomTom is not needed. If it is installed, its arrow can be used instead from the Arrow tab of the settings (off by default).

Features

• Guides optimized for XP per hour. The routes are generated offline from QuestieDB: quests grouped to avoid back-and-forth, poor-value detours left out, never a quest above your level (one level above at most). The new quests of Forever are included.
• Resumes where you really are. Ding picks the guide for your race, class and level. When you resume, it first sends you to finish the guide's old quests still in your log, then skips what you have done.
• Guide window. One line per action and objective, with counters (2/6), done / to do / not yet possible states and the guide's notes. Hover a line to see its quest (name, level, objectives); click it to send the arrow there. Right-click the window to mark the step as done or skip it for later: steps left by hand keep their own color (violet: marked done, amber: skipped). Minimizes to a single line, automatically in combat if you want. Closing it hides the arrow too; the minimap button brings both back.
• Waypoint arrow. Distance and time to the target, red with "turn around" when it is behind you. Among the monsters you have to kill, it tells you you're in the area. When you die, it leads your ghost back to your corpse.
• Automation. Accepts and turns in the guide's quests when you talk to an NPC (you still choose your reward), catches up on missing prerequisite quests, can skip gray quests.
• Quest item button. A floating button with the item the step needs: one press of a gamepad button uses it. Shows the cooldown and when you are out of range.
• Minimap button. Left-click for the settings, right-click to show or hide the guide.
• Languages. English, French, German, Spanish (Spain and Latin America), Brazilian Portuguese, Korean, Simplified and Traditional Chinese: Ding follows your game's language. Quest, NPC and item names come from QuestieDB in that language. Each language has its own files; to add one, see docs/SPEC.md (in French).

With a gamepad

On first launch, Ding opens its settings on the Keybinds tab: bind a button to "Open Ding settings" (for example LT+Start), then to "Next step", "Previous step" and "Use the quest item". In the settings window: A selects, B closes, LB / RB change tabs, the D-pad picks and adjusts, Y resets to default.

The guide window never takes a button away from the game. To browse it with the gamepad, bind "Browse the guide with the gamepad" (focus mode): the D-pad picks a line, A sends the arrow there (or uses the item), X shows its quest, LB / RB change steps, Y minimizes the window, B gives the gamepad back to the game.

The settings also move the window, the arrow and the item button with the D-pad, set the opacity and the size, minimize the guide in combat and pick the button names (Xbox or PlayStation). They also open from the window's menu button, the minimap button or Options > AddOns > Ding.

Commands

/ding show/hide · /ding config settings · /ding list · /ding guide <id> · /ding next · /ding prev · /ding skip · /ding back · /ding reset (take the guide up where you are) · /ding scale <0.5-1.5> · /ding arrow · /ding arrowflip · /ding minimap · /ding debug

Writing a guide

Guides are plain Lua files with quest ids, route points and notes: see docs/SPEC.md (in French). External guide packs can call Ding.RegisterGuide.

Development

Nothing runs in the game here: the offline tools load Ding with a mocked WoW API and play every guide. See tools/README.md and CLAUDE.md (in French). Every pull request runs the whole suite (.github/workflows/tests.yml); pushing a v* tag publishes the release on CurseForge and GitHub once the suite passes (.github/workflows/release.yml).

License

Ding is free software, released under the GNU GPL v3 (see LICENSE): you may use, modify and redistribute it, provided you publish your modified versions under the same license, with their source code.

Everything built on Ding stays free: a guide pack for Ding (an addon that calls Ding.RegisterGuide) is a derivative work and must be released under the GPL v3 as well. There is no exception.

The Noto Sans fonts in Ding/Media/Fonts are under the SIL Open Font License 1.1 (OFL.txt). QuestieDB and TomTom are separate addons; Ding ships none of their code or data.