@shipload/sdk 0.7.1 → 1.0.0-next.0

package/src/data/entities.json

@@ -0,0 +1,50 @@
+[
+  {
+    "entityItemId": 10200,
+    "slots": []
+  },
+  {
+    "entityItemId": 10201,
+    "slots": [
+      {
+        "type": "any"
+      },
+      {
+        "type": "any"
+      },
+      {
+        "type": "any"
+      },
+      {
+        "type": "any"
+      },
+      {
+        "type": "any"
+      }
+    ]
+  },
+  {
+    "entityItemId": 10202,
+    "slots": [
+      {
+        "type": "loader"
+      },
+      {
+        "type": "storage"
+      },
+      {
+        "type": "storage"
+      },
+      {
+        "type": "storage"
+      },
+      {
+        "type": "storage"
+      }
+    ]
+  },
+  {
+    "entityItemId": 20200,
+    "slots": []
+  }
+]

package/src/data/item-ids.ts

@@ -0,0 +1,75 @@
+// Synced from game/build/catalog via `make sync-catalog` — do not edit.
+
+export const ITEM_ORE_T1 = 101
+export const ITEM_ORE_T2 = 102
+export const ITEM_ORE_T3 = 103
+export const ITEM_ORE_T4 = 104
+export const ITEM_ORE_T5 = 105
+export const ITEM_ORE_T6 = 106
+export const ITEM_ORE_T7 = 107
+export const ITEM_ORE_T8 = 108
+export const ITEM_ORE_T9 = 109
+export const ITEM_ORE_T10 = 110
+export const ITEM_CRYSTAL_T1 = 201
+export const ITEM_CRYSTAL_T2 = 202
+export const ITEM_CRYSTAL_T3 = 203
+export const ITEM_CRYSTAL_T4 = 204
+export const ITEM_CRYSTAL_T5 = 205
+export const ITEM_CRYSTAL_T6 = 206
+export const ITEM_CRYSTAL_T7 = 207
+export const ITEM_CRYSTAL_T8 = 208
+export const ITEM_CRYSTAL_T9 = 209
+export const ITEM_CRYSTAL_T10 = 210
+export const ITEM_GAS_T1 = 301
+export const ITEM_GAS_T2 = 302
+export const ITEM_GAS_T3 = 303
+export const ITEM_GAS_T4 = 304
+export const ITEM_GAS_T5 = 305
+export const ITEM_GAS_T6 = 306
+export const ITEM_GAS_T7 = 307
+export const ITEM_GAS_T8 = 308
+export const ITEM_GAS_T9 = 309
+export const ITEM_GAS_T10 = 310
+export const ITEM_REGOLITH_T1 = 401
+export const ITEM_REGOLITH_T2 = 402
+export const ITEM_REGOLITH_T3 = 403
+export const ITEM_REGOLITH_T4 = 404
+export const ITEM_REGOLITH_T5 = 405
+export const ITEM_REGOLITH_T6 = 406
+export const ITEM_REGOLITH_T7 = 407
+export const ITEM_REGOLITH_T8 = 408
+export const ITEM_REGOLITH_T9 = 409
+export const ITEM_REGOLITH_T10 = 410
+export const ITEM_BIOMASS_T1 = 501
+export const ITEM_BIOMASS_T2 = 502
+export const ITEM_BIOMASS_T3 = 503
+export const ITEM_BIOMASS_T4 = 504
+export const ITEM_BIOMASS_T5 = 505
+export const ITEM_BIOMASS_T6 = 506
+export const ITEM_BIOMASS_T7 = 507
+export const ITEM_BIOMASS_T8 = 508
+export const ITEM_BIOMASS_T9 = 509
+export const ITEM_BIOMASS_T10 = 510
+export const ITEM_HULL_PLATES = 10001
+export const ITEM_CARGO_LINING = 10002
+export const ITEM_THRUSTER_CORE = 10003
+export const ITEM_POWER_CELL = 10004
+export const ITEM_MATTER_CONDUIT = 10005
+export const ITEM_SURVEY_PROBE = 10006
+export const ITEM_CARGO_ARM = 10007
+export const ITEM_TOOL_BIT = 10008
+export const ITEM_REACTION_CHAMBER = 10009
+export const ITEM_FOCUSING_ARRAY = 10010
+export const ITEM_ENGINE_T1 = 10100
+export const ITEM_GENERATOR_T1 = 10101
+export const ITEM_GATHERER_T1 = 10102
+export const ITEM_LOADER_T1 = 10103
+export const ITEM_CRAFTER_T1 = 10104
+export const ITEM_STORAGE_T1 = 10105
+export const ITEM_HAULER_T1 = 10106
+export const ITEM_CONTAINER_T1_PACKED = 10200
+export const ITEM_SHIP_T1_PACKED = 10201
+export const ITEM_WAREHOUSE_T1_PACKED = 10202
+export const ITEM_HULL_PLATES_T2 = 20001
+export const ITEM_CARGO_LINING_T2 = 20002
+export const ITEM_CONTAINER_T2_PACKED = 20200

