# Lemontropia Suite - Test Hunt Guide

**Version:** 0.2.0  
**Date:** 2026-02-09

---

## Pre-Test Checklist

### 1. Environment Setup
```powershell
# Pull latest code
git pull origin main

# Run the application
python gui_main.py
```

### 2. Configure Settings
- Open **Settings** → Set your `PLAYER_NAME` (for personal global detection)
- Set **Log Path** (usually `C:/Users/[Username]/Documents/Entropia Universe/chat.log`)
- Enable/disable **Mock Mode** (use mock mode for testing without EU running)

---

## Test Hunt Steps

### Step 1: Create a Project
1. Click **"New Project"**
2. Name: `Test Hunt - ArMatrix BP-25`
3. Activity Type: `Hunting`
4. Description: `Testing armor, weapon, and healing tracking`

### Step 2: Configure Loadout
1. Go to **Tools** → **Loadout Manager** (or press `Ctrl+L`)
2. **Weapon Selection:**
   - Click "Select Weapon"
   - Search: `ArMatrix BP-25`
   - Select and confirm
   - **NO attachments** for this test

3. **Armor Selection:**
   - Click "Select Armor" 
   - Choose either:
     - **Full Set:** `Ghost` (recommended for test)
     - **Individual Pieces:** Mix and match if desired
   - **NO plates** for this test (or add if you want to test plates)

4. **Healing Tool Selection:**
   - Select from dropdown:
     - `Vivo S10` (starter)
     - `Adjusted Restoration Chip` (mid-level)
     - `Hedoc MM10` (economical)

5. **Save Loadout:**
   - Name: `Test Loadout`
   - Click "Save"

### Step 3: Start Session
1. Select your project from the list
2. Click **"▶️ Start Session"**
3. The HUD overlay will appear
4. Verify HUD shows:
   - Weapon name
   - Armor name
   - Medical tool name
   - All costs at 0.00

### Step 4: Hunt in Entropia Universe
1. Go hunt creatures in EU
2. The app will automatically track:
   - **Shots fired** (from weapon decay events)
   - **Damage dealt** (from chat log)
   - **Damage taken** (from chat log)
   - **Heals performed** (from chat log)
   - **Loot received** (excluding shrapnel/UA)
   - **Globals/HOFs** (if any)

### Step 5: Monitor Real-Time
Watch the HUD for:
- **Session time** (running counter)
- **Loot total** (shrapnel/UA excluded)
- **Cost total** (weapon + armor + healing)
- **Profit/Loss** (green = profit, red = loss)
- **Shots fired** counter
- **Estimated kills** (1 per loot event)
- **Damage dealt/taken**

### Step 6: Stop Session
1. Click **"⏹️ Stop"** (or close HUD)
2. Review session summary in the main window
3. Check:
   - Total loot value
   - Total cost breakdown
   - Return percentage
   - Cost per kill

---

## Expected Behavior

### Cost Calculations
- **Weapon cost:** ~9.17 PED per 100 shots (ArMatrix BP-25)
- **Armor cost:** ~0.007 PED per 15 damage taken (Ghost)
- **Healing cost:** ~0.017 PED per heal (Vivo S10)

### Loot Tracking
- **Shrapnel:** Tracked but excluded from profit
- **Universal Ammo:** Tracked but excluded from profit
- **Other loot:** Included in profit calculation

### Session Metrics
- **Return %:** (Loot / Cost) × 100
- **Cost/Kill:** Total cost / number of kills
- **Cost/Hour:** Total cost / session hours

---

## Troubleshooting

### HUD Not Showing
- Press `F9` to show HUD
- Check if session is running

### Costs Not Updating
- Verify log path is correct
- Check that log file exists and is readable
- Enable mock mode for testing

### Wrong Player Name
- Update `PLAYER_NAME` in Settings
- Required for personal global detection

### App Crashes
- Check console for error messages
- Verify Python 3.11+ and PyQt6 installed
- Run `pytest tests/` to check for issues

---

## Post-Test Actions

### Review Data
1. Check session summary in main window
2. Compare calculated costs with actual PED spent
3. Verify loot values match EU inventory

### Report Issues
If anything seems wrong:
1. Note the discrepancy
2. Check `chat.log` for relevant lines
3. Share findings for formula refinement

---

## Next Steps After Test

Once basic hunting works:
1. **Test with attachments:** Add amplifier, scope
2. **Test with plates:** Add armor plating
3. **Test mining:** Switch to mining activity
4. **Test crafting:** Switch to crafting activity

---

**Good luck with the test hunt!** 🍋🎯