Add files via upload

Core.lua

@@ -6,7 +6,7 @@ RelationshipsAttune = RelationshipsAttune or {}
 local RA = RelationshipsAttune
 local L  = RelationshipsAttune_L
 
-RA.VERSION      = "1.3.0"
+RA.VERSION      = "1.4.0"
 RA.COMM_PREFIX  = "RATTUNE"
 
 RA.playerName    = nil
@@ -58,7 +58,7 @@ function RA:InitDB()
     end
     local o = RelationshipsAttuneDB.options
     if o.autoShare       == nil     then o.autoShare       = true end
-    if o.autoScanSeconds == nil     then o.autoScanSeconds = 20   end
+    if o.autoScanSeconds == nil     then o.autoScanSeconds = 10   end
     if type(o.minimapAngle)  ~= "number" then o.minimapAngle  = 200 end
     if type(o.minimapRadius) ~= "number" then o.minimapRadius = 80  end
     if o.minimapHide == nil then o.minimapHide = false end
@@ -472,16 +472,27 @@ end
 -- Throttled auto-scan
 -- ---------------------------------------------------------------
 RA._throttle    = 0
+RA._periodic    = 0
 RA._dirty       = false
-RA._minRescan   = 2.0
+RA._minRescan   = 1.5
 
 function RA:MarkDirty() RA._dirty = true end
 
+-- Full periodic rescan (quest log + bags + recompute + UI refresh).
+function RA:AutoScan()
+    RA:ScanQuestLog()
+    RA:ScanBags()
+    RA:RecomputeAll()
+    if RA.UI and RA.UI.Refresh then RA.UI:Refresh() end
+end
+
 function RA:_OnUpdate(elapsed)
-    RA._throttle = RA._throttle + (elapsed or 0)
+    elapsed = elapsed or 0
+    RA._throttle = RA._throttle + elapsed
+    RA._periodic = RA._periodic + elapsed
     local interval = (RelationshipsAttuneDB and RelationshipsAttuneDB.options
-                      and RelationshipsAttuneDB.options.autoScanSeconds) or 20
+                      and RelationshipsAttuneDB.options.autoScanSeconds) or 10
-    if interval < 5 then interval = 5 end
+    if interval < 3 then interval = 3 end
 
     if RA._retryAt and GetTime then
         local now = GetTime()
@@ -508,22 +519,22 @@ function RA:_OnUpdate(elapsed)
         end
     end
 
+    -- Event-driven rescan: something changed, catch up quickly.
     if RA._dirty and RA._throttle >= RA._minRescan then
         RA._dirty = false
         RA._throttle = 0
-        RA:ScanQuestLog()
+        RA._periodic = 0
-        RA:ScanBags()
+        RA:AutoScan()
-        RA:RecomputeAll()
-        if RA.UI and RA.UI.Refresh then RA.UI:Refresh() end
         return
     end
 
-    if RA._throttle >= interval then
+    -- Unconditional periodic rescan so state stays fresh even if no events fire
+    -- (e.g. reputation ticks from mob kills, quest turn-ins on stock 1.12
+    -- without QUEST_TURNED_IN, background item pickups by other addons).
+    if RA._periodic >= interval then
+        RA._periodic = 0
         RA._throttle = 0
-        RA:ScanQuestLog()
+        RA:AutoScan()
-        RA:ScanBags()
-        RA:RecomputeAll()
-        if RA.UI and RA.UI.Refresh then RA.UI:Refresh() end
     end
 end
 
@@ -632,6 +643,11 @@ ef:RegisterEvent("CHAT_MSG_ADDON")
 -- pcall prevents a hard failure on builds that don't recognise them.
 pcall(function() ef:RegisterEvent("QUEST_TURNED_IN") end)
 pcall(function() ef:RegisterEvent("KEYRING_UPDATE") end)
