Trophy Hunter v1.0.0

Part of the Ultima Suite • Rare Entity, Treasure & Collectible Intelligence Radar for World of Warcraft (Retail & Midnight-Ready)

---

🌟 Overview

Part of the Ultima Suite — engineered to operate 100% standalone with zero mandatory cross-addon dependencies, while providing seamless inter-addon synergies via UltimaBridge when other suite modules are installed.

Trophy Hunter is a next-generation rare creature, treasure chest, and world vignette tracker engineered for World of Warcraft Retail (Patch 12.1.0 / Midnight, Interface 120100). Serving as our proprietary, zero-taint alternative to RareScanner, Trophy Hunter combines fluid 3D animated entity previews, directional compass navigation, native Blizzard super-tracking, and intelligent Warband collectible filtering with a fraction of the memory footprint.

---

✨ Key Features

👑 1. Smart Loot & Warband Intelligence

• Golden Trophy Priority Alerts: Connects with the Warband collection system to evaluate rare drop tables. If a rare drops an uncollected Mount, Battle Pet, Toy, or Transmog, Trophy Hunter fires an epic Golden Fanfare Alert with luminous gold borders!
• Town & Housing Noise Filtering: Automatically filters out non-combat town services, housing vendors (such as Decor Specialists in Ironforge, Dornogal, etc.), trainers, and portals, preventing spammy false alarms.
• Configurable Re-Alert Cooldown: Customizable cooldown (1 to 30 minutes, 10 minutes default) prevents repetitive spam for the same stationary target, with a 30-minute mute on dismissal.
• Noise Suppression: Suppresses intrusive audio alerts for generic or previously defeated creatures, eliminating notification fatigue while still displaying subtle map pins.

🎬 2. Cinematic 3D Alert HUD

• Live 3D Model Rendering: Directly renders animated 3D models of rare creatures and treasure chests in a stylish Ultima Dark Slate interface (with high-definition 2D fallback icons for un-modeled targets).
• Directional Compass: Live bearing indicators show the compass direction (N, NE, E, SE, S, SW, W, NW) and distance in yards.
• 1-Click Dismissal & Silence: Click the close button [X] or type /th clear to immediately dismiss the alert and mute that entity for 30 minutes.
• 1-Click Waypoint Navigation: Click Target Entity or Set Waypoint to set Blizzard's native map pin and in-world directional arrow on demand (automatic pin setting is disabled by default).
• Zero-Taint Secure Targeting: Features a protected action button (/targetexact <Name>\n/tm 8) that queues state changes seamlessly if triggered during combat lockdown.

🗺️ 3. Zero-Lag World Map & Minimap Overlay

• Frame-Recycled Pins: Employs Blizzard's native MapCanvasPinMixin frame pool (CreateFramePool) to eliminate garbage generation and map lag.
• Loot Tooltip Inspection: Hovering over pins displays live kill lockout status, coordinates, and full item drop lists with collectible badges.

📖 4. Two-Tier Navigation Zone Codex

• Complete Zone Almanac: Two-Tier Gold navigation studio displaying all rare creatures, treasures, and events in your current zone.
• Progress Badges: Tracks daily defeat status (e.g., Zone Progress: 14/18 Rares Defeated).
• Test Simulation: Built-in simulator allows testing 3D HUD alerts at any time via /th test.

💎 5. Zone Collectibles & Loot Matrix (All The Things Replacement)

• Tab 2: Loot & Collectibles: Provides a comprehensive live checklist of all collectible rewards in your current zone directly inside the Zone Codex.
• Filter Pills: Quickly filter items by All, Uncollected, Mounts, Pets, Toys, or Transmog.
• Live Collection Status: Dynamically checks C_TransmogCollection, C_MountJournal, C_ToyBox, and C_PetJournal to display glowing ✔ Collected or ✦ Uncollected badges.
• 1-Click Super-Track Waypoints: Single-click sets Blizzard's native user map waypoint and in-world navigation pin directly to the creature or chest dropping the uncollected item.
• Zone Progress Tracking: Real-time completion progress header (e.g. Zone Collectibles: 32/45 (71%)).

🌉 6. UltimaBridge Synergies

• Champion Companion Integration: Automatically verifies account-wide uncollected mounts, pets, and transmogs across all alts.
• Menagerie Keeper Integration: Detects wild pet encounters and coordinates counter-teams.
• Action Ring Integration: Push detected coordinates to quick-action navigation rings.

---

⌨️ Slash Commands

Command	Action
/th / /trophy	Toggle the Trophy Hunter Zone Codex window
/th test [rare|treasure]	Trigger a simulated 3D discovery alert
/th clear	Dismiss the active on-screen alert HUD and mute this entity
/th reset	Reset all configuration options to factory defaults
/th help	Print command usage instructions in chat

---

🌐 Supported Languages

Full localization across all 10 official World of Warcraft client languages:

• 🇬🇧 English (enUS)
• 🇩🇪 German (deDE)
• 🇪🇸 Spanish (esES / esMX)
• 🇫🇷 French (frFR)
• 🇮🇹 Italian (itIT)
• 🇧🇷 Portuguese (ptBR)
• 🇷🇺 Russian (ruRU)
• 🇰🇷 Korean (koKR)
• 🇨🇳 Simplified Chinese (zhCN)
• 🇹🇼 Traditional Chinese (zhTW)

---

📦 Installation

1. Download the latest release.
2. Extract into your World of Warcraft AddOns directory:
   World of Warcraft\_retail_\Interface\AddOns\TrophyHunter
3. Launch World of Warcraft and type /th to open the Zone Codex.

---

📜 Credits & License

Developed with ❤️ by **Satyros**. Designed for World of Warcraft Retail (Patch 12.1.0 / *Midnight*).  
Licensed under the **MIT License**. Part of the **Ultima Suite**.

### Acknowledgements & Inspirations:
* Built for the **Ultima Suite** ecosystem (`UltimaBridge`).
* Special thanks to the trailblazers of rare and treasure hunting in World of Warcraft: **RareScanner** (*marlam*), **SilverDragon** (*Kemayo*), and **AllTheThings (ATT)** (*Crieve & ATT Team*).