From 0e5e54e386712410fb808c8d66b4d4f471efc4b7 Mon Sep 17 00:00:00 2001 From: LemonNexus Date: Mon, 9 Feb 2026 11:07:48 +0000 Subject: [PATCH] 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 --- docs/EQUIPMENT_STRUCTURE.md | 267 ++++++++++++++++++++++++++++++++++++ 1 file changed, 267 insertions(+) create mode 100644 docs/EQUIPMENT_STRUCTURE.md diff --git a/docs/EQUIPMENT_STRUCTURE.md b/docs/EQUIPMENT_STRUCTURE.md new file mode 100644 index 0000000..169c36b --- /dev/null +++ b/docs/EQUIPMENT_STRUCTURE.md @@ -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 ✅