+pcall(function() ef:RegisterEvent("UNIT_INVENTORY_CHANGED") end)
+pcall(function() ef:RegisterEvent("ITEM_PUSH") end)
+pcall(function() ef:RegisterEvent("PLAYER_XP_UPDATE") end)
+pcall(function() ef:RegisterEvent("ZONE_CHANGED_NEW_AREA") end)
+pcall(function() ef:RegisterEvent("SKILL_LINES_CHANGED") end)
 
 ef:SetScript("OnEvent", function()
     local e = event
@@ -662,7 +678,12 @@ ef:SetScript("OnEvent", function()
         or e == "BAG_UPDATE"
         or e == "KEYRING_UPDATE"
         or e == "PLAYER_LEVEL_UP"
-        or e == "UPDATE_FACTION" then
+        or e == "UPDATE_FACTION"
+        or e == "UNIT_INVENTORY_CHANGED"
+        or e == "ITEM_PUSH"
+        or e == "PLAYER_XP_UPDATE"
+        or e == "ZONE_CHANGED_NEW_AREA"
+        or e == "SKILL_LINES_CHANGED" then
         if RA.initialized then RA:MarkDirty() end
 
     elseif e == "QUEST_TURNED_IN" then

Data.lua

@@ -19,16 +19,13 @@
 -- final=true marks the "you are attuned" step so that if it's complete
 -- the whole attunement is treated as done (used for quest-only chains
 -- that have no key item at the end, e.g. Naxx/BWL/MC).
-
 local ICON_QUEST  = "Interface\\GossipFrame\\AvailableQuestIcon"
 local ICON_ACTIVE = "Interface\\GossipFrame\\ActiveQuestIcon"
 local ICON_KEY    = "Interface\\Icons\\INV_Misc_Key_03"
 local ICON_LEVEL  = "Interface\\Icons\\Spell_Nature_EnchantArmor"
 local ICON_REP    = "Interface\\Icons\\Achievement_Reputation_01"
 local ICON_ITEM   = "Interface\\Icons\\INV_Misc_QuestionMark"
-
 RelationshipsAttune_Data = {
-
     ----------------------------------------------------------------
     -- ONYXIA'S LAIR - full Drakefire Amulet chain (both factions)
     ----------------------------------------------------------------
@@ -38,7 +35,6 @@ RelationshipsAttune_Data = {
         steps = {
             { type = "level", level = 55, name = "Reach Level 55", icon = ICON_LEVEL,
               desc = "Minimum level to start either faction's Onyxia attunement chain." },
-
             ------------------------------------------------------------------
             -- ALLIANCE CHAIN
             ------------------------------------------------------------------
@@ -49,47 +45,47 @@ RelationshipsAttune_Data = {
             { type = "quest", id = 4183, faction = "Alliance",
               name = "The True Masters (Helendis)", icon = ICON_QUEST,
               desc = "Deliver Helendis Riverhorn's Letter to Magistrate Solomon in Lakeshire.",
-              start = "Helendis Riverhorn, Morgan's Vigil, Burning Steppes (86, 69)." },
+              start = "Helendis Riverhorn, Morgan's Vigil, Burning Steppes (86, 69). Solomon: Lakeshire town hall, Redridge (30, 44)." },
             { type = "quest", id = 4184, faction = "Alliance",
               name = "The True Masters (Solomon -> Bolvar)", icon = ICON_QUEST,
               desc = "Take Solomon's Plea to Highlord Bolvar Fordragon in Stormwind Keep.",
-              start = "Magistrate Solomon, Lakeshire town hall, Redridge Mountains (30, 44)." },
+              start = "Magistrate Solomon, Lakeshire town hall, Redridge Mountains (30, 44). Bolvar: Stormwind Keep throne room (78, 18)." },
             { type = "quest", id = 4185, faction = "Alliance",
               name = "The True Masters (Prestor)", icon = ICON_QUEST,
               desc = "Speak with Lady Katrana Prestor, then return to Bolvar.",
-              start = "Highlord Bolvar Fordragon, Stormwind Keep throne room (78, 18)." },
+              start = "Highlord Bolvar Fordragon, Stormwind Keep throne room (78, 18). Prestor stands next to him." },
             { type = "quest", id = 4186, faction = "Alliance",
               name = "The True Masters (Bolvar's Decree)", icon = ICON_QUEST,
               desc = "Return Bolvar's Decree to Magistrate Solomon in Lakeshire.",
-              start = "Highlord Bolvar Fordragon, Stormwind Keep (78, 18)." },
+              start = "Highlord Bolvar Fordragon, Stormwind Keep (78, 18). Solomon: Lakeshire, Redridge (30, 44)." },
             { type = "quest", id = 4223, faction = "Alliance",
               name = "The True Masters (Maxwell)", icon = ICON_QUEST,
               desc = "Report to Marshal Maxwell at Morgan's Vigil.",
-              start = "Magistrate Solomon, Lakeshire, Redridge Mountains (30, 44)." },
+              start = "Magistrate Solomon, Lakeshire, Redridge Mountains (30, 44). Maxwell: Morgan's Vigil, Burning Steppes (85, 69)." },
             { type = "quest", id = 4224, faction = "Alliance",
               name = "The True Masters (Ragged John)", icon = ICON_QUEST,
               desc = "Find Ragged John in a cave north of Thaurissan, then return to Maxwell.",
-              start = "Marshal Maxwell, Morgan's Vigil, Burning Steppes (85, 69). Ragged John: cave at (65, 24)." },
+              start = "Marshal Maxwell, Morgan's Vigil, Burning Steppes (85, 69). Ragged John: cave at Burning Steppes (65, 24)." },
             { type = "quest", id = 4241, faction = "Alliance",
               name = "Marshal Windsor", icon = ICON_QUEST,
               desc = "Enter Blackrock Depths and find Marshal Windsor in his cell.",
-              start = "Marshal Maxwell, Morgan's Vigil, Burning Steppes (85, 69). BRD: Blackrock Mountain." },
+              start = "Marshal Maxwell, Morgan's Vigil, Burning Steppes (85, 69). BRD entrance: Blackrock Mountain (~30, 37) in Burning Steppes." },
             { type = "quest", id = 4242, faction = "Alliance",
               name = "Abandoned Hope", icon = ICON_QUEST,
               desc = "Return the bad news from Windsor to Marshal Maxwell.",
-              start = "Marshal Windsor, Windsor Cell, Blackrock Depths jail." },
+              start = "Marshal Windsor, Windsor Cell, Blackrock Depths jail (inside BRD, entrance at Blackrock Mountain ~30, 37, Burning Steppes)." },
             { type = "quest", id = 4264, faction = "Alliance",
               name = "A Crumpled Up Note", icon = ICON_QUEST,
               desc = "Random drop item from BRD slaves/mobs; return it to Windsor.",
-              start = "Loot A Crumpled Up Note from BRD slaves (outside instance) or trash inside." },
+              start = "Loot A Crumpled Up Note from BRD slaves (Shadowforge City) or trash inside Blackrock Depths (entrance Blackrock Mountain ~30, 37, Burning Steppes)." },
             { type = "quest", id = 4282, faction = "Alliance",
               name = "A Shred of Hope", icon = ICON_QUEST,
               desc = "Kill General Angerforge and Golem Lord Argelmach in BRD and loot Windsor's Lost Information from each.",
-              start = "Marshal Windsor, Windsor Cell, Blackrock Depths jail." },
+              start = "Marshal Windsor, Windsor Cell, Blackrock Depths jail (BRD entrance Blackrock Mountain ~30, 37, Burning Steppes)." },
             { type = "quest", id = 4322, faction = "Alliance",
               name = "Jail Break!", icon = ICON_QUEST,
               desc = "Escort Marshal Windsor out of BRD, then report to Marshal Maxwell.",
-              start = "Marshal Windsor, Windsor Cell, Blackrock Depths jail." },
+              start = "Marshal Windsor, Windsor Cell, Blackrock Depths jail. Turn in to Maxwell, Morgan's Vigil, Burning Steppes (85, 69)." },
             { type = "quest", id = 6402, faction = "Alliance",
               name = "Stormwind Rendezvous", icon = ICON_QUEST,
               desc = "Speak to Squire Rowe at the Stormwind gates to summon Reginald Windsor.",
@@ -97,7 +93,7 @@ RelationshipsAttune_Data = {
             { type = "quest", id = 6403, faction = "Alliance",
               name = "The Great Masquerade", icon = ICON_ACTIVE,
               desc = "Escort Reginald Windsor to Stormwind Keep; unmask Lady Prestor as Onyxia.",
-              start = "Reginald Windsor, Stormwind City gates (after Rendezvous)." },
+              start = "Reginald Windsor, Stormwind City gates (70, 86) after Rendezvous; escort ends in Stormwind Keep (78, 18)." },
             { type = "quest", id = 6501, faction = "Alliance",
               name = "The Dragon's Eye", icon = ICON_QUEST,
               desc = "Take the Fragment of the Dragon's Eye to Haleh in Mazthoril, Winterspring.",
@@ -105,8 +101,7 @@ RelationshipsAttune_Data = {
             { type = "quest", id = 6502, faction = "Alliance",
               name = "Drakefire Amulet (Alliance)", icon = ICON_ACTIVE,
               desc = "Kill General Drakkisath in Upper Blackrock Spire and loot Blood of the Black Dragon Champion; return to Haleh.",
-              start = "Haleh, Mazthoril cave, Winterspring (55, 51)." },
+              start = "Haleh, Mazthoril cave, Winterspring (55, 51). UBRS entrance: Blackrock Mountain (~30, 37), Burning Steppes." },
-
             ------------------------------------------------------------------
             -- HORDE CHAIN
             ------------------------------------------------------------------
@@ -117,11 +112,11 @@ RelationshipsAttune_Data = {
             { type = "quest", id = 4941, faction = "Horde",
               name = "Eitrigg's Wisdom", icon = ICON_QUEST,
               desc = "Speak to Eitrigg in Orgrimmar, then turn in to Thrall.",
-              start = "Warlord Goretooth, Kargath, Badlands (6, 48). Eitrigg/Thrall: Valley of Wisdom, Orgrimmar (32, 38)." },
+              start = "Warlord Goretooth, Kargath, Badlands (6, 48). Eitrigg/Thrall: Grommash Hold, Valley of Wisdom, Orgrimmar (32, 38)." },
             { type = "quest", id = 4974, faction = "Horde",
               name = "For The Horde!", icon = ICON_QUEST,
               desc = "Kill Warchief Rend Blackhand in UBRS and return his head to Thrall (grants Warchief's Blessing).",
-              start = "Thrall, Grommash Hold, Valley of Wisdom, Orgrimmar (32, 38)." },
+              start = "Thrall, Grommash Hold, Valley of Wisdom, Orgrimmar (32, 38). UBRS: Blackrock Mountain (~30, 37), Burning Steppes." },
             { type = "quest", id = 6566, faction = "Horde",
               name = "What the Wind Carries", icon = ICON_QUEST,
               desc = "Listen to Thrall's tale and turn in.",
@@ -129,15 +124,15 @@ RelationshipsAttune_Data = {
             { type = "quest", id = 6567, faction = "Horde",
               name = "The Champion of the Horde", icon = ICON_QUEST,
               desc = "Find Rexxar patrolling between Desolace, Stonetalon and Feralas.",
-              start = "Thrall, Grommash Hold, Orgrimmar (32, 38). Rexxar: Desolace patrol path." },
+              start = "Thrall, Grommash Hold, Orgrimmar (32, 38). Rexxar: Desolace patrol between (35, 10) and (65, 70)." },
             { type = "quest", id = 6568, faction = "Horde",
               name = "The Testament of Rexxar", icon = ICON_QUEST,
               desc = "Deliver Rexxar's Testament to Myranda the Hag in Western Plaguelands.",
-              start = "Rexxar, Desolace (roaming). Myranda: near Uther's Tomb, Western Plaguelands (51, 78)." },
+              start = "Rexxar, Desolace patrol (35-65, 10-70). Myranda: near Uther's Tomb, Western Plaguelands (51, 78)." },
             { type = "quest", id = 6569, faction = "Horde",
               name = "Oculus Illusions", icon = ICON_QUEST,
               desc = "Collect 20 Black Dragonspawn Eyes from UBRS dragonkin for your disguise.",
-              start = "Myranda the Hag, Western Plaguelands (51, 78)." },
+              start = "Myranda the Hag, Western Plaguelands (51, 78). UBRS: Blackrock Mountain (~30, 37), Burning Steppes." },
             { type = "quest", id = 6570, faction = "Horde",
               name = "Emberstrife", icon = ICON_QUEST,
               desc = "Use Amulet of Draconic Subversion and speak to Emberstrife in his den, Dustwallow Marsh.",
@@ -149,7 +144,7 @@ RelationshipsAttune_Data = {
             { type = "quest", id = 6582, faction = "Horde",
               name = "The Test of Skulls, Scryer", icon = ICON_QUEST,
               desc = "Kill Scryer (Blue) inside Mazthoril cave, Winterspring.",
-              start = "Emberstrife, Emberstrife's Den, Dustwallow Marsh (57, 87). Scryer: Mazthoril (53, 56)." },
+              start = "Emberstrife, Emberstrife's Den, Dustwallow Marsh (57, 87). Scryer: Mazthoril, Winterspring (53, 56)." },
             { type = "quest", id = 6583, faction = "Horde",
               name = "The Test of Skulls, Somnus", icon = ICON_QUEST,
               desc = "Kill Somnus (Green) patrolling south-east Swamp of Sorrows.",
@@ -157,26 +152,24 @@ RelationshipsAttune_Data = {
             { type = "quest", id = 6585, faction = "Horde",
               name = "The Test of Skulls, Axtroz", icon = ICON_QUEST,
               desc = "Unlocks after the other three Skull quests. Kill Axtroz (Red) at Grim Batol, Wetlands.",
-              start = "Emberstrife, Emberstrife's Den, Dustwallow Marsh (57, 87). Axtroz: Wetlands (85, 49)." },
+              start = "Emberstrife, Emberstrife's Den, Dustwallow Marsh (57, 87). Axtroz: Grim Batol entrance, Wetlands (85, 49)." },
             { type = "quest", id = 6601, faction = "Horde",
               name = "Ascension...", icon = ICON_QUEST,
               desc = "Take the Dull Drakefire Amulet to Rexxar in Desolace (not to Drakkisath).",
-              start = "Emberstrife, Emberstrife's Den, Dustwallow Marsh (57, 87). Rexxar: Desolace patrol." },
+              start = "Emberstrife, Emberstrife's Den, Dustwallow Marsh (57, 87). Rexxar: Desolace patrol (35-65, 10-70)." },
             { type = "quest", id = 6602, faction = "Horde",
               name = "Blood of the Black Dragon Champion", icon = ICON_ACTIVE,
               desc = "Kill General Drakkisath in UBRS, loot his blood and return to Rexxar for the Drakefire Amulet.",
-              start = "Rexxar, Desolace patrol path." },
+              start = "Rexxar, Desolace patrol (35-65, 10-70). UBRS: Blackrock Mountain (~30, 37), Burning Steppes." },
-
             ------------------------------------------------------------------
             -- Final reward (both factions).
             ------------------------------------------------------------------
             { type = "item", id = 16309, name = "Drakefire Amulet",
               icon = "Interface\\Icons\\INV_Jewelry_Talisman_11",
               desc = "Must be in every raid member's bags (not bank) to enter Onyxia's Lair.",
-              start = "Awarded by Haleh (Alliance, Winterspring) or Rexxar (Horde, Desolace patrol)." },
+              start = "Awarded by Haleh (Alliance, Mazthoril, Winterspring 55, 51) or Rexxar (Horde, Desolace patrol 35-65, 10-70)." },
         },
     },
