# Vamoose's Pet Patrol

**Never miss an uncollected battle pet again -- see what's available in your zone at a glance, with a map to find them.**

Vamoose's Pet Patrol tracks wild battle pets as you explore, alerting you when there are uncollected pets in your current zone. Browse your zone's pets with quality and upgrade indicators, open an animated map with spawn pins, or search the complete pet database by source type.

---

## What's New in v1.3.0

- **Map controls moved to the main window** -- Attach left, attach right, detach, and the map eye now live together at the top of the main window. Active side is highlighted so you always know where the map is going to land.

- **Follow Player mode** -- Toggle on the detached map and your blip stays centered while the map pans underneath you, minimap-style. Auto-zooms in when enabled.

- **Minimap-style player arrow** -- The player marker is a real directional arrow that rotates with your facing, and it stays a constant on-screen size whether you're zoomed all the way in or out.

- **Sub-zones now fall back to the parent zone** -- Walking into Slayer's Rise used to make the map go blank. Now it shows the Voidstorm map and pins, with the title reading "Voidstorm - Slayer's Rise" so you know exactly where you are.

- **Search the All tab by pet name** -- New search field filters the entire battle pet database as you type.

- **Click a pin again to clear its waypoint** -- First click sets, second click clears. Shift+click still drops a chat link.

- **Filter setting persists** -- Uncollected on the Zone tab now stays Uncollected across zone hops and reloads.

- **Zoom level stays put when you change zones** -- Stay zoomed in on a cluster, hop maps, your zoom commitment is preserved (the view recenters on the new zone).

- **Alert only for uncollected pets** -- New checkbox in Config so you don't get pinged in zones where you've already caught everything.

- **Tooltip hints** -- Pet rows now mention click-to-highlight on the map; map pins call out shift+click for chat links. Discoverability for the hidden interactions.

- **Cross-fade transitions on the detached map** -- Cleaner zone changes — the map texture fades out and back in instead of using the column-by-column drawer effect.

- **Performance pass** -- Standing still no longer generates background memory churn. Mouse hover and player-blip work both reduced.

- **Fixes** -- Detached map no longer closes when you switch tabs, you can drag a zoomed-in map all the way to the zone edges, Nestor's bounce timer plays nicely with combat, and a handful of smaller cleanups.

See CHANGELOG.txt for full version history.

---

## Zone Pets Tab -- Your Current Zone

**See every wild battle pet available where you are right now.**

- **Pet List** -- All wild pets in your current zone with name, icon, type, and source

- **Pet Type Icons** -- Localized type glyph next to each row (Humanoid, Beast, Dragonkin, etc.)

- **Collection Status** -- Gold "NEW!" badge for uncollected pets, best-quality name for owned pets

- **Per-Copy Levels** -- Every owned copy's level shown beneath the status, each colored by its individual quality

- **Quality-Colored Names** -- Pet name colored by your best owned quality at a glance

- **Upgrade Arrow** -- Gold upward arrow on pets you own below Rare quality

- **Filters** -- Toggle between All, Uncollected, and Collected views

- **Count Display** -- "X new / Y total" showing how many pets you still need

- **Map Window** -- Open the zone map to see spawn pins and your current position

---

## All Pets Tab -- Browse Everything

**Search the complete battle pet database by source type.**

- **Source Filter** -- Dropdown with 12 source categories: Pet Battle, Drop, Quest, Vendor, Profession, Achievement, World Event, PvP, Promotion, Trading Card, In-Game Shop

- **Name Search** -- Type any partial pet name to filter the full database instantly

- **Collection Filter** -- Radio buttons for All, Uncollected, Collected

- **Sort Toggle** -- Switch between A-Z and best-quality order

- **Comprehensive Scan** -- Includes all obtainable battle pets and Midnight click-to-catch pets

- **Detailed Counts** -- "X new / Y unique / Z owned" showing both unique species and total instances

---

## Map Window -- Find Your Pets

**A standalone zone map with spawn coordinate pins, zoom, and three placement modes.**

