Miyoo Extraction RPG — Phase 3: Loot, Gear & Town Hub

Phase 3 turns the game into a true roguelike + Tarkov extraction experience. You will implement the full loot system (rarity scaling, random affixes, 0–3 augment slots), the complete town hub, inventory/equip UI, extraction logic, and daily/weekly tasks — all while keeping the Miyoo client lightweight and responsive.

🎯 Goal

Build the complete extraction loop: find powerful loot with meaningful progression, manage it in town, and risk everything on every run.

✅ Final Deliverable

A fully playable solo extraction loop on real Miyoo hardware: gear up in town, enter a dungeon, loot rare items with affixes and augment slots, extract (or die and lose equipped gear), and see your stash update with new items and task rewards.

📋 Prerequisites — Complete Phase 0, 1 & 2 First

✔️ Rust server with combat tick loop and classes
✔️ Miyoo client with chunk rendering and combat feedback
✔️ Working hybrid TCP+UDP networking
✔️ 16×16 sprites for items, augments, weapons, and icons
✔️ Procedural dungeons and player movement

Detailed Steps for Phase 3

Expand Shared Crate with Full Item System

In shared/src/lib.rs define the complete data model for loot:

#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum Rarity { Common, Uncommon, Rare, Epic, Legendary }

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Affix {
    pub name: String,
    pub value: f32,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Augment {
    pub id: u32,
    pub name: String,
    pub effect: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Item {
    pub base_id: u32,
    pub rarity: Rarity,
    pub affixes: Vec<Affix>,
    pub augments: Vec<Option<Augment>>, // up to 3 slots, Some/None
    pub flavor_text: Option<String>,
}

This struct lives in the shared crate so both client and server understand every item identically.

Server: Implement Loot Generation Function

Create a pure function in the server that generates loot when enemies die or chests are opened:

Choose base item template
Roll rarity (weighted by dungeon depth)
Scale base stats by rarity multiplier
Roll random affixes (more and stronger on higher rarity)
Roll 0–3 augment slots (rarity strongly influences chance)

All randomness and math happens only on the server — the client receives the final computed Item.

Server: Extraction & Death Logic

When a player reaches an extract portal or dies:

Successful extraction → move equipped items to persistent stash (SQLite)
Death → equipped items are permanently lost (Tarkov-style)
Stash items are always safe

Client: Inventory Grid & Equip Screen

Build on Miyoo SDL2:

4–6 column inventory grid (16×16 item icons)
Hover/select shows tooltip with rarity color, affixes, augment slots, and flavor text
Drag-and-drop or button equip/unequip
Visual slots on items (tiny embedded augment icons in corners)

Client: Town Hub UI

Create several clean town screens:

Stash — view and manage extracted items
Vendors — buy/sell with stock that slowly improves via extractions
Augment Bench — insert/remove augments from items

Use the same tooltip system as inventory for consistency.

Implement Daily/Weekly Tasks + Bounty Board

On the server:

Simple task templates (e.g. “Extract with 2 Rare+ items”)
Auto-refresh daily/weekly
Track progress and award small rewards (potions, stash slots, vendor unlocks)

On the client: a clean “Bounty Board” screen in town showing current tasks and progress.

Add Flavor Text & Visual Polish

Attach short flavor text to high-rarity items/augments. Add subtle visual cues on the client (rarity-colored names, glowing augment slots, tiny particles on legendary items).

Full Solo Loop Testing on Real Hardware

Test the complete loop end-to-end on the Miyoo:

Gear up in town
Enter dungeon, fight, loot
Extract successfully and see stash update
Die and confirm equipped gear is lost
Complete a daily task and receive reward

✅ Phase 3 Complete When You Can:

✔️ Find, inspect, and equip loot with rarity, affixes, and augment slots
✔️ Use the full town hub (stash, vendors, augment bench, bounty board)
✔️ Successfully extract and permanently lose equipped gear on death
✔️ Complete daily/weekly tasks and see meaningful rewards
✔️ Play the entire solo extraction loop end-to-end on real Miyoo hardware

The core extraction loop is now complete and addictive. You are ready for Phase 4 where multiplayer queues and PvPvE come online.