@shipload/sdk 2.0.0-rc13 → 2.0.0-rc15

package/src/data/recipes.ts

@@ -96,39 +96,39 @@ export const components: ComponentDefinition[] = [
     {
         id: ITEM_HULL_PLATES,
         name: 'Hull Plates',
-        description: 'Structural plating formed from metal. Used in hulls, containers, and frames.',
+        description: 'Structural plating formed from ore. Used in hulls, containers, and frames.',
         color: '#7B8D9E',
         mass: 50000,
         stats: [
-            {key: 'strength', source: 'metal'},
-            {key: 'density', source: 'metal'},
+            {key: 'strength', source: 'ore'},
+            {key: 'density', source: 'ore'},
         ],
-        recipe: [{category: 'metal', quantity: 15}],
+        recipe: [{category: 'ore', quantity: 15}],
         usedIn: [
             {type: 'entity', name: 'Container'},
-            {type: 'entity', name: 'Warehouse T1'},
-            {type: 'entity', name: 'Ship T1'},
+            {type: 'entity', name: 'Warehouse'},
+            {type: 'entity', name: 'Ship'},
         ],
     },
     {
         id: ITEM_CARGO_LINING,
         name: 'Cargo Lining',
         description:
-            'Precision-formed composite lining for cargo storage. Combines precious metal shaping with organic sealing.',
-        color: '#D4A843',
+            'Composite lining formed from fine regolith bound in biomass polymer. Dense enough to seal cargo holds, flexible enough to absorb vibration.',
+        color: '#C4A57B',
         mass: 30000,
         stats: [
-            {key: 'ductility', source: 'precious'},
-            {key: 'purity', source: 'organic'},
+            {key: 'fineness', source: 'regolith'},
+            {key: 'saturation', source: 'biomass'},
         ],
         recipe: [
-            {category: 'precious', quantity: 6},
-            {category: 'organic', quantity: 14},
+            {category: 'regolith' as ResourceCategory, quantity: 10},
+            {category: 'biomass' as ResourceCategory, quantity: 20},
         ],
         usedIn: [
             {type: 'entity', name: 'Container'},
-            {type: 'entity', name: 'Warehouse T1'},
-            {type: 'entity', name: 'Ship T1'},
+            {type: 'module', name: 'Loader'},
+            {type: 'module', name: 'Storage'},
         ],
     },
     {
@@ -147,73 +147,76 @@ export const components: ComponentDefinition[] = [
     {
         id: ITEM_POWER_CELL,
         name: 'Power Cell',
-        description: 'Crystalline energy storage matrix formed from resonant minerals.',
-        color: '#7B5AE8',
+        description: 'Crystalline energy storage matrix. Resonant lattices retain and release charge.',
+        color: '#4ADBFF',
         mass: 30000,
         stats: [
-            {key: 'resonance', source: 'mineral'},
-            {key: 'clarity', source: 'mineral'},
+            {key: 'resonance', source: 'crystal'},
+            {key: 'reflectivity', source: 'crystal'},
+        ],
+        recipe: [{category: 'crystal' as ResourceCategory, quantity: 20}],
+        usedIn: [
+            {type: 'module', name: 'Generator'},
+            {type: 'module', name: 'Hauler'},
         ],
-        recipe: [{category: 'mineral' as ResourceCategory, quantity: 20}],
-        usedIn: [{type: 'module', name: 'Generator'}],
     },
     {
         id: ITEM_MATTER_CONDUIT,
         name: 'Matter Conduit',
-        description: 'Heavy-duty metal shaft used in gathering equipment.',
+        description: 'Heavy-duty ore shaft used in gathering equipment.',
         color: '#7B8D9E',
         mass: 50000,
         stats: [
-            {key: 'strength', source: 'metal'},
-            {key: 'tolerance', source: 'metal'},
+            {key: 'strength', source: 'ore'},
+            {key: 'tolerance', source: 'ore'},
         ],
-        recipe: [{category: 'metal' as ResourceCategory, quantity: 15}],
+        recipe: [{category: 'ore' as ResourceCategory, quantity: 15}],
         usedIn: [{type: 'module', name: 'Gatherer'}],
     },
     {
         id: ITEM_SURVEY_PROBE,
         name: 'Survey Probe',
-        description: 'Precious metal sensor array for deep resource detection.',
-        color: '#D4A843',
+        description: 'Crystal-lattice sensor array for deep resource detection.',
+        color: '#4ADBFF',
         mass: 30000,
         stats: [
-            {key: 'conductivity', source: 'precious'},
-            {key: 'reflectivity', source: 'precious'},
+            {key: 'conductivity', source: 'crystal'},
+            {key: 'reflectivity', source: 'crystal'},
         ],
-        recipe: [{category: 'precious' as ResourceCategory, quantity: 10}],
+        recipe: [{category: 'crystal' as ResourceCategory, quantity: 10}],
         usedIn: [{type: 'module', name: 'Gatherer'}],
     },
     {
         id: ITEM_CARGO_ARM,
         name: 'Cargo Arm',
-        description: 'Flexible organic composite arm for cargo handling.',
-        color: '#6B8E5A',
+        description: 'Flexible biomass composite arm for cargo handling.',
+        color: '#5A8B3E',
         mass: 30000,
         stats: [
-            {key: 'plasticity', source: 'organic'},
-            {key: 'insulation', source: 'organic'},
+            {key: 'plasticity', source: 'biomass'},
+            {key: 'insulation', source: 'biomass'},
         ],
-        recipe: [{category: 'organic' as ResourceCategory, quantity: 32}],
+        recipe: [{category: 'biomass' as ResourceCategory, quantity: 32}],
         usedIn: [{type: 'module', name: 'Loader'}],
     },
     {
         id: ITEM_TOOL_BIT,
         name: 'Tool Bit',
-        description: 'Dense mineral cutting head for manufacturing operations.',
-        color: '#B8A9C9',
+        description: 'Dense regolith cutting head for manufacturing operations.',
+        color: '#C4A57B',
         mass: 30000,
         stats: [
-            {key: 'hardness', source: 'mineral'},
-            {key: 'clarity', source: 'mineral'},
+            {key: 'hardness', source: 'regolith'},
+            {key: 'composition', source: 'regolith'},
         ],
-        recipe: [{category: 'mineral' as ResourceCategory, quantity: 20}],
+        recipe: [{category: 'regolith' as ResourceCategory, quantity: 20}],
         usedIn: [{type: 'module', name: 'Manufacturing'}],
     },
     {
         id: ITEM_REACTION_CHAMBER,
         name: 'Reaction Chamber',
         description: 'Gas-pressurized vessel for controlled manufacturing reactions.',
-        color: '#7EC8E3',
+        color: '#B8E4A0',
         mass: 50000,
         stats: [
             {key: 'reactivity', source: 'gas'},
@@ -226,48 +229,48 @@ export const components: ComponentDefinition[] = [
         id: ITEM_FOCUSING_ARRAY,
         name: 'Focusing Array',
         description:
-            "Precision-formed precious-metal lens array. Routes the haul beam's energy efficiently to the target lock.",
-        color: '#D4A843',
+            "Precision-formed crystal lens array. Routes the haul beam's energy efficiently to the target lock.",
+        color: '#4ADBFF',
         mass: 40000,
         stats: [
-            {key: 'conductivity', source: 'precious'},
-            {key: 'ductility', source: 'precious'},
+            {key: 'conductivity', source: 'crystal'},
+            {key: 'resonance', source: 'crystal'},
         ],
-        recipe: [{category: 'precious' as ResourceCategory, quantity: 25}],
-        usedIn: [{type: 'module', name: 'Hauler Module T1'}],
+        recipe: [{category: 'crystal' as ResourceCategory, quantity: 25}],
+        usedIn: [{type: 'module', name: 'Hauler'}],
     },
     {
         id: ITEM_HULL_PLATES_T2,
         name: 'Hull Plates T2',
-        description: 'Advanced structural plating reinforced with tier 2 metals.',
+        description: 'Advanced structural plating reinforced with tier 2 ore.',
         color: '#9BADB8',
         mass: 50000,
         stats: [
-            {key: 'strength', source: 'metal'},
-            {key: 'density', source: 'metal'},
+            {key: 'strength', source: 'ore'},
+            {key: 'density', source: 'ore'},
         ],
         recipe: [
             {itemId: ITEM_HULL_PLATES, quantity: 2},
-            {category: 'metal', quantity: 15},
+            {category: 'ore', quantity: 15},
         ],
-        usedIn: [{type: 'entity', name: 'Container T2'}],
+        usedIn: [{type: 'entity', name: 'Container'}],
     },
     {
         id: ITEM_CARGO_LINING_T2,
-        name: 'Cargo Lining T2',
-        description: 'Advanced composite lining with improved storage properties.',
-        color: '#E0B84D',
-        mass: 30000,
+        name: 'Cargo Lining',
+        description: 'Advanced composite lining reinforced with tier 2 regolith and biomass polymer.',
+        color: '#C4A57B',
+        mass: 45000,
         stats: [
-            {key: 'ductility', source: 'precious'},
-            {key: 'purity', source: 'organic'},
+            {key: 'fineness', source: 'regolith'},
+            {key: 'saturation', source: 'biomass'},
         ],
         recipe: [
             {itemId: ITEM_CARGO_LINING, quantity: 2},
-            {category: 'precious', quantity: 6},
-            {category: 'organic', quantity: 14},
+            {category: 'regolith' as ResourceCategory, quantity: 5},
+            {category: 'biomass' as ResourceCategory, quantity: 10},
         ],
-        usedIn: [{type: 'entity', name: 'Container T2'}],
+        usedIn: [{type: 'entity', name: 'Container'}],
     },
 ]
 
@@ -285,13 +288,13 @@ export const entityRecipes: EntityRecipe[] = [
         stats: [
             {key: 'strength', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'strength'},
             {key: 'density', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'density'},
-            {key: 'ductility', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'ductility'},
-            {key: 'purity', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'purity'},
+            {key: 'fineness', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'fineness'},
+            {key: 'saturation', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'saturation'},
         ],
     },
     {
         id: 'ship-t1',
-        name: 'Ship T1',
+        name: 'Ship',
         description: 'General-purpose vessel with 5 module slots.',
         color: '#4AE898',
         packedItemId: ITEM_SHIP_T1_PACKED,
@@ -302,8 +305,8 @@ export const entityRecipes: EntityRecipe[] = [
         stats: [
             {key: 'strength', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'strength'},
             {key: 'density', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'density'},
-            {key: 'ductility', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'ductility'},
-            {key: 'purity', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'purity'},
+            {key: 'fineness', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'fineness'},
+            {key: 'saturation', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'saturation'},
         ],
         moduleSlots: [
             {type: MODULE_ANY},
@@ -315,7 +318,7 @@ export const entityRecipes: EntityRecipe[] = [
     },
     {
         id: 'warehouse-t1',
-        name: 'Warehouse T1',
+        name: 'Warehouse',
         description: 'Massive stationary storage facility with a single loader module slot.',
         color: '#EAB308',
         packedItemId: ITEM_WAREHOUSE_T1_PACKED,
@@ -326,8 +329,8 @@ export const entityRecipes: EntityRecipe[] = [
         stats: [
             {key: 'strength', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'strength'},
             {key: 'density', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'density'},
-            {key: 'ductility', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'ductility'},
-            {key: 'purity', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'purity'},
+            {key: 'fineness', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'fineness'},
+            {key: 'saturation', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'saturation'},
         ],
         moduleSlots: [
             {type: MODULE_LOADER, label: 'Loader'},
@@ -339,7 +342,7 @@ export const entityRecipes: EntityRecipe[] = [
     },
     {
         id: 'container-t2',
-        name: 'Container T2',
+        name: 'Container',
         description: 'Advanced cargo container with improved capacity formulas.',
         color: '#9BADB8',
         packedItemId: ITEM_CONTAINER_T2_PACKED,
@@ -350,8 +353,12 @@ export const entityRecipes: EntityRecipe[] = [
         stats: [
             {key: 'strength', sourceComponentId: ITEM_HULL_PLATES_T2, sourceStatKey: 'strength'},
             {key: 'density', sourceComponentId: ITEM_HULL_PLATES_T2, sourceStatKey: 'density'},
-            {key: 'ductility', sourceComponentId: ITEM_CARGO_LINING_T2, sourceStatKey: 'ductility'},
-            {key: 'purity', sourceComponentId: ITEM_CARGO_LINING_T2, sourceStatKey: 'purity'},
+            {key: 'fineness', sourceComponentId: ITEM_CARGO_LINING_T2, sourceStatKey: 'fineness'},
+            {
+                key: 'saturation',
+                sourceComponentId: ITEM_CARGO_LINING_T2,
+                sourceStatKey: 'saturation',
+            },
         ],
     },
 ]
@@ -384,14 +391,14 @@ export const moduleRecipes: ModuleRecipe[] = [
     {
         id: 'generator-t1',
         name: 'Generator',
-        description: 'Basic energy system. Stores and recharges energy from resonant minerals.',
-        color: '#7B5AE8',
+        description: 'Basic energy system. Stores and recharges energy from resonant crystals.',
+        color: '#4ADBFF',
         itemId: ITEM_GENERATOR_T1,
         moduleType: MODULE_GENERATOR,
         recipe: [{itemId: ITEM_POWER_CELL, quantity: 5}],
         stats: [
             {key: 'resonance', sourceComponentId: ITEM_POWER_CELL, sourceStatKey: 'resonance'},
-            {key: 'clarity', sourceComponentId: ITEM_POWER_CELL, sourceStatKey: 'clarity'},
+            {key: 'reflectivity', sourceComponentId: ITEM_POWER_CELL, sourceStatKey: 'reflectivity'},
         ],
     },
     {
@@ -429,7 +436,7 @@ export const moduleRecipes: ModuleRecipe[] = [
         id: 'loader-t1',
         name: 'Loader',
         description: 'Basic cargo handling system. Loads and unloads cargo with articulated arms.',
-        color: '#6B8E5A',
+        color: '#5A8B3E',
         itemId: ITEM_LOADER_T1,
         moduleType: MODULE_LOADER,
         recipe: [
@@ -437,7 +444,7 @@ export const moduleRecipes: ModuleRecipe[] = [
             {itemId: ITEM_CARGO_ARM, quantity: 3},
         ],
         stats: [
-            {key: 'ductility', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'ductility'},
+            {key: 'fineness', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'fineness'},
             {key: 'plasticity', sourceComponentId: ITEM_CARGO_ARM, sourceStatKey: 'plasticity'},
         ],
     },
@@ -446,7 +453,7 @@ export const moduleRecipes: ModuleRecipe[] = [
         name: 'Manufacturing',
         description:
             'Basic crafting system. Processes materials using reaction chambers and cutting tools.',
-        color: '#7EC8E3',
+        color: '#B8E4A0',
         itemId: ITEM_MANUFACTURING_T1,
         moduleType: MODULE_CRAFTER,
         recipe: [
@@ -459,7 +466,7 @@ export const moduleRecipes: ModuleRecipe[] = [
                 sourceComponentId: ITEM_REACTION_CHAMBER,
                 sourceStatKey: 'reactivity',
             },
-            {key: 'clarity', sourceComponentId: ITEM_TOOL_BIT, sourceStatKey: 'clarity'},
+            {key: 'composition', sourceComponentId: ITEM_TOOL_BIT, sourceStatKey: 'composition'},
         ],
     },
     {
@@ -475,17 +482,17 @@ export const moduleRecipes: ModuleRecipe[] = [
         ],
         stats: [
             {key: 'strength', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'strength'},
-            {key: 'ductility', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'ductility'},
-            {key: 'purity', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'purity'},
-            {key: 'density', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'density'},
+            {key: 'density', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'density'},
+            {key: 'fineness', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'fineness'},
+            {key: 'saturation', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'saturation'},
         ],
     },
     {
         id: 'hauler-t1',
-        name: 'Hauler Module T1',
+        name: 'Hauler',
         description:
             'Projects a haul beam to lock onto and transport containers or warehouses through group travel.',
-        color: '#D4A843',
+        color: '#4ADBFF',
         itemId: ITEM_HAULER_T1,
         moduleType: MODULE_HAULER,
         recipe: [
@@ -493,14 +500,13 @@ export const moduleRecipes: ModuleRecipe[] = [
             {itemId: ITEM_FOCUSING_ARRAY, quantity: 3},
         ],
         stats: [
-            {key: 'capacity', sourceComponentId: ITEM_POWER_CELL, sourceStatKey: 'resonance'},
+            {key: 'resonance', sourceComponentId: ITEM_POWER_CELL, sourceStatKey: 'resonance'},
+            {key: 'reflectivity', sourceComponentId: ITEM_POWER_CELL, sourceStatKey: 'reflectivity'},
             {
-                key: 'efficiency',
+                key: 'conductivity',
                 sourceComponentId: ITEM_FOCUSING_ARRAY,
                 sourceStatKey: 'conductivity',
             },
-            {key: 'drain', sourceComponentId: ITEM_POWER_CELL, sourceStatKey: 'clarity'},
-            {key: 'ductility', sourceComponentId: ITEM_FOCUSING_ARRAY, sourceStatKey: 'ductility'},
         ],
     },
 ]

package/src/derivation/crafting.ts

@@ -22,27 +22,27 @@ export interface CategoryStacks {
 }
 
 export function encodeStats(values: number[]): bigint {
-    let seed = 0n
+    let stats = 0n
     for (let i = 0; i < values.length && i < 6; i++) {
-        seed |= BigInt(values[i] & 0x3ff) << BigInt(i * 10)
+        stats |= BigInt(values[i] & 0x3ff) << BigInt(i * 10)
     }
-    return seed
+    return stats
 }
 
-export function decodeStat(seed: bigint, index: number): number {
-    return Number((seed >> BigInt(index * 10)) & 0x3ffn)
+export function decodeStat(stats: bigint, index: number): number {
+    return Number((stats >> BigInt(index * 10)) & 0x3ffn)
 }
 
-export function decodeStats(seed: bigint, count: number): number[] {
-    const stats: number[] = []
+export function decodeStats(stats: bigint, count: number): number[] {
+    const result: number[] = []
     for (let i = 0; i < count; i++) {
-        stats.push(decodeStat(seed, i))
+        result.push(decodeStat(stats, i))
     }
-    return stats
+    return result
 }
 
-function mapStatsToKeys(seed: bigint, statDefs: {key: string}[]): Record<string, number> {
-    const values = decodeStats(seed, statDefs.length)
+function mapStatsToKeys(stats: bigint, statDefs: {key: string}[]): Record<string, number> {
+    const values = decodeStats(stats, statDefs.length)
     const result: Record<string, number> = {}
     for (let i = 0; i < statDefs.length; i++) {
         result[statDefs[i].key] = values[i]
@@ -50,15 +50,15 @@ function mapStatsToKeys(seed: bigint, statDefs: {key: string}[]): Record<string,
     return result
 }
 
-export function decodeCraftedItemStats(itemId: number, seed: bigint): Record<string, number> {
+export function decodeCraftedItemStats(itemId: number, stats: bigint): Record<string, number> {
     const comp = getComponentById(itemId)
-    if (comp) return mapStatsToKeys(seed, comp.stats)
+    if (comp) return mapStatsToKeys(stats, comp.stats)
 
     const entityRecipe = entityRecipes.find((r) => r.packedItemId === itemId)
-    if (entityRecipe) return mapStatsToKeys(seed, entityRecipe.stats)
+    if (entityRecipe) return mapStatsToKeys(stats, entityRecipe.stats)
 
     const moduleRecipe = moduleRecipes.find((r) => r.itemId === itemId)
-    if (moduleRecipe) return mapStatsToKeys(seed, moduleRecipe.stats)
+    if (moduleRecipe) return mapStatsToKeys(stats, moduleRecipe.stats)
 
     return {}
 }
@@ -126,20 +126,20 @@ export function computeEntityStats(
     })
 }
 
-function decodeStackStats(itemId: number, seed: UInt64): Record<string, number> {
+function decodeStackStats(itemId: number, stats: UInt64): Record<string, number> {
     if (itemId >= 10000) {
-        return decodeCraftedItemStats(itemId, BigInt(seed.toString()))
+        return decodeCraftedItemStats(itemId, BigInt(stats.toString()))
     }
-    const raw = deriveResourceStats(BigInt(seed.toString()))
-    return {stat1: raw.stat1, stat2: raw.stat2, stat3: raw.stat3}
+    const s = BigInt(stats.toString())
+    return {stat1: decodeStat(s, 0), stat2: decodeStat(s, 1), stat3: decodeStat(s, 2)}
 }
 
 export const categoryItemMass: Record<string, number> = {
-    metal: 30000,
-    precious: 40000,
+    ore: 30000,
+    crystal: 40000,
     gas: 15000,
-    mineral: 22000,
-    organic: 15000,
+    regolith: 22000,
+    biomass: 15000,
 }
 
 export function computeInputMass(
@@ -187,11 +187,11 @@ export function blendCrossGroup(sources: {value: number; weight: number}[]): num
 
 export function blendCargoStacks(
     itemId: number,
-    stacks: {quantity: number; seed: UInt64}[]
+    stacks: {quantity: number; stats: UInt64}[]
 ): UInt64 {
     const decoded = stacks.map((s) => ({
         quantity: s.quantity,
-        stats: decodeStackStats(itemId, s.seed),
+        stats: decodeStackStats(itemId, s.stats),
     }))
     const allKeys = Object.keys(decoded[0]?.stats ?? {})
     const blended = allKeys.map((key) => Math.max(1, Math.min(999, blendStacks(decoded, key))))
@@ -201,23 +201,22 @@ export function blendCargoStacks(
 export interface RecipeSlotInput {
     itemId: number
     category: ResourceCategory | undefined
-    stacks: {quantity: number; seed: bigint}[]
+    stacks: {quantity: number; stats: bigint}[]
 }
 
 function decodeRawStackToCategoryStats(
-    seed: bigint,
+    stats: bigint,
     category: ResourceCategory
 ): Record<string, number> {
-    const raw = deriveResourceStats(seed)
     const defs = getStatDefinitions(category)
     const result: Record<string, number> = {}
-    if (defs[0]) result[defs[0].key] = raw.stat1
-    if (defs[1]) result[defs[1].key] = raw.stat2
-    if (defs[2]) result[defs[2].key] = raw.stat3
+    if (defs[0]) result[defs[0].key] = decodeStat(stats, 0)
+    if (defs[1]) result[defs[1].key] = decodeStat(stats, 1)
+    if (defs[2]) result[defs[2].key] = decodeStat(stats, 2)
     return result
 }
 
-export function computeCraftedOutputSeed(
+export function computeCraftedOutputStats(
     outputItemId: number,
     slotInputs: RecipeSlotInput[]
 ): UInt64 {
@@ -230,8 +229,8 @@ export function computeCraftedOutputSeed(
             const stacks: StackInput[] = slot.stacks.map((s) => ({
                 quantity: s.quantity,
                 stats: slotIsComponent
-                    ? decodeCraftedItemStats(slot.itemId, s.seed)
-                    : decodeRawStackToCategoryStats(s.seed, slot.category!),
+                    ? decodeCraftedItemStats(slot.itemId, s.stats)
+                    : decodeRawStackToCategoryStats(s.stats, slot.category!),
             }))
             categoryStacks.push({category: slot.category, stacks})
         }
@@ -257,7 +256,7 @@ export function computeCraftedOutputSeed(
             for (const s of slot.stacks) {
                 list.push({
                     quantity: s.quantity,
-                    stats: decodeCraftedItemStats(slot.itemId, s.seed),
+                    stats: decodeCraftedItemStats(slot.itemId, s.stats),
                 })
             }
         }
@@ -269,5 +268,20 @@ export function computeCraftedOutputSeed(
         return UInt64.from(encodeStats(ordered))
     }
 
-    throw new Error(`computeCraftedOutputSeed: no recipe found for outputItemId=${outputItemId}`)
+    throw new Error(`computeCraftedOutputStats: no recipe found for outputItemId=${outputItemId}`)
+}
+
+/**
+ * Mirrors the contract's gather-time transform. Takes a deposit's entropy
+ * seed (bigint from deriveStratum), derives stats via weibull hashing, and
+ * returns a UInt64 whose bit-packed form matches what the contract writes
+ * to cargo_item.stats on gather.
+ *
+ * Use this whenever off-chain code simulates a gather (testmap, player
+ * scanners that project cargo outcomes) and needs a value that matches
+ * what on-chain cargo would carry.
+ */
+export function encodeGatheredCargoStats(depositSeed: bigint): UInt64 {
+    const raw = deriveResourceStats(depositSeed)
+    return UInt64.from(encodeStats([raw.stat1, raw.stat2, raw.stat3]))
 }

package/src/derivation/resources.ts

@@ -24,21 +24,21 @@ interface ResourceEntry {
 }
 
 const RESOURCE_CATALOG: ResourceEntry[] = [
-    {id: 26, tier: 't1'},
-    {id: 13, tier: 't2'},
-    {id: 24, tier: 't3'},
-    {id: 29, tier: 't1'},
-    {id: 47, tier: 't2'},
-    {id: 79, tier: 't3'},
-    {id: 1, tier: 't1'},
-    {id: 2, tier: 't2'},
-    {id: 18, tier: 't3'},
-    {id: 14, tier: 't1'},
-    {id: 1000, tier: 't2'},
-    {id: 1001, tier: 't3'},
-    {id: 6, tier: 't1'},
-    {id: 1003, tier: 't2'},
-    {id: 1002, tier: 't3'},
+    {id: 101, tier: 't1'},
+    {id: 102, tier: 't2'},
+    {id: 103, tier: 't3'},
+    {id: 201, tier: 't1'},
+    {id: 202, tier: 't2'},
+    {id: 203, tier: 't3'},
+    {id: 301, tier: 't1'},
+    {id: 302, tier: 't2'},
+    {id: 303, tier: 't3'},
+    {id: 401, tier: 't1'},
+    {id: 402, tier: 't2'},
+    {id: 403, tier: 't3'},
+    {id: 501, tier: 't1'},
+    {id: 502, tier: 't2'},
+    {id: 503, tier: 't3'},
 ]
 
 export function getDepthThreshold(tier: ResourceTier): number {
@@ -91,14 +91,14 @@ export function getResourceWeight(itemId: number, stratum: number): number {
     }
 }
 
-const ASTEROID_RESOURCES = [26, 13, 24, 29, 47]
-const NEBULA_RESOURCES = [47, 79, 1, 2, 18]
-const GAS_GIANT_RESOURCES = [1, 2, 18, 14, 6]
-const ROCKY_RESOURCES = [26, 13, 24, 14, 1000, 1001, 1002]
-const TERRESTRIAL_RESOURCES = [29, 47, 14, 1000, 6, 1003, 1002]
-const ICY_RESOURCES = [26, 1, 2, 14, 1001, 6, 1003]
-const OCEAN_RESOURCES = [29, 79, 1, 18, 6, 1003, 1002]
-const INDUSTRIAL_RESOURCES = [26, 13, 24, 29, 79, 1000, 1001]
+const ASTEROID_RESOURCES = [101, 102, 103, 201, 202]
+const NEBULA_RESOURCES = [202, 203, 301, 302, 303]
+const GAS_GIANT_RESOURCES = [301, 302, 303, 401, 501]
+const ROCKY_RESOURCES = [101, 102, 103, 401, 402, 403, 503]
+const TERRESTRIAL_RESOURCES = [201, 202, 401, 402, 501, 502, 503]
+const ICY_RESOURCES = [101, 301, 302, 401, 403, 501, 502]
+const OCEAN_RESOURCES = [201, 203, 301, 303, 501, 502, 503]
+const INDUSTRIAL_RESOURCES = [101, 102, 103, 201, 203, 402, 403]
 
 export function getLocationCandidates(locationType: number, subtype: number): number[] {
     if (locationType === 2) return ASTEROID_RESOURCES