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

Vamooses Endeavors