Personal Equipment Reference
Personal equipment is gear worn directly by the player character — suit, helmet, boots, gloves, backpack, weapons, and accessories. All personal equipment must set "dungeon": "ground" in its JSON.
Files live in: <pack_root>/data/items/equipment/personal/<slot>/<item_name>.json
JSON Shape
{
"displayName": "items.materials.mypack.suit.reinforced_suit",
"description": "items.materials.mypack.suit.reinforced_suit.desc",
"texture": "mypack/assets/textures/equipment/personal/armor/suit/reinforced_suit.png",
"equipmentSlot": "personal/suit",
"rarity": "uncommon",
"dungeon": "ground",
"storeCategory": "personal_equipment",
"storePrice": 1500,
"storeSellValue": 600,
"storeShowWeight": 5,
"stats": {
"health": 40,
"defence.base": 12,
"defence.chance": 0.3,
"defence.rate": 0.5,
"resistance.base": 0.2,
"resistance.physical": 0.3,
"resistance.heat": 0.15
}
}
Root Fields
| Field | Type | Required | Description |
|---|---|---|---|
displayName | string (lang key) | ✅ | Registry key for the item display name. |
description | string (lang key) | ✅ | Registry key for the item description. |
texture | string (path) | ✅ | Path to the PNG texture, relative to the pack root. |
equipmentSlot | string | ✅ | Slot this item occupies. See slot table below. |
rarity | string | ✅ | common, uncommon, rare, epic, or legendary. |
dungeon | string | ✅ | Must be "ground" for all personal equipment. |
storeCategory | string | ✅ | Store section. Use "personal_equipment". |
storePrice | integer | ✅ | Buy price. |
storeSellValue | integer | ✅ | Sell price. |
storeShowWeight | integer | ✅ | Store listing weight. 0 = never shown. |
stats | object | ✅ | Stat map. Only include stats relevant to your item. |
Equipment Slots
| Slot Value | Holds |
|---|---|
personal/suit | Body armour / spacesuit |
personal/helmet | Helmet |
personal/gloves | Gloves |
personal/boots | Boots |
personal/backpack | Backpack |
personal/weapon | Personal weapon |
personal/accessory | Accessory (rings, implants, etc.) |
Stats Reference
All stat fields are optional — only include those relevant to your item. Each stat group has three variants: .base (flat value), .chance (probability 0–1), and .rate (multiplier).
| Stat Group | Keys |
|---|---|
| Health | health (flat HP bonus) |
| Attack | attack.base, attack.chance, attack.rate |
| Defence | defence.base, defence.chance, defence.rate |
| Penetration | penetration.base, penetration.chance, penetration.rate |
| Reflect | reflect.base, reflect.chance, reflect.rate |
| Resistance | resistance.base, resistance.physical, resistance.cold, resistance.heat, resistance.ion, resistance.gamma, resistance.plasma |
Resistance values are decimals between 0 and 1 where
0.5 = 50% resistance. Only include resistance types that make thematic sense for your item.Example — Combat Gloves
{
"displayName": "items.materials.mypack.gloves.combat_gloves",
"description": "items.materials.mypack.gloves.combat_gloves.desc",
"texture": "mypack/assets/textures/equipment/personal/gloves/combat_gloves.png",
"equipmentSlot": "personal/gloves",
"rarity": "rare",
"dungeon": "ground",
"storeCategory": "personal_equipment",
"storePrice": 2200,
"storeSellValue": 900,
"storeShowWeight": 3,
"stats": {
"health": 5,
"attack.base": 8,
"attack.chance": 0.35,
"attack.rate": 0.6,
"penetration.base": 4,
"penetration.chance": 0.2,
"penetration.rate": 0.4
}
}