Repository navigation
"Getting Started" kinda unclear about how to buy ship #83
Description
I am currently going through https://docs.spacetraders.io/quickstart/purchase-ship
it states
Look for a waypoint with the SHIPYARD trait. [...] Take note of the symbol for the orbital station waypoint that has a shipyard, which you can use to purchase a mining drone.
To view the ships available for purchase at a shipyard, send the following request. You will notice that there is a mining drone available for purchase, which can help you fulfill your starting contract.
so my expectation is
- find all waypoint with shipyards
- find one of type "orbital"
- list ship types
- ship types MUST contain one of type "mining drone"
from what I observed, this isn't necessarily true, sometimes the "mining drone" isn't available in the "orbital" but e.g. "moon"
curl 'https://api.spacetraders.io/v2/systems/X1-RA81/waypoints?traits=SHIPYARD'
--header 'Authorization: Bearer eyJhbGci[...]
[...] "systemSymbol":"X1-RA81", "symbol":"X1-RA81-H59", "type":"MOON", [...]
curl 'https://api.spacetraders.io/v2/systems/X1-RA81/waypoints/X1-RA81-H59/shipyard'
--header 'Authorization: Bearer eyJhbG[...]
[...] "data":{"symbol":"X1-RA81-H59", "shipTypes":[{"type": "SHIP_SURVEYOR"}, {"type": "SHIP_MINING_DRONE" [...]
is it intended that any of the shipyards may contain the "mining drone", and if yes, could you please update the "getting started" to make that more clear?
Activity
space-admiral commentedon Dec 7, 2023
Thanks for posting, you are right, the guide needs to be updated with some recent changes to the starting system. Really appreciate you catching this!
Julesssss commentedon Feb 23, 2025
+1 to this issue. I got stuck at this step as the first two waypoints with shipyard wasn't selling
SHIP_MINING_DRONE.An improvement might be for the docs to say something like:
Julesssss commentedon Feb 23, 2025
Another minor typo:
tankorsmash commentedon Mar 13, 2025
My starting probe was docked at a
MOONinstead of anORBITAL_STATION, so I was confused because the only orbital stations that had a shipyard didn't also have a mining probe for sale.I couldn't figure out where the quick start source comes from to make the PR either.