🏠 HomeWatch — Your Home, Your Guests, Your Story

HomeWatch is a social and observational addon for the player housing system introduced in The War Within / Midnight. It keeps track of who visits your home, how long they stay, and when you visit others — all wrapped in a warm, lore-friendly presentation.

Whether you're hosting open houses, welcoming friends, or simply curious who stopped by, HomeWatch gives your home a sense of life and continuity.

✨ Features

👥 Guest Tracking

• Live "Current Guests" list with elapsed timers
• Arrival and departure detection via system messages, group roster, and nameplate radar
• Room-transition safe (10-second grace period)
• Guest notes (per-guest and per-visit)
• Dedicated [W] whisper button and [N] note button on every guest row

📖 Guest Book (6 Tabs)

1. Current Guests — live list with timers, whisper and note buttons
2. Guest Log — full visit history with home tag, date, and duration
3. My Visits — your visits to other homes with owner, date, and duration
4. Stats — unique visitors, busiest hour, longest stay, and more
5. Help — token reference, feature documentation, and ToS compliance note
6. Options — all settings in one place, no separate popup needed

🎉 Open House Mode

• Show My House button starts an Open House from the Current Guests tab (only visible when inside your house instance)
• Guests who join your raid group automatically receive a customizable Open House Greeting whisper
• Guests who leave receive a customizable Open House Thank You whisper
• Timed Message — a second whisper sent to each guest after a configurable delay (Off, 1–5 minutes); cancels if the guest leaves early
• When starting with raid members already present, a prompt asks whether to send them the greeting — timed message timers always start regardless
• Guild Chat Announcement button with a preview/edit popup before posting
• All Open House events logged with date, duration, peak attendance, and full participant list

💬 Welcome & Thank You Whispers

• Customizable welcome whisper on arrival and thank you whisper on departure
• Full token support: [name], [host], [owner], [address], [nickname], [address2], [nickname2]
• Leave the thank you field blank to disable it entirely
• Test whisper button sends a preview to yourself

🏡 My Homes

• Register multiple homes by owner name
• Set a friendly nickname for each home (e.g. "the Swamp", "the Rooftop")
• [nickname] and [nickname2] tokens resolve silently — no leftover punctuation if not set
• Update each home's address from inside the instance with one click

🐾 Pet Greeter

Summons a companion pet when you arrive at your own home and dismisses it on exit — but only if HomeWatch summoned it.

• Random pet from your entire collection
• Random from favorites only
• Specific pet
• Per-home pet overrides
• Option to skip greeting pet if one is already out

📓 Guestbook Integration

Works alongside the Guestbook addon (by HousingNotes) to prompt you to sign a guestbook when visiting homes that have it installed.

• Show popup — a prompt appears on arrival with an optional personal note field
• Autosign — signs automatically on arrival with no prompt
• Ignore — disables the integration entirely
• Never fires on your own home
• Configure in the Options tab

📊 Statistics

• Per-home visit counts
• Most frequent visitor
• Longest stay
• Average stay
• Busiest hour
• Most visited home (from My Visits)

⬇️ CSV Export

Export your data for any of:

• Guest Log
• My Visits
• Stats Summary
• Open House Events

Perfect for RP journals, community event records, or personal archival.

🧭 Accurate Housing Detection (12.0.x)

HomeWatch uses a robust three-layer detection system:

1. System messages — instant, full-instance detection
2. Group roster sweep — catches guests already present on arrival or reload
3. Nameplate radar — fallback for non-housing contexts (not available inside housing instances)

Fully compatible with:

• C_Housing.GetCurrentHouseInfo()
• GetMinimapZoneText() interior detection
• Room transitions within the instance
• Neighborhood vs. interior zone distinction

🗺️ Minimap Button

• Left-click toggles the Guest Book
• Right-click opens My Homes
• Drag to reposition; position saved across sessions

🧰 Slash Commands

/homewatch

🛡️ ToS-Friendly by Design

HomeWatch follows Blizzard's addon policy:

• No automation of gameplay
• No input injection
• Cosmetic and social features only
• Whisper-only greetings (Say/Yell are subject to cross-faction language barriers even in neutral housing zones)
• No silent data collection

📦 Requirements

• World of Warcraft Retail
• Patch 12.0.5+ (The War Within / Midnight)

📝 Credits

Author: Blodwedd Mallory
Questions or feedback: blodweddmallory.com/contact
Special thanks to the WoW housing community for early testing and feedback.