FOREVER TURN-INS 0.8.18

0.8.18: Dungeon objectives stay visible when the client provides no usable map or exact coordinates. Matches the active dungeon to quest-log categories or area metadata, including The Drowned City. Dungeon floors remain separate from outdoor zones. Unlocated objectives show progress and open quest details without creating a guessed pin. Existing completion and tracking filters still apply.

0.8.17: Clicking a ready quest or active objective now selects that quest and opens its Blizzard quest description alongside the map. Works with OpenMap pins. Quests with no known turn-in location still open their details. Stale quests are rechecked, and opening/rearranging the quest panel is skipped during combat. Existing pins and tracker focus are retained.

QUEST RIGHT-CLICK ACTIONS
Right-click an objective or ready-to-turn-in quest for Focus quest, Stop tracking
or Abandon quest. Focus pins the destination and brings the quest to the top.
Stopped quests remain in your log, but disappear from this tracker until you
restore them from the filter dropdown > Stopped quests, or track them in the
Blizzard quest log. Choices are saved per character.
Abandon requires confirmation, checks that the quest is still in your log and
can be abandoned, and is unavailable during combat. On older clients without
the required API, it opens the quest log so you can abandon there.

QUEST FILTER DROPDOWN
The bar-graph icon opens a compact Blizzard dropdown with Sort by, Order and
Zone submenus. Selected choices are marked. Choosing an option closes the menu
without closing the tracker. The old green filter window has been removed.

OBJECTIVE FIREWORKS
A compact gold-and-green firework celebration plays when a known unfinished
objective becomes complete, with the quest name. Lasts 5.1 seconds with
three waves of sparks and a final fade. Several objectives from
the same update are grouped into one notice. Repeated log events do not
replay it, and login/reload/zone changes do not celebrate old completions.
Enabled by default. Under ... use Fireworks: On/Off and Preview, or type
/fturnins celebrate to preview. The animation uses independent, click-through
artwork and can run during combat without changing protected quest buttons.
No extra sound or dependency on Forge or Combat Assistant is required.


EMPTY OBJECTIVES COLLAPSE
When no quests match the objectives section, it folds to its header only.
It opens again when matching quests return, unless manually collapsed.
Turn-ins, gathering and the overall tracker keep their existing state.

FOCUSED QUEST FIRST
The quest selected by the existing navigation arrow stays above the other
unfinished objectives in every sort mode. Clicking one of our objective
rows also records its quest identity for the existing OpenMap/client pin.
Changing or clearing that pin releases the previous focus. Remaining quests
keep the selected sorting and zone filter. No extra navigation arrow is
created. Protected quest-item layout changes still wait until combat ends.

QUIETER TRACKER HEADER
Minimize, quest filters and ... sit at 20% opacity when idle. Hover over
each control to restore full brightness; quest text remains unchanged.

CLICKABLE QUEST ITEMS
The game-reported usable quest item appears beside its objective when you
carry it in your bags. Click the icon to use it; hover for its tooltip.
Cooldowns and charges are shown where available. Quest-title clicks still
pin the objective. Bank-only items and unconfirmed item matches are omitted.
Prepared item buttons remain clickable in combat. Once the tracker contains
secure item buttons, layout, scrolling and row changes wait until combat
ends; new or changed items are attached then. Cooldowns continue updating.


ACTUAL QUEST OBJECTIVES
Client quest markers now show the actual quest-log objectives and progress
beneath the title. Completed tasks are labeled in green. Long text wraps,
and rows grow to fit. Quest-log updates refresh progress automatically.
Yard distances are hidden; distance sorting still works in the background.
Clicking still pins the known quest location; existing Questie objective
locations and ready-to-turn-in tracking are preserved. If the client cannot
provide objective details, the tracker says so instead of inventing tasks.

QUEST FILTERS AND READABLE TEXT
Use the bar-graph icon beside ... to sort objectives by quest name, distance,
level, zone or map area. Ascending/descending and only this zone/all zones
are saved per character. Default: only this zone, nearest first. Distance
is a straight-line estimate and refreshes as you move; unknown distances
and levels stay last. Ready-to-turn-in quests are unaffected.
Fully transparent trackers add a black outline and stronger dark shadow
to all text, including quest titles, XP, objectives and gathering tips.

