# User Manual - Gamified Habit Tracker

Complete guide to using the Gamified Habit Tracker system and all its features.

## Table of Contents

1. [Introduction](#introduction)
2. [Getting Started](#getting-started)
3. [Dashboard Overview](#dashboard-overview)
4. [Habit Management](#habit-management)
5. [Character System](#character-system)
6. [Leveling and Experience](#leveling-and-experience)
7. [Attributes System](#attributes-system)
8. [Equipment System](#equipment-system)
9. [Daily Check-Ins](#daily-check-ins)
10. [Tower Combat](#tower-combat)
11. [Achievement System](#achievement-system)
12. [Leaderboard](#leaderboard)
13. [Settings and Customization](#settings-and-customization)
14. [Tips and Best Practices](#tips-and-best-practices)

---

## Introduction

### What is the Gamified Habit Tracker?

The Gamified Habit Tracker transforms boring habit tracking into an engaging RPG-style game. Every habit you complete gives you XP to level up your character, unlock new features, earn achievements, and climb the leaderboard.

### Core Concept

**Real-life habits = In-game progression**

- Complete a workout → Gain Strength XP
- Read a book → Gain Intelligence XP
- Paint or draw → Gain Creativity XP
- Socialize → Gain Social XP
- Eat healthy → Gain Health XP

### Key Benefits

- **Motivation:** Turn habits into quests with rewards
- **Progress Tracking:** Visual feedback on your growth
- **Competition:** Compete with friends on the leaderboard
- **Customization:** Personalize your character and appearance
- **Achievements:** Unlock 21 badges as you progress
- **Combat:** Battle enemies in the Tower using your stats

---

## Getting Started

### Creating Your Account

1. **Navigate to Registration Page**
   - Open your browser to `http://localhost:5173`
   - Click "Sign Up" or "Register"

2. **Fill in Registration Form**
   - **Username:** Choose a unique username (3-30 characters)
   - **Email:** Enter a valid email address
   - **Password:** Create a secure password (min. 8 characters)
   - **Confirm Password:** Re-enter your password

3. **Submit and Login**
   - Click "Create Account"
   - You'll be redirected to the login page
   - Login with your new credentials

### Using Test Accounts

For testing, use one of the pre-created accounts:

**Admin Account:**
- Username: `johndoe`
- Password: `demo123`

**Regular User:**
- Username: `reese`
- Password: `demo123`

**Additional 49 accounts:** See `backend/mock_users_auth.txt`

### First Login

After logging in, you'll see:

1. **Welcome Screen** - Brief introduction to the system
2. **Empty Dashboard** - Your character starts at Level 1 with 0 XP
3. **Tutorial Prompts** - Guidance on creating your first habit

---

## Dashboard Overview

The Dashboard is your command center, displaying all critical information at a glance.

### Dashboard Components

#### 1. Character Display (Left Side)

**Character Avatar:**
- Visual representation of your character
- Updates based on equipped items and selected theme
- Shows current character design (Default, Zoro, Cyberpunk, etc.)

**Character Stats:**
- **Level:** Current character level (1-30)
- **XP Bar:** Progress to next level
- **Total XP:** Lifetime experience points earned

#### 2. Attributes Panel

Displays your 5 core attributes with progress bars:

- **Strength** (Red) - Physical fitness habits
- **Intelligence** (Blue) - Mental/learning habits
- **Creativity** (Purple) - Creative/artistic habits
- **Social** (Green) - Social interaction habits
- **Health** (Yellow) - Health and wellness habits

Each attribute shows:
- Current value (0-100)
- Visual progress bar
- Percentage completion

#### 3. Active Quests (Habits) Section

**Quest Limits by Level:**
- **Level 1-4:** 4 active quests
- **Level 5-9:** 6 active quests
- **Level 10-14:** 8 active quests
- **Level 15-19:** 10 active quests
- **Level 20+:** Unlimited quests

**Quest Display:**
- Quest name and description
- Attribute type (Strength, Intelligence, etc.)
- XP reward
- Completion checkbox
- Last completed timestamp

#### 4. Quick Actions Bar

Navigation buttons:
- **Dashboard** - Main overview (current page)
- **Habits** - Manage your quests
- **Tower** - Combat and progression
- **Leaderboard** - Rankings and competition
- **Achievements** - View unlocked badges
- **Settings** - Customize your profile

#### 5. Daily Check-In Widget

**GitHub-Style Calendar:**
- Shows daily check-in streak
- Green squares = Days checked in
- Gray squares = Missed days
- Hover to see date and status

**Daily Reward:**
- 100 XP per check-in
- Resets at midnight (local time)
- Cannot check in twice in one day

---

## Habit Management

### Creating a New Habit (Quest)

#### Step 1: Navigate to Habit Creation

- Click "Habits" in the navigation menu
- Click "Create New Habit" button

#### Step 2: Fill in Habit Details

**Required Fields:**

1. **Habit Name** (Quest Title)
   - Example: "Morning Workout"
   - Keep it short and descriptive (max 100 characters)

2. **Description**
   - Example: "30 minutes of exercise including cardio and strength training"
   - Detailed explanation of what the habit involves

3. **Attribute Type**
   - Select from dropdown:
     - Strength - Physical activities
     - Intelligence - Learning, reading, studying
     - Creativity - Art, music, writing, design
     - Social - Socializing, networking, relationships
     - Health - Nutrition, sleep, meditation, wellness

4. **Difficulty Level**
   - **Easy** (1x XP multiplier)
     - Simple, low-effort tasks
     - Example: "Drink 8 glasses of water"

   - **Medium** (1.5x XP multiplier)
     - Moderate effort, requires some commitment
     - Example: "Read 30 pages of a book"

   - **Hard** (2x XP multiplier)
     - Significant effort, challenging tasks
     - Example: "Complete a full workout routine"

   - **Epic** (3x XP multiplier)
     - Extremely challenging, major achievements
     - Example: "Run a marathon"

5. **XP Reward** (Auto-calculated)
   - Base XP calculated by AI based on habit description
   - Multiplied by difficulty level
   - Can be manually adjusted if needed

#### Step 3: Submit Habit

- Click "Create Habit"
- Habit appears in your "Active Quests" list
- Can be completed once per day

### Completing a Habit

1. **Navigate to Dashboard or Habits Page**
2. **Find the Habit to Complete**
3. **Click the Checkbox** next to the habit
4. **Confirmation Modal Appears:**
   - Shows XP gained
   - Shows attribute increased
   - Animation plays
5. **XP is Added:**
   - Progress bar updates
   - May trigger level-up animation
   - Attribute increases accordingly

**Cooldown:** Each habit can only be completed once per 24 hours from last completion.

### Editing a Habit

1. **Navigate to Habits Page**
2. **Click "Edit" Button** on the habit card
3. **Modify Fields:**
   - Change name, description, or difficulty
   - Update attribute type
   - Adjust XP reward
4. **Save Changes**

**Note:** Editing a habit does NOT reset its completion cooldown.

### Deleting a Habit

1. **Navigate to Habits Page**
2. **Click "Delete" Button** on the habit card
3. **Confirm Deletion** in the modal
4. **Habit is Permanently Removed**

**Warning:** This action cannot be undone. All completion history for this habit is lost.

### Habit Filtering and Sorting

**Filter Options:**
- **All Habits** - Show all active quests
- **By Attribute** - Filter by Strength, Intelligence, etc.
- **Available** - Show only habits ready to complete
- **Completed** - Show recently completed habits

**Sort Options:**
- **By Name** - Alphabetical order
- **By XP** - Highest to lowest reward
- **By Difficulty** - Epic → Easy
- **By Attribute** - Group by attribute type

---

## Character System

### Character Themes

Choose from multiple character designs:

#### 1. Default Character
- Classic RPG hero design
- Basic armor and weapons
- Suitable for all playstyles

#### 2. Zoro (One Piece Inspired)
- Swordsman aesthetic
- Green hair and bandana
- Sword-wielding animations

#### 3. Cyberpunk Theme
- Futuristic cyber aesthetic
- Neon colors and tech gear
- Multiple variants:
  - **Default** - Standard cyberpunk look
  - **Corrupted** - Glitchy, distorted appearance
  - **Ascended** - Enhanced, powered-up form

### Changing Character Theme

1. **Navigate to Settings**
2. **Go to "Character Customization" Tab**
3. **Select Theme** from dropdown
4. **Preview** the character appearance
5. **Save Changes**

### Character Appearance

Your character's appearance updates based on:
- **Selected Theme** - Base character design
- **Equipped Items** - Weapons, armor, helmets show on character
- **Level** - Higher levels may unlock additional visual effects

---

## Leveling and Experience

### How XP Works

**XP (Experience Points)** is the primary progression currency:

- Earned by completing habits
- Each habit has a base XP value
- Multiplied by difficulty level
- Bonus XP from daily check-ins (100 XP/day)

### XP Calculation Formula

```
Total XP = (Base XP × Difficulty Multiplier) + AI Adjustment
```

**AI-Powered XP:**
- If OpenAI API is configured, habit descriptions are analyzed
- AI suggests appropriate XP based on effort required
- More detailed descriptions = More accurate XP

**Manual XP:**
- Without AI, base XP defaults to 50-200
- Can be manually adjusted during habit creation

### Leveling Up

**Level Requirements:**
- Each level requires progressively more XP
- Formula: `XP_required = 100 × (level ^ 1.5)`

**Level Thresholds (Examples):**
- Level 2: 100 XP
- Level 5: 500 XP
- Level 10: 3,162 XP
- Level 20: 17,889 XP
- Level 30: 50,000+ XP

**Level-Up Rewards:**
- Increased quest limits
- New equipment unlocked
- Achievement progress
- Leaderboard ranking boost

### Quest Limit Increases

As you level up, you can track more habits simultaneously:

| Level Range | Max Active Quests |
|-------------|-------------------|
| 1-4 | 4 quests |
| 5-9 | 6 quests |
| 10-14 | 8 quests |
| 15-19 | 10 quests |
| 20+ | Unlimited |

---

## Attributes System

### The 5 Core Attributes

#### 1. Strength (Red)

**What It Represents:** Physical fitness and power

**Example Habits:**
- Weight training
- Running or jogging
- Sports practice
- Physical labor
- Martial arts

**Combat Benefits:**
- Increases physical damage
- Higher HP in combat
- Better defense against physical attacks

#### 2. Intelligence (Blue)

**What It Represents:** Mental acuity and knowledge

**Example Habits:**
- Reading books
- Studying courses
- Solving puzzles
- Learning new skills
- Research work

**Combat Benefits:**
- Increases magic damage
- Better strategy options
- Faster skill cooldowns

#### 3. Creativity (Purple)

**What It Represents:** Artistic expression and innovation

**Example Habits:**
- Drawing or painting
- Writing stories
- Music practice
- Crafting
- Design work

**Combat Benefits:**
- Unique special abilities
- Creative problem-solving in combat
- Enhanced equipment bonuses

#### 4. Social (Green)

**What It Represents:** Interpersonal skills and relationships

**Example Habits:**
- Meeting friends
- Networking events
- Volunteering
- Team activities
- Communication practice

**Combat Benefits:**
- Team bonuses (future feature)
- Better loot drops
- Merchant discounts

#### 5. Health (Yellow)

**What It Represents:** Overall wellness and self-care

**Example Habits:**
- Eating healthy meals
- Getting 8 hours of sleep
- Meditation
- Drinking water
- Doctor checkups

**Combat Benefits:**
- Higher max HP
- Faster HP regeneration
- Status effect resistance

### Attribute Progression

**How Attributes Increase:**
- Each habit completion increases its associated attribute
- Attribute gain = XP gained / 10
- Example: 100 XP Strength habit = +10 Strength points

**Attribute Cap:**
- Each attribute maxes at 100 points
- Displayed as percentage (0-100%)
- Progress bars show visual progress

**Balanced vs. Specialized:**
- **Balanced Build:** Increase all attributes equally
  - Pros: Well-rounded combat abilities, flexible strategy
  - Cons: No particular strengths

- **Specialized Build:** Focus on 1-2 attributes
  - Pros: Extremely powerful in specific areas
  - Cons: Weak in other areas

### Viewing Attribute Stats

1. **Dashboard** - Main attribute display with progress bars
2. **Character Stats Panel** - Detailed breakdown
3. **Combat Screen** - Active attribute effects during battles

---

## Equipment System

### Equipment Types

#### 1. Weapons
- **Slot:** Main Hand
- **Effect:** Increases attack damage
- **Variants:** Swords, axes, staffs, bows

#### 2. Helmets
- **Slot:** Head
- **Effect:** Increases defense
- **Variants:** Light, medium, heavy armor

#### 3. Chest Armor
- **Slot:** Torso
- **Effect:** Increases HP and defense
- **Variants:** Cloth, leather, plate

#### 4. Boots
- **Slot:** Feet
- **Effect:** Increases speed/evasion
- **Variants:** Light boots, heavy boots

### Acquiring Equipment

**Methods to Get Equipment:**

1. **Starting Items**
   - New characters receive basic starter equipment
   - Automatically equipped

2. **Level Rewards**
   - Unlock new equipment tiers at specific levels
   - Better equipment at higher levels

3. **Tower Combat**
   - Defeat enemies to earn loot
   - Random equipment drops

4. **Shop (Gold Purchase)**
   - Buy equipment with earned gold
   - Gold earned from combat and achievements

### Equipment Stats

Each equipment item has:

**Base Stats:**
- **Name** - Equipment identifier
- **Type** - Weapon, helmet, chest, feet
- **Level Requirement** - Minimum level to equip
- **Gold Cost** - Purchase price

**Combat Stats:**
- **Attack Bonus** - Added damage
- **Defense Bonus** - Damage reduction
- **HP Bonus** - Additional health points
- **Special Effects** - Unique abilities (some items)

### Equipping Items

1. **Navigate to Settings → Equipment Tab**
2. **View Available Equipment**
   - Items you own appear in inventory
   - Locked items shown in gray
3. **Click "Equip" Button** on desired item
4. **Confirm Equip** in modal
5. **Character Updates** - Visual appearance changes

### Equipment Comparison

**Before Equipping:**
- View stat comparison
- See what stats will increase/decrease
- Make informed decisions

**Example:**
```
Current Weapon: Iron Sword
  - Attack: +10
  - Defense: +0

New Weapon: Steel Sword
  - Attack: +15
  - Defense: +2

Net Change: +5 Attack, +2 Defense
```

---

## Daily Check-Ins

### What Are Daily Check-Ins?

A simple way to earn bonus XP and build consistency streaks.

### How It Works

1. **Visit Dashboard** daily
2. **Click "Check In" Button**
3. **Receive 100 XP** instantly
4. **Calendar Updates** - Today's square turns green

### Check-In Rules

- **One per day** - Cannot check in multiple times
- **Resets at midnight** - Based on your local timezone
- **No retroactive check-ins** - Missed days cannot be recovered

### Streak Tracking

**GitHub-Style Calendar:**
- **Green squares** - Checked in
- **Gray squares** - Not checked in
- **Current week** - Highlighted
- **Hover** - See date and status

**Streak Benefits:**
- Visual motivation
- Achievement progress (e.g., "7-Day Streak")
- Leaderboard points

**Breaking Streaks:**
- Missing a day breaks your streak
- Streak resets to 0
- Must rebuild from day 1

### Calendar View

**Date Range:** Shows last 60 days

**Navigation:**
- Scroll horizontally to view older dates
- Current day always visible
- Week labels (Sun-Sat)

---

## Tower Combat

### What is the Tower?

A progressive combat challenge where you battle enemies on ascending floors.

### How Combat Works

#### 1. Entering the Tower

1. **Navigate to Tower Page**
2. **View Current Floor** - Shows floor number and enemy
3. **Click "Enter Combat"** - Initiates battle

#### 2. Combat Mechanics

**Turn-Based System:**

**Your Turn:**
1. **Choose Action:**
   - **Attack** - Deal damage based on Strength + Weapon
   - **Defend** - Reduce incoming damage (50%)
   - **Special Ability** - Unique skills based on attributes
   - **Flee** - Attempt to escape (may fail)

2. **View Stats:**
   - Your HP
   - Enemy HP
   - Attack/Defense values

**Enemy Turn:**
- Enemy automatically attacks
- Damage calculated: Enemy Attack - Your Defense
- HP decreases accordingly

**Combat Loop:**
- Turns alternate until:
  - Enemy HP reaches 0 (Victory)
  - Your HP reaches 0 (Defeat)
  - You flee successfully

#### 3. Victory Rewards

**Upon Defeating Enemy:**
- **XP Gained** - Based on enemy difficulty
- **Gold Earned** - Currency for equipment
- **Floor Progress** - Advance to next floor
- **Possible Loot** - Random equipment drops

**Floor Advancement:**
- Each floor has progressively stronger enemies
- Higher floors = Better rewards
- Tower progress tracked on profile

#### 4. Defeat Consequences

**If Defeated:**
- **No XP Lost** - Keep all earned XP
- **Remain on Current Floor** - Try again
- **No Equipment Loss** - All items safe
- **Can Retry Immediately**

### Enemy Types

**Enemy Progression:**

| Floor Range | Enemy Types | Difficulty |
|-------------|-------------|------------|
| 1-5 | Blue Slimes | Easy |
| 6-10 | Red Slimes | Medium |
| 11-15 | Shadows | Hard |
| 16-20 | Skeleton Warriors | Very Hard |
| 21+ | Skeleton Captains | Epic |

**Enemy Stats Increase:**
- HP scales with floor number
- Attack increases per floor
- Defense improves at higher floors

### Combat Strategies

**Attribute-Based Strategies:**

1. **Strength Build**
   - Focus on Attack actions
   - High damage, quick victories
   - Good for early floors

2. **Health Build**
   - Tank damage with high HP
   - Outlast enemies
   - Good for tough bosses

3. **Balanced Build**
   - Mix of attack and defense
   - Adaptable to any enemy
   - Consistent performance

**Equipment Optimization:**
- Equip best available gear before entering
- Balance attack and defense
- Consider enemy type (physical vs. magic)

### Real-Time Combat Mode

**Alternative Combat System:**
- Action-based combat (not turn-based)
- Dodge enemy attacks in real-time
- Timing-based special abilities
- More engaging, skill-based

**Enable Real-Time Mode:**
1. Navigate to Settings
2. Toggle "Real-Time Combat" option
3. Save changes

---

## Achievement System

### What Are Achievements?

Unlockable badges that recognize milestones and accomplishments.

### Achievement Categories

#### 1. Level-Based Achievements

| Achievement | Requirement |
|-------------|-------------|
| **Novice** | Reach Level 5 |
| **Apprentice** | Reach Level 10 |
| **Expert** | Reach Level 15 |
| **Master** | Reach Level 20 |
| **Legendary** | Reach Level 30 |

#### 2. Habit Completion Achievements

| Achievement | Requirement |
|-------------|-------------|
| **First Steps** | Complete 1 habit |
| **Getting Started** | Complete 10 habits |
| **Habit Former** | Complete 50 habits |
| **Habit Master** | Complete 100 habits |
| **Unstoppable** | Complete 500 habits |

#### 3. Streak Achievements

| Achievement | Requirement |
|-------------|-------------|
| **Consistent** | 7-day check-in streak |
| **Dedicated** | 30-day check-in streak |
| **Unwavering** | 100-day check-in streak |

#### 4. Tower Achievements

| Achievement | Requirement |
|-------------|-------------|
| **Tower Beginner** | Reach Floor 5 |
| **Tower Climber** | Reach Floor 10 |
| **Tower Conqueror** | Reach Floor 20 |
| **Tower Legend** | Reach Floor 50 |

#### 5. Attribute Achievements

| Achievement | Requirement |
|-------------|-------------|
| **Strength Specialist** | Strength reaches 50 |
| **Intelligence Guru** | Intelligence reaches 50 |
| **Creative Genius** | Creativity reaches 50 |
| **Social Butterfly** | Social reaches 50 |
| **Health Enthusiast** | Health reaches 50 |

#### 6. Balanced Build Achievement

| Achievement | Requirement |
|-------------|-------------|
| **Jack of All Trades** | All attributes reach 25 |

### Viewing Achievements

1. **Navigate to Achievements Page**
2. **View Achievement Grid:**
   - **Unlocked** - Colored badge with checkmark
   - **Locked** - Grayed out with progress bar
3. **Click Achievement** for details:
   - Description
   - Progress toward unlock
   - Unlock date (if earned)

### Achievement Notifications

**When Unlocked:**
- Popup notification appears
- Badge icon displayed
- Congratulatory message
- Achievement added to profile

---

## Leaderboard

### What is the Leaderboard?

A global ranking system showing top players by various metrics.

### Ranking Categories

#### 1. Overall Ranking (Default)

**Ranked By:** Total XP earned

**Display:**
- Rank number (1st, 2nd, 3rd...)
- Username
- Level
- Total XP
- Your rank highlighted

#### 2. Level Ranking

**Ranked By:** Current level, then XP

**Display:**
- Shows highest level players
- Tiebreaker: XP at current level

#### 3. Attribute Rankings

**Separate Rankings For:**
- Strength Leaders
- Intelligence Leaders
- Creativity Leaders
- Social Leaders
- Health Leaders

**Display:**
- Top players in each attribute
- Attribute value shown

#### 4. Tower Ranking

**Ranked By:** Highest floor reached

**Display:**
- Top tower climbers
- Current floor number
- Tower completion percentage

### Viewing the Leaderboard

1. **Navigate to Leaderboard Page**
2. **Select Ranking Category** from tabs
3. **View Top 100 Players**
4. **Find Your Rank:**
   - Your entry is highlighted
   - Shows your position even if not in top 100

### Climbing the Leaderboard

**Strategies:**
1. **Complete habits daily** - More XP = Higher rank
2. **Focus on streaks** - Consistency matters
3. **Challenge the Tower** - Floor progression gives points
4. **Max attributes** - Compete in specialized rankings
5. **Stay active** - Inactive players drop in rank

### Leaderboard Refresh

- Updates in real-time (every 5 seconds)
- Your rank recalculates automatically
- Cached for performance

---

## Settings and Customization

### Account Settings

#### Profile Information

**Editable Fields:**
- **Username** - Change your display name
- **Email** - Update contact email
- **Password** - Change account password

**How to Update:**
1. Navigate to Settings → Profile Tab
2. Edit desired fields
3. Click "Save Changes"
4. Confirm with current password

#### Privacy Settings

**Options:**
- **Show on Leaderboard** - Toggle public visibility
- **Share Progress** - Allow others to view your stats
- **Anonymous Mode** - Hide username in rankings

### Character Customization

#### Appearance

**Character Theme Selection:**
1. Navigate to Settings → Appearance Tab
2. **Select Theme:**
   - Default
   - Zoro
   - Cyberpunk (Default, Corrupted, Ascended)
3. **Preview** live character render
4. **Apply** changes

**Theme Unlock Requirements:**
- Most themes unlocked by default
- Special themes may require achievements or levels

#### Equipment Management

**View and Equip:**
1. Navigate to Settings → Equipment Tab
2. **View Inventory:**
   - Owned equipment
   - Locked equipment (grayed out)
3. **Equip Items:**
   - Click item card
   - Click "Equip" button
   - Confirm selection
4. **Visual Update:**
   - Character sprite updates immediately
   - Stats recalculated

### Notification Preferences

**Notification Types:**
- Level-up notifications
- Achievement unlocks
- Habit completion confirmations
- Daily check-in reminders

**How to Configure:**
1. Settings → Notifications Tab
2. Toggle each notification type
3. Save preferences

### Game Settings

#### Combat Mode

**Options:**
- **Turn-Based** (Default) - Classic RPG combat
- **Real-Time** - Action-based combat

**Change Combat Mode:**
1. Settings → Game Tab
2. Select combat mode
3. Apply changes
4. Affects all future Tower battles

#### Display Settings

**Options:**
- **Theme** - Light/Dark mode (UI theme, not character)
- **Animations** - Enable/disable visual effects
- **Sound Effects** - Toggle audio

---

## Tips and Best Practices

### Habit Creation Best Practices

**1. Be Specific**
- ❌ Bad: "Exercise"
- ✅ Good: "30-minute jog around the neighborhood"

**2. Make It Achievable**
- Start with Easy habits
- Gradually increase difficulty
- Don't overcommit

**3. Use Accurate Descriptions**
- Detailed descriptions help AI calculate better XP
- Include time commitment and effort level

**4. Balance Attributes**
- Don't focus only on one attribute
- Well-rounded characters perform better
- Unlock "Jack of All Trades" achievement

**5. Set Realistic Difficulty**
- Easy: Daily, low-effort tasks
- Medium: Requires some planning
- Hard: Significant commitment
- Epic: Major achievements (use sparingly)

### Leveling Optimization

**1. Daily Check-Ins**
- Never miss a day (100 XP bonus)
- Build streaks for achievements
- Costs zero effort

**2. Complete All Available Habits**
- Max out your quest limit
- Prioritize high-XP habits first
- Rotate habits daily for variety

**3. Progressive Difficulty**
- Start with Easy habits to build momentum
- Gradually increase to Medium/Hard
- Save Epic for major milestones

**4. Tower Progression**
- Regular combat for bonus XP
- Equipment improves efficiency
- Don't skip floors (consistent progression)

### Combat Strategy

**1. Pre-Combat Preparation**
- Equip best available gear
- Check attribute stats
- Ensure high HP (Health attribute)

**2. During Combat**
- **Early Floors (1-10):** Aggressive attacking
- **Mid Floors (11-20):** Mix attack and defend
- **Late Floors (21+):** Strategic, careful play

**3. Equipment Upgrades**
- Upgrade when available
- Prioritize weapons for damage
- Balance attack and defense

**4. Attribute Focus**
- Strength = More damage
- Health = Survive longer
- Intelligence = Special abilities

### Time Management

**1. Morning Routine**
- Check in daily (100 XP)
- Complete quick Easy habits
- Review progress

**2. Evening Review**
- Complete remaining habits
- Plan tomorrow's quests
- Check leaderboard position

**3. Weekly Planning**
- Create new habits on Sundays
- Remove habits you're not doing
- Adjust difficulty as needed

### Motivation Maintenance

**1. Track Visual Progress**
- Watch XP bar fill
- See attribute growth
- Celebrate level-ups

**2. Achievement Hunting**
- Focus on next achievement
- Work toward specific badges
- Share accomplishments

**3. Leaderboard Competition**
- Compete with friends
- Set ranking goals
- Friendly rivalry

**4. Character Customization**
- Change themes when bored
- Earn new equipment
- Visual variety maintains interest

### Common Mistakes to Avoid

**1. Creating Too Many Habits**
- Don't exceed your quest limit
- Quality over quantity
- Focus on habits you'll actually do

**2. Setting Unrealistic Difficulty**
- Epic difficulty for basic tasks = unsustainable
- Accurate difficulty = better long-term results

**3. Ignoring Attributes**
- One-dimensional builds limit combat effectiveness
- Balanced progression unlocks more content

**4. Skipping Daily Check-Ins**
- Easy 100 XP lost
- Breaks streak progress
- Slows leveling significantly

**5. Not Exploring the Tower**
- Missing XP and gold
- No equipment drops
- Slower overall progression

---

## Frequently Asked Questions

### Q: How do I reset my password?

**A:** Currently, password reset is done through account settings:
1. Login to your account
2. Navigate to Settings → Profile
3. Enter current password
4. Enter new password
5. Confirm changes

### Q: Can I delete my account?

**A:** Yes. Navigate to Settings → Account → Delete Account. This action is permanent and cannot be undone.

### Q: How is XP calculated?

**A:** XP is calculated using:
1. Base XP (from AI analysis or manual input)
2. Difficulty multiplier (Easy: 1x, Medium: 1.5x, Hard: 2x, Epic: 3x)
3. Total XP = Base XP × Difficulty Multiplier

### Q: Why can't I create more habits?

**A:** You've reached your quest limit. Quest limits are:
- Level 1-4: 4 quests
- Level 5-9: 6 quests
- Level 10-14: 8 quests
- Level 15-19: 10 quests
- Level 20+: Unlimited

Level up to unlock more quest slots.

### Q: How do I get better equipment?

**A:** Equipment is obtained by:
1. Leveling up (unlocks new tiers)
2. Defeating enemies in the Tower (random drops)
3. Purchasing with gold (earned from combat)

### Q: What happens if I lose a Tower battle?

**A:** Nothing negative. You:
- Keep all earned XP
- Keep all equipment
- Remain on same floor
- Can retry immediately

### Q: Can I compete with friends?

**A:** Yes! The leaderboard shows all players. Share your username with friends and compete for rankings.

### Q: Is there a mobile app?

**A:** Currently, the system is web-based. Access it from any browser (desktop or mobile).

### Q: How do achievements affect gameplay?

**A:** Achievements are cosmetic rewards that:
- Show on your profile
- Demonstrate progress
- Don't provide gameplay bonuses (currently)

### Q: Can I change my username?

**A:** Yes. Navigate to Settings → Profile → Edit Username → Save Changes.

---

## Conclusion

The Gamified Habit Tracker transforms mundane habit tracking into an engaging RPG adventure. By completing real-life tasks, you'll build a powerful character, unlock achievements, and compete with others.

### Key Takeaways

1. **Start Small** - Begin with a few Easy habits
2. **Be Consistent** - Daily check-ins and habit completion
3. **Progress Gradually** - Increase difficulty as you improve
4. **Explore All Features** - Combat, achievements, customization
5. **Compete and Compare** - Use the leaderboard for motivation

### Getting Help

**Need Support?**
- Check this manual first
- Review [Installation Guide](INSTALLATION.md) for setup issues
- Report bugs on GitHub Issues
- Contact support (if available)

### Happy Questing!

Your journey to better habits and a stronger character starts now. Complete quests, level up, and become a legend!

---

**User Manual Version:** 1.0.0
**Last Updated:** December 15, 2025