- **Spawn Pins** -- Color-coded markers showing exactly where each pet spawns (data from Wowhead)

- **Per-Pet Colors** -- Each pet gets a unique color from a 20-hue colorblind-safe palette, matching the color blip on its list row

- **Pin Pulse** -- Click a pet row to highlight its pins on the map and dim everything else

- **Three Placement Modes** -- Attach the map to the left or right of the main window, or detach it as a free-floating window. Placement buttons live on the main window title bar (left arrow / eye / right arrow / detach).

- **Follow Player Mode** -- Toggle on the detached map and your blip stays centered while the map pans underneath you (minimap-style). Auto-zooms in when enabled.

- **Minimap-Style Player Arrow** -- Real directional arrow that rotates with your facing and stays a constant on-screen size at any zoom.

- **Sub-zone Fallback** -- Walking into a sub-area (e.g. Slayer's Rise inside Voidstorm) falls back to the parent zone's map and pins, with the title showing both ("Voidstorm - Slayer's Rise").

- **Cross-Fade Transitions** -- Detached map cleanly fades the canvas out and back in on zone changes; the title bar stays visible the whole time.

- **Independent Lifecycle** -- Detached map stays open when the main window closes (and stays open when you switch tabs so you can adjust scale on Config); pinned map survives /reload and re-opens automatically.

- **Independent Scale** -- Separate Map Scale stepper in Config, sized completely apart from the main window.

- **Interior Zoom** -- Mouse wheel (centered on your cursor), +/-/Home buttons, click-drag to pan. Pins stay clickable at every zoom level. Zoom level is preserved across zone changes.

- **Explored Overlay** -- Fog of war removed from areas you've visited

- **Waypoints** -- Click any pin to set a native waypoint with super-track arrow; click the same pin again to clear it.

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

- **Pin Tooltips** -- Hover for pet name, quality, coordinates, and action hints

- **Combat-Safe** -- Auto-hides on combat, restores after.

- **Empty State** -- Friendly message with logo backdrop when no wild pets exist in the current zone

---

## Zone Change Alerts

**Get notified the moment you enter a zone with pets to collect.**

- **Chat Alert** -- Message showing uncollected and upgrade counts when you enter a zone

- **Sound Alert** -- Optional sound notification (toggle in config)

- **Mouseover Detection** -- Pets you mouse over or target get a green "NEARBY!" highlight in the Zone tab

---

## Window Features

- **Pin Button** -- Pin the window to keep it open through Esc and /reload

- **Nestor Mascot** -- Left-click for a quote with bounce animation, right-click to toggle Robo-Nestor

- **Map Placement Cluster** -- Detach / attach-left / eye / attach-right buttons grouped on the title bar

- **Quick Toggle from Detached Map** -- The small VPP logo on the detached map title bar opens or hides the main window

---

## Config Tab

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

- **Buy Me a Coffee** -- Support link

- **Alerts** -- Toggle zone change alerts, sound notifications, and a "uncollected only" filter so you don't get pinged in cleared zones

- **Nestor** -- Enable/disable companion quotes, chat-only mode option

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

- **Minimap Button** -- Show/hide toggle

- **Rebuild Pet Index** -- Force rescan of all pet data

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

---

## Quick Start

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

**Tabs:** Zone | All | Config

**Commands:**

- `/vpp` -- Toggle main panel

- `/vpp map` -- Toggle map window

- `/vpp map show` / `hide` -- Force show or hide the map

- `/vpp map reset` -- Reset map position, scale, and placement to defaults

- `/vpp scan` -- Force rebuild pet index

- `/vpp debug` -- Toggle debug mode

- `/vpp zone` -- Show current zone info

- `/vpp check <name>` -- Look up a pet by name or species ID

---

## 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 Neighbors](https://www.curseforge.com/wow/addons/vamooses-neighbors)** — Neighborhood directory with plot owners, waypoints, and initiative tracking

- **[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 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.3.0

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

---

*Also known as: pet tracker, battle pet finder, wild pet scanner, pet collection tracker, uncollected pets, pet patrol, wow pet addon*

Vamooses Pet Patrol