# Vamoose's Neighbors

**Your neighborhood directory for World of Warcraft Housing -- see who lives where, check endeavor progress, and visit friends.**

Browse every plot in your neighborhood at a glance. See who owns each house, check which endeavor each neighborhood is running and how far along it is, discover new neighborhoods before you commit, and find your Battle.net friends' and guild members' houses across all neighborhoods -- all from one compact panel with an embedded map.

---

## What's New in v1.6.1

**Polish pass on v1.6.0**

- **Search also finds friends by Battle.net tag** -- not just character name.

- **Renaming a group works** -- fixed.

- **Groups are exclusive** -- moving a house to group B now auto-removes it from the old group. No more duplicates.

- **Favourites section above Groups** -- stars come first.

- **"Empty plots" bucket behaves itself** -- hidden from the Groups popup (it manages itself), always sits at the bottom of the Neighborhood list, renamed from the confusing "Empty" label.

- **Localization** -- Groups, Favourites, Favourite / Unfavourite, Alliance / Horde / All, and the default group name now display in German, Spanish, French, Italian, Korean, Portuguese, Russian, Chinese (simplified + traditional).

- **Stale plot ownership cleaned up** -- if a friend's plot changes hands (a former owner is no longer the actual owner), VN now correctly clears the old entry on the next scan.

- **Battle.net tag sticks when a friend goes offline** -- we remember it once we've seen it; it only clears when the friend is removed from your BNet list entirely.

See CHANGELOG.txt for full version history.

---

## Directory Tab -- Your Neighborhood at a Glance

**See every plot owner in your current neighborhood.**

- **My Homes** -- One row per owned house with faction icon, neighborhood name, house name, live cooldown remaining, and a dedicated Teleport button for each house (two houses = two buttons)

- **Plot List** -- All plots with owner names, color-coded by relationship (teal = you, blue = friend, gold = guild, gray = stranger, dim = empty)

- **Search** -- Filter by owner name or plot name

- **Sort** -- Sort by plot number or owner name (ascending/descending)

- **Pin Button** -- Set a native waypoint to any plot with super-track arrow

- **Visit Button** -- Teleport directly to a neighbor's house via SecureActionButton (combat-safe)

- **Endeavor Progress** -- Live progress bar showing the current endeavor name and completion percentage (shows "Loading endeavor..." while the game API catches up)

- **Return to Previous Location** -- Header button to bounce back after visiting another player, without needing the housing dashboard

- **Favourites + Custom Groups** -- Star any owned plot, friend, or guildie to pin to the top; right-click for a context menu that adds/removes them to named groups (persisted across reloads)

- **Faction Badge** -- Neighborhood name is prefixed with the Alliance or Horde atlas so you can see the faction at a glance

---

## Friends Sub-Tab -- Find Your Friends

**Locate all your Battle.net friends' houses across every neighborhood.**

- **Cross-Neighborhood** -- Scans all BNet friends and shows their houses regardless of which neighborhood they're in

- **Search** -- Filter by friend name or neighborhood name

- **Visit** -- Blue visit button on each row to teleport directly to a friend's house

- **Incremental Scan** -- Only new friends are scanned on login; removed friends are pruned automatically. Weekly full re-scan catches data drift. Force Refresh triggers a complete re-scan at any time.

- **Endeavor Progress** -- Each friend's neighborhood shows its current endeavor and completion percentage

---

## Guild Sub-Tab -- Find Your Guildmates

**Locate all your guild members' houses across every neighborhood.**

- **Cross-Neighborhood** -- Scans all guild members and shows their houses with gold-accented visit buttons

- **Search** -- Filter by member name or neighborhood name

- **Guild Change Detection** -- Automatically wipes cache and re-scans when you switch guilds

- **BNet Dedup** -- Guild members who are also BNet friends are not double-scanned

- **Endeavor Progress** -- Each member's neighborhood shows its current endeavor and completion percentage

---

## Browse Tab -- Discover Neighborhoods

**Explore neighborhoods beyond your own using the House Finder. See which endeavor each neighborhood is running and how far along they are -- before you commit.**

- **Neighborhood List** -- Scrollable list of discoverable neighborhoods with type and owner info

- **Endeavor Progress** -- Each neighborhood shows its current endeavor name and completion percentage, fetched live

- **Your Houses** -- Your own houses pinned at the top with a teal accent bar

- **Click to Explore** -- Click any neighborhood row to view its plots in the Directory and embedded map

- **Recent Visits** -- Browse tab has a Recent sub-tab showing your last 20 visited neighborhoods with timestamps

