Hearthlink

Hearthlink helps solo players and close-knit World of Warcraft groups decide what tonight is for.

It turns character progress, saved preferences, live activity hints, gear usefulness, and party sync data into a practical Tonight's Plan: a short list of useful things to do now, things that are better solo, and things that make more sense with friends.

Current Version

Current alpha version: 0.3.9

What It Does

Hearthlink is not meant to be a strict checklist or optimization tool. It is a friendly planning addon that helps answer questions like:

What is worth doing tonight?
What fits a short session?
What should I do solo?
What is better with this group?
Which weekly or gear-related tasks still look useful?
What should I save for later?

Alpha Notice

Hearthlink is currently in small-group alpha testing. Some task detection, reward values, and scoring rules may change as the addon is tested against real weekly play patterns.

Feedback is especially useful around:

Suggestions that feel too high or too low
Activities that are missing or incorrectly detected
Party recommendations that do not match what the group actually wants
Gear or crest usefulness that feels wrong
Intent choices that do not reorder Tonight's Plan in a helpful way

Current Alpha Features

Tonight's Plan view for scan-friendly recommendations.
Session intent dropdown with Auto, Weeklies, Quick Wins, Chill Solo, Gear Progress, Group Night, Professions, and Catch-Up.
Weighted recommendation scoring so the selected intent strongly affects what rises to the top without hiding everything else.
Solo and group-aware suggestions that shift when Hearthlink detects a party.
Activity tracking for campaign progress, Delves, Great Vault, Midnight weeklies, Prey hunts, PvP weeklies, crests, and optional currencies.
Lightweight profession planning tasks for profession weeklies, knowledge points, farming, and check-ins.
Profession Knowledge Points details with found/missing source items, source KP values, catch-up progress, and compact activity tooltips.
Gear usefulness scoring by equipped item level and reward category.
Mythic+ score and Delver's Journey progress as recommendation factors where available.
Cached alt status when characters have logged in with the addon.
Status, preferences, character, squad, about, and optional debug views.
Party sync with privacy options for shared character data.
Hearthlink World Map / Quest Log tab with a Blizzard-native activity panel.
Hearthlink activities can be tracked in WoW's All Objectives UI under a Hearthlink section.
Compact Hearthlink objective lines keep tracked tasks readable where useful, including profession Knowledge Points progress.
Quest-style Hearthlink activity Details in the map panel with activity cards, Back navigation, Track action, Locations area, and WoW Quest Text Contrast support.
Quest-like active activity behavior: clicking a Hearthlink objective icon marks it active and clears other active objectives.
Hearthlink All Objectives entries and map/quest-log activity rows support the quest watch toggle modifier, so Shift-click by default stops or toggles tracking for the Hearthlink activity.
Active Hearthlink activities show a WoW-toned in-world waypoint overlay that follows Blizzard's navigation frame for the Hearthlink-owned user waypoint.
Party sync for tracked Hearthlink activities and the currently active Hearthlink activity.
Hearthlink map/quest panel gear button opens the main Preferences window for sync, privacy, suggestion, and activity-preference settings.
Hearthlink addon icon and micro-menu button integration.
Vehicle micro menu preference for shrinking Hearthlink's compact micro-menu entry, hiding it, or showing a temporary minimap button.

Version History

0.3.9

Updated Hearthlink for World of Warcraft Retail 12.0.7 by bumping the addon interface target to 120007.
Reviewed the 12.0.7 Blizzard UI/API source changes against Hearthlink's map tab, objective tracker, minimap button, context menu, and party sync integrations; no addon code-path changes were required.
Updated Hearthlink's in-addon version, About screen, README, and release documentation to 0.3.9.

0.3.8

Reduced native World Map tooltip taint risk by preserving the Hearthlink map tab while deferring Hearthlink map-panel refresh/layout work out of Blizzard SetDisplayMode, ValidateTabs, OnShow, and OnSizeChanged callback execution.
Kept Hearthlink map-panel hover UI on the private addon tooltip and documented the current WoW UI taint rules, failure patterns, and validation workflow.
Documented that in-world tracking markers and navigation indicators are still in development and are not finished yet.
Updated Hearthlink's in-addon version, About screen, README, and release documentation to 0.3.8.

0.3.7

Added Blizzard-style layered Hearthlink objective icons using native quest POI frame, glow, pressed, and highlight treatments with a Hearthlink center mark.
Refined the active Hearthlink waypoint overlay with Hearthlink activity marker art, title / distance / symbol ordering, and tighter far-marker spacing.
Fixed active-objective handoff so focusing native quests, content, map pins, or vignettes clears the previously active Hearthlink objective in both normal and party-board / All Objectives modes.
Added compact Hearthlink objective text support and applied it to profession Knowledge Points so tracked entries show a single line like 22/312 Knowledge Points Found.
Updated Hearthlink's in-addon version, About screen, README, and release documentation to 0.3.7.

