2.3 KiB
2.3 KiB
Sprint 2: GUI Foundation + Loadout Manager
Date: 2026-02-08
Status: IN PROGRESS
Lead Engineer: LemonNexus
Objective: Build PyQt6 GUI with transparent HUD overlay + Entropia Nexus loadout manager
Sprint 2 Scope
Phase 1: GUI Foundation (PyQt6)
- Main application window
- Transparent HUD overlay (always-on-top, click-through)
- Real-time stats display panel
- Session controls (start/stop/pause)
- Theme system (dark/light)
Phase 2: Loadout Manager
- Weapon/Armor/Tool configuration UI
- Entropia Nexus API client (stats fetching)
- Cost calculations (PED/hour, PED/drop)
- Loadout save/load system
- DPP (Damage Per Pec) calculator
Phase 3: Integration
- Connect HUD to live session data
- Display current loadout stats
- Real-time cost tracking
- ROI calculations with gear costs
Technical Stack
| Component | Technology |
|---|---|
| GUI Framework | PyQt6 6.4+ |
| Overlay | Qt Widgets with WA_TransparentForMouseEvents |
| Styling | QSS (Qt StyleSheets) |
| API Client | httpx (async) |
| Data Storage | SQLite (existing) |
Development Notes
Self-Testing Strategy:
- Use mock data for UI development
- Test overlay positioning with fake stats
- Validate Entropia Nexus API integration
- Simulate loadout changes
User Testing Required For:
- Real Entropia Nexus API responses
- Actual gear stats validation
- In-game HUD positioning
- Live loadout switching
Architecture
/ui
/components → Reusable widgets
/windows → Main window, HUD overlay
/themes → QSS stylesheets
/loadout → Loadout manager UI
/core
/nexus_api.py → Entropia Nexus client (expand)
/loadout.py → Loadout data models
Entropia Nexus Integration
Status: ✅ OFFICIAL REST API FOUND!
API Docs: https://api.entropianexus.com/docs/
Approach: Use official REST API (no scraping needed!)
Endpoints to Explore:
/items— Weapon/Armor/Tool stats/weapons— Weapon-specific data/markets— Markup data (optional)
Data Needed:
- Weapon: damage, decay, ammo, DPP
- Armor: protection values, decay
- Tools: depth, radius, cost
- Market: markups (optional)
Next Update: When Phase 1 (GUI Foundation) is ready for review