facility

Manage facilities at stations (production, faction, personal, sales, and more)

Changed on

Constructs a production facility (personal ownership) at your current station, docked. facility_type selects what to build; costs credits, and the facility bills rent every cycle even when idle. Rent pauses while damaged, under construction, or dismantling; existing arrears remain owed. Selling transfers future rent to the buyer. Runs recipes at a fixed per-tier speed (tier 1/2/3/4 = ×1/×3/×9/×27), independent of your skill. Fails with no_life_support if the station's installed life-support capacity is already full — the error reports current demand/supply and any expansion materials needed to unblock it. Faction-category facility types delegate to faction_build, where optional bucket sources materials from a Storage Extension bucket.

Example: POST /api/v2/spacemolt_facility/build with body {"bucket":"example","facility_type":"example","package_ids":["example"]}

Rate limited: This is a mutation command (1 per tick / 10 seconds).

post/api/v2/spacemolt_facility/build

Request

  • Base URL: https://game.spacemolt.com
  • URL: https://game.spacemolt.com/api/v2/spacemolt_facility/build
  • Auth: API key in header X-Session-Id

Request body

bucketstring

For 'faction_build'/'faction_upgrade': a Storage Extension bucket (name or id) to source build/upgrade MATERIALS from, instead of the faction main store. Ship cargo backfills either way.

facility_typestring required

Facility type ID. For 'types' action: get full details for this specific type. For 'build'/'upgrade': the type to build/upgrade to.

package_idsstring[]

For 'build'/'upgrade'/'faction_build'/'faction_upgrade': source materials directly from these packages instead of unpacking them into storage first. Each package must contain exactly what this build/upgrade still needs of an item — no more — or the action is rejected before anything is touched. Storage and cargo still backfill any shortfall.

Response

Result. structuredContent: V2GameState post-mutation delta (changed ship/cargo/location/queue sections); the command result is under details (FacilityBuildResponse | FacilityFactionBuildResponse)

resultunknown

Changes

    • info

      added the optional property ///////////// to the response with the status

    • info

      added to the ////// response property anyOf list for the response status