HomeWatch

HomeWatch — Release Notes (v1.0.2) — 2026-05-30

Summary Major feature release adding Open House mode with full guest tracking, automated whispers, timed messages, and event logging. Includes significant robustness improvements to guest detection, pet greeting logic, and UI stability, plus a complete visual overhaul to the Stone Hearth design system.

New

• Open House Mode

  • Show My House button on the Current Guests tab starts an Open House. Button only appears when inside your house instance (not in the neighborhood or yard).
  • Guests who join your raid group receive a customizable Open House Greeting whisper automatically.
  • Guests who leave the raid group receive a customizable Open House Thank You whisper.
  • Open House Timed Message — a second whisper sent to each guest after a configurable delay (Off, 1–5 minutes). Timer cancels if the guest leaves early; all timers clear on disband.
  • When starting an Open House with raid members already present, a confirmation prompt asks whether to send them the greeting whisper. Timed message timers always start for existing members regardless of choice.
  • Guild Chat Announcement button posts a customizable message to guild chat, with a preview/edit popup before sending.
  • All Open House events logged to HomeWatch_OpenHouseLog with date, duration, peak attendance, and full participant list.
  • Open House event history shown in the Guest Log tab.

• Home Nicknames

  • Each registered home can be given a short nickname (e.g. "the Swamp", "the Rooftop") via a Set Nickname button in the My Homes popup.
  • [nickname] and [nickname2] tokens available in all customizable messages; silently omitted if no nickname is set.

• Minimap Button

  • Angle-based positioning around the minimap; drag to reposition.
  • Left-click toggles the Guest Book; right-click opens My Homes.
  • Position saved to HomeWatch_Options.minimapAngle.

• Export

  • CSV export for Guest Log, My Visits, Stats Summary, and Open House Events.
  • Export popup with section dropdown; click inside and use Ctrl+A / Ctrl+C to copy.

• [W] Whisper Button

  • Dedicated whisper button on every guest row in Guest Log and My Visits.
  • Row click-to-whisper removed to eliminate overlap conflicts with note button.

Improved

• Stone Hearth Design System

  • Full UI redesign with consistent dark brown/gold color palette throughout all windows, popups, and tabs.
  • Shared widget library (HomeWatchUI.lua) provides HW_CreateWindow, HW_CreateButton, HW_CreateRadioGroup, HW_CreateDropdown, HW_CreateMultilineEditField, and more.

• Radio Button Groups

  • Pet Greeting Mode and "If a Pet is Already Out" both use HW_CreateRadioGroup() for correct mutual exclusivity.

• Multiline Text Boxes

  • All five customizable message fields use wrapping 56px multiline edit boxes (plain container + naked EditBox; no unsupported templates).

• Guest Detection Robustness

  • Group and raid members excluded from guest detection via UnitInParty/UnitInRaid guards in both RecordArrival and ParseSystemMessage.
  • Return visitor welcome-back whisper guards against logging the current visit and clamps negative day values.
  • IsInOpenHouseRaid forward reference fixed — definition moved before first call site.

• Per-home Pet Overrides

  • greetingMode = "none" now correctly checked before per-home override, so "No pet greeting" always wins.

• Migration Block

  • InitOptions auto-corrects stale saved values on load: old greeting text, old thank you default, old announcement wording, flat myHomes string arrays.

• ASCII-only UI

  • All UTF-8 characters replaced with plain ASCII equivalents ([N], [W], +, >>, v) for compatibility with WoW's default font.

Fixed

• Welcome whispers no longer fire on exit due to PLAYER_ENTERING_WORLD misuse.
• Placeholder GUIDs (SYSMSG:name) correctly replaced by real GUIDs when nameplates appear.
• Pet greeting correctly suppressed when greetingMode = "none", even if a per-home override exists.
• Open House Farewell field retired (replaced by Thank You); saved text preserved in openHouseFarewell key to avoid data loss.
• HW_OPENHOUSE_GREET_EXISTING popup correctly starts timed message timers on both Yes and No responses.

Known Issues

• Open House state does not survive UI reload — host must restart the Open House; the existing-members prompt handles this gracefully.
• Corner ornaments (+) and resize grip (>>) render as empty boxes on some systems — atlas texture replacement planned.
• Remaining translucency on some popups.

QA Checklist

Open House — Basic Flow

• Start an Open House with an active raid group; confirm greeting whisper fires for each member.
• Have a friend join the raid mid-Open House; confirm they receive the greeting whisper.
• Have a friend leave the raid; confirm they receive the thank you whisper.
• Disband the raid; confirm all remaining members receive thank you whispers and the event is logged.

Open House — Timed Message

• Set a timed message and a 1-minute delay in Options.
• Start an Open House; confirm the timed message fires ~1 minute after a guest joins.
• Have a guest leave before the timer fires; confirm they do NOT receive the timed message.

Open House — Existing Members Prompt

• Form a raid group, then click Show My House.
• Confirm the StaticPopup appears listing the member count.
• Click Yes; confirm all members receive the greeting whisper.
• Repeat, click No; confirm no greeting whispers but timed message timers still start.

Show My House Button Visibility

• Confirm button is visible inside the house instance.
• Confirm button is hidden in the neighborhood/yard.

Home Nicknames

• Set a nickname for a registered home; confirm [nickname] resolves in whisper previews.
• Clear the nickname; confirm [nickname] is silently omitted with no leftover punctuation.

Guild Announcement

• Click Announce in Guild; confirm preview popup appears with formatted text.
• Edit and post; confirm message appears in guild chat.

Pet Greeting

• Set greeting mode to "No pet greeting"; confirm no pet is summoned even if a per-home override exists.

Export

• Open Export for each section (Guest Log, My Visits, Stats Summary, Open House Events).
• Copy CSV and validate structure in a text editor.

Minimap Button

• Left-click toggles Guest Book; right-click opens My Homes.
• Drag to reposition; reload UI; confirm position persists.

Packaging Notes

• ## Version in HomeWatch.toc is 1.0.2.
• Zip structure: HomeWatch-1.0.2.zip → HomeWatch/ → 5 files (HomeWatch.toc, HomeWatchUI.lua, Options.lua, Core.lua, HWmini.tga). No outer versioned folder.
• Always delete and recreate the zip — never use --update.