- **BNet Search** -- Search for neighborhoods your Battle.net friends live in

- **Auto-Refresh** -- List refreshes periodically and on charter accept/decline events

---

## Embedded Map Drawer

**An animated neighborhood map that slides out from the panel.**

- **Animated Map** -- Neighborhood map loads with a smooth column-by-column fade-in (toggleable in config)

- **Color-Coded Pins** -- Plot markers colored by ownership (teal = self, blue = friend, gray = stranger, dim = empty)

- **Waypoint Tracking** -- Click any pin to set a waypoint; a blue tracking marker appears on the map

- **Clear Waypoint** -- Right-click the waypoint pin, or close the map, to clear it

- **Chat Sharing** -- Shift-click a pin to share a clickable map link in chat

- **Pin Tooltips** -- Hover to see owner name, plot name, and action hints

- **Neighborhood Title** -- Current neighborhood name displayed in themed header font on the map canvas

- **Auto-Show** -- Map opens automatically when neighborhood data is available, closes on Friends/Config tabs

- **Toggle** -- Manual toggle via header button; remembers your preference

- **Plot Marker Overlay** -- Toggle numbered circles on plots (empty/taken/both) for easy identification and screenshot sharing

---

## House Finder Integration

**Endeavor progress shown directly on Blizzard's House Finder.**

- Each neighborhood button in the native House Finder shows its current endeavor name and progress percentage

- Data loads automatically as you browse -- no extra clicks needed

---

## Config Tab

- **Discord** -- Join link with one-click copy

- **8 Themes** -- Solarized Dark, Gruvbox Dark, Everforest Dark, Everforest Access, Kanagawa Dark, Housing Theme, Accessibility HC, Colorblind Safe

- **Language** -- Override auto-detected client language from 12 options (reloads UI on change)

- **Font Selector** -- Choose from multiple font families

- **UI Scale** -- Stepper buttons at 0.1 increments (0.5x - 2.0x)

- **Auto-Show Map** -- Toggle automatic map drawer behavior

- **Animated Map Effect** -- Toggle tile fade-in animation on/off

- **House Finder Endeavors** -- Show/hide endeavor progress on Blizzard's House Finder

- **Neighborhood Manager** -- Enable right-click tag system for categorizing neighbors (off by default)

- **Clear Tags** -- Reset all neighbor tags at once (appears when Neighborhood Manager is enabled)

- **Minimap Button** -- Show/hide with drag positioning

- **Debug Mode** -- Toggle verbose logging

---

## Quick Start

Type **`/vn`** to open the panel.

**Tabs:** Directory | Browse | Config

**Commands:**

- `/vn` -- Toggle main panel

- `/vn minimap` -- Toggle minimap button

- `/vn theme <name>` -- Switch theme

- `/vn wipe` -- Clear all caches and rescan (troubleshooting)

---

## Requirements

**Required:**

- World of Warcraft: Midnight (12.0.0+)

---

## More Addons by Vamoose

- **[Vamoose's Housing Decor Guide](https://www.curseforge.com/wow/addons/housing-decor-guide)** — Track, craft, preview, and acquire housing decorations across all professions

- **[Vamoose's Endeavors](https://www.curseforge.com/wow/addons/vamooses-endeavors)** — Track Housing Endeavor progress across all your characters

- **[Vamoose's Dye Studio](https://www.curseforge.com/wow/addons/vamooses-dye-studio)** — Browse, preview, and manage housing dyes with custom palettes and live dyeing

- **[Vamoose's Companion](https://www.curseforge.com/wow/addons/vamooses-companions)** — A companion personality that reacts to your adventures with contextual commentary

- **[Vamoose's Pet Patrol](https://www.curseforge.com/wow/addons/vamooses-pet-patrol)** — Find uncollected wild battle pets in your current zone

- **[Vamoose's Guild Crafter](https://www.curseforge.com/wow/addons/vamooses-guild-crafter)** — Find which guildies can craft what you need

- **[LiteWQ](https://www.curseforge.com/wow/addons/litewq)** — Lightweight world quest tracker with reward icons, subzone rollup, and warband alt tracking

---

## Support & Feedback

Found a bug or have a suggestion? Please report on our Discord!

Discord: https://discord.gg/RWZaxJaHFP

Buy Me a Coffee: https://buymeacoffee.com/Vamoose

---

**Author:** Vamoose

**Version:** 1.6.1

**Game Version:** 12.0.0+ (Midnight)

---

*Also known as: neighbours, neighbourhood, neighbourhoods, neighbor finder, neighbourhood directory, housing neighbours, wow neighbourhood addon*

Vamooses Neighbors