166 lines
4.1 KiB
Markdown
166 lines
4.1 KiB
Markdown
# 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!** 🍋🎯 |