-
     ----------------------------------------------------------------
     -- MOLTEN CORE
     ----------------------------------------------------------------
@@ -185,15 +178,11 @@ RelationshipsAttune_Data = {
         icon = "Interface\\Icons\\Spell_Fire_SelfDestruct",
         steps = {
             { type = "level", level = 55, name = "Reach Level 55", icon = ICON_LEVEL },
-            { type = "quest", id = 7487, name = "The Molten Core (BRD group summon)", icon = ICON_QUEST,
+            { type = "quest", id = 7487, name = "Attunement to the Core", icon = ICON_ACTIVE, final = true,
-              desc = "Group prereq that starts the attunement chain via Lothos Riftwaker. Must fight to the top of BRD and use the Core Fragment recipe / Molten Bridge to access the MC portal.",
+              desc = "Fight through Blackrock Depths to the Molten Bridge and loot a Core Fragment from the elementals near the MC portal, then hand it to Lothos Riftwaker. Grants direct teleport into MC from the BRD entrance instance portal.",
-              start = "Lothos Riftwaker, Blackrock Mountain (top of chained platform near the MC portal)." },
+              start = "Lothos Riftwaker, BRD instance entrance platform inside Blackrock Mountain (~30, 37), Burning Steppes, next to the Molten Core portal." },
-            { type = "quest", id = 7848, name = "Attunement to the Core", icon = ICON_ACTIVE, final = true,
-              desc = "Turn in a Core Fragment (from Molten Core mobs) to Lothos Riftwaker; grants direct teleport into MC from BRD.",
-              start = "Lothos Riftwaker, Blackrock Mountain (BRD entrance platform)." },
         },
     },
-
     ----------------------------------------------------------------
     -- BLACKWING LAIR
     ----------------------------------------------------------------
@@ -204,13 +193,12 @@ RelationshipsAttune_Data = {
             { type = "level", level = 58, name = "Reach Level 58", icon = ICON_LEVEL },
             { type = "item",  id = 12344, name = "Seal of Ascension (UBRS key prereq)", icon = ICON_KEY,
               desc = "You must be able to enter UBRS to reach Vaelan; requires the Seal of Ascension chain.",
-              start = "Chain starts with Kibler at Flame Crest, Burning Steppes (62, 24), and Jorgen at Morgan's Vigil (85, 68)." },
+              start = "Jorgen at Morgan's Vigil, Burning Steppes (85, 68) points you to Vaelan in UBRS (Blackrock Mountain ~30, 37, Burning Steppes)." },
             { type = "quest", id = 7761, name = "Blackhand's Command", icon = ICON_ACTIVE, final = true,
               desc = "Read the scroll dropped by Vaelan behind the hidden door in UBRS, then use the orb at the top of UBRS to enter BWL.",
-              start = "Vaelan, hidden alcove past the UBRS orb room, Upper Blackrock Spire." },
+              start = "Vaelan, hidden alcove past the UBRS orb room, Upper Blackrock Spire (Blackrock Mountain ~30, 37, Burning Steppes)." },
         },
     },
-
     ----------------------------------------------------------------
     -- NAXXRAMAS
     ----------------------------------------------------------------
@@ -234,7 +222,6 @@ RelationshipsAttune_Data = {
               start = "Archmage Angela Dosantos, Light's Hope Chapel, Eastern Plaguelands (76, 53)." },
         },
     },
-
     ----------------------------------------------------------------
     -- AQ20 - Ruins of Ahn'Qiraj
     ----------------------------------------------------------------
@@ -249,10 +236,9 @@ RelationshipsAttune_Data = {
               start = "Windcaller Yessendra / Proudhorn, Cenarion Hold, Silithus (50, 33)." },
             { type = "quest", id = 8743, name = "The Gates of Ahn'Qiraj (server-wide event)", icon = ICON_QUEST, final = true,
               desc = "The AQ gates must have been opened server-side. Once open, anyone can walk in.",
-              start = "Anachronos, Caverns of Time entrance, Tanaris (65, 50)." },
+              start = "Anachronos, Caverns of Time entrance, Tanaris (65, 50). AQ gates: southern Silithus (28, 92)." },
         },
     },
-
     ----------------------------------------------------------------
     -- AQ40 - Temple of Ahn'Qiraj (Scepter of the Shifting Sands)
     ----------------------------------------------------------------
@@ -263,17 +249,17 @@ RelationshipsAttune_Data = {
             { type = "level", level = 60, name = "Reach Level 60", icon = ICON_LEVEL },
             { type = "quest", id = 8286, name = "What Tomorrow Brings", icon = ICON_QUEST,
               desc = "Speak with Anachronos at the Caverns of Time to begin the Scepter chain.",
-              start = "Anachronos, Caverns of Time entrance, Tanaris (65, 50). Talk to him at the Gates of Ahn'Qiraj first (Silithus)." },
+              start = "Anachronos, Caverns of Time entrance, Tanaris (65, 50). Talk to him at the Gates of Ahn'Qiraj first, Silithus (28, 92)." },
             { type = "quest", id = 8288, name = "Only One May Rise", icon = ICON_QUEST,
               desc = "Kill Vaelastrasz in Blackwing Lair and loot the Vessel of Rebirth.",
-              start = "Anachronos, Silithus / Caverns of Time." },
+              start = "Anachronos, Silithus AQ gates (28, 92) / Caverns of Time, Tanaris (65, 50). BWL: Blackrock Mountain (~30, 37), Burning Steppes." },
             { type = "quest", id = 8301, name = "The Path of the Righteous", icon = ICON_QUEST,
               desc = "Continue Anachronos' story after handing in the Vessel.",
               start = "Anachronos, Caverns of Time entrance, Tanaris (65, 50)." },
             { type = "rep",   faction = "Brood of Nozdormu", standing = 4,
               name = "Neutral with Brood of Nozdormu", icon = ICON_REP,
               desc = "Kill AQ40 trash / bosses to raise Nozdormu rep from Hated to Neutral; required before Anachronos will continue.",
-              start = "Kill Qiraji inside AQ40; automatic once AQ40 is open." },
+              start = "Kill Qiraji inside AQ40, southern Silithus (28, 92); automatic once AQ40 is open." },
             { type = "quest", id = 8303, name = "Chamber of the Aspects", icon = ICON_QUEST,
               desc = "Anachronos sends you to speak with the four dragon Aspect representatives.",
               start = "Anachronos, Caverns of Time entrance, Tanaris (65, 50)." },
