@shipload/sdk 1.0.0-next.16 → 1.0.0-next.18

package/src/data/metadata.ts

@@ -109,56 +109,63 @@ export const itemMetadata: Record<number, ItemMetadata> = {
 
     // === Components (T1) ===
     10001: {
-        name: 'Hull Plates',
-        description: 'Structural plating formed from ore. Used in hulls, containers, and frames.',
+        name: 'Plate',
+        description:
+            'Structural plating formed from ore. Used in hulls, containers, and storage modules.',
         color: '#7B8D9E',
     },
     10002: {
-        name: 'Cargo Lining',
+        name: 'Frame',
         description:
-            'Composite lining formed from fine regolith bound in biomass polymer. Dense enough to seal cargo holds, flexible enough to absorb vibration.',
+            'Composite framing 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.',
+        name: 'Plasma Cell',
+        description:
+            'High-energy gaseous storage cell. Volatile gas held under controlled thermal conditions.',
         color: '#E86344',
     },
     10004: {
-        name: 'Power Cell',
+        name: 'Resonator',
         description:
-            'Crystalline energy storage matrix. Resonant lattices retain and release charge.',
+            'Crystalline resonance lattice. Stores and releases charge through coherent oscillation.',
         color: '#4ADBFF',
     },
     10005: {
-        name: 'Matter Conduit',
-        description: 'Heavy-duty ore shaft used in gathering equipment.',
+        name: 'Beam',
+        description:
+            'Heavy-duty structural beam machined from refined ore. Strong enough to bear load, tolerant enough to survive harsh environments.',
         color: '#7B8D9E',
     },
     10006: {
-        name: 'Survey Probe',
-        description: 'Crystal-lattice sensor array for deep resource detection.',
+        name: 'Sensor',
+        description:
+            'Crystal-lattice sensing element with conductive and reflective properties. Reads signal and surface alike.',
         color: '#4ADBFF',
     },
     10007: {
-        name: 'Cargo Arm',
-        description: 'Flexible biomass composite arm for cargo handling.',
+        name: 'Polymer',
+        description:
+            'Pliable biomass-derived polymer with high insulation. Flexible, durable, electrically inert.',
         color: '#5A8B3E',
     },
     10008: {
-        name: 'Tool Bit',
-        description: 'Dense regolith cutting head for crafting operations.',
+        name: 'Ceramic',
+        description:
+            'Hardened fine-grained ceramic refined from regolith. Hard enough to cut, fine enough to finish.',
         color: '#C4A57B',
     },
     10009: {
-        name: 'Reaction Chamber',
-        description: 'Gas-pressurized vessel for controlled crafting reactions.',
+        name: 'Reactor',
+        description:
+            'Gas-pressurized vessel for controlled reactions. Vents heat and contains volatility.',
         color: '#B8E4A0',
     },
     10010: {
-        name: 'Focusing Array',
+        name: 'Emitter',
         description:
-            "Precision-formed crystal lens array. Routes the haul beam's energy efficiently to the target lock.",
+            'Precision-formed crystal emitter array. Routes energy efficiently to a target lock.',
         color: '#4ADBFF',
     },
 
@@ -206,6 +213,12 @@ export const itemMetadata: Record<number, ItemMetadata> = {
             'Folds local space-time around the hull, projecting the ship across vast distances in a single discharge of the entire energy reserve.',
         color: '#9be4ff',
     },
+    10108: {
+        name: 'Battery',
+        description:
+            'Extends energy capacity. Stores additional charge produced by generators, letting builds chain more high-drain actions between recharges.',
+        color: '#4ADBFF',
+    },
 
     // === Entities (packed, T1) ===
     10200: {
@@ -237,14 +250,14 @@ export const itemMetadata: Record<number, ItemMetadata> = {
 
     // === Components (T2) ===
     20001: {
-        name: 'Hull Plates',
+        name: 'Plate',
         description: 'Advanced structural plating reinforced with tier 2 ore.',
         color: '#9BADB8',
     },
     20002: {
-        name: 'Cargo Lining',
+        name: 'Frame',
         description:
-            'Advanced composite lining reinforced with tier 2 regolith and biomass polymer.',
+            'Advanced composite framing reinforced with tier 2 regolith and biomass polymer.',
         color: '#C4A57B',
     },
 

package/src/data/recipes.json

@@ -1,12 +1,12 @@
 [
   {
     "outputItemId": 10001,
-    "outputMass": 50000,
+    "outputMass": 420000,
     "inputs": [
       {
         "category": "ore",
         "tier": 1,
-        "quantity": 15
+        "quantity": 20
       }
     ],
     "statSlots": [
@@ -31,12 +31,12 @@
   },
   {
     "outputItemId": 10002,
-    "outputMass": 30000,
+    "outputMass": 600000,
     "inputs": [
       {
         "category": "regolith",
         "tier": 1,
-        "quantity": 10
+        "quantity": 30
       },
       {
         "category": "biomass",
@@ -66,12 +66,12 @@
   },
   {
     "outputItemId": 10003,
-    "outputMass": 50000,
+    "outputMass": 390000,
     "inputs": [
       {
         "category": "gas",
         "tier": 1,
-        "quantity": 32
+        "quantity": 65
       }
     ],
     "statSlots": [
@@ -96,12 +96,17 @@
   },
   {
     "outputItemId": 10004,
-    "outputMass": 30000,
+    "outputMass": 600000,
     "inputs": [
       {
         "category": "crystal",
         "tier": 1,
-        "quantity": 20
+        "quantity": 25
+      },
+      {
+        "category": "biomass",
+        "tier": 1,
+        "quantity": 15
       }
     ],
     "statSlots": [
@@ -126,12 +131,17 @@
   },
   {
     "outputItemId": 10005,
-    "outputMass": 50000,
+    "outputMass": 600000,
     "inputs": [
       {
         "category": "ore",
         "tier": 1,
-        "quantity": 15
+        "quantity": 20
+      },
+      {
+        "category": "gas",
+        "tier": 1,
+        "quantity": 30
       }
     ],
     "statSlots": [
@@ -156,12 +166,12 @@
   },
   {
     "outputItemId": 10006,
-    "outputMass": 30000,
+    "outputMass": 420000,
     "inputs": [
       {
         "category": "crystal",
         "tier": 1,
-        "quantity": 10
+        "quantity": 30
       }
     ],
     "statSlots": [
@@ -186,12 +196,12 @@
   },
   {
     "outputItemId": 10007,
-    "outputMass": 30000,
+    "outputMass": 420000,
     "inputs": [
       {
         "category": "biomass",
         "tier": 1,
-        "quantity": 32
+        "quantity": 25
       }
     ],
     "statSlots": [
@@ -216,12 +226,12 @@
   },
   {
     "outputItemId": 10008,
-    "outputMass": 30000,
+    "outputMass": 400000,
     "inputs": [
       {
         "category": "regolith",
         "tier": 1,
-        "quantity": 20
+        "quantity": 45
       }
     ],
     "statSlots": [
@@ -246,12 +256,17 @@
   },
   {
     "outputItemId": 10009,
-    "outputMass": 50000,
+    "outputMass": 590000,
     "inputs": [
       {
         "category": "gas",
         "tier": 1,
-        "quantity": 32
+        "quantity": 40
+      },
+      {
+        "category": "regolith",
+        "tier": 1,
+        "quantity": 40
       }
     ],
     "statSlots": [
@@ -276,12 +291,17 @@
   },
   {
     "outputItemId": 10010,
-    "outputMass": 40000,
+    "outputMass": 590000,
     "inputs": [
       {
         "category": "crystal",
         "tier": 1,
-        "quantity": 25
+        "quantity": 20
+      },
+      {
+        "category": "ore",
+        "tier": 1,
+        "quantity": 15
       }
     ],
     "statSlots": [
@@ -306,7 +326,7 @@
   },
   {
     "outputItemId": 10100,
-    "outputMass": 150000,
+    "outputMass": 940000,
     "inputs": [
       {
         "itemId": 10003,
@@ -335,11 +355,11 @@
   },
   {
     "outputItemId": 10101,
-    "outputMass": 75000,
+    "outputMass": 1440000,
     "inputs": [
       {
         "itemId": 10004,
-        "quantity": 5
+        "quantity": 6
       }
     ],
     "statSlots": [
@@ -364,11 +384,11 @@
   },
   {
     "outputItemId": 10102,
-    "outputMass": 145000,
+    "outputMass": 1220000,
     "inputs": [
       {
         "itemId": 10005,
-        "quantity": 4
+        "quantity": 3
       },
       {
         "itemId": 10006,
@@ -416,22 +436,18 @@
   },
   {
     "outputItemId": 10103,
-    "outputMass": 90000,
+    "outputMass": 1010000,
     "inputs": [
-      {
-        "itemId": 10002,
-        "quantity": 3
-      },
       {
         "itemId": 10007,
-        "quantity": 3
+        "quantity": 6
       }
     ],
     "statSlots": [
       {
         "sources": [
           {
-            "inputIndex": 1,
+            "inputIndex": 0,
             "statIndex": 1
           }
         ]
@@ -439,7 +455,7 @@
       {
         "sources": [
           {
-            "inputIndex": 1,
+            "inputIndex": 0,
             "statIndex": 0
           }
         ]
@@ -449,7 +465,7 @@
   },
   {
     "outputItemId": 10104,
-    "outputMass": 120000,
+    "outputMass": 1190000,
     "inputs": [
       {
         "itemId": 10008,
@@ -482,15 +498,15 @@
   },
   {
     "outputItemId": 10105,
-    "outputMass": 100000,
+    "outputMass": 1220000,
     "inputs": [
       {
         "itemId": 10001,
-        "quantity": 8
+        "quantity": 3
       },
       {
         "itemId": 10002,
-        "quantity": 4
+        "quantity": 3
       }
     ],
     "statSlots": [
@@ -531,7 +547,7 @@
   },
   {
     "outputItemId": 10106,
-    "outputMass": 120000,
+    "outputMass": 1430000,
     "inputs": [
       {
         "itemId": 10004,
@@ -575,15 +591,15 @@
   },
   {
     "outputItemId": 10107,
-    "outputMass": 180000,
+    "outputMass": 1420000,
     "inputs": [
       {
         "itemId": 10010,
-        "quantity": 6
+        "quantity": 3
       },
       {
         "itemId": 10009,
-        "quantity": 4
+        "quantity": 3
       }
     ],
     "statSlots": [
@@ -605,9 +621,58 @@
       1
     ]
   },
+  {
+    "outputItemId": 10108,
+    "outputMass": 970000,
+    "inputs": [
+      {
+        "itemId": 10003,
+        "quantity": 3
+      },
+      {
+        "itemId": 10007,
+        "quantity": 3
+      }
+    ],
+    "statSlots": [
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 0
+          }
+        ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 1
+          }
+        ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 1,
+            "statIndex": 0
+          }
+        ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 1,
+            "statIndex": 1
+          }
+        ]
+      }
+    ],
+    "blendWeights": []
+  },
   {
     "outputItemId": 10200,
-    "outputMass": 80000,
+    "outputMass": 1490000,
     "inputs": [
       {
         "itemId": 10001,
@@ -656,7 +721,7 @@
   },
   {
     "outputItemId": 10201,
-    "outputMass": 100000,
+    "outputMass": 2300000,
     "inputs": [
       {
         "itemId": 10001,
@@ -705,7 +770,7 @@
   },
   {
     "outputItemId": 10202,
-    "outputMass": 1300000,
+    "outputMass": 5760000,
     "inputs": [
       {
         "itemId": 10001,
@@ -754,7 +819,7 @@
   },
   {
     "outputItemId": 10203,
-    "outputMass": 800000,
+    "outputMass": 4440000,
     "inputs": [
       {
         "itemId": 10001,
@@ -803,7 +868,7 @@
   },
   {
     "outputItemId": 10204,
-    "outputMass": 800000,
+    "outputMass": 5540000,
     "inputs": [
       {
         "itemId": 10001,

package/src/derivation/capabilities.ts

@@ -75,18 +75,15 @@ export function computeGathererCapabilities(
     yield: number
     drain: number
     depth: number
-    speed: number
 } {
     const str = stats.strength
     const con = stats.conductivity
-    const ref = stats.reflectivity
     const tol = stats.tolerance
 
     return {
         yield: 200 + str,
         drain: Math.max(250, 1250 - Math.floor((con * 25) / 20)),
         depth: gathererDepthForTier(tol, tier),
-        speed: 100 + Math.floor((ref * 4) / 5),
     }
 }
 
@@ -163,6 +160,7 @@ import {
 } from '../data/item-ids'
 import {
     getModuleCapabilityType,
+    MODULE_BATTERY,
     MODULE_ENGINE,
     MODULE_GENERATOR,
     MODULE_GATHERER,
@@ -222,7 +220,7 @@ export interface ComputedCapabilities {
     capacity: number
     engines?: {thrust: number; drain: number}
     generator?: {capacity: number; recharge: number}
-    gatherer?: {yield: number; drain: number; depth: number; speed: number}
+    gatherer?: {yield: number; drain: number; depth: number}
     loaders?: {mass: number; thrust: number; quantity: number}
     crafter?: {speed: number; drain: number}
     hauler?: {capacity: number; efficiency: number; drain: number}
@@ -251,7 +249,6 @@ export function computeEntityCapabilities(
     let totalGathYield = 0
     let totalGathDrain = 0
     let maxGathDepth = 0
-    let totalGathSpeed = 0
     let hasGatherer = false
 
     let totalStorageBonus = 0
@@ -270,6 +267,9 @@ export function computeEntityCapabilities(
     let totalWarpRange = 0
     let hasWarp = false
 
+    let totalBatteryStatSum = 0
+    let batteryCount = 0
+
     for (const mod of modules) {
         const item = getItem(mod.itemId)
         const modType = getModuleCapabilityType(mod.itemId)
@@ -294,7 +294,6 @@ export function computeEntityCapabilities(
             totalGathYield += applySlotMultiplier(caps.yield, amp)
             totalGathDrain += caps.drain
             if (caps.depth > maxGathDepth) maxGathDepth = caps.depth
-            totalGathSpeed += applySlotMultiplier(caps.speed, amp)
         } else if (modType === MODULE_LOADER) {
             hasLoader = true
             const caps = computeLoaderCapabilities(decodedStats)
@@ -320,9 +319,22 @@ export function computeEntityCapabilities(
             hasWarp = true
             const caps = computeWarpCapabilities(decodedStats)
             totalWarpRange += applySlotMultiplier(caps.range, amp)
+        } else if (modType === MODULE_BATTERY) {
+            batteryCount++
+            const vol = decodedStats.volatility ?? 0
+            const thm = decodedStats.thermal ?? 0
+            const pla = decodedStats.plasticity ?? 0
+            const ins = decodedStats.insulation ?? 0
+            totalBatteryStatSum += vol + thm + pla + ins
         }
     }
 
+    if (hasGenerator && batteryCount > 0) {
+        const genCapBase = totalGenCapacity
+        const bonusPctNum = 10 * batteryCount + Math.floor((totalBatteryStatSum * 10) / 2997)
+        totalGenCapacity += Math.floor((genCapBase * bonusPctNum) / 100)
+    }
+
     const result: ComputedCapabilities = {
         hullmass: computeBaseHullmass(stats) + installedModuleMass,
         capacity: baseCapacity + totalStorageBonus,
@@ -342,7 +354,6 @@ export function computeEntityCapabilities(
             yield: clampUint16(totalGathYield),
             drain: totalGathDrain,
             depth: maxGathDepth,
-            speed: clampUint16(totalGathSpeed),
         }
     }
     if (hasLoader) {

package/src/derivation/capability-mappings.ts

@@ -16,6 +16,7 @@ import {
     ITEM_STORAGE_T1,
     ITEM_HAULER_T1,
     ITEM_WARP_T1,
+    ITEM_BATTERY_T1,
     ITEM_SHIP_T1_PACKED,
     ITEM_CONTAINER_T1_PACKED,
     ITEM_WAREHOUSE_T1_PACKED,
@@ -32,6 +33,7 @@ export const KIND_TO_ITEM_ID: Record<SlotConsumerKind, number> = {
     storage: ITEM_STORAGE_T1,
     hauler: ITEM_HAULER_T1,
     warp: ITEM_WARP_T1,
+    battery: ITEM_BATTERY_T1,
     'ship-t1': ITEM_SHIP_T1_PACKED,
     'container-t1': ITEM_CONTAINER_T1_PACKED,
     'warehouse-t1': ITEM_WAREHOUSE_T1_PACKED,

package/src/derivation/index.ts

@@ -17,7 +17,9 @@ export {
     DEPTH_THRESHOLD_T5,
     LOCATION_MIN_DEPTH,
     LOCATION_MAX_DEPTH,
-    YIELD_THRESHOLD,
+    yieldThresholdAt,
+    YIELD_FRACTION_SHALLOW,
+    YIELD_FRACTION_DEEP,
     PLANET_SUBTYPE_GAS_GIANT,
     PLANET_SUBTYPE_ROCKY,
     PLANET_SUBTYPE_TERRESTRIAL,
@@ -26,8 +28,11 @@ export {
     PLANET_SUBTYPE_INDUSTRIAL,
 } from './resources'
 
-export {RESERVE_TIERS, TIER_ROLL_MAX, rollTier, rollWithinTier} from './tiers'
+export {RESERVE_TIERS, TIER_ROLL_MAX, tierOfReserve, rollTier, rollWithinTier} from './tiers'
 export type {ReserveTier, TierRange} from './tiers'
 
+export {getEffectiveReserve} from './reserve-regen'
+export type {EffectiveReserveInput} from './reserve-regen'
+
 export * from './stats'
 export * from './crafting'

package/src/derivation/reserve-regen.ts

@@ -0,0 +1,34 @@
+import type {BlockTimestamp, UInt32} from '@wharfkit/antelope'
+
+export interface EffectiveReserveInput {
+    remaining: UInt32 | number
+    max_reserve: UInt32 | number
+    last_block: BlockTimestamp
+}
+
+function toNumber(value: UInt32 | number): number {
+    return typeof value === 'number' ? value : Number(value)
+}
+
+function slotsBetween(now: BlockTimestamp, last: BlockTimestamp): number {
+    const nowMs = now.toMilliseconds()
+    const lastMs = last.toMilliseconds()
+    if (nowMs <= lastMs) return 0
+    return Math.floor((nowMs - lastMs) / 500)
+}
+
+export function getEffectiveReserve(
+    row: EffectiveReserveInput,
+    now: BlockTimestamp,
+    epochSeconds: number
+): number {
+    const remaining = toNumber(row.remaining)
+    const max = toNumber(row.max_reserve)
+    if (remaining >= max) return max
+    const epochSlots = epochSeconds * 2
+    if (epochSlots === 0) return remaining
+    const elapsed = slotsBetween(now, row.last_block)
+    const regen = Math.floor((max * elapsed) / epochSlots)
+    const effective = remaining + regen
+    return effective >= max ? max : effective
+}

package/src/derivation/resources.ts

@@ -15,7 +15,15 @@ export const DEPTH_THRESHOLD_T10 = 63000
 export const LOCATION_MIN_DEPTH = 500
 export const LOCATION_MAX_DEPTH = 65535
 
-export const YIELD_THRESHOLD = Math.floor(0.001 * 0xffffffff)
+export const YIELD_FRACTION_SHALLOW = 0.0025
+export const YIELD_FRACTION_DEEP = 0.0005
+
+export function yieldThresholdAt(stratum: number): number {
+    const clamped = stratum > 65535 ? 65535 : stratum
+    const t = clamped / 65535
+    const fraction = YIELD_FRACTION_SHALLOW + (YIELD_FRACTION_DEEP - YIELD_FRACTION_SHALLOW) * t
+    return Math.floor(fraction * 0xffffffff)
+}
 
 export const PLANET_SUBTYPE_GAS_GIANT = 0
 export const PLANET_SUBTYPE_ROCKY = 1