package/src/data/items.json

@@ -0,0 +1,252 @@
+[
+  {
+    "id": 101,
+    "mass": 52000,
+    "type": "resource",
+    "tier": 1,
+    "category": "ore"
+  },
+  {
+    "id": 102,
+    "mass": 58000,
+    "type": "resource",
+    "tier": 2,
+    "category": "ore"
+  },
+  {
+    "id": 103,
+    "mass": 64000,
+    "type": "resource",
+    "tier": 3,
+    "category": "ore"
+  },
+  {
+    "id": 201,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 1,
+    "category": "crystal"
+  },
+  {
+    "id": 202,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 2,
+    "category": "crystal"
+  },
+  {
+    "id": 203,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 3,
+    "category": "crystal"
+  },
+  {
+    "id": 301,
+    "mass": 15000,
+    "type": "resource",
+    "tier": 1,
+    "category": "gas"
+  },
+  {
+    "id": 302,
+    "mass": 13500,
+    "type": "resource",
+    "tier": 2,
+    "category": "gas"
+  },
+  {
+    "id": 303,
+    "mass": 12000,
+    "type": "resource",
+    "tier": 3,
+    "category": "gas"
+  },
+  {
+    "id": 401,
+    "mass": 22000,
+    "type": "resource",
+    "tier": 1,
+    "category": "regolith"
+  },
+  {
+    "id": 402,
+    "mass": 25000,
+    "type": "resource",
+    "tier": 2,
+    "category": "regolith"
+  },
+  {
+    "id": 403,
+    "mass": 28000,
+    "type": "resource",
+    "tier": 3,
+    "category": "regolith"
+  },
+  {
+    "id": 501,
+    "mass": 42000,
+    "type": "resource",
+    "tier": 1,
+    "category": "biomass"
+  },
+  {
+    "id": 502,
+    "mass": 37000,
+    "type": "resource",
+    "tier": 2,
+    "category": "biomass"
+  },
+  {
+    "id": 503,
+    "mass": 33000,
+    "type": "resource",
+    "tier": 3,
+    "category": "biomass"
+  },
+  {
+    "id": 10001,
+    "mass": 50000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10002,
+    "mass": 30000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10003,
+    "mass": 50000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10004,
+    "mass": 30000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10005,
+    "mass": 50000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10006,
+    "mass": 30000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10007,
+    "mass": 30000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10008,
+    "mass": 30000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10009,
+    "mass": 50000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10010,
+    "mass": 40000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10100,
+    "mass": 150000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "engine"
+  },
+  {
+    "id": 10101,
+    "mass": 75000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "generator"
+  },
+  {
+    "id": 10102,
+    "mass": 145000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "gatherer"
+  },
+  {
+    "id": 10103,
+    "mass": 90000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "loader"
+  },
+  {
+    "id": 10104,
+    "mass": 120000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "crafter"
+  },
+  {
+    "id": 10105,
+    "mass": 100000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "storage"
+  },
+  {
+    "id": 10106,
+    "mass": 120000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "hauler"
+  },
+  {
+    "id": 10200,
+    "mass": 80000,
+    "type": "entity",
+    "tier": 1
+  },
+  {
+    "id": 10201,
+    "mass": 100000,
+    "type": "entity",
+    "tier": 1
+  },
+  {
+    "id": 10202,
+    "mass": 1300000,
+    "type": "entity",
+    "tier": 1
+  },
+  {
+    "id": 20001,
+    "mass": 50000,
+    "type": "component",
+    "tier": 2
+  },
+  {
+    "id": 20002,
+    "mass": 30000,
+    "type": "component",
+    "tier": 2
+  },
+  {
+    "id": 20200,
+    "mass": 80000,
+    "type": "entity",
+    "tier": 2
+  }
+]