@@ -285,110 +271,130 @@ RelationshipsAttune_Data = {
               start = "Anachronos, Caverns of Time entrance, Tanaris (65, 50)." },
             { type = "quest", id = 8555, name = "The Nightmare's Corruption (Red)", icon = ICON_QUEST,
               desc = "Kill Vaelastrasz (BWL), loot Vaelastrasz's Tooth for Caelestrasz.",
-              start = "Caelestrasz, Anachronos' platform, Caverns of Time." },
+              start = "Caelestrasz, Anachronos' platform, Caverns of Time, Tanaris (65, 50)." },
             { type = "quest", id = 8733, name = "Beyond the Grave (Green)", icon = ICON_QUEST,
               desc = "Investigate the pool inside The Temple of Atal'Hakkar for Merithra.",
-              start = "Merithra of the Dream, Caverns of Time." },
+              start = "Merithra of the Dream, Anachronos' platform, Caverns of Time, Tanaris (65, 50). Sunken Temple: Swamp of Sorrows (69, 53)." },
             { type = "quest", id = 8734, name = "Draconic for Dummies (Blue)", icon = ICON_QUEST,
               desc = "Arygos sends you to research Nightmare Scale fragments across Azeroth.",
-              start = "Arygos, Caverns of Time." },
+              start = "Arygos, Anachronos' platform, Caverns of Time, Tanaris (65, 50)." },
             { type = "quest", id = 8735, name = "Stones of Binding (Bronze)", icon = ICON_QUEST,
               desc = "Retrieve five Nightmare Engravings from world dragons (Ysondre, Emeriss, Lethon, Taerar and Azuregos) for Kalecgos.",
-              start = "Kalecgos, Caverns of Time." },
+              start = "Kalecgos, Anachronos' platform, Caverns of Time, Tanaris (65, 50). Azuregos: Azshara (56, 42)." },
             { type = "quest", id = 8736, name = "Preparations", icon = ICON_QUEST,
               desc = "Return to Anachronos with the Nightmare Scale.",
-              start = "Anachronos, Caverns of Time." },
+              start = "Anachronos, Caverns of Time entrance, Tanaris (65, 50)." },
             { type = "quest", id = 8741, name = "The Charge of the Dragonflights", icon = ICON_QUEST,
               desc = "The Aspects reforge the scepter. Deliver the Fragment of the Nightmare's Corruption.",
-              start = "Anachronos, Caverns of Time." },
+              start = "Anachronos, Caverns of Time entrance, Tanaris (65, 50)." },
             { type = "quest", id = 8742, name = "The Hand of the Righteous", icon = ICON_QUEST,
               desc = "Final scepter reforging quest. Rewards Scepter of the Shifting Sands.",
-              start = "Anachronos, Caverns of Time." },
+              start = "Anachronos, Caverns of Time entrance, Tanaris (65, 50)." },
             { type = "item",  id = 21175, name = "Scepter of the Shifting Sands",
               icon = "Interface\\Icons\\INV_Hammer_25",
               desc = "Use this item at the Scarab Gong outside AQ to trigger the 10-hour war and open the gates server-wide.",
-              start = "Reward from 'The Hand of the Righteous'." },
+              start = "Reward from 'The Hand of the Righteous' (Anachronos, Caverns of Time, Tanaris 65, 50)." },
             { type = "quest", id = 8743, name = "Bang a Gong!", icon = ICON_ACTIVE, final = true,
               desc = "Ring the Scarab Gong at the Gates of Ahn'Qiraj to open both AQ raids server-wide. First person to ring gets Scarab Lord title + mount.",
-              start = "Scarab Gong, Gates of Ahn'Qiraj, Silithus." },
+              start = "Scarab Gong, Gates of Ahn'Qiraj, southern Silithus (28, 92)." },
             { type = "item",  id = 21176, name = "Black Qiraji Resonating Crystal (Scarab Lord mount)",
               icon = "Interface\\Icons\\INV_Misc_QirajiCrystal_04",
               desc = "Awarded only to the player who rings the gong within the 10-hour war window.",
-              start = "Reward for completing 'Bang a Gong!' during the war event." },
+              start = "Reward for completing 'Bang a Gong!' at the AQ gates, Silithus (28, 92) during the war event." },
         },
     },
-
     ----------------------------------------------------------------
     -- VANILLA KEYS & DUNGEON ACCESS
     ----------------------------------------------------------------
     {
-        id = "ubrs", name = "Upper Blackrock Spire", category = "Keys & Access", faction = "Both",
+        id = "ubrs", name = "Upper Blackrock Spire (Seal of Ascension)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Key_04",
         steps = {
             { type = "level", level = 55, name = "Reach Level 55", icon = ICON_LEVEL },
-            { type = "quest", id = 4903, name = "Kibler's Exotic Pets (chain start)", icon = ICON_QUEST,
+            { type = "item",  id = 12219, name = "Unadorned Seal of Ascension", icon = ICON_KEY,
-              desc = "Opens Jorgen's Seal of Ascension chain.",
+              desc = "Opens the UBRS door at the top of LBRS. Drops from The Beast in UBRS, Overlord Wyrmthalak in LBRS, and Pyroguard Emberseer, and is provided by Vaelan for the attunement chain.",
-              start = "Kibler, Flame Crest, Burning Steppes (62, 24)." },
+              start = "Loot from LBRS/UBRS bosses, or given directly by Vaelan (hidden alcove past the orb room in UBRS, Blackrock Mountain ~30, 37, Burning Steppes)." },
-            { type = "quest", id = 4743, name = "Seal of Ascension", icon = ICON_QUEST,
+            { type = "quest", id = 4742, name = "Seal of Ascension", icon = ICON_QUEST,
-              desc = "Requires the Unadorned Seal of Ascension (drops from The Beast in UBRS or Overlord Wyrmthalak in LBRS) plus three gemstones from LBRS bosses (Highlord Omokk, War Master Voone, Overlord Wyrmthalak).",
+              desc = "Collect the three Gemstones of Command (Smolderthorn from War Master Voone, Spirestone from Highlord Omokk, Bloodaxe from Overlord Wyrmthalak - all in LBRS) and return them with the Unadorned Seal of Ascension to Vaelan.",
-              start = "Jorgen, Morgan's Vigil, Burning Steppes (85, 68)." },
+              start = "Vaelan, hidden alcove past the orb room, Upper Blackrock Spire (Blackrock Mountain ~30, 37, Burning Steppes)." },
-            { type = "item",  id = 12344, name = "Seal of Ascension", icon = ICON_KEY,
+            { type = "item",  id = 12344, name = "Seal of Ascension", icon = ICON_KEY, final = true,
-              desc = "Opens the door to Upper Blackrock Spire at the top of the LBRS instance.",
+              desc = "Uses the orb at the top of UBRS to open the instance portal. Required to enter UBRS.",
-              start = "Awarded by Jorgen at Morgan's Vigil after completing the Seal of Ascension chain." },
+              start = "Reward from Vaelan for turning in 'Seal of Ascension' inside UBRS (Blackrock Mountain ~30, 37, Burning Steppes)." },
         },
     },
-
     {
         id = "brd", name = "Blackrock Depths (Shadowforge Key)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Key_06",
         steps = {
             { type = "level", level = 47, name = "Reach Level 47", icon = ICON_LEVEL },
-            { type = "quest", id = 4136, name = "Dark Iron Legacy", icon = ICON_QUEST,
+            { type = "quest", id = 3802, name = "Dark Iron Legacy", icon = ICON_QUEST,
-              desc = "Kill Fineous Darkvire in the Halls of Crafting inside BRD and loot the Ironfel weapon; the quest rewards the Shadowforge Key.",
+              desc = "Kill Fineous Darkvire in the Hall of Crafting inside BRD and loot Ironfel, then place Ironfel on Franclorn Forgewright's statue at the Shrine of Thaurissan. Turn-in rewards the Shadowforge Key.",
-              start = "Franclorn Forgewright's ghost, Blackrock Mountain / inside Blackrock Depths (Detention Block hallway near his statue)." },
+              start = "Franclorn Forgewright's ghost at the Shrine of Thaurissan inside Blackrock Depths (BRD entrance: Blackrock Mountain ~30, 37, Burning Steppes). Accept 3801 first, then 3802." },
             { type = "item",  id = 11000, name = "Shadowforge Key", icon = ICON_KEY,
-              desc = "Opens Shadowforge City / Manufactory doors deep in BRD.",
+              desc = "Opens the Shadowforge Lock and every Dark Iron door in the deeper half of BRD.",
-              start = "Reward from 'Dark Iron Legacy'." },
+              start = "Reward from completing 'Dark Iron Legacy' (quest 3802) inside BRD (Blackrock Mountain ~30, 37, Burning Steppes)." },
         },
     },