0.3.6

Added MyusKnowledgePointsTracker-style profession Knowledge Points source tracking with itemized found/missing sources, KP values, weekly/treatise/Darkmoon/first-time/catch-up entries, and hidden catch-up currency handling.
Reworked profession Knowledge Points activity tooltips and Details formatting so the card shows progress, total profession knowledge points, found item counts, itemized source rows, and an explanatory Knowledge Points description.
Updated Hearthlink's quest-style map Details pane to respect WoW's Quest Text Contrast setting for background and text colors, matching Blizzard quest detail color behavior.
Fixed profession Knowledge Points map Details scrolling so long source lists and descriptions can scroll fully above the Locations panel.
Updated Hearthlink's in-addon version, About screen, README, and release documentation to 0.3.6.

0.3.5

Added quest-style Hearthlink activity Details inside the World Map / Quest Log panel. Activity cards now open a focused Details view with objectives, description, Back navigation, and a Track action while preserving the existing Hearthlink map tab behavior.
Reworked the lower Details section from direct rewards into a Locations area for destination hints, including active bountiful Delve names when Blizzard map POI data is available.
Improved Details panel layering so the Track button stays above the lower panel art and the parent map-panel border is hidden while Details is open to avoid duplicate bottom borders.
Improved profession-focused activity data so current-expansion profession tasks, skill caps, racial bonuses, and knowledge-point progress are represented more accurately.
Updated Hearthlink's in-addon version, About screen, README, and release documentation to 0.3.5.

0.3.4

Restored Hearthlink's World Map / Quest Log integration to the stable Blizzard-native tab and content path so previous native tab content no longer shows through the Hearthlink panel.
Kept the secure ToggleQuestLog hook and native Quest Log micro button state sync from the last working release.
Retained the updated CurseForge HTML changelog packaging flow for this release.
Updated Hearthlink's in-addon version, About screen, README, and release documentation to 0.3.4.

0.3.3

Added a one-click Sync Inspector Party Probe that sends a lightweight TEST request over the active party, raid, or instance addon-message channel and automatically records replies from other Hearthlink clients.
Added Sync Inspector BOARD controls for sending the shared party board and running a local fake board sequence covering empty board, selected task, active task, and active clear.
Improved Sync Inspector decoding for BOARD payloads so logs show board revision, update metadata, selected activity count, active task, and active timestamp.
Reduced World Map tooltip taint risk by keeping Hearthlink map-panel tooltips on a private tooltip frame, avoiding native map-pin hover callbacks/glow mutations, and using a secure hook instead of replacing ToggleQuestLog.
Updated Hearthlink's in-addon version and About screen to 0.3.3.

0.3.2

Added the first shared party-board sync layer so grouped players can converge on the same selected Hearthlink activities and shared active task.
Hardened sync parsing for legacy 0.3.1 PROFILE/TRACKING payloads that omitted empty fields.
Kept remote party active state out of the current character profile to prevent invalid tracked/active sync combinations.
Updated Hearthlink's in-addon version and About screen to 0.3.2.

0.3.1

Defaulted party sync and activity-status sharing back on for existing alpha installs through a sync defaults migration bump.
Added Sync Inspector blocked-send feedback so solo tests show when PROFILE/TRACKING payloads were built but no party, raid, or instance channel was available.
Added local debug injection for fake partner TRACKING payloads, letting Sync Inspector emulate received party sync without a second account.
Added a one-click Sync Inspector test that runs the fake party join, tracked activity, and active activity sequence.
Updated Hearthlink's in-addon version and About screen to 0.3.1.

0.3.0

Added the Hearthlink World Map / Quest Log tab and native-style activity panel for browsing recommended activities alongside the map.
Added Hearthlink activity tracking in WoW's All Objectives UI. Checked activities now appear under a dedicated Hearthlink objective tracker section.
Added clickable Hearthlink activity icons in both the Hearthlink panel and All Objectives list. Icons behave like quest POI buttons: clicking marks the activity active, clicking the active activity clears it, and setting a Hearthlink activity active clears native super-tracking.
Added party sync for tracked Hearthlink activities and the active Hearthlink activity. Party members' tracked Hearthlink activities can appear locally, and the newest active selection is mirrored visually for the group.
Fixed tracked and active Hearthlink activity sync to use a dedicated lightweight tracking message, so activity changes propagate immediately instead of depending only on the larger profile sync payload.
Added Fake Partner debug controls for emulating a party member's tracked Hearthlink objective and active Hearthlink activity without needing a second account.
Added a Sync Inspector debug tab that records sent and received PROFILE/TRACKING payloads, decoded tracked/active activity fields, channels, senders, targets, chunk counts, and raw payload text. The tab also includes a one-click fake party sync test for the initial join, tracked activity, and active activity sequence.
Documented the Hearthlink map/quest panel controls, including the gear icon beside Tonight's Focus that opens the main Preferences window.
Cleaned up Hearthlink panel naming so the active World Map panel lives in UI/MapPanel.lua, and temporarily hid the unused party/player count indicator on activity rows.
Updated Hearthlink's in-addon version and About screen to 0.3.0.
Refreshed README, release notes, description, and development documentation for the current release.

