Lemontropia-Suite/ui/HUD_REDESIGN.md

126 lines
3.6 KiB
Markdown

# 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`:
```python
# 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:
```json
{
"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
}
```