Lemontropia-Suite/docs/EQUIPMENT_STRUCTURE.md

# Entropia Universe Complete Equipment Structure

**Source:** Entropia Nexus Loadout Export  
**Date:** 2026-02-09  
**Reference:** Test Loadout JSON from Nexus

---

## 1. ARMOR (7 Slots)

Standard 7-piece armor system used by all armor sets:

| Slot | Nexus Name | Piece Type | Example (Viceroy) |
|------|------------|------------|-------------------|
| **Head** | Head | Helmet | Viceroy Helmet |
| **Torso** | Torso | Harness/Chest | Viceroy Harness |
| **Arms** | Arms | Arm Guards | Viceroy Arm Guards |
| **Hands** | Hands | Gloves | Viceroy Gloves |
| **Legs** | Legs | Thigh Guards | Viceroy Thigh Guards |
| **Shins** | Shins | Shin Guards | Viceroy Shin Guards |
| **Feet** | Feet | Foot Guards | Viceroy Foot Guards |

### Plating System
Each armor piece can have ONE plate attached:
```json
"Armor": {
  "Head": {
    "Name": "Viceroy Helmet",
    "Plate": {"Name": "Armor Plating Mk. 5B"}
  },
  ...
}
```

### Armor Enhancers
Armor pieces can have enhancers (optional):
```json
"Enhancers": {
  "Defense": 10,
  "Durability": 0
}
```

---

## 2. WEAPON

### Base Weapon
```json
"Weapon": {
  "Name": "ArMatrix LP-70 (L)"
}
```

### Weapon Attachments (6 Slots)

| Attachment | Slot | Example |
|------------|------|---------|
| **Scope** | Scope | ZX Eagle Eye |
| **Sight** | ScopeSight | Bullseye III (L) |
| **Sight** | Sight | Bullseye III (L) |
| **Amplifier** | Amplifier | Omegaton A104 |
| **Absorber** | Absorber | ArMatrix Extender P10 (L) |
| **Matrix** | Matrix | (optional, null in example) |
| **Implant** | Implant | (optional, null in example) |

**Note:** Scopes can have their OWN sight!
```json
"Scope": {
  "Name": "ZX Eagle Eye",
  "Sight": {"Name": "Bullseye III (L)"}
}
```

### Weapon Enhancers (10 Slots!)
```json
"Enhancers": {
  "Range": 1,
  "Damage": 6,
  "Economy": 1,
  "Accuracy": 1,
  "SkillMod": 1
  // 5 more slots available
}
```

---

## 3. CLOTHING / ACCESSORIES

Various cosmetic and buff items:

```json
"Clothing": [
  {"Name": "Athenic Ring (L)", "Side": "Left", "Slot": "Ring"},
  {"Name": "Aeglic Ring (L)", "Side": "Right", "Slot": "Ring"},
  {"Name": "Duster Courier Boots", "Slot": "Unknown"},
  {"Name": "Duster Courier Coat", "Slot": "Unknown"},
  {"Name": "Duster Courier Goggles", "Slot": "Unknown"},
  {"Name": "Duster Courier Jacket", "Slot": "Unknown"},
  {"Name": "Duster Courier Pants", "Slot": "Unknown"},
  {"Name": "Vampiric Cloak of Vitality", "Slot": "Unknown"}
]
```

**Types:**
- Rings (Left/Right)
- Face (Goggles, Glasses)
- Body (Coat, Jacket)
- Legs (Pants, Boots)
- Back (Cloaks)

---

## 4. CONSUMABLES

Buff items with duration:

```json
"Consumables": [
  {"Name": "Merry Mayhem Candy Cane"},
  {"Name": "Loot Collection Pill, Augmented"}
]
```

---

## 5. PET

Combat pets with passive buffs:

```json
"Pet": {
  "Name": "Atrox Ruby Pup",
  "Effect": "Decreased Critical Damage Taken::3"
}
```

---

## 6. MARKUP TRACKING

Nexus tracks markup percentages for all items:

```json
"Markup": {
  "Ammo": 100,
  "Scope": 100,
  "Sight": 100,
  "Armors": {
    "Arms": 100, "Feet": 100, "Head": 100,
    "Legs": 100, "Hands": 100, "Shins": 100, "Torso": 100
  },
  "Plates": {
    "Arms": 100, "Feet": 100, "Head": 100,
    "Legs": 100, "Hands": 100, "Shins": 100, "Torso": 100
  },
  "Weapon": 100,
  "Implant": 100,
  "Absorber": 100,
  "ArmorSet": 100,
  "PlateSet": 100,
  "Amplifier": 100,
  "ScopeSight": 100
}
```

---

## 7. PROPERTIES / BUFFS

Calculated bonuses from gear:

```json
"Properties": {
  "BonusDamage": 0,
  "BonusReload": 0,
  "BonusCritChance": 0,
  "BonusCritDamage": 0
}
```

---

## 8. SKILL REQUIREMENTS

Minimum skills to use gear:

```json
"Skill": {
  "Dmg": 69,  // Damage profession
  "Hit": 72   // Hit profession
}
```

---

## Equipment Hierarchy Summary

```
LOADOUT
├── Pet
├── Armor (7 slots + plates + enhancers)
│   ├── Head + Plate + Enhancers
│   ├── Torso + Plate + Enhancers
│   ├── Arms + Plate + Enhancers
│   ├── Hands + Plate + Enhancers
│   ├── Legs + Plate + Enhancers
│   ├── Shins + Plate + Enhancers
│   └── Feet + Plate + Enhancers
├── Weapon
│   ├── Base Weapon
│   ├── Scope (with Sight)
│   ├── Sight
│   ├── Amplifier
│   ├── Absorber
│   ├── Matrix (optional)
│   ├── Implant (optional)
│   └── Enhancers (10 slots)
├── Clothing (multiple slots)
│   ├── Rings (L/R)
│   ├── Face
│   ├── Body
│   ├── Legs
│   └── Back
└── Consumables (buffs)
```

---

## Implementation Notes for Lemontropia Suite

### Priority 1: Core Hunting
- ✅ Armor (7 slots) - DONE
- ✅ Weapon (base + cost) - DONE
- 🔄 Weapon attachments - Partial
- ✅ Healing tools - DONE
- 🔄 Consumables - TODO

### Priority 2: Full Gear
- 🔄 Weapon enhancers (10 slots)
- 🔄 Armor plates (7 slots)
- 🔄 Armor enhancers
- 🔄 Clothing/Accessories
- 🔄 Pets

### Priority 3: Advanced
- 🔄 Markup tracking
- 🔄 Property calculations
- 🔄 Skill requirements
- 🔄 Full Nexus import/export

---

## Key Insights from Nexus Export

1. **Armor slots are EXACTLY:** Head, Torso, Arms, Hands, Legs, Shins, Feet
2. **Plates are per-piece** - 7 plate slots total
3. **Weapon can have 2 sights:** One on scope, one on weapon
4. **10 weapon enhancer slots** - Damage, Economy, Range, Accuracy, SkillMod + 5 more
5. **Clothing is cosmetic + buffs** - separate from armor
6. **Consumables are temporary buffs**
7. **Pets provide passive effects**

---

**Status:** Armor structure now matches Nexus exactly ✅