-
     {
         id = "brd_prison", name = "BRD Prison Cell Key", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Key_05",
         steps = {
             { type = "level", level = 52, name = "Reach Level 52", icon = ICON_LEVEL },
-            { type = "item",  id = 11266, name = "Prison Cell Key", icon = ICON_KEY,
+            { type = "item",  id = 11140, name = "Prison Cell Key", icon = ICON_KEY,
-              desc = "Unlocks the Detention Block cells in Blackrock Depths (frees Marshal Windsor, Dughal, Kharan Mighthammer, etc). Rogues can also pick these locks at 275.",
+              desc = "Unlocks the Detention Block cells in Blackrock Depths (frees Marshal Windsor, Dughal Stormwing, Kharan Mighthammer, etc). Rogues can also pick these locks around 250 lockpicking.",
-              start = "Drops from Warder Stilgiss (patrolling the Detention Block, Blackrock Depths)." },
+              start = "Drops from Warder Stilgiss (patrolling the Detention Block corridor with his frost hound Frostwrath, inside Blackrock Depths - entrance Blackrock Mountain ~30, 37, Burning Steppes)." },
         },
     },
-
     {
         id = "scholo", name = "Scholomance (Skeleton Key)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Key_11",
         steps = {
             { type = "level", level = 55, name = "Reach Level 55", icon = ICON_LEVEL },
-            { type = "quest", id = 5153, name = "The Deed to Southshore", icon = ICON_QUEST,
+            { type = "quest", id = 5537, faction = "Alliance",
-              desc = "First step of the Barov chain. Loot the Deed to Southshore from Cannon Master Willey in Stratholme.",
+              name = "Skeletal Fragments (Alliance)", icon = ICON_QUEST,
-              start = "Alliance: Alexi Barov, Hearthglen, Western Plaguelands (44, 21). Horde: Weldon Barov, Chillwind Camp equivalent / Alexi Barov, Ruins of Andorhal (42, 68)." },
+              desc = "Collect 15 Skeletal Fragments from the reanimated skeletons around Andorhal / Sorrow Hill for the Alchemist to imbue.",
-            { type = "quest", id = 5154, name = "The Deed to Tarren Mill", icon = ICON_QUEST,
+              start = "Alchemist Arbington, Chillwind Camp, Western Plaguelands (43, 84)." },
-              desc = "Loot the Deed to Tarren Mill from Magistrate Barthilas in Stratholme Live.",
+            { type = "quest", id = 5538, faction = "Horde",
-              start = "Alexi Barov (Alliance) / Weldon Barov (Horde)." },
+              name = "Skeletal Fragments (Horde)", icon = ICON_QUEST,
-            { type = "quest", id = 5155, name = "The Deed to Brill", icon = ICON_QUEST,
+              desc = "Horde version of the fragment collection quest for the Skeleton Key.",
-              desc = "Loot the Deed to Brill from Jandice Barov in Scholomance.",
+              start = "Apothecary Dithers, The Bulwark, Western Plaguelands (81, 71)." },
-              start = "Alexi Barov (Alliance) / Weldon Barov (Horde)." },
+            { type = "quest", id = 5514, faction = "Alliance",
-            { type = "quest", id = 5156, name = "The Deed to Caer Darrow", icon = ICON_QUEST,
+              name = "Mold Rhymes With... (Alliance)", icon = ICON_QUEST,
-              desc = "Loot the Deed to Caer Darrow from Lord Alexei Barov in Scholomance (Great Ossuary).",
+              desc = "Bring the Imbued Skeletal Fragments and 15 gold to Krinkle Goodsteel in Gadgetzan to buy the Skeleton Key Mold.",
-              start = "Alexi Barov (Alliance) / Weldon Barov (Horde)." },
+              start = "Alchemist Arbington, Chillwind Camp, Western Plaguelands (43, 84). Krinkle: Gadgetzan, Tanaris (51, 29)." },
-            { type = "quest", id = 5382, name = "The Key to Scholomance", icon = ICON_QUEST,
+            { type = "quest", id = 5515, faction = "Horde",
-              desc = "Combine the four Deeds (Southshore, Tarren Mill, Brill, Caer Darrow) with the Blood of Innocents (Scarlet Monastery) and Viewing Room Key (Scholomance) at Caer Darrow to receive the Skeleton Key.",
+              name = "Mold Rhymes With... (Horde)", icon = ICON_QUEST,
-              start = "Alexi Barov (Alliance) / Weldon Barov (Horde) - hands in at Caer Darrow." },
+              desc = "Horde variant: bring the Imbued Skeletal Fragments and 15 gold to Krinkle Goodsteel in Gadgetzan.",
-            { type = "item",  id = 13704, name = "Skeleton Key", icon = ICON_KEY,
+              start = "Apothecary Dithers, The Bulwark, Western Plaguelands (81, 71). Krinkle: Gadgetzan, Tanaris (51, 29)." },
-              desc = "Opens the front door of Scholomance in Caer Darrow.",
+            { type = "quest", id = 5801, faction = "Alliance",
-              start = "Reward from 'The Key to Scholomance'." },
+              name = "Fire Plume Forged (Alliance)", icon = ICON_QUEST,
+              desc = "Use the Skeleton Key Mold plus 2 Thorium Bars at the lava lake atop Fire Plume Ridge in Un'Goro Crater to cast the Unfinished Skeleton Key.",
+              start = "Krinkle Goodsteel, Gadgetzan, Tanaris (51, 29). Fire Plume Ridge: Un'Goro Crater (49, 60)." },
+            { type = "quest", id = 5802, faction = "Horde",
+              name = "Fire Plume Forged (Horde)", icon = ICON_QUEST,
+              desc = "Horde variant: forge the Unfinished Skeleton Key at Fire Plume Ridge in Un'Goro Crater.",
+              start = "Krinkle Goodsteel, Gadgetzan, Tanaris (51, 29). Fire Plume Ridge: Un'Goro Crater (49, 60)." },
+            { type = "quest", id = 5803, faction = "Alliance",
+              name = "Araj's Scarab (Alliance)", icon = ICON_QUEST,
+              desc = "Slay Araj the Summoner (elite lich, center of ruined Andorhal) and loot Araj's Scarab - the head of the key. Group quest.",
+              start = "Alchemist Arbington, Chillwind Camp, Western Plaguelands (43, 84). Araj: center of Andorhal (42, 68)." },
+            { type = "quest", id = 5804, faction = "Horde",
+              name = "Araj's Scarab (Horde)", icon = ICON_QUEST,
+              desc = "Horde variant of the Araj kill quest.",
+              start = "Apothecary Dithers, The Bulwark, Western Plaguelands (81, 71). Araj: center of Andorhal (42, 68)." },
+            { type = "quest", id = 5505, faction = "Alliance",
+              name = "The Key to Scholomance (Alliance)", icon = ICON_ACTIVE,
+              desc = "Turn in Araj's Scarab and receive the Skeleton Key.",
+              start = "Alchemist Arbington, Chillwind Camp, Western Plaguelands (43, 84)." },
+            { type = "quest", id = 5506, faction = "Horde",
+              name = "The Key to Scholomance (Horde)", icon = ICON_ACTIVE,
+              desc = "Horde turn-in for the Skeleton Key.",
+              start = "Apothecary Dithers, The Bulwark, Western Plaguelands (81, 71)." },
+            { type = "item",  id = 13704, name = "Skeleton Key", icon = ICON_KEY, final = true,
+              desc = "Opens the front door of Scholomance on Caer Darrow. Rogues can pick the door at 280 lockpicking, so the key is optional but persistent.",
+              start = "Reward from the final 'The Key to Scholomance' turn-in (Chillwind Camp 43, 84 Alliance / The Bulwark 81, 71 Horde, Western Plaguelands). Scholomance door: Caer Darrow, Western Plaguelands (69, 73)." },
         },
     },
