Description
# 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)






