docs: add complete equipment structure from Nexus export

- Full 7-slot armor system (Head, Torso, Arms, Hands, Legs, Shins, Feet)
- Weapon attachments (Scope, Sight x2, Amp, Absorber, Matrix, Implant)
- 10 weapon enhancer slots
- Clothing/Accessories system
- Consumables and Pets
- Markup tracking structure
- Priority implementation roadmap
This commit is contained in:
LemonNexus 2026-02-09 11:07:48 +00:00
parent 9e55c751b9
commit 0e5e54e386
1 changed files with 267 additions and 0 deletions

267
docs/EQUIPMENT_STRUCTURE.md Normal file
View File

@ -0,0 +1,267 @@
# 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 ✅