Lemontropia-Suite/docs/TEST_HUNT_GUIDE.md

Lemontropia Suite - Test Hunt Guide

Version: 0.2.0
Date: 2026-02-09

---

Pre-Test Checklist

1. Environment Setup

# 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! 🍋🎯