🏠 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)

Current Guests — live list with timers, whisper and note buttons
Guest Log — full visit history with home tag, date, and duration
My Visits — your visits to other homes with owner, date, and duration
Stats — unique visitors, busiest hour, longest stay, and more
Help — token reference, feature documentation, and ToS compliance note
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:

System messages — instant, full-instance detection
Group roster sweep — catches guests already present on arrival or reload
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.