-
     {
         id = "strat_live", name = "Stratholme (Service Entrance)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Key_07",
@@ -396,10 +402,9 @@ RelationshipsAttune_Data = {
             { type = "level", level = 55, name = "Reach Level 55", icon = ICON_LEVEL },
             { type = "item",  id = 12382, name = "Key to the City", icon = ICON_KEY,
               desc = "Opens the Service Entrance shortcut into Stratholme Live.",
-              start = "Drops from Magistrate Barthilas, patrolling the main road of Stratholme Live." },
+              start = "Drops from Magistrate Barthilas, patrolling the main road of Stratholme Live (instance entrance: Eastern Plaguelands 27, 12)." },
         },
     },
-
     {
         id = "dm", name = "Dire Maul (Crescent Key)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Key_09",
@@ -407,10 +412,9 @@ RelationshipsAttune_Data = {
             { type = "level", level = 55, name = "Reach Level 55", icon = ICON_LEVEL },
             { type = "item",  id = 18249, name = "Crescent Key", icon = ICON_KEY,
               desc = "Opens locked doors and cages throughout Dire Maul (all three wings).",
-              start = "Pickpocket from Kobold Geomancers inside Dire Maul West (Rogue only), lockpick at 300, or buy from the AH." },
+              start = "Pickpocket from Kobold Geomancers inside Dire Maul West (Rogue only, DM entrance: Feralas 61, 30), lockpick at 300, or buy from the AH." },
         },
     },
-
     {
         id = "dm_tribute", name = "Dire Maul North (Gordok Tribute Run)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Crown_02",
@@ -418,30 +422,25 @@ RelationshipsAttune_Data = {
             { type = "level", level = 58, name = "Reach Level 58", icon = ICON_LEVEL },
             { type = "item",  id = 18249, name = "Crescent Key", icon = ICON_KEY,
               desc = "Needed to open the doors within Dire Maul North for the King run.",
-              start = "Same source as regular DM Crescent Key." },
+              start = "Same source as regular DM Crescent Key (DM entrance: Feralas 61, 30)." },
             { type = "item",  id = 18746, name = "Ogre Tannin", icon = ICON_ITEM,
               desc = "Bring Ogre Tannin from Knot Thimblejack's Cache in Dire Maul North (found via lockpicking or Crescent Key) to Cho'Rush the Observer AFTER King Gordok dies. Skipping this makes the tribute run impossible.",
-              start = "Knot Thimblejack's Cache, Dire Maul North (past the Warpwood Quarter)." },
+              start = "Knot Thimblejack's Cache, Dire Maul North past the Warpwood Quarter (DM entrance: Feralas 61, 30)." },
         },
     },
-
     {
         id = "gnomer", name = "Gnomeregan (Workshop Shortcut)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Key_08",
         steps = {
             { type = "level", level = 24, name = "Reach Level 24", icon = ICON_LEVEL },
-            { type = "quest", id = 2904, name = "Grime-Encrusted Ring", icon = ICON_QUEST,
+            { type = "quest", id = 2945, name = "Grime-Encrusted Ring", icon = ICON_QUEST,
-              desc = "Drop-quest item off Gnomeregan mobs; leads into 'Return to Marvon'.",
+              desc = "Loot a Grime-Encrusted Ring off Dark Iron mobs inside Gnomeregan and clean it in the Sparklematic 5200 (Tinker Town, Ironforge or the Gnomeregan Sparklematic). Cleaning it produces a Workshop Key.",
-              start = "Loot Grime-Encrusted Ring inside Gnomeregan (Dun Morogh 25, 40)." },
+              start = "Loot Grime-Encrusted Ring from Dark Iron dwarves inside Gnomeregan (entrance: Dun Morogh 25, 40). Clean it at any Sparklematic 5200 (Tinker Town, Ironforge)." },
-            { type = "quest", id = 2905, name = "Return to Marvon", icon = ICON_QUEST,
+            { type = "item",  id = 6893, name = "Workshop Key", icon = ICON_KEY,
-              desc = "Rewards the Workshop Key for skipping Grubbis.",
+              desc = "Opens the Workshop shortcut door in Gnomeregan, letting you skip most of the trash on the way to Mekgineer Thermaplugg.",
-              start = "Marvon Rivetseeker, Steamwheedle Port camp, Tanaris (66, 22)." },
+              start = "Reward for cleaning the Grime-Encrusted Ring at the Sparklematic 5200 (Tinker Town, Ironforge, or inside Gnomeregan entrance Dun Morogh 25, 40)." },
-            { type = "item",  id = 9240, name = "Workshop Key", icon = ICON_KEY,
-              desc = "Opens the shortcut door in Gnomeregan bypassing the Grubbis wing.",
-              start = "Reward from 'Return to Marvon'." },
         },
     },
-
     {
         id = "mara", name = "Maraudon (Portal Shortcut)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Idol_02",
@@ -449,16 +448,15 @@ RelationshipsAttune_Data = {
             { type = "level", level = 40, name = "Reach Level 40", icon = ICON_LEVEL },
             { type = "quest", id = 7064, name = "Legends of Maraudon", icon = ICON_QUEST,
               desc = "Prereq for the Scepter of Celebras.",
-              start = "Celebras the Redeemed, freed on the Orange side of Maraudon after the vine tunnel." },
+              start = "Celebras the Redeemed, freed on the Orange side of Maraudon after the vine tunnel (Maraudon entrance: Desolace 29, 63)." },
             { type = "quest", id = 7065, name = "The Scepter of Celebras", icon = ICON_QUEST,
               desc = "Rewards Scepter of Celebras (teleport into inner Maraudon).",
-              start = "Celebras the Redeemed, Maraudon (Orange side)." },
+              start = "Celebras the Redeemed, Maraudon Orange side (entrance: Desolace 29, 63)." },
             { type = "item",  id = 17191, name = "Scepter of Celebras", icon = ICON_KEY,
               desc = "Teleports directly to the Princess wing of Maraudon.",
-              start = "Reward from 'The Scepter of Celebras'." },
+              start = "Reward from 'The Scepter of Celebras' (Maraudon entrance: Desolace 29, 63)." },
         },
     },
-
     {
         id = "st", name = "Sunken Temple (Atal'ai + Jammal'an)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Idol_03",
@@ -469,80 +467,76 @@ RelationshipsAttune_Data = {
               start = "Yeh'kinya, Steamwheedle Port, Tanaris (66, 22)." },
             { type = "quest", id = 3380, name = "The Atal'ai Exile", icon = ICON_QUEST,
               desc = "Prereq for the raid form; introduces you to Atal'alarion / Jammal'an's followers.",
-              start = "Al'tabim the All-Seeing, Marshal's Refuge, Un'Goro Crater." },
+              start = "Al'tabim the All-Seeing, Marshal's Refuge, Un'Goro Crater (44, 6)." },
             { type = "quest", id = 3441, name = "Screecher Spirits", icon = ICON_QUEST,
               desc = "Kills for Atal'ai Screechers around Sunken Temple; part of the Hakkar summoning chain.",
-              start = "Fel'zerul, Stonard, Swamp of Sorrows." },
+              start = "Fel'zerul, Stonard, Swamp of Sorrows (46, 55)." },
             { type = "quest", id = 3446, name = "Into the Depths / Jammal'an", icon = ICON_QUEST, final = true,
               desc = "Activate the six statues around the central pit in Sunken Temple to summon Jammal'an the Prophet; no key required, but the puzzle must be solved (kill six Atal'ai Defenders in the correct order).",
-              start = "Fel'zerul, Stonard, Swamp of Sorrows (Horde) / Brohann Caskbelly, Ironforge (Alliance)." },
+              start = "Fel'zerul, Stonard, Swamp of Sorrows (46, 55) - Horde / Brohann Caskbelly, Hall of Explorers, Ironforge (76, 12) - Alliance. Sunken Temple entrance: Swamp of Sorrows (69, 53)." },
         },
     },
