Lemontropia-Suite/docs/FEATURE_RESEARCH.md

244 lines
5.8 KiB
Markdown

# 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? 🎮**