package/src/data/locations.ts

@@ -0,0 +1,53 @@
+export interface PlanetSubtypeInfo {
+    id: number
+    label: string
+    description: string
+    paletteType: string
+}
+
+const planetSubtypes: PlanetSubtypeInfo[] = [
+    {
+        id: 0,
+        label: 'Gas Giant',
+        description: 'Massive planets with thick atmospheres rich in gases',
+        paletteType: 'gasGiant',
+    },
+    {
+        id: 1,
+        label: 'Rocky',
+        description: 'Dense, mineral-rich worlds with metallic cores',
+        paletteType: 'rocky',
+    },
+    {
+        id: 2,
+        label: 'Terrestrial',
+        description: 'Earth-like planets with varied terrain and life potential',
+        paletteType: 'terrestrial',
+    },
+    {
+        id: 3,
+        label: 'Icy',
+        description: 'Frozen worlds with subsurface resources',
+        paletteType: 'ice',
+    },
+    {
+        id: 4,
+        label: 'Ocean',
+        description: 'Water worlds with dissolved minerals and organics',
+        paletteType: 'ocean',
+    },
+    {
+        id: 5,
+        label: 'Industrial',
+        description: 'Heavily processed worlds rich in refined materials',
+        paletteType: 'industrial',
+    },
+]
+
+export function getPlanetSubtypes(): PlanetSubtypeInfo[] {
+    return planetSubtypes
+}
+
+export function getPlanetSubtype(id: number): PlanetSubtypeInfo | undefined {
+    return planetSubtypes.find((s) => s.id === id)
+}

package/src/data/metadata.ts

