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

---

## **What's New in v1.5.3 - Housing Theme Polish**

- **Enhanced Housing Theme** - Custom logo, wood-sign section headers, decorative foliage
- **Improved Tab Styling** - Native Blizzard atlas textures for active/inactive tabs
- **UI Refinements** - Dimmed title bar buttons, right-aligned house level, better spacing
- **Theme Tooltip** - Now shows current and next theme when hovering

*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
- **House XP Earned** - Estimated total XP with progressive DR formula

### **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
- **My Total Row** - Combined contributions across all your alts
- **Player Highlight** - All your characters highlighted in accent color

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

### **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-Refresh** - Updates when you earn rewards

### **Full Customization**
Make the addon fit your preferences.

- **Font Size** - Adjust from -4 to +8 in Settings
- **UI Scale** - Resize window from 80% to 140%
- **Background Transparency** - Set opacity from 30% to 100%
- **Font Family** - Choose from 5 fonts including Expressway

### **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** - "T" button in title bar for instant switching

---

## **Quick Start**

Type **`/ve`** to open the main window.

### **Pro Tips**

- **Theme Button** - Click "T" in title bar to cycle themes
- **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.0+)
- Access to Housing (required level)

---

## **Commands**

- `/ve` - Toggle main window

---

## **Downloads**

- [CurseForge](https://www.curseforge.com/wow/addons/vamooses-endeavors)
- [Wago.io](https://addons.wago.io/addons/vamooses-endeavors)
- [GitHub](https://github.com/justin963/VamoosesEndeavors)

---

## **Support & Feedback**

Found a bug or have a suggestion? Please report on CurseForge or GitHub Issues.

We're actively maintaining and improving this addon based on your feedback.

---

**Author:** Vamoose
**Version:** 1.5.3
**Game Version:** 12.0.0+ (Midnight)
