# Lemontropia Suite - Feature Research & Implementation

## 🎨 Icon Extraction System (NEW)

### Implementation: `modules/icon_manager.py`

**What it does:**
- Downloads item icons from EntropiaWiki
- Caches icons locally for fast access
- Multiple size presets (32x32, 64x64, 128x128)
- Batch export to PNG
- Failed lookup tracking (avoids repeated requests)

**Usage:**
```python
from modules.icon_manager import IconManager

icons = IconManager()

# Get single icon
icon_path = icons.get_icon("ArMatrix BP-25 (L)", size='large')

# Export for use elsewhere
icons.export_icon("ArMatrix BP-25 (L)", Path("C:/Export/weapon.png"))

# Batch export all gear
icons.batch_export_icons(
    ["ArMatrix BP-25", "Ghost Harness", "Regeneration Chip"],
    Path("C:/Export/GearIcons/")
)
```

**Future Enhancements:**
- [ ] Extract icons directly from game client files (if accessible)
- [ ] Icon recognition (identify item from screenshot of icon)
- [ ] Custom icon overlays (add tier, condition indicators)
- [ ] Icon pack export (zip of all known items)

---

## 💰 Market Price Integration (NEW)

### Implementation: `modules/market_prices.py`

**What it does:**
- Manual price tracking for frequently traded items
- Calculate loot value with markup
- Crafting profitability calculator
- Hunting profitability analysis

**Features:**
- Set custom markup % for items
- Calculate real loot value (not just TT)
- Track unknown prices (items needing price data)
- Export price lists

**Usage:**
```python
from modules.market_prices import ManualPriceTracker, ProfitCalculator

prices = ManualPriceTracker()
prices.set_price("Shrapnel", Decimal("100.01"), Decimal("0.01"))  # 100.01% MU

# Calculate hunt profitability
calc = ProfitCalculator(prices)
result = calc.calculate_hunting_profit(
    ammo_cost=Decimal("45.00"),
    armor_decay=Decimal("5.00"),
    healing_cost=Decimal("3.00"),
    loot_items=[
        ("Shrapnel", Decimal("0.01"), 5000),  # 50 PED
        ("Iron Stone", Decimal("0.05"), 10),   # 0.5 PED
    ]
)
# Shows: total_cost, loot_mu, profit, return_pct
```

**Future:**
- [ ] EntropiaWiki scraping for auto-prices
- [ ] Price trend graphs
- [ ] Best time to sell analysis

---

## 📊 Additional Feature Ideas

### 1. **Session Replay System**
- Record all events during session
- Replay hunt in timeline view
- Click on timestamp to see game state
- Share "run" files with friends

### 2. **Comparative Analytics**
- Compare hunting spots efficiency
- Compare weapon DPP over time
- Best time of day analysis
- Day-of-week performance

### 3. **Predictive Loot System**
- Machine learning model
- Predict next global timer
- Estimate remaining mobs until global
- (Based on EU's RNG patterns)

### 4. **Mining Assistant**
- Claim depth/radius tracker
- Claim type recording (lgt, oily, etc.)
- Mining run profitability
- Resource hotspot mapping

### 5. **Event Calendar Integration**
- Track Mayhem, Easter, Summer events
- Personal event statistics
- Event loot analysis
- Compare event vs regular hunting

### 6. **Bankroll Management**
- Track PED deposits/withdrawals
- Set daily/weekly hunting budgets
- Alert when approaching limits
- ROI tracking over time

### 7. **Social Features**
- Friend comparison (who got biggest global?)
- Guild/team shared stats
- Loot leaderboards
- Competition mode

### 8. **Export Capabilities**
- CSV export for Excel analysis
- PDF session reports
- YouTube video metadata generation
- Stream overlay integration (OBS)

### 9. **Mobile Companion App**
- Discord bot commands
- Telegram status updates
- Mobile alert on big loot
- View stats on phone

### 10. **Advanced Vision**
- Read health % from screen
- Detect claim sizes visually
- Read chat messages automatically
- Detect globals without log parsing

---

## 🔧 Technical Implementations Needed

### For Icon Extraction:
1. ✅ Icon manager with wiki integration
2. [ ] GUI icon browser/preview
3. [ ] Drag-drop icon export
4. [ ] Icon overlay system for HUD

### For Market Prices:
1. ✅ Manual price tracker
2. [ ] Price database UI
3. [ ] Import/export price lists
4. [ ] EntropiaWiki scraper (respecting rate limits)

### For Advanced Features:
1. [ ] Machine learning model training
2. [ ] Database schema for analytics
3. [ ] Background data processing
4. [ ] Cloud sync option

---

## 📱 Integration Priorities

### Week 1 (Immediate Testing):
1. ✅ Icon manager - Export gear icons
2. ✅ Market prices - Track common loot MU
3. ✅ Profit calculator - Real hunting ROI

### Week 2 (Enhanced UX):
4. [ ] Icon browser GUI
5. [ ] Price database UI
6. [ ] Session replay viewer

### Week 3 (Analytics):
7. [ ] Comparative hunting analysis
8. [ ] Weapon efficiency reports
9. [ ] Time-of-day optimization

### Week 4 (Advanced):
10. [ ] ML loot prediction (experimental)
11. [ ] Cloud backup/sync
12. [ ] Mobile companion

---

## 🎯 User Experience Goals

**Powerful but Simple:**
- Default settings work out of the box
- Advanced features hidden behind menus
- Tooltips explain every metric
- Video tutorials for complex features

**Fast & Responsive:**
- All operations under 100ms
- Background data loading
- Lazy loading for history
- Cached icons and prices

**Customizable:**
- Toggle any feature on/off
- Custom HUD layouts
- User-defined categories
- Personal color schemes

---

## 🔐 Security & Ethics

**User Data:**
- All data stored locally by default
- Optional cloud sync (encrypted)
- No telemetry without consent
- Open source for transparency

**Game Compliance:**
- Read-only from game (no injection)
- Respects Entropia Universe EULA
- No automation/botting features
- Fair play for all users

---

## 🚀 Next Steps

1. **Test current features** in real hunting session
2. **Gather feedback** on what's most useful
3. **Prioritize** based on user needs
4. **Iterate** quickly on most-wanted features
5. **Document** everything thoroughly

---

**Ready to make this the ultimate Entropia hunting companion? 🎮**