Description
# 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.9.1
- **See when each neighbor last contributed to an endeavor.** A clock button beside the search box reads the endeavor activity log for the neighborhood you are standing in, and shows each plot owner's last contribution beside their name, colored from green (today) through to red (six weeks or more). A dash means no contribution was found for them. This works on the Neighborhood tab and the Guild tab, so charter neighborhoods are covered as well as guild ones. Note that only the neighborhood set as your active endeavor has a log to read, and that the log covers the current endeavor only, so a new endeavor starts everyone at a dash until they contribute again.
- **Record a Discord tag against any neighbor.** Each row has a Discord button that opens a text field. The tag appears beside the character name, is matched by the search box, and is saved between sessions.
- **List the least active first.** The Neighborhood tab has an Activity sort column that puts plots with no contribution at the top, then the oldest. The Guild tab has an "Inactive first" option in its endeavor dropdown.
- **Two exports.** Config can copy the current subdivision's roster, or every scanned guild member house across all neighborhoods. Both include the last contribution date and the Discord tag, as comma-separated text to paste into a spreadsheet.
- **Scrolling large guild lists.** The Directory now draws only the rows on screen, so the scrollbar keeps up in guilds with hundreds of houses. The previous 250-row display limit is gone and every guild member house is listed.
- **Choose your plot marker colors.** The palette button in the title bar opens a panel where empty-plot and taken-plot markers are switched on independently, each with a color of your choice from eight swatches. Plot numbers switch between black and white to stay readable on any color.
- **Config scrolls**, so the buttons at the bottom are reachable at any font size, and it now opens with a short description of the addon.
- **The addon pauses during combat.** Lists stop rebuilding and the friend and guild scan stops, both resuming when you leave combat.
- **Fixed:** subdivision numbers now match the number Blizzard's House Finder shows, and no longer disappear when you open the House Finder. Charter neighborhoods no longer show a subdivision number, since they only ever have one. Your own endeavor could previously be replaced by a guildmate's and stay wrong until you reloaded.
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
- **Last Endeavor Contribution** -- A clock button reads the endeavor activity log and shows each plot owner's last contribution beside their name, colored by how recent it is. Sort by the Activity column to put the least active first
- **Discord Tags** -- Record a Discord name against any plot owner. Tags show beside the character name and are matched by the search box
---
## 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
- **Endeavor Filter** -- A dropdown on the sort row filters the list to only friends whose neighborhood is running a chosen endeavor. Each endeavor is color-coded in the list and the dropdown
---
## 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
- **Endeavor Filter** -- A dropdown on the sort row filters the list to only guildmates whose neighborhood is running a chosen endeavor
- **Last Endeavor Contribution** -- A Check activity button reads the endeavor activity log for your current neighborhood and shows each member's last contribution beside their name, colored by how recent it is
- **Discord Tags** -- Record a Discord name against any member. Tags show beside the character name and are matched by the search box
- **Inactive First** -- An ordering option that lists members with no contribution at the top, then the oldest contributions
---
## 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** -- Numbered circles on plots for identification and screenshot sharing. Empty and taken plots are switched on independently from the palette button, each with a color you choose
---
## 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)
- **Export Neighborhood Data** -- Copy the current subdivision's plots, owners, endeavor contribution, and Discord tags as comma-separated text
- **Export Guild Data** -- Copy every scanned guild member house with the same columns, across all neighborhoods
- **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.9.1
**Game Version:** 12.0.0+ (Midnight)
---
*Also known as: neighbours, neighbourhood, neighbourhoods, neighbor finder, neighbourhood directory, housing neighbours, wow neighbourhood addon*


