Lemontropia-Suite/docs/FEATURE_RESEARCH.md

5.8 KiB

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:

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:

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):

  1. Icon browser GUI
  2. Price database UI
  3. Session replay viewer

Week 3 (Analytics):

  1. Comparative hunting analysis
  2. Weapon efficiency reports
  3. Time-of-day optimization

Week 4 (Advanced):

  1. ML loot prediction (experimental)
  2. Cloud backup/sync
  3. 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? 🎮