Ship equipment is gear mounted on the player spacecraft — controlling how it performs in space combat. This is distinct from Personal Equipment, which is worn in ground dungeons.
| Slot Type | Role |
|---|
| Hull | Outer plating; provides health and base defence |
| Shields | Energy barrier; absorbs damage before the hull takes hits |
| Engines | Powers the ship; contributes health to the engine system |
| Thrusters | Controls speed and agility |
| Weapons | Deals damage to enemy ships |
Files live in: <your_pack_id>/data/items/equipment/ship/<slot_type>/<item_name>.json
File Structure
{
"plating": {
"id": "...",
"displayName": "...",
"description": "...",
"texture": "...",
"stats": { },
"meta": {
"rarity": "common",
"equipmentSlot": "...",
"storeCategory": "...",
"dungeon": "space"
}
}
}
The key difference from personal equipment is "dungeon": "space" in meta. This tells the game this item is for space combat.
Stats by Slot Type
Hull
| Field | Description |
|---|
health | Flat HP added to the ship hull |
resistance.base | Base damage resistance (decimal). 0.1 = 10% reduction |
defence.rating | Defence rating score; reduces damage from strong attackers |
reflect.chance | Chance to reflect a portion of damage back to attackers |
Shields
| Field | Description |
|---|
health | Shield pool size — hit points the shield absorbs before breaking |
resistance.base | Resistance applied while shield is active |
defence.rating | Defence rating while shielded |
reflect.chance | Chance to reflect damage while shield is up |
Engines
| Field | Description |
|---|
health | Hit points of the engine system itself |
Thrusters
| Field | Description |
|---|
health | Hit points of the thruster |
defence.rating | Minor defence from thruster placement |
speed | Speed added to the ship movement |
Weapons
| Field | Description |
|---|
attack | Flat damage added to the ship attacks |
health | Hit points of the weapon hardpoint |
defence.rating | Minor defence from weapon placement |
Ship Equipment Slots
| Slot | Purpose | Multi-slot? |
|---|
pack_id:ship_hull | Ship hull plating | No |
pack_id:ship_shields | Ship energy shields | No |
pack_id:ship_engines | Ship engine | No |
pack_id:ship_weapon_1 / _2 | Weapon hardpoints | Yes — weapons fit multiple slots |
pack_id:ship_thruster_1 … _4 | Thruster slots | Yes — thrusters fit multiple slots |
Example — Hull Plating
{
"plating": {
"id": "stellar_forge:hull_composite_plating",
"displayName": "items.materials.stellar_forge.hull.composite_plating",
"description": "items.materials.stellar_forge.hull.composite_plating.desc",
"texture": "stellar_forge/assets/textures/equipment/ship/hulls/composite_plating.png",
"stats": {
"health": 80,
"resistance.base": 0.15,
"defence.rating": 3.5,
"reflect.chance": 0.08
},
"meta": {
"rarity": "uncommon",
"equipmentSlot": "stellar_forge:ship_hull",
"storeCategory": "stellar_forge:ship_equipment",
"dungeon": "space"
}
}
}
Example — Shields
{
"plating": {
"id": "stellar_forge:shield_phase_barrier",
"displayName": "items.materials.stellar_forge.shield.phase_barrier",
"description": "items.materials.stellar_forge.shield.phase_barrier.desc",
"texture": "stellar_forge/assets/textures/equipment/ship/shields/phase_barrier.png",
"stats": {
"health": 120,
"resistance.base": 0.5,
"defence.rating": 6.0,
"reflect.chance": 5.0
},
"meta": {
"rarity": "rare",
"equipmentSlot": "stellar_forge:ship_shields",
"storeCategory": "stellar_forge:ship_equipment",
"dungeon": "space"
}
}
}
Example — Thrusters (Multi-Slot)
{
"plating": {
"id": "stellar_forge:thruster_ion_booster",
"displayName": "items.materials.stellar_forge.thruster.ion_booster",
"description": "items.materials.stellar_forge.thruster.ion_booster.desc",
"texture": "stellar_forge/assets/textures/equipment/ship/thrusters/ion_booster.png",
"stats": {
"health": 25,
"defence.rating": 0.2,
"speed": 18.0
},
"meta": {
"rarity": "uncommon",
"equipmentSlot": [
"stellar_forge:ship_thruster_1",
"stellar_forge:ship_thruster_2",
"stellar_forge:ship_thruster_3",
"stellar_forge:ship_thruster_4"
],
"storeCategory": "stellar_forge:ship_equipment",
"dungeon": "space"
}
}
}
Example — Ship Weapon (Multi-Slot)
{
"plating": {
"id": "stellar_forge:weapon_railgun_mk1",
"displayName": "items.materials.stellar_forge.weapon.railgun_mk1",
"description": "items.materials.stellar_forge.weapon.railgun_mk1.desc",
"texture": "stellar_forge/assets/textures/equipment/ship/weapons/railgun_mk1.png",
"stats": {
"attack": 22.0,
"health": 15,
"defence.rating": 0.15
},
"meta": {
"rarity": "rare",
"equipmentSlot": [
"stellar_forge:ship_weapon_1",
"stellar_forge:ship_weapon_2"
],
"storeCategory": "stellar_forge:ship_equipment",
"dungeon": "space"
}
}
}
Balanced Mid-Game Loadout Guide
| Slot | Recommended Health | Key Stat |
|---|
| Hull | 60–120 | defence.rating |
| Shields | 80–150 | resistance.base + reflect.chance |
| Engine | 80–150 | health |
| Thruster ×2 | 20–40 each | speed |
| Weapon ×2 | 10–20 each | attack |