Lemontropia-Suite/ui/HUD_REDESIGN.md

3.6 KiB

HUD Redesign - Clean & Customizable

New Features

1. Simplified Default View

By default, the new HUD shows only the essentials:

  • Status indicator (● Live)
  • Current gear (weapon, armor, loadout)
  • Profit/Loss (big, prominent)
  • Return % (big, prominent)
  • Cost per shot/hit/heal
  • Session time
  • Drag hint

2. Customizable Display

Click the ⚙️ (settings) button to choose what to show:

  • Core Stats (recommended on)
    • Session Time
    • Profit/Loss
    • Return %
    • Cost per Shot/Hit/Heal
    • Current Gear
  • Optional Stats (off by default)
    • Cost Breakdown (weapon/armor/heal separate costs)
    • Combat Stats (kills, globals)
    • Damage Stats (dealt/taken)
    • Shrapnel Amount
  • 📏 Display Mode
    • Compact Mode (smaller font, narrower)

3. Auto-Size Based on Content

The HUD automatically adjusts its height based on what you're showing. No wasted space!

Files

File Purpose
ui/hud_overlay_clean.py New clean HUD implementation

How to Test

Replace the import in main_window.py:

# OLD:
from ui.hud_overlay import HUDOverlay

# NEW:
from ui.hud_overlay_clean import HUDOverlay

Default Layout (Clean)

┌─────────────────────────┐
│ ● Ready          [⚙️]   │
├─────────────────────────┤
│ 🔫 ArMatrix BP-25       │
│ 🛡️ Frontier, Adjusted   │
│ 📋 Test Loadout         │
├─────────────────────────┤
│ P/L: +12.50 PED    105% │
├─────────────────────────┤
│ Shot: 0.091  Hit: 0.0001│
├─────────────────────────┤
│ 00:23:45     Ctrl+drag  │
└─────────────────────────┘

Expanded Layout (All Stats)

┌─────────────────────────┐
│ ● Live           [⚙️]   │
├─────────────────────────┤
│ 🔫 ArMatrix BP-25       │
│ 🛡️ Frontier, Adjusted   │
│ 📋 Test Loadout         │
├─────────────────────────┤
│ P/L: +12.50 PED    105% │
├─────────────────────────┤
│ Shot: 0.091  Hit: 0.0001│
├─────────────────────────┤
│ Weapon:   2.15          │
│ Armor:    0.50          │
│ Healing:  0.25          │
├─────────────────────────┤
│ Kills: 15  Globals: 2   │
├─────────────────────────┤
│ 00:23:45     Ctrl+drag  │
└─────────────────────────┘

Migration

To migrate to the new HUD:

  1. Backup your current hud_overlay.py
  2. Replace import in main_window.py
  3. Test the new layout
  4. Use ⚙️ button to customize
  5. Settings are saved automatically

Settings File

Settings are saved to:

%USERPROFILE%\.lemontropia\hud_config.json

Example:

{
  "show_session_time": true,
  "show_profit_loss": true,
  "show_return_pct": true,
  "show_cost_breakdown": false,
  "show_combat_stats": false,
  "show_damage_stats": false,
  "show_cost_metrics": true,
  "show_shrapnel": false,
  "show_gear_info": true,
  "compact_mode": false
}