WHERE TO LEARN
Unlearned guide recipes and rank reminders now show their learning source,
faction-appropriate trainer/vendor, zone, coordinates and a Pin learning
location button when an exact location is recorded. Includes training books
and quests, and identifies world-drop patterns instead of inventing trainers.
Nearest means the nearest comparable known location on the same continent,
using straight-line world distance, not a walking/flight route. When position
or distance is unavailable, a known location is shown without a nearest claim.
Dungeon trainers without coordinates show their name and location, no false pin.
Recipe trainer lists should be checked in-game before buying materials.
Sources checked 2026-11-14: https://www.wow-professions.com/forever/
Profession-specific trainer and leveling-guide pages plus their NPC pages.
Recipe source/skill fallback uses the recorded Forever profession catalogue.


CLEARER CRAFTING STEPS AND TRACKER LOADING
The guide pins the current recipe first, with the next small batch and the
whole-step estimate clearly separated. Materials show how many to get;
the next recipe appears only under After skill. Gray, unlearned and capped
recipes show Do not craft yet. Enchanting counts applications explicitly.
Temporary UI hides no longer change your saved tracker visibility. Native
trackers are rechecked immediately after login, world entry and addon loading.
Protected tracker changes still wait until combat ends.


CLICKABLE FISHING GUIDE
Click Fishing in Gathering to open its guide. It lists recommended spots for
your current base skill, possible catches, minimum/effective skill and the
extra bonus needed for reliable catches. Early recommendations favor your
faction. Skill 300 still shows farming options. Catch examples are not a
complete loot table or a guarantee; Tanaris seasonal fish are marked.
Skill and equipment/aura changes update an open Fishing guide. No crafting
window is opened and the quest tracker keeps its position and visibility.
Sources checked 2026-11-14:
https://www.wow-professions.com/forever/fishing-and-cooking-leveling-guide
https://www.wowhead.com/forever/guide/professions/fishing/overview-leveling
https://www.wowhead.com/forever/item=13758/raw-redgill
https://www.wowhead.com/forever/item=13759/raw-nightfin-snapper
https://www.wowhead.com/forever/item=13760/raw-sunscale-salmon

FISHING IN GATHERING
Learned Fishing now appears in Gathering when the current zone has recorded
open-water requirements. Green means sufficient effective skill for reliable
catches; yellow means fish may escape or requirements vary by fishing spot;
red shows the minimum needed. Hover for thresholds and exception areas.
Skill caps remind you to train. Easier zones can still provide skill-ups.
Client-reported pole/lure/food bonuses count toward effective skill. Player
aura and equipment changes refresh the display without rescanning quests.
Unknown zones are omitted instead of claiming they are good fishing spots.
Mixed waters (Azshara, Feralas, Stranglethorn Vale) stay cautious unless all
recorded requirements are met or the named special fishing spot is identified.
Special subzone name recognition currently uses English names; other locales
retain the mixed-zone warning. Normal zone lookup uses localized area names.
Source checked 2026-11-14:
https://www.wowhead.com/forever/guide/professions/fishing/overview-leveling

CRAFTS REMAINING AND TARGET ALERTS
Crafting guides keep a large Crafts remaining estimate above the scrolling
instructions, with the target skill and next recipe. It covers the whole
guide step even if training is needed before you can finish. The small
starting batch remains separate. Counts recalculate from actual skill;
gray recipes show unavailable rather than promising more skill gains.
Alerts are on by default. Reaching a step target or an intervening skill cap
while the profession/guide is open plays a warning sound and shows a popup.
Stop the crafting queue manually; the addon does not cancel crafts for you.
Each reached target warns once, not repeatedly on every bag/recipe refresh.
Use Alerts: on/off in the guide to change the setting. Sound still depends
on the game's Master sound setting. Estimates are crafts, not output items.

LIGHTWEIGHT TRACKER APPEARANCE
The tracker uses a transparent background, no outer border, gold quest text
and compact, unboxed section headings. Quest and objective rows remain
clickable and show a subtle highlight on hover. Text has a dark shadow.
Click ... for controls, log count, close button and the resize grip. Outside
that view those extras stay hidden. Drag the Objectives heading to move;
the - / + control still minimizes and restores it. The Opacity control
optionally adds a light background, starting from fully transparent.

OBJECTIVE TRACKER REPLACEMENT
Replaces Blizzard's side objective tracker by default while this window is
shown. First use moves the window to the right side; it remains draggable,
resizable and minimizable. Turn-ins appear first, current-zone unfinished
objectives next, and existing gathering information below them.
Click ... then Tracker: Forever to restore Blizzard's tracker, or use
/fturnins blizzard. /fturnins replace enables the replacement again.
Blizzard's tracker also has a small FG button next to its expand/collapse
control to switch back. The button is hidden while Forever is active.
Hiding the Forever window also restores the native tracker. Minimizing it
keeps the replacement active. Escape still leaves the Forever window open.
Protected native frame changes wait until combat ends. Native tracking
events and quest watches remain intact; no other addon files are changed.
This replaces the side tracker, not the quest-log/map window. The replacement
shows the existing ready quests and known current-zone objective locations;
it does not reproduce Blizzard achievement/scenario tracking or item buttons.

