Personal equipment is gear worn directly by the player character β spacesuit, boots, gloves, backpack, weapons, and accessories. It provides stats that affect survivability and combat effectiveness in ground/dungeon environments.
Files live in: <your_pack_id>/data/items/equipment/personal/<slot_type>/<item_name>.json
Recommended sub-folders: accessory/, backpack/, boots/, gloves/, suit/, weapons/
File Structure
{
"plating": {
"id": "...",
"displayName": "...",
"description": "...",
"texture": "...",
"stats": { },
"meta": {
"rarity": "common",
"equipmentSlot": "...",
"storeCategory": "...",
"dungeon": "ground"
}
}
}
The root key is "plating" for most personal equipment. Backpacks use "armour" as their root key instead.
Root Object Fields
| Field | Type | Required | Description |
|---|
id | string | β
| Namespaced ID. Example: stellar_forge:suit_reinforced |
displayName | string | β
| Translation key for the item display name |
description | string | β
| Translation key for the item description |
texture | string | β
| Path to the image file, relative to the pack root |
stats | object | β
| Combat and survivability stats this item provides |
meta | object | β
| Metadata controlling how the item works in the game |
Stats Fields
All stat fields are optional β only include those relevant to your item.
Attack Stats
| Field | Type | Description |
|---|
attack.base | number | Flat base attack damage added to player attacks |
attack.chance | number | Chance (0β1) that an attack lands a bonus hit |
attack.rating | number | Attack quality rating; affects damage scaling against higher-tier enemies |
Defence Stats
| Field | Type | Description |
|---|
defence.base | number | Flat base damage reduction before other calculations |
defence.chance | number | Chance (0β1) to trigger a defensive proc |
defence.rating | number | Defence quality rating; scales damage reduction against stronger attackers |
health | number | Flat increase to the player maximum health |
Penetration Stats
| Field | Type | Description |
|---|
penetration.base | number | Flat armour penetration; bypasses a portion of enemy defence |
penetration.chance | number | Chance (0β1) for an attack to apply full penetration |
penetration.rating | number | Penetration quality rating |
Reflect Stats
| Field | Type | Description |
|---|
reflect.base | number | Flat damage reflected back to attackers |
reflect.chance | number | Chance (0β1) to reflect damage on any given hit |
reflect.rating | number | Reflect quality rating |
Resistance Stats
| Field | Type | Description |
|---|
resistance.base | number | General damage resistance (decimal). 0.1 = 10% reduction to all incoming damage |
resistance.cold | number | Resistance to cold/cryo damage |
resistance.gamma | number | Resistance to gamma/radiation damage |
resistance.heat | number | Resistance to heat/fire damage |
resistance.ion | number | Resistance to ion/electric damage |
resistance.physical | number | Resistance to physical/impact damage |
resistance.plasma | number | Resistance to plasma damage |
Resistance values are decimals between 0 and 1 where 0.5 = 50% resistance. Only include the resistance types that make sense for your item.
Meta Fields
| Field | Type | Required | Description |
|---|
rarity | string | β
| "common", "uncommon", "rare", "epic", or "legendary" |
equipmentSlot | string or array | β
| Which slot(s) this item fits. Single string for one slot, array for multi-slot items. |
storeCategory | string | β
| Shop category ID. Must match a category in manifest.json. |
dungeon | string | β
| Must be "ground" for all personal equipment. |
Equipment Slots
| Slot ID | Holds |
|---|
pack_id:personal_helmet | Helmet |
pack_id:personal_suit | Suit / body armour |
pack_id:personal_gloves | Gloves |
pack_id:personal_boots | Boots |
pack_id:personal_backpack | Backpack |
pack_id:personal_weapons | Personal weapon |
pack_id:personal_accessory_1 β¦ _4 | Accessory slots |
Example β Defence Suit
{
"plating": {
"id": "stellar_forge:suit_reinforced",
"displayName": "items.materials.stellar_forge.suit.reinforced_suit",
"description": "items.materials.stellar_forge.suit.reinforced_suit.desc",
"texture": "stellar_forge/assets/textures/equipment/personal/suit/reinforced_suit.png",
"stats": {
"health": 40,
"defence.base": 12.0,
"defence.rating": 2.5,
"resistance.base": 0.2,
"resistance.physical": 0.3,
"resistance.heat": 0.15
},
"meta": {
"rarity": "uncommon",
"equipmentSlot": "stellar_forge:personal_suit",
"storeCategory": "stellar_forge:personal_equipment",
"dungeon": "ground"
}
}
}
Example β Attack Gloves
{
"plating": {
"id": "stellar_forge:gloves_combat",
"displayName": "items.materials.stellar_forge.gloves.combat_gloves",
"description": "items.materials.stellar_forge.gloves.combat_gloves.desc",
"texture": "stellar_forge/assets/textures/equipment/personal/gloves/combat_gloves.png",
"stats": {
"health": 5,
"attack.base": 8.0,
"attack.chance": 0.35,
"attack.rating": 0.6,
"penetration.base": 4.0,
"penetration.chance": 0.2,
"penetration.rating": 0.4
},
"meta": {
"rarity": "rare",
"equipmentSlot": "stellar_forge:personal_gloves",
"storeCategory": "stellar_forge:personal_equipment",
"dungeon": "ground"
}
}
}
Example β Backpack (uses armour root key) β All Stats
This example shows every available stat key in a single item. In practice only include what makes thematic sense.
{
"armour": {
"id": "stellar_forge:backpack_heavy",
"displayName": "items.materials.stellar_forge.backpack.heavy_backpack",
"description": "items.materials.stellar_forge.backpack.heavy_backpack.desc",
"texture": "stellar_forge/assets/textures/equipment/personal/backpacks/heavy_backpack.png",
"stats": {
"attack.base": 9.2, "attack.chance": 0.5, "attack.rating": 0.5,
"defence.base": 55.5, "defence.chance": 0.5, "defence.rating": 0.5,
"health": 50,
"penetration.base": 0.5, "penetration.chance": 0.5, "penetration.rating": 0.5,
"reflect.base": 0.5, "reflect.chance": 0.5, "reflect.rating": 0.5,
"resistance.base": 0.5, "resistance.cold": 0.5, "resistance.gamma": 0.5,
"resistance.heat": 0.5, "resistance.ion": 0.5, "resistance.physical": 0.5,
"resistance.plasma": 0.5
},
"meta": {
"rarity": "epic",
"equipmentSlot": "stellar_forge:personal_backpack",
"storeCategory": "stellar_forge:personal_equipment",
"dungeon": "ground"
}
}
}
Example β Multi-Slot Accessory
{
"plating": {
"id": "stellar_forge:accessory_cryo_ring",
"displayName": "items.materials.stellar_forge.accessory.cryo_ring",
"description": "items.materials.stellar_forge.accessory.cryo_ring.desc",
"texture": "stellar_forge/assets/textures/equipment/personal/accessory/cryo_ring.png",
"stats": {
"health": 8,
"resistance.cold": 0.4,
"resistance.gamma": 0.2,
"resistance.ion": 0.2
},
"meta": {
"rarity": "uncommon",
"equipmentSlot": [
"stellar_forge:personal_accessory_1",
"stellar_forge:personal_accessory_2",
"stellar_forge:personal_accessory_3",
"stellar_forge:personal_accessory_4"
],
"storeCategory": "stellar_forge:personal_equipment",
"dungeon": "ground"
}
}
}
Example β Personal Weapon
{
"plating": {
"id": "stellar_forge:weapon_plasma_pistol",
"displayName": "items.materials.stellar_forge.weapon.plasma_pistol",
"description": "items.materials.stellar_forge.weapon.plasma_pistol.desc",
"texture": "stellar_forge/assets/textures/equipment/personal/weapons/plasma_pistol.png",
"stats": {
"health": 5,
"attack.base": 18.0,
"attack.chance": 0.55,
"attack.rating": 0.8,
"penetration.base": 6.0,
"penetration.chance": 0.3,
"resistance.plasma": 0.1
},
"meta": {
"rarity": "rare",
"equipmentSlot": "stellar_forge:personal_weapons",
"storeCategory": "stellar_forge:personal_equipment",
"dungeon": "ground"
}
}
}