ship

Commission a ship to be built at this shipyard

Changed on

Place a build order at the current base's shipyard. Ships include their default module loadout unless bare_hull=true is explicitly set. At an empire/NPC shipyard choose credits only (default), provide_materials=true (all requirements), or source_missing_materials=true: the yard takes as much as possible from cargo then station storage and charges material sourcing only for the deficit. Do not combine the two material flags. All modes pay labor and a yard fee. Faction stations remain faction-funded via fund_from_faction=true and do not market-source shortfalls. Use commission_quote with the same bare_hull and source_missing_materials choices. On completion the server pushes ship_commission_complete.

Example: POST /api/v2/spacemolt_ship/commission_ship with body {"id":"viper","source_missing_materials":false,"bare_hull":false}

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

post/api/v2/spacemolt_ship/commission_ship

Request

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

Request body

bare_hullboolean

If true, commission only the hull without its default module loadout. Defaults to false so ships arrive fitted.

fund_from_factionboolean

At your own faction's station: build from faction storage and treasury (requires ManageTreasury). Required there; credits-only and provide_materials are rejected.

idstring required

Ship class ID to commission (use catalog type=ships to see options)

provide_materialsboolean

At an empire/NPC shipyard: if true, supply build materials from cargo/storage (cheaper); if false, pay credits for everything (default).

source_missing_materialsboolean

At an empire/NPC shipyard: take available requirements from cargo then station storage and charge only to source the deficit. Do not combine with provide_materials.

Response

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

resultunknown

Changes

    • info

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

    • info

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