MINING FARMING GUIDE
Mining opens a short farming-zone list instead of crafting instructions.
Recommendations follow Mining skill plus bonuses, not character level.
Early choices favor your faction; Iron favors Thousand Needles below
character level 40. Brief route notes flag harder caves and elite areas.
The ore list only names ores unlocked at your effective skill. At 300,
farming locations remain available. A capped lower rank adds a training note.
Opening this list does not open Smelting. The existing current-zone Gathering
section is unchanged. Zones are recommendations, not a live density ranking.
Source checked 2026-11-14:
https://www.wow-professions.com/forever/mining-leveling-guide
The source marks routes from 125 onward as provisional Classic routes
awaiting higher-level Forever testing. Follow actual node requirements.

QUEST OBJECTIVES IN YOUR ZONE
A separate collapsible section lists unfinished quests with objectives in
your current zone. Nearby objectives are grouped into 5-percent map areas.
Questie supplies individual unfinished objectives and progress where it has
loaded them; otherwise the client's current-zone quest marker/waypoint is
shown as quest activity. Unknown locations are omitted, not guessed from
quest-log headings. Indoor maps use their parent zone. Quest and zone events
refresh the list. Click a row to pin its objective with the existing OpenMap
or Blizzard waypoint support. Stale clicks are checked again before pinning.
The ready-to-turn-in list and its XP totals remain unchanged across all zones.
Other addons' map markers are unchanged.

MINIMIZE
Click - beside X to fold the window into a small draggable title bar.
Click + to restore the previous size and contents. The title stays in place;
moving the minimized bar moves the restored window too. Minimized state
saves per character. Escape still leaves it visible. /fturnins reset also
clears minimized state. /fprofessions does not change this window.

PROFESSION GUIDES
Click the book icon above the ? beside the Blizzard profession window, or use
/fprofessions. Profession guides are no longer listed in Ready to Turn In.
The slash command selects the open profession, last selection, or first
learned profession. It opens a separate, opaque guide panel and
opens the profession window when the client supports it and you are not in
combat. The guide docks beside Blizzard's profession window, switching to
the left when there is more room there. Without an open matching profession,
it remains a standalone guide. It follows profession changes while open.
Closing the native profession window also closes its attached guide.
A book icon beside the native profession window reopens the guide for
that profession. Hover it for the Profession guide tooltip. The icon is
hidden while its attached guide is open. The guide leaves space for the
native profession tabs along the right edge.
Use the guide's own A-/A+ buttons for readable 12-20 point text. The guide
uses short bullet lists: Make first, Materials, Learn next, and Tips.
Guide link reveals the copyable source URL. X closes only the guide.
Eight crafting guides cover Alchemy, Blacksmithing, Enchanting, Engineering,
Leatherworking, Tailoring, Cooking and First Aid. Mining, Herbalism, Skinning
and Fishing show gathering/training guidance instead of fabricated crafts.
Both primary and secondary professions are detected from the player's live
skill records, including Forever tier skill lines and legacy API fallbacks.

The current recipe, estimated crafts remaining, a starting batch up to five,
next recipe milestone and next training rank follow your skill and cap.
The estimate scales the guide's quantity to remaining skill in the step;
it recalculates after skill changes. Yellow/green crafts may give no point.
Craft counts are not output item counts. Save intermediates for later;
the current skill-step estimate is not an entire route shopping list.
This does not calculate auction prices or guarantee the cheapest route.

Open your native profession window to load learned recipe and reagent data.
Live gray/disabled/unlearned recipes and skill caps stop the suggested batch.
Missing recipe information remains unknown. Linked/guild books never prove
that you learned a recipe. Open recipe selects the native crafting recipe;
all crafting and purchases remain manual. Combat blocks that shortcut.
The separate guide shows required reagents for the first batch, bag counts and
shortages. Unknown counts and reagent choices are not treated as zero.
Each character remembers the last selected profession and guide text size.

