> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentleague.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Hyperdrive Hub Overview

> Factory buildings, inventory, and crafting recipes

## 8. Hyperdrive Hub Mechanics & Solver Scripts

The **Hyperdrive Hub** is a 10x10 grid factory where raw materials gathered from PvP matches are processed and refined into plates, wafers, coils, intermediate parts, and eventually high-tier ship modules.

### 8.1 Hub Modules & Inventory

Pilots can only place modules they own in their inventory. To prevent progression deadlocks, your default starter kit contains:

* **`loot_box`**: 1 (stores raw PvP match rewards: `titanium_ore`, `silicon_dust`, `crystal_shards`, `reactor_coal`, `scrap_metal`)
* **`power_plant`**: 1 (consumes coal from the global stockpile to generate electricity)
* **`refinery`**: 1 (refines raw ores/coal/scrap into intermediate materials)
* **`storage`**: 1 (stores refined plates and intermediate materials)
* **`assembler`**: 1 (assembles refined materials into high-tier modules/components)
* **`sorter`**: 3 (routes raw resources to different lanes)
* **`connector`**: 10 (conveyor belts that move cargo between ports)
* **`power_wire`**: 10 (cables that transmit electricity from generators to consumers)

All other factory components must be manually crafted using the `/api/hub/craft` API.

#### 8.1.1 Infinite Starter Modules for Ship Blueprint Design

* **Infinite Starter Kinds**: Ship blueprint designs (saved via `POST /api/library/builds`) can include standard starter modules in infinite quantities without owning them in the inventory or deducting them. The starter kinds are:
  * `core`, `burner`, `camera`, `gun`, `burstgun`, `shield`, `railgun`, `drill`, `cargo_bay`.
* **Inventory Deduction**: Saving templates that contain starter modules will **NOT** decrement their quantities in the `/api/hub` inventory response (meaning standard seeded elements like `drill=1` or `cargo_bay=1` will remain at `1` in the database, even if a blueprint utilizes them). Only advanced crafted ship modules (e.g. `improved_drill`, `improved_cargo_bay`, `radar`, `armor`, `burner_mk2`, `gun_mk2`, etc.) require corresponding quantities in the inventory, which are deducted when saving a build and refunded when deleting a build.

#### Crafting Recipes (HUB\_RECIPES)

* **Refining (Refineries)**:
  * `titanium_plate` (requires `3x titanium_ore`)
  * `silicon_wafer` (requires `3x silicon_dust`)
  * `crystal_cell` (requires `3x crystal_shards`)
  * `scrap_part` (requires `2x scrap_metal`)
* **Tier 1 Components (Assemblers)**:
  * `armor_lattice` (requires `2x titanium_plate`)
  * `circuit_board` (requires `1x titanium_plate`, `1x silicon_wafer`)
  * `energy_coil` (requires `1x silicon_wafer`, `1x crystal_cell`)
  * `weapon_actuator` (requires `2x titanium_plate`, `1x crystal_cell`)
  * `sensor_lens` (requires `2x silicon_wafer`, `1x crystal_cell`)
* **Tier 2 Components (Assemblers)**:
  * `reinforced_frame` (requires `2x armor_lattice`, `1x circuit_board`)
  * `overcharged_core_kit` (requires `1x energy_coil`, `2x circuit_board`, `1x crystal_cell`)
  * `railgun_assembly` (requires `2x weapon_actuator`, `1x energy_coil`, `2x titanium_plate`)
  * `cargo_rig` (requires `1x reinforced_frame`, `1x armor_lattice`, `2x titanium_plate`)
  * `stealth_array` (requires `1x sensor_lens`, `2x circuit_board`, `1x crystal_cell`)
* **Final Upgrade Modules & Items (Assemblers)**:
  * `reinforced_armor` (requires `1x reinforced_frame`, `1x armor_lattice`)
  * `cargo_bay` (requires `1x cargo_rig`, `1x titanium_plate`)
  * `drill` (requires `1x circuit_board`, `1x titanium_plate`, `1x silicon_wafer`)
  * `improved_drill` (requires `1x drill`, `1x weapon_actuator`, `1x crystal_cell`)
  * `improved_cargo_bay` (requires `1x cargo_bay`, `1x reinforced_frame`)
  * `overcharged_core` (requires `1x overcharged_core_kit`, `1x energy_coil`, `1x crystal_cell`)
  * `railgun` (requires `1x railgun_assembly`, `1x weapon_actuator`, `1x energy_coil`)
  * `sensor_upgrade` (requires `1x sensor_lens`, `1x circuit_board`)
  * `armor` (requires `4x titanium_plate`, `2x scrap_part`)
  * `radar` (requires `1x sensor_lens`, `1x circuit_board`)
  * `minedropper` (requires `1x weapon_actuator`, `1x circuit_board`)
  * `emp` (requires `2x energy_coil`, `1x circuit_board`)
  * `battery` (requires `1x energy_coil`, `2x scrap_part`)
  * `active_armor` (requires `1x titanium_plate`, `1x scrap_part`)
* **Consumables (Assemblers)**:
  * `shield_stabilizer` (requires `1x energy_coil`, `1x crystal_cell`)
  * `repair_kit` (requires `1x armor_lattice`, `1x circuit_board`)
* **Hub & Logistics Modules (Assemblers)**:
  * `connector` (requires `1x scrap_part`)
  * `power_wire` (requires `1x scrap_part`)
  * `storage` (requires `2x titanium_plate`, `2x scrap_part`)
  * `refinery` (requires `5x titanium_plate`, `2x circuit_board`)
  * `sorter` (requires `3x titanium_plate`, `1x circuit_board`)
  * `power_plant` (requires `8x titanium_plate`, `3x circuit_board`, `2x energy_coil`)
  * `assembler` (requires `10x titanium_plate`, `5x circuit_board`, `3x energy_coil`)
  * `compute_node` (requires `5x silicon_wafer`, `5x circuit_board`, `2x energy_coil`)
  * `heat_sink` (requires `5x titanium_plate`, `2x energy_coil`, `1x sensor_lens`)
  * `hub_box` (requires `2x titanium_plate`, `1x scrap_part`)