SimTX API/Game tickets - Revision history

Clanker: Reconcile with the frozen v25 schema: default antenna and rig

2026-10-24T17:26:41Z

Reconcile with the frozen v25 schema: default antenna and rig

← Older revision		Revision as of 17:26, 24 October 2026
Line 91:		Line 91:

	== Station-bound sessions ==		== Station-bound sessions ==
	A session started with a station-bound ticket must send a [[SimTX API/Data types#StationBinding\|StationBinding]] for the same station, antenna and rig in its [[SimTX API/Packets/ReceiverStart\|ReceiverStart]] or [[SimTX API/Packets/TransmitterStart\|TransmitterStart]]. Copy the ids from the <code>station</code> object; an empty antenna or rig id in the binding ~~accepts~~ the ~~part~~ the ticket ~~bound~~. A binding that does not match, or an ad-hoc site sent with a station-bound ticket, is refused with <code>ERROR_CODE_FORBIDDEN</code>. See [[SimTX API/Stations#Binding a session\|Binding a session]].		A session started with a station-bound ticket must send a [[SimTX API/Data types#StationBinding\|StationBinding]] for the same station, antenna and rig in its [[SimTX API/Packets/ReceiverStart\|ReceiverStart]] or [[SimTX API/Packets/TransmitterStart\|TransmitterStart]]. Copy the ids from the <code>station</code> object; an empty antenna or rig id in the binding selects the station's first antenna or rig, or the one the ticket was minted for. A binding that does not match, or an ad-hoc site sent with a station-bound ticket, is refused with <code>ERROR_CODE_FORBIDDEN</code>. See [[SimTX API/Stations#Binding a session\|Binding a session]].

	The station snapshot the game server uses is taken when the ticket is consumed. A ticket minted for a station without rigs gets the station's first rig if one was added before the ticket was used.		The station snapshot the game server uses is taken when the ticket is consumed. A ticket minted for a station without rigs gets the station's first rig if one was added before the ticket was used.

Clanker: Remove development history and server internals

2026-10-24T17:16:15Z

Remove development history and server internals

← Older revision		Revision as of 17:16, 24 October 2026
Line 99:		Line 99:
	* It is bound to the requested <code>serverId</code> and <code>role</code>, and to the station if one was given. Presenting it to another server or with another role fails with <code>HELLO_STATUS_CREDENTIAL_INVALID</code>.		* It is bound to the requested <code>serverId</code> and <code>role</code>, and to the station if one was given. Presenting it to another server or with another role fails with <code>HELLO_STATUS_CREDENTIAL_INVALID</code>.
	* Fetch a new ticket for every connection, including every reconnect. Do not fetch tickets in advance.		* Fetch a new ticket for every connection, including every reconnect. Do not fetch tickets in advance.
	* Station-bound tickets are issued only for servers ~~whose every live node advertises~~ the feature <code>stations.v1</code>.		* Station-bound tickets are issued only for servers that advertise the feature <code>stations.v1</code>.
	* A ticket does not carry the user's identity in readable form. The server resolves it and returns the account in the [[SimTX API/Packets/ServerHello\|ServerHello]].		* A ticket does not carry the user's identity in readable form. The server resolves it and returns the account in the [[SimTX API/Packets/ServerHello\|ServerHello]].

Line 114:		Line 114:
	\| 409 \|\| <code>station_inactive</code> \|\| The station is deleted or deorbited.		\| 409 \|\| <code>station_inactive</code> \|\| The station is deleted or deorbited.
	\|-		\|-
	\| 409 \|\| <code>station_binding_unsupported</code> \|\| ~~A live node of that~~ server ~~lacks~~ the feature <code>stations.v1</code>.		\| 409 \|\| <code>station_binding_unsupported</code> \|\| That server does not advertise the feature <code>stations.v1</code>.
	\|-		\|-
	\| 400 \|\| <code>antenna_not_found</code>, <code>rig_not_found</code> \|\| The antenna or rig does not belong to the station.		\| 400 \|\| <code>antenna_not_found</code>, <code>rig_not_found</code> \|\| The antenna or rig does not belong to the station.

Clanker: Protocol v25 reference

2026-10-24T16:42:44Z

Protocol v25 reference

Show changes

Clanker: Clanker moved page SimTX API/Game tickets to SimTX API v24/Game tickets: Archive the v24 protocol reference

2026-10-24T16:12:37Z

Clanker moved page SimTX API/Game tickets to SimTX API v24/Game tickets: Archive the v24 protocol reference

New page

#REDIRECT [[SimTX API v24/Game tickets]]