Vamooses Endeavors

# Vamoose's Endeavors
**Track Housing Endeavor progress across all your characters!**
See your neighborhood initiative tasks, track completion across alts, and never miss out on endeavor rewards.
> **Featured on [Icy Veins](https://www.icy-veins.com/wow/news/players-are-missing-housing-rewards-these-2-addons-fix-it/)!** *"Players Are Missing Housing Rewards - These 2 Addons Fix It"*
---
## **What's New in v1.19.0**
- **The Activity and Rankings tabs no longer stutter the game in busy neighborhoods.** Both lists now draw only the rows visible on screen, so a neighborhood with thousands of logged completions costs no more to display than a quiet one.
- **A tooltip on the season progress bar.** Hover it to see what the bar tracks, and when your completion chest is ready, where to go and collect it.
- **Right-click the progress bar to mark the chest as claimed.** Use this if you collected the chest somewhere the addon couldn't see it. It does the same thing as `/ve claimed`.
- **The claimable chest icon is easier to spot.** It now grows and shrinks as it pulses instead of only fading.
- **House level, XP and coupons appear straight away after login.** Each character remembers its own values and shows them immediately, then updates when the live data arrives.
- **Switching house updates both lists right away.** The Activity feed and Rankings previously kept showing the previous house's entries until new data happened to arrive.
- **Task rows show the full progress count.** Tasks counting toward a large total had the number cut short.

*See CHANGELOG.txt for complete version history*
---
## **Features**
### **Endeavor Task Tracking** Track all housing endeavor tasks from the Neighborhood Initiative system.
- **Completion Status** - Green indicator for completed tasks, gray for incomplete - **Repeatable Tasks** - Clear icon showing which tasks can be repeated - **Progress Display** - Shows X/Y progress for multi-step tasks - **Point Values** - Gold badge showing endeavor XP per task - **Coupon Rewards** - Cyan badge showing coupon reward (with diminishing returns) - **Task Sorting** - Click column headers to sort by XP or Coupons - **Task Favourites** - Shift-click to pin up to 5 tasks for quick access - **House XP Available** - Live remaining House XP budget straight from Blizzard's 12.0.5 native API, with current house XP and a projected end-of-cycle total in the tooltip
### ⭐ **Alt Sharing & Leaderboard Grouping** **The most requested feature!** Group contributions by player account.
- **Opt-in Alt Sharing** - Share your alt list with guildmates who use this addon - **Leaderboard Grouping** - Toggle to view rankings by player, not character - **Cross-Faction Support** - BattleTag-based linking groups characters across Alliance/Horde - **Privacy-Focused** - BattleTags hashed before broadcast (never shared in plain text) - **Your Alts Always Group** - Even without sharing, your own characters combine - **Main Character Selection** - Choose which name represents your account
### **Contribution Leaderboard** See who's contributing the most to your neighborhood!
- **Rankings** - Gold/Silver/Bronze colors for top 3 contributors - **Total Contribution** - XP contributed by each member - **Group by Account** - Toggle to combine alts into one leaderboard entry - **CSV Export** - Export rankings data with Warband Group column - **Player Highlight** - All your characters highlighted in accent color
### **Completion Chest Tracking** The 100% milestone reward, tracked end-to-end.
- **Pulsing Chest Icon** - On the progress bar, grows and shrinks while claimable, freezes once collected - **Progress Bar Tooltip** - Hover the bar for cycle progress, and where to collect the chest when it's ready - **Auto Claim Detection** - Detects the moment you click the chest in your neighborhood (~1 second) - **Account-Wide, Per-House** - Claim on one alt locks the chest for all your alts on that house - **Cycle-Aware** - Claim flag resets automatically each initiative cycle - **Login Status Line** - Active-endeavor message tells you whether your chest is ready or already done - **Manual Override** - Right-click the progress bar, or use `/ve claimed`, to flag a chest the addon didn't see you collect
### **Activity Feed** Track recent neighborhood activity in real-time.
- **Top 5 Tasks** - Most completed tasks by your neighborhood - **Activity Feed** - Recent completions sorted by time (newest first) - **Player Names** - See who completed what and when - **Coupon Earnings** - Toggle to view actual post-DR coupon rewards per task
### **Season Progress** See your overall endeavor season progress at a glance.
- **Progress Bar** - Visual progress toward season goal - **Milestone Markers** - Diamond indicators for reward thresholds - **Days Remaining** - Countdown to season end - **Season Name** - Current endeavor theme displayed
### **House Level & Coupons** Track your housing progress in the header area.
- **Multi-House Dropdown** - Switch between all your owned houses and track endeavor tasks for each separately - **House Level** - Current level with XP progress to next level - **Community Coupons** - Total coupons displayed in title bar - **Fetch Status** - See loading state and last updated time - **Auto-Activate** - Optionally set active endeavor when switching houses in dropdown - **Auto-Refresh** - Updates when you earn rewards
### **Full Customization** Make the addon fit your preferences.
- **UI Scale** - Resize window from 80% to 140% - **Background Transparency** - Set opacity from 30% to 100% - **Font Family** - Choose from 6 fonts including Game Default (locale-aware) and Expressway - **Pin Window** - Keep VE open through Escape key and auto-open on reload - **Show During Combat** - Keep the window visible in combat instead of auto-hiding it
### **11 Beautiful Themes** Choose from 11 professionally designed color schemes.
- **Housing Theme** - Native WoW aesthetic with Blizzard Atlas textures - **Solarized Dark/Light** - Classic developer themes, easy on the eyes - **Gruvbox Dark/Light** - Warm, retro-styled with earthy tones - **Everforest Dark/Light** - Nature-inspired green-grey forest tones - **Everforest Access** - Everforest with enhanced contrast - **Kanagawa Dark/Light** - Japanese-inspired ink and parchment aesthetic - **Accessibility HC** - High contrast neon on black for maximum visibility - **Quick Toggle** - Theme button in title bar, left-click next / right-click previous
---
## **Quick Start**
Type **`/ve`** to open the main window.
### **Pro Tips**
- **Theme Button** - Left-click to cycle forward, right-click to go back - **Minimap Button** - Click to toggle window - **Settings Tab** - Font size, UI scale, transparency, font family - **Auto-Refresh** - Data updates when endeavor events fire - **Refresh Button** - Force update house level and tasks
---
## **Installation**
1. Download and extract to `World of Warcraft/_retail_/Interface/AddOns/` 2. Folder should be named `VamoosesEndeavors` 3. Type `/reload` or restart WoW 4. Type `/ve` to start!
---
## **Requirements**
**Required:** - World of Warcraft: Midnight (12.0.5+) - Access to Housing (required level)
---
## **Commands**
- `/ve` - Toggle main window - `/ve status` - Print initiative progress, House XP breakdown, and chest state in chat - `/ve claimed` - Manually mark the active house's chest as claimed for the current cycle (useful if you claimed before v1.18 was running). Clears automatically next cycle. - `/ve unclaimed` - Clear the claim flag if you set it by mistake

---
## **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 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 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.19.0 **Game Version:** 12.0.7+ (Midnight)