0.2.1

Fixed solo-content bucket routing in party mode. Tasks tagged as solo, currency, or crest chores (group value solo / currency / crest) now respect the player's own Not Interested preference and the player's own completion state instead of being forced into the "For You" group regardless. A solo weekly the player has finished and that has no alt need or party need will now correctly fall into "Already Done" with an Already complete for this character. blocker, and any solo task marked Not Interested resolves to "Maybe Later" / Skip.
Replaced the Hearthlink Debug Tests tab's multi-line preview panel with a fixed two-line summary. The first line reports combinations processed, lines generated, and elapsed time; the second line lists per-bucket counts parsed from the run (best, party, assist, mood, completed, skip). The full HLTEST dump is still available through the existing Copy Last Output button, which avoids the rendering overflow caused by the long tab-separated header lines.
Verified the scoring engine against a fresh 1,632-combination HLTEST/1.0 sweep. All previously misrouted cases (campaign / crest_adventurer / shards complete-on-both-sides; Not Interested solo activities) now produce the expected blockers and sortRank=0.
Updated Hearthlink's in-addon version and About screen to 0.2.1.
Refreshed README, release notes, description, and development documentation for the current release.

0.2.0

Introduced an explicit weighted recommendation scoring engine in Data/TaskStatus.lua. Each task is now scored on four 0-100 axes (Preference, Status, Progression, Freshness) that are blended into a single final score using the new RECOMMENDATION_WEIGHTS constants (40% / 30% / 20% / 10%). Bucket assignment is driven by configurable score bands in RECOMMENDATION_THRESHOLDS (together ≥ 70, helpOut ≥ 50, feeling ≥ 30, otherwise "Maybe Later"), with overrides preserved for assist/mood tasks and blocked tasks.
Replaced the embedded Debug tab with a dedicated, free-floating Hearthlink Debug window (UI/DebugWindow.lua). The window auto-tracks the main window's visibility, persists open/closed state across reloads via HL.db.profile.debugWindowOpen, and is gated by the existing Enable debug mode checkbox and /hlink debug toggle.
Added a Fake Partner debug tab that injects a synthetic squad member (HLDEBUG-FakeParty) the recommendation engine treats as a live, in-range player, with per-activity Status and Preference cyclers plus identity controls (name, level, class, role, spec, item level, zone, privacy).
Added a Player Override debug tab that writes directly onto the current character profile's preferences and progress, gated by its own enable checkbox and restored on reload when still active. Includes a gear-tier selector (live | adventurer | veteran | champion | hero | myth).
Added a Details debug tab with Copy as Text (human-readable dump of profile, squad, and scored recommendation groups) and Copy Report (compact HLR/1.1 protocol output suitable for bug reports and AI-assisted diagnosis).
Bumped the debug report protocol to HLR/1.1: the O: line now carries the player-override gear tier as a second field. HLR/1.0 consumers should ignore the trailing field.
Removed the in-tab Debug view from the main window; debug controls now live exclusively in the Options tab and the standalone Debug window.
Updated Hearthlink's in-addon version and About screen to 0.2.0.
Refreshed README, release notes, description, and development documentation for the current release.

0.1.8

Anchored party-mode counts to the actual WoW group size (GetNumGroupMembers) instead of only counting party members whose sync data has arrived recently, so an offline or stale partner no longer makes a shared weekly look like a solo task.
Reworked the at-a-glance party-benefit indicator to be honest about missing sync data. Two-person groups now also display "Partner unknown" (when the player is done) and "You need, partner unknown" (when the player is not), and larger groups show breakdowns like "3 need, 1 unknown" so the player can tell apart "my partner has finished it" from "I don't have current data for my partner."
Moved the party-benefit callout onto its own highlighted line above the at-a-glance summary so the existing reward / status line stops getting crowded. Task rows now grow vertically only when an indicator is present.
Rebalanced Tonight task row padding so the icon, title, party-benefit line, and at-a-glance summary anchor from the top of the row with even spacing instead of the title sitting low with a large gap above it. Row heights were tightened to match the actual content.
Tightened the "Already Done" bucket so it only fires when every real party member has synced and reported complete, preventing premature completion credit when a partner is offline.
Fixed party-mode bucket routing so a task the player has already finished still lands in "Play Together" whenever a synced party member still needs it or a real group member's sync data is missing. The previous chain blocker-routed those to "Maybe Later", which contradicted the new "Partner needs" / "Partner unknown" indicators.
Updated Hearthlink's in-addon version and About screen to 0.1.8.
Refreshed README, release notes, and description documentation for the current release.