@@ -0,0 +1,208 @@
+import items from './items.json'
+
+export interface ItemMetadata {
+    name: string
+    description: string
+    color: string
+}
+
+export interface EntityMetadata {
+    moduleSlotLabels?: string[]
+}
+
+export const itemMetadata: Record<number, ItemMetadata> = {
+    // === Resources (raw) ===
+    101: {name: 'Ore', description: 'Crude metallic ore.', color: '#C26D3F'},
+    102: {name: 'Ore', description: 'Refined metallic ore with improved purity.', color: '#C26D3F'},
+    103: {
+        name: 'Ore',
+        description: 'High-grade metallic ore with exceptional density.',
+        color: '#C26D3F',
+    },
+    201: {name: 'Crystal', description: 'Raw resonant crystal.', color: '#4ADBFF'},
+    202: {
+        name: 'Crystal',
+        description: 'Refined resonant crystal with improved clarity.',
+        color: '#4ADBFF',
+    },
+    203: {
+        name: 'Crystal',
+        description: 'High-grade resonant crystal with exceptional purity.',
+        color: '#4ADBFF',
+    },
+    301: {name: 'Gas', description: 'Raw volatile gas.', color: '#B8E4A0'},
+    302: {
+        name: 'Gas',
+        description: 'Refined volatile gas with improved reactivity.',
+        color: '#B8E4A0',
+    },
+    303: {
+        name: 'Gas',
+        description: 'High-grade volatile gas with exceptional energy density.',
+        color: '#B8E4A0',
+    },
+    401: {name: 'Regolith', description: 'Crude regolith dust.', color: '#C4A57B'},
+    402: {
+        name: 'Regolith',
+        description: 'Refined regolith with improved fineness.',
+        color: '#C4A57B',
+    },
+    403: {
+        name: 'Regolith',
+        description: 'High-grade regolith with exceptional uniformity.',
+        color: '#C4A57B',
+    },
+    501: {name: 'Biomass', description: 'Crude organic biomass.', color: '#5A8B3E'},
+    502: {
+        name: 'Biomass',
+        description: 'Refined biomass with improved plasticity.',
+        color: '#5A8B3E',
+    },
+    503: {
+        name: 'Biomass',
+        description: 'High-grade biomass with exceptional saturation.',
+        color: '#5A8B3E',
+    },
+
+    // === Components (T1) ===
+    10001: {
+        name: 'Hull Plates',
+        description: 'Structural plating formed from ore. Used in hulls, containers, and frames.',
+        color: '#7B8D9E',
+    },
+    10002: {
+        name: 'Cargo Lining',
+        description:
+            'Composite lining formed from fine regolith bound in biomass polymer. Dense enough to seal cargo holds, flexible enough to absorb vibration.',
+        color: '#C4A57B',
+    },
+    10003: {
+        name: 'Thruster Core',
+        description: 'High-energy propulsion component formed from volatile gases.',
+        color: '#E86344',
+    },
+    10004: {
+        name: 'Power Cell',
+        description:
+            'Crystalline energy storage matrix. Resonant lattices retain and release charge.',
+        color: '#4ADBFF',
+    },
+    10005: {
+        name: 'Matter Conduit',
+        description: 'Heavy-duty ore shaft used in gathering equipment.',
+        color: '#7B8D9E',
+    },
+    10006: {
+        name: 'Survey Probe',
+        description: 'Crystal-lattice sensor array for deep resource detection.',
+        color: '#4ADBFF',
+    },
+    10007: {
+        name: 'Cargo Arm',
+        description: 'Flexible biomass composite arm for cargo handling.',
+        color: '#5A8B3E',
+    },
+    10008: {
+        name: 'Tool Bit',
+        description: 'Dense regolith cutting head for crafting operations.',
+        color: '#C4A57B',
+    },
+    10009: {
+        name: 'Reaction Chamber',
+        description: 'Gas-pressurized vessel for controlled crafting reactions.',
+        color: '#B8E4A0',
+    },
+    10010: {
+        name: 'Focusing Array',
+        description:
+            "Precision-formed crystal lens array. Routes the haul beam's energy efficiently to the target lock.",
+        color: '#4ADBFF',
+    },
+
+    // === Modules (T1) ===
+    10100: {
+        name: 'Engine',
+        description: 'Basic propulsion system. Converts volatile gases into thrust.',
+        color: '#E86344',
+    },
+    10101: {
+        name: 'Generator',
+        description: 'Basic energy system. Stores and recharges energy from resonant crystals.',
+        color: '#4ADBFF',
+    },
+    10102: {
+        name: 'Gatherer',
+        description: 'Basic gathering system. Probes and conduits for raw resources.',
+        color: '#7B8D9E',
+    },
+    10103: {
+        name: 'Loader',
+        description: 'Basic cargo handling system. Loads and unloads cargo with articulated arms.',
+        color: '#5A8B3E',
+    },
+    10104: {
+        name: 'Crafter',
+        description:
+            'Basic crafting system. Processes materials using reaction chambers and cutting tools.',
+        color: '#B8E4A0',
+    },
+    10105: {
+        name: 'Storage',
+        description: 'Expands cargo capacity based on hull material quality.',
+        color: '#8B7355',
+    },
+    10106: {
+        name: 'Hauler',
+        description:
+            'Projects a haul beam to lock onto and transport containers or warehouses through group travel.',
+        color: '#4ADBFF',
+    },
+
+    // === Entities (packed, T1) ===
+    10200: {
+        name: 'Container',
+        description: 'Passive floating cargo storage in space. Towed by ships.',
+        color: '#7B8D9E',
+    },
+    10201: {
+        name: 'Ship',
+        description: 'General-purpose vessel with 5 module slots.',
+        color: '#4AE898',
+    },
+    10202: {
+        name: 'Warehouse',
+        description: 'Massive stationary storage facility with a single loader module slot.',
+        color: '#EAB308',
+    },
+
+    // === Components (T2) ===
+    20001: {
+        name: 'Hull Plates',
+        description: 'Advanced structural plating reinforced with tier 2 ore.',
+        color: '#9BADB8',
+    },
+    20002: {
+        name: 'Cargo Lining',
+        description:
+            'Advanced composite lining reinforced with tier 2 regolith and biomass polymer.',
+        color: '#C4A57B',
+    },
+
+    // === Entities (packed, T2) ===
+    20200: {
+        name: 'Container',
+        description: 'Advanced cargo container with improved capacity formulas.',
+        color: '#9BADB8',
+    },
+}
+
+export const entityMetadata: Record<number, EntityMetadata> = {
+    10201: {moduleSlotLabels: ['Engine', 'Generator', 'Gatherer', 'Loader', 'Storage']},
+    10202: {moduleSlotLabels: ['Loader', 'Storage', 'Storage', 'Storage', 'Storage']},
+}
+
+for (const item of items as Array<{id: number}>) {
+    if (!itemMetadata[item.id]) {
+        throw new Error(`Missing metadata for item ${item.id}. Add an entry to metadata.ts.`)
+    }
+}