# WoW Forever addons Seven small quality-of-life addons for WoW Forever (client 1.60.1, Interface 16001). | Addon | What it does | Check command | | --- | --- | --- | | Quest Item Tip | Item tooltips show the quest, its level and have / need. Warns when a quest item is no longer needed. | `/qit` | | Quest Craft Highlight | Highlights profession recipes whose crafted item an active quest needs. | `/qch` | | Vendor Flag | Marks items for 10 minutes after Auctionator warns they would earn more at a vendor. Requires [Auctionator](https://www.curseforge.com/wow/addons/auctionator). | `/vf` | | Quest Shopping List | A panel beside the auction house listing items your quests still need, with cost against the quest's reward. Click to search. Requires [Auctionator](https://www.curseforge.com/wow/addons/auctionator). | `/qsl` | | Dungeon Pre-Quest | Marks dungeon quests and quests whose chain leads to one, in the quest log, NPC quest lists and the quest offer window, with a purple "!" on the minimap for ones you can pick up now. | `/dpq ` | | Ship Routes | Draws every boat, zeppelin and airship route on the world map, coloured by faction. Hover a dock marker to see where it sails and light up its route, click it to open the destination's map. On a continent or zone map, a route that sails off it ends in a marker at the edge naming where it goes. | `/routes`, `/routes mine`, `/routes all` | | Fish Key | While you fish, the key you cast Fishing with clicks the bobber instead. It casts Fishing again once the fish is looted and the key is released. For the cast it turns the Interact Key setting on and press and hold casting off, then puts both back. | `/fish`, `/fish on`, `/fish off` | ## Install Copy the seven addon folders into `World of Warcraft/_forever_/Interface/AddOns/`, then type `/reload` in game. Each addon works on its own, so copy only the ones you want. Vendor Flag and Quest Shopping List stay disabled unless Auctionator is installed. ## Known limits - Vendor Flag only marks an item when Auctionator shows its vendor warning as you post. - Quest Item Tip's "can delete" only knows quests seen since it was installed. - Quest Craft Highlight doesn't highlight recipes inside collapsed categories until you expand them. - Dungeon Pre-Quest misses chains that QuestieDB has no links for, which includes many quests new to Forever. - Its minimap markers skip quests started by an item, and quests with profession or reputation requirements. - Quest Shopping List's prices are Auctionator's last-seen prices, so run "Search all" for current ones. Rewards count gold plus item value, not XP. - Ship Routes' dock names and the list of which paths are transports are curated by hand in `ShipRoutes/tools/generate.py`, because the client doesn't record which ship sails which path. Lanes between continents follow hand-placed sea waypoints there too, since the ships teleport mid-ocean. The Zephras Isle airships have no line, since the island isn't on the world map, and they have no known faction, so they show in neutral gold. - Fish Key finds Fishing on Blizzard's action bars, `CLICK` bindings to addon buttons, and spell or macro bindings. It doesn't see bar addons that bind keys through their own override bindings, such as Bartender. While you fish it raises the interact range to 30 yards, so a closer NPC or object can be picked over the bobber. ## Tests The tests run each addon against a mock of the WoW API, using stock Lua 5.1: ``` lua tests/test_qit.lua QuestItemTip/QuestItemTip.lua lua tests/test_qch.lua QuestCraftHighlight/QuestCraftHighlight.lua lua tests/test_vf.lua VendorFlag/VendorFlag.lua lua tests/test_dpq.lua DungeonPreQuest/DungeonPreQuest.lua lua tests/test_dpq_minimap.lua DungeonPreQuest/Minimap.lua lua tests/test_qsl.lua QuestShoppingList/QuestShoppingList.lua lua tests/test_sr.lua ShipRoutes lua tests/test_fk.lua FishKey/FishKey.lua ``` ## Regenerating Dungeon Pre-Quest's data `DungeonPreQuest/Data.lua` and `PinData.lua` are generated from QuestieDB and Questie, cloned locally: ``` lua DungeonPreQuest/tools/extract.lua merged.lua lua DungeonPreQuest/tools/generate.lua merged.lua DungeonPreQuest/Data.lua DungeonPreQuest/PinData.lua lua QuestShoppingList/tools/generate.lua merged.lua QuestShoppingList/Data.lua ``` ## Regenerating Ship Routes' data `ShipRoutes/Data.lua` comes from the client's own `TaxiPathNode.db2`, read out of the local game install (product `wowf`) with Python 3: ``` python3 ShipRoutes/tools/casc.py "" wowf out 1000437 python3 ShipRoutes/tools/generate.py out/1000437.db2 ShipRoutes/Data.lua ``` The generator stops if a route's stop isn't near a dock it knows, so a moved or new dock shows up as an error rather than a wrong name. `ShipRoutes/tools/icons.py ShipRoutes/Icons` redraws the marker textures. ## Credits and licence Dungeon Pre-Quest's data is derived from [QuestieDB](https://github.com/Questie/QuestieDB) and [Questie](https://github.com/Questie/Questie), both GPL-3.0. This project is released under the GNU General Public License v3.0, see [LICENSE.md](LICENSE.md). `DungeonPreQuest/Libs` bundles LibStub, CallbackHandler-1.0 and Questie's copy of HereBeDragons (BSD), each under its own licence.