-
     {
         id = "zf", name = "Zul'Farrak (Sacred Mallet)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Hammer_16",
         steps = {
             { type = "level", level = 45, name = "Reach Level 45", icon = ICON_LEVEL },
-            { type = "quest", id = 2770, name = "The Prophecy of Mosh'aru", icon = ICON_QUEST,
-              desc = "Prereq to Divino-matic Rod chain from the Wildhammer/Revantusk hunter camps.",
-              start = "Yeh'kinya, Steamwheedle Port, Tanaris (66, 22)." },
-            { type = "quest", id = 2744, name = "The Ancient Mallet (Sacred Mallet)", icon = ICON_QUEST,
-              desc = "Retrieve the Sacred Mallet from the ogres on top of the Altar of Zul in the Hinterlands.",
-              start = "Yeh'kinya, Steamwheedle Port, Tanaris (66, 22). Altar: Hinterlands (76, 65)." },
             { type = "item",  id = 9241, name = "Sacred Mallet", icon = ICON_KEY,
-              desc = "Take to the Altar of the Storms in the Hinterlands to be transformed into Mallet of Zul'Farrak.",
+              desc = "No quest required. Fight your way to the top of the Altar of Zul in the Hinterlands (Vilebranch troll city Jintha'Alor) and loot the Sacred Mallet from the pedestal at the summit.",
-              start = "Looted at the top of the Altar of Zul, Hinterlands (76, 65)." },
+              start = "Top of the Altar of Zul, Jintha'Alor, Hinterlands (~63, 74). The whole hill is heavily patrolled by level 46-50 Vilebranch trolls." },
-            { type = "item",  id = 9240, name = "Mallet of Zul'Farrak", icon = ICON_KEY,
+            { type = "item",  id = 9240, name = "Mallet of Zul'Farrak", icon = ICON_KEY, final = true,
-              desc = "Ring the gong in the Gahz'rilla arena inside Zul'Farrak to summon the boss Gahz'rilla.",
+              desc = "Right-click the Sacred Mallet while standing on the Altar of the Storms (the small square platform south of the Altar of Zul) to transform it into the Mallet of Zul'Farrak. Ring the gong in the Gahz'rilla arena inside Zul'Farrak to summon the boss.",
-              start = "Use the Sacred Mallet at the Altar of Zul, Hinterlands (76, 65)." },
+              start = "Altar of the Storms, Hinterlands (~59, 62), while carrying the Sacred Mallet. Zul'Farrak entrance: Tanaris (39, 20)." },
         },
     },
-
     {
         id = "sm_cath", name = "Scarlet Monastery (Cathedral)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Key_02",
         steps = {
             { type = "level", level = 35, name = "Reach Level 35", icon = ICON_LEVEL },
-            { type = "quest", id = 1050, name = "Clear the Scarlet Monastery Library", icon = ICON_QUEST,
+            { type = "item",  id = 7146, name = "Scarlet Key", icon = ICON_KEY, final = true,
-              desc = "Clear the Library wing and loot the small chest behind the final boss to obtain the Scarlet Key.",
+              desc = "Opens the front doors of the Scarlet Monastery Armory, Cathedral and Graveyard wings. NOT a quest reward: the key is looted from a small chest ('Ill-Fated Chest') behind Arcanist Doan at the end of the Library wing, so run Library first. Rogues can also pick these doors around 175 lockpicking.",
-              start = "Scarlet Monastery Library wing entrance, Tirisfal Glades (85, 32)." },
+              start = "Ill-Fated Chest behind Arcanist Doan, end of the Library wing, Scarlet Monastery, Tirisfal Glades (85, 32)." },
-            { type = "item",  id = 7146, name = "Scarlet Key", icon = ICON_KEY,
-              desc = "Opens the front doors to the Scarlet Monastery Armory, Cathedral and Graveyard wings.",
-              start = "Found in a small loot chest behind Arcanist Doan at the end of the Library wing (not a boss drop)." },
         },
     },
-
     {
-        id = "sgorge", name = "Searing Gorge Access", category = "Keys & Access", faction = "Both",
+        id = "sgorge", name = "Key to Searing Gorge", category = "Keys & Access", faction = "Alliance",
-        icon = "Interface\\Icons\\INV_Misc_Gem_Ruby_02",
+        icon = "Interface\\Icons\\INV_Misc_Key_14",
         steps = {
-            { type = "level", level = 45, name = "Reach Level 45", icon = ICON_LEVEL },
+            { type = "level", level = 43, name = "Reach Level 43", icon = ICON_LEVEL,
-            { type = "quest", id = 3441, faction = "Alliance",
+              desc = "Minimum recommended level to survive the trip into south-east Searing Gorge." },
-              name = "A Bindings Blockade (Alliance)", icon = ICON_QUEST,
+            { type = "quest", id = 3181, faction = "Alliance",
-              desc = "Opens the Thorium Brotherhood gate from Loch Modan into Searing Gorge.",
+              name = "The Horn of the Beast", icon = ICON_QUEST,
-              start = "Prospector Stormpike, The Military Ward, Ironforge." },
+              desc = "Travel through the Badlands into Searing Gorge, slay Margol the Rager (level 48 elite Stegodon in the south-east corner of Searing Gorge), and loot Margol's Gigantic Horn. Return it to Mountaineer Pebblebitty.",
-            { type = "quest", id = 3701, faction = "Horde",
+              start = "Mountaineer Pebblebitty, Stonewrought Pass gate, southern Loch Modan (33, 51). Margol: south-east Searing Gorge (~78, 70)." },
-              name = "The Flame's Casing (Horde)", icon = ICON_QUEST,
+            { type = "quest", id = 3182, faction = "Alliance",
-              desc = "Rewards Horde access through the Thorium Brotherhood gate into Searing Gorge.",
+              name = "Proof of Deed", icon = ICON_QUEST,
-              start = "Krakle, Kargath, Badlands (3, 45)." },
+              desc = "Pebblebitty doesn't believe the horn is real. Take Margol's Gigantic Horn to Curator Thorius in the Ironforge museum (Hall of Explorers) for authentication.",
+              start = "Mountaineer Pebblebitty, Stonewrought Pass gate, southern Loch Modan (33, 51). Curator Thorius: Hall of Explorers, Ironforge (73, 10)." },
+            { type = "quest", id = 3201, faction = "Alliance",
+              name = "At Last!", icon = ICON_QUEST,
+              desc = "Return to Mountaineer Pebblebitty with the Proof of Deed to receive the Key to Searing Gorge.",
+              start = "Curator Thorius, Hall of Explorers, Ironforge (73, 10). Pebblebitty: Stonewrought Pass, southern Loch Modan (33, 51)." },
+            { type = "item", id = 5396, name = "Key to Searing Gorge", icon = ICON_KEY, final = true,
+              desc = "Opens the Stonewrought Pass gate between Loch Modan and Searing Gorge. Horde do not need a key - they reach Searing Gorge via the Kargath / Badlands back road.",
+              start = "Reward from 'At Last!' handed in to Mountaineer Pebblebitty, Stonewrought Pass gate, southern Loch Modan (33, 51)." },
         },
     },
-
     {
         id = "uldaman", name = "Uldaman (Discs of Norgannon)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Gem_Diamond_01",
         steps = {
             { type = "level", level = 40, name = "Reach Level 40", icon = ICON_LEVEL },
-            { type = "quest", id = 2278, name = "The Lost Tablets of Will", icon = ICON_QUEST,
+            { type = "quest", id = 1139, faction = "Alliance",
-              desc = "Prereq to activating the Discs of Norgannon so Archaedas can be reached.",
+              name = "The Lost Tablets of Will", icon = ICON_QUEST,
-              start = "Alliance: Advisor Belgrum, Ironforge. Horde: Rigglefuzz, Hillsbrad Foothills." },
+              desc = "Alliance prereq that leads to the Discs of Norgannon and spawning Archaedas. Fetch the Tablet of Will from inside Uldaman for Advisor Belgrum. Part of the longer 'Passing Word of a Threat' -> 'An Ambassador of Evil' -> 'The Lost Tablets of Will' -> Discs chain.",
-            { type = "quest", id = 2418, name = "The Platinum Discs", icon = ICON_QUEST, final = true,
+              start = "Advisor Belgrum, Great Forge, Ironforge (55, 46). Uldaman entrance: Badlands (42, 20)." },
-              desc = "Interact with the Discs of Norgannon inside the Chamber of Khaz'mul to spawn Archaedas.",
+            { type = "quest", id = 2418, faction = "Both",
-              start = "Uldaman, Badlands (42, 20)." },
+              name = "The Platinum Discs", icon = ICON_QUEST, final = true,
+              desc = "Interact with the Discs of Norgannon inside the Chamber of Khaz'mul (deepest room in Uldaman) to spawn Archaedas. Uldaman itself is open to everyone - no attunement is required to enter, only to finish the disc/Archaedas storyline.",
+              start = "Discs of Norgannon, Chamber of Khaz'mul, Uldaman, Badlands (42, 20)." },
         },
     },
-
     {
         id = "hydraxian", name = "Hydraxian Waterlords (MC Runes)", category = "Keys & Access", faction = "Both",
         icon = "Interface\\Icons\\Spell_Frost_SummonWaterElemental",
@@ -554,7 +548,6 @@ RelationshipsAttune_Data = {
               start = "Duke Hydraxis, small island off south-east Azshara (79, 76). Turn in water elemental drops (Azshara/Silithus) and MC boss items." },
         },
     },
-
     ----------------------------------------------------------------
     -- TURTLE / OCTO WOW CUSTOM CONTENT
     -- Placeholder ids where the live client id isn't confirmed; the