SOURCES
Selected recipe milestones and spell IDs from the eight guides linked at
https://www.wow-professions.com/forever/
Each profession includes its copyable source URL and check date. The source
describes its data as Forever beta guidance; live client data takes priority.
Training and recipe-acquisition notes are summaries, not copied guide text.
Rebuild recipe links with scripts/build-profession-guide.mjs; this reads the
public source pages and fails rather than guessing an unresolved spell ID.
No website connection is required in game. Source checks: 2026-11-14.

0.4.0: Ready rewards total at the top of the quest section, with their share
of XP remaining to next level. Unknown rewards are counted separately and
never invented. Hover the Turn-ins heading for the full total explanation.
The log count shows capacity and a nearly-full warning when the client
provides a capacity. Quests are grouped by nearby destination coordinates;
this is approximate proximity, not a route or an assertion of the same NPC.
Quests and Gathering collapse independently and remember their state.
Gathering highlights known skill colors, displays the next locked node,
and identifies unknown cutoffs and estimated variants in hover details.

GATHERING AND QUEST XP
- Compact, collapsible Gathering section in the same scrolling window.
- Mining and Herbalism rank/cap and bonuses come from the client's skill list.
- Up to three suggested nodes in your current zone, with required skill.
- Next locked node or current skill-cap status when relevant.
- Hover a gathering line for the complete zone list and requirements.
- Zone/skill changes refresh the panel; unlearned professions are not listed.
- XP is right-aligned beside each ready quest title. The game supplies the
  reward; an unavailable amount shows -- XP, distinct from a real 0 XP.

GATHERING DATA AND LIMITS
Bundled zone/resource facts: 445 records across 41 area IDs extracted from
the user-supplied Forever Companion Data/Nodes.lua snapshot (2026-10-21),
which identifies Wowhead Forever as its source. No spawn paths are bundled.
This is a recorded zone list, not a scan for currently spawned nodes.
Unsupported zones say no records rather than borrowing a nearby zone.
Exact-name Forever guide records override required skills and supply known
yellow/green/gray cutoffs. Missing cutoffs remain unknown. Unmatched nodes
use estimated windows of required skill + 100 (100 for beginner nodes),
marked with ~. These suggestions do not guarantee points.
Skill bonuses count toward eligibility; the actual cap is read from the client.
Current source checks:
https://www.wowhead.com/forever/guide/professions/mining/overview-leveling
https://www.wowhead.com/forever/guide/professions/herbalism/overview-leveling
Guides updated 2026-11-09; thresholds checked 2026-11-14.
Rebuild the compact facts with scripts/build-turn-ins-gathering.mjs after
updating the supplied source snapshot. No change to quest pins or Escape.

A quest tracker and ready-to-hand-in list. Replaces the old map filter/button.
Your normal OpenMap, Questie and Blizzard map markers are left alone.

USING THE WINDOW
- Only active, completed, nonfailed quests are listed; rewarded history,
  incomplete quests and hidden log entries are excluded.
- Click a quest to open the map and pin its turn-in location.
- Drag the title bar to move. Drag the bottom-right grip to resize.
- Click ... for smaller/larger text, background opacity and position lock.
- Escape leaves it on screen. X hides it; the minimap icon reopens it.
- /fturnins toggles the window. /fturnins reset restores its size/position.
- Position, size, text size, transparency, lock and visibility save per character.
- Ready count and quest-log count update as your log changes.

LOCATION SOURCES
Uses the client's current completed-quest waypoint first, then Questie's
recorded finisher (NPC or object), then the client's current-zone waypoint
or quest marker. Questie's coordinates come from its installed data; no
new Classic locations are bundled or assumed. Unknown locations open quest
details with an explanation rather than inventing a pin. A row is rechecked
on click so abandoned or already-turned-in quests cannot be pinned.

OPENMAP
Uses OpenMap 0.8.13's existing waypoint bridge, including its own pin on maps
without native user-waypoint support. Standard maps use Blizzard's waypoint
when available. Unsupported maps can track the quest instead. OpenMap's
waypoint bridge is an internal integration and may need updating if it changes.
No OpenMap or Questie files are modified. The previous map filter is retired;
its saved switch is removed, and it no longer hides any other quest markers.

INSTALL / UPDATE
Replace the ForeverTurnIns folder in your WoW Forever Interface/AddOns folder.
Reload the UI after updating. A new installation may require restarting WoW.
Enable Forever Turn-ins in the AddOns list. No other Forever addon is required.

VALIDATION
Automated checks cover ready-only lists, lifecycle events, stale clicks,
client and OpenMap pinning, Questie finishers, unknown locations, settings,
legacy fallbacks and pooled list rows. Live game rendering is not verified.