0.1.7

Added an "Already Done" group to party mode so weeklies the player and every synced party member have already finished move out of "Play Together" and stop cluttering the active suggestions. Tasks where only one side is done still appear in the active groups, and "neither done" tasks rank above "only one needs it" through the existing party-need score.
Added an at-a-glance party-benefit indicator on every task card in party mode ("You need", "Partner needs", "Both need" for two-person groups; a count fallback like "You + N need" or "All need" for larger groups) so it's obvious why a task still appears when the player has already finished it.
Updated Hearthlink's in-addon version and About screen to 0.1.7.
Refreshed README, release notes, and description documentation for the current release.

0.1.6

Fixed rotating-pool weekly tasks (Arcantina, Halduron, Void Assaults, Ritual Sites, Special Assignment, Fortify Runestones, Unity Against the Void, Active World Boss, Zerella PvP Weeklies, and Prey hunts) incorrectly showing as complete because the character had finished a variant of the same task in a previous week. Hearthlink now tracks which quest IDs were freshly completed inside the current weekly reset window and only credits those toward weekly progress.
Scoped the new "completed this week" tracking to genuine multi-week rotating pools only. Single-event weeklies (Abundance, Lost Legends, Abyss Anglers, Saltheril's Soiree) continue to rely on the quest completion flag directly, so a completion finished before installing this update is still credited.
Updated Hearthlink's in-addon version and About screen to 0.1.6.
Refreshed README, release notes, and description documentation for the current release.

0.1.5

Prepared the v0.1.5 release.
Fixed a loading issue in the packaged addon.
Updated Hearthlink's in-addon version and About screen to 0.1.5.
Updated the WoW interface metadata from 120007 to 120005 to match the current live Retail client.
Refreshed README, development notes, release notes, and project description documentation for the current release.

Release and packaging

Kept the current CurseForge publishing workflow and removed obsolete alpha-release plumbing.
Improved release packaging behavior around addon-folder packaging, zip entry normalization, and artifact generation.
Added repository ownership metadata with CODEOWNERS.

0.1.4

Updated Hearthlink's in-addon version and About screen to 0.1.4.
Refreshed project documentation for the current alpha.
Cleaned up release packaging by replacing the older alpha workflow with the current Hearthlink workflow.
Added deploy tooling for smoother local release packaging.
Improved updater and release plumbing so installing test builds is less of a side quest.

0.1.3

Added the Hearthlink icon to addon metadata so WoW and addon managers can display the proper artwork.
Updated the micro-menu button to expose the Hearthlink name and icon more consistently.
Bumped packaged version metadata and docs for the 0.1.3 alpha.

0.1.2

Added the Tonight focus intent dropdown.
Added Weeklies, Quick Wins, Chill Solo, Gear Progress, Group Night, Professions, and Catch-Up intent weighting.
Added weighted intent scoring with visible suggestion reasons.
Added lightweight profession planning tasks: Profession Weeklies, Knowledge Points, Profession Farming, and Profession Check-In.
Improved task icon coverage and added fallback icon handling.
Renamed the main planning tab to Tonight.
Switched the intent selector to a native WoW dropdown control.
Improved Tonight's Focus layout and spacing.
Removed placeholder collection-planning tasks and intent. Collection planning may become a separate module or addon later.

0.1.1

Reframed the addon around Tonight's Plan rather than a simple checklist.
Improved recommendation text hierarchy across list rows, tooltips, and detail pages.
Added clearer detail-page sections for why an activity is suggested, who it helps, where to start, and expected rewards.
Added local development sync tooling for copying the addon into the WoW AddOns folder.
Split project documentation into feature, product experience, and development notes.
Added a CurseForge alpha publishing workflow.

0.1.0

Initial alpha foundation.
Added the main Hearthlink window, tabs, slash commands, micro-menu button, saved variables, activity preferences, character snapshots, and early recommendation data.
Added early party/squad sync support and privacy controls.
Added basic status, preferences, and debug surfaces for testing.

Scope Notes

Hearthlink is focused on practical session planning. It is not currently trying to become a full collection tracker, route planner, guild management tool, or optimization simulator.

Mount and transmog collection planning may be better as a separate module or addon because it needs source tracking, routes, lockouts, drop data, and character eligibility rules.

Privacy

Hearthlink is designed for coordination with trusted party members. Sync can be disabled, and privacy options are available to limit shared character details.

Slash Commands

/hearthlink
/hlink

Both commands toggle the main Hearthlink window.