@@ -567,13 +560,12 @@ RelationshipsAttune_Data = {
             { type = "level", level = 55, name = "Reach Level 55", icon = ICON_LEVEL },
             { type = "quest", id = 40001, name = "Karazhan Crypt attunement (Koren)", icon = ICON_QUEST, final = true,
               desc = "Custom Turtle attunement chain for Karazhan Crypt (10-man). Follow the chain from Koren the Seeker in Deadwind Pass; involves clearing the outer crypt trash and delivering an item to the Alturus circle at Karazhan.",
-              start = "Koren the Seeker, Morgan's Plot camp, Deadwind Pass (40, 75)." },
+              start = "Koren the Seeker, Morgan's Plot camp, Deadwind Pass (40, 75). Karazhan: Deadwind Pass (47, 75)." },
             { type = "item",  id = 60001, name = "Karazhan Crypt Key", icon = ICON_KEY,
               desc = "Key required to enter the crypt beneath Karazhan (10-man). Matches by tooltip name if the numeric id differs on your build.",
-              start = "Awarded from Koren the Seeker after completing the Karazhan Crypt attunement chain." },
+              start = "Awarded from Koren the Seeker (Morgan's Plot, Deadwind Pass 40, 75) after completing the Karazhan Crypt attunement chain." },
         },
     },
-
     {
         id = "kara40", name = "Lower Karazhan Halls (40)", category = "Turtle", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Gem_Sapphire_01",
@@ -581,13 +573,12 @@ RelationshipsAttune_Data = {
             { type = "level", level = 60, name = "Reach Level 60", icon = ICON_LEVEL },
             { type = "quest", id = 40010, name = "Lower Karazhan Halls attunement", icon = ICON_QUEST, final = true,
               desc = "Custom Turtle attunement chain for Lower Karazhan Halls (40-man). Alturus / Kamsis at Karazhan will guide you through several steps culminating in the Master's Key.",
-              start = "Archmage Alturus, Morgan's Plot camp, Deadwind Pass (40, 75)." },
+              start = "Archmage Alturus, Morgan's Plot camp, Deadwind Pass (40, 75). Karazhan: Deadwind Pass (47, 75)." },
             { type = "item",  id = 60010, name = "Master's Key (LKH)", icon = ICON_KEY,
               desc = "40-man Karazhan raid key. Matches by tooltip name if the numeric id differs on your build.",
-              start = "Awarded from Archmage Alturus at the end of the LKH attunement." },
+              start = "Awarded from Archmage Alturus (Morgan's Plot, Deadwind Pass 40, 75) at the end of the LKH attunement." },
         },
     },
-
     {
         id = "es", name = "Emerald Sanctum", category = "Turtle", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Head_Dragon_Green",
@@ -598,7 +589,6 @@ RelationshipsAttune_Data = {
               start = "Keeper Remulos avatar, eastern Hinterlands near Seradane (55, 22)." },
         },
     },
-
     {
         id = "cgrove", name = "Crescent Grove (Turtle 20-man)", category = "Turtle", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Herb_02",
@@ -606,10 +596,9 @@ RelationshipsAttune_Data = {
             { type = "level", level = 55, name = "Reach Level 55", icon = ICON_LEVEL },
             { type = "quest", id = 40100, name = "Crescent Grove attunement", icon = ICON_QUEST, final = true,
               desc = "Turtle-WoW 20-man Emerald-themed raid in Ashenvale. Speak to the druid representative at the grove entrance to start the chain (collect corrupted samples inside the outer ring).",
-              start = "Ashenvale, near the Crescent Grove portal south of Warsong Lumber Camp." },
+              start = "Ashenvale, near the Crescent Grove portal south of Warsong Lumber Camp (~40, 63)." },
         },
     },
-
     {
         id = "gilneas", name = "Gilneas City", category = "Turtle", faction = "Both",
         icon = "Interface\\Icons\\Ability_Mount_WhiteDireWolf",
@@ -620,7 +609,6 @@ RelationshipsAttune_Data = {
               start = "Lord Darius Crowley, Greymane Wall entrance, southern Silverpine Forest (43, 66)." },
         },
     },
-
     {
         id = "hateforge", name = "Hateforge Quarry", category = "Turtle", faction = "Both",
         icon = "Interface\\Icons\\INV_Hammer_16",
@@ -631,7 +619,6 @@ RelationshipsAttune_Data = {
               start = "Overseer Maltorius, Flame Crest camp, northern Burning Steppes (62, 24)." },
         },
     },
-
     {
         id = "stormwind_vault", name = "Stormwind Vault", category = "Turtle", faction = "Both",
         icon = "Interface\\Icons\\INV_Misc_Coin_01",
@@ -639,10 +626,9 @@ RelationshipsAttune_Data = {
             { type = "level", level = 55, name = "Reach Level 55", icon = ICON_LEVEL },
             { type = "quest", id = 40050, name = "Stormwind Vault attunement", icon = ICON_QUEST, final = true,
               desc = "Attunement for the Stormwind Vault dungeon (Turtle). Alliance intro from the Stockade warden; Horde variant from a SI:7 defector in Booty Bay.",
-              start = "Warden Thelwater, Stormwind Stockade entrance, Mage Quarter, Stormwind City (50, 68)." },
+              start = "Warden Thelwater, Stormwind Stockade entrance, Mage Quarter, Stormwind City (50, 68). Horde variant: Booty Bay, Stranglethorn (27, 77)." },
         },
     },
-
     ----------------------------------------------------------------
     -- DRAGONMAW RETREAT (Turtle/Octo custom, Wetlands, patch 1.18)
     ----------------------------------------------------------------
@@ -652,36 +638,32 @@ RelationshipsAttune_Data = {
         steps = {
             { type = "level", level = 25, name = "Reach Level 25", icon = ICON_LEVEL,
               desc = "Minimum level to enter Dragonmaw Retreat." },
-
             { type = "quest", id = 41810, faction = "Alliance",
               name = "To Crush The Dragonmaw", icon = ICON_QUEST,
               desc = "Alliance intro quest for Dragonmaw Retreat.",
-              start = "Captain Stoutfist, Menethil Harbor, Wetlands." },
+              start = "Captain Stoutfist, Menethil Harbor, Wetlands (10, 58)." },
             { type = "quest", id = 41811, faction = "Alliance",
               name = "Blackheart's Demise", icon = ICON_QUEST,
               desc = "Alliance follow-up to slay Overlord Blackheart inside the dungeon.",
-              start = "Captain Stoutfist, Menethil Harbor, Wetlands." },
+              start = "Captain Stoutfist, Menethil Harbor, Wetlands (10, 58)." },
-
             { type = "quest", id = 41820, faction = "Horde",
               name = "Cavernweb Extract", icon = ICON_QUEST,
               desc = "Horde intro quest - collect spider extract inside Dragonmaw Retreat.",
-              start = "Okul, Hammerfall, Arathi Highlands." },
+              start = "Okul, Hammerfall, Arathi Highlands (73, 33)." },
             { type = "quest", id = 41821, faction = "Horde",
               name = "A Blaze Unending", icon = ICON_QUEST,
               desc = "Horde follow-up in Dragonmaw Retreat.",
-              start = "Shara Blazen, Tarren Mill, Hillsbrad Foothills." },
+              start = "Shara Blazen, Tarren Mill, Hillsbrad Foothills (60, 20)." },
-
             { type = "quest", id = 41830, name = "Gowlfang's Defeat", icon = ICON_QUEST,
               desc = "Neutral quest - defeat the gnoll leader Gowlfang.",
-              start = "Grimbite, Green Belt gnoll camp, central Wetlands." },
+              start = "Grimbite, Green Belt gnoll camp, central Wetlands (~46, 50)." },
             { type = "quest", id = 41831, name = "The Dragonmaw Brood", icon = ICON_QUEST,
               desc = "Neutral quest - cull the drakes and whelps inside the retreat.",
-              start = "Nidiszanz, Dragonmaw Gates, Wetlands." },
+              start = "Nidiszanz, Dragonmaw Gates, Wetlands (~70, 40)." },
-
             { type = "item", id = 61810, name = "Lower Reserve Key",
               icon = ICON_KEY, final = true,
               desc = "Opens the gates of Dragonmaw Retreat / Dragonmaw Reserve in the Wetlands.",
-              start = "Looted from Dragonmaw guards in the Dragonmaw Reserve outpost, Wetlands." },
+              start = "Looted from Dragonmaw guards in the Dragonmaw Reserve outpost, Wetlands (~70, 40)." },
         },
     },
 }