SimTX API/Packets/CatalogEntry: Difference between revisions

Latest revision as of 17:16, 24 October 2026

API overviewQuick startHandshakeFramingAll messagesData typesStationsAccount serviceLimits and errorsv24 reference

CatalogEntry
Frame	`ServerFrame`, field 37
Member	`catalog_entry`
Direction	Server → client
Session	Control (catalog)
Roles	`ROLE_CONTROL`.
Permission	None
Answered by
Answers	CatalogFetch
Defined in	`control.proto`

CatalogEntry returns the files of one catalog entry requested with CatalogFetch. An unknown entry is answered with Error instead.

Definition[edit | edit source]

message CatalogEntry {
  reserved 3;
  int64 request_id = 1;
  int32 entry_id = 2;
  string kind = 4;
  string name = 5;
  int32 revision = 6;
  repeated CatalogFile files = 7;
}

Fields[edit | edit source]

#	Field	Type	Description
1	`request_id`	`int64`	The request this answers.
2	`entry_id`	`int32`	The entry ID.
4	`kind`	`string`	`extension` or `preset`.
5	`name`	`string`	Entry name.
6	`revision`	`int32`	Revision number.
7	`files`	`repeated` CatalogFile	The entry's files, at most 1,000.

Field number 3 is reserved; do not use it.

Usage[edit | edit source]

For an extension, the files form a package as described in Lua extension manifest. Install it by writing each file to its path below an extension directory.
For a preset, there is exactly one .stxpreset file.

See also[edit | edit source]

CatalogFetch

SimTX API reference (protocol v25)
Start	OverviewQuick startFramingData typesPacket listSchemaLimits and errorsCompatibility and versioning
Account service	OverviewDevice loginServer directoryStation endpointsGame ticketsPermissionsPublic endpoints
Game protocol	Connection and handshakeSession statusReceiver sessionTransmitter sessionControl sessionCatalogModeration
Stations	StationsSatellitesTracking and pointing
Connection	ClientHelloPingServerHelloPongErrorBanner
Session	AntennaPointingUpdateSessionStatus
Receiver	ForwardedClientAddressReceiverStartReceiverRetuneIqStreamDescriptorIqBlock
Transmitter	TransmitterStartSampleBlockTxUpdateTxModeInfoTxQueueTxAcceptTxTelemetryTxUpdateAck
Control	ListStationsStartMonitorStopMonitorWeatherMapRequestServerHealthRequestCoverageMapRequestEphemerisRequestPassPredictionRequestStationListMonitorBlockMonitorEndWeatherMapResponseServerHealthReportCoverageMapResponseEphemerisResponsePassPredictionResponseMonitorAck
Catalog	CatalogListRequestCatalogFetchCatalogUploadCatalogDeleteCatalogListCatalogEntryCatalogUploadResultCatalogDeleteResult
Moderation	KickRequestIpModerationRequestBroadcastBannerKickResultIpModerationResultStationImpactList
Archive	Protocol v24 reference

@@ Line 13: / Line 13: @@
 | file = control.proto
 }}
-'''CatalogEntry''' returns the files of one catalog entry requested with [[SimTX API/Packets/CatalogFetch|CatalogFetch]]. An unknown entry is answered with [[SimTX API/Packets/Error|Error]] instead; the v24 <code>found</code> flag is gone.
+'''CatalogEntry''' returns the files of one catalog entry requested with [[SimTX API/Packets/CatalogFetch|CatalogFetch]]. An unknown entry is answered with [[SimTX API/Packets/Error|Error]] instead.
 == Definition ==
@@ Line 19: / Line 19: @@
 message CatalogEntry {
    reserved 3;
-  reserved "found";
    int64 request_id = 1;
    int32 entry_id = 2;
@@ Line 46: / Line 45: @@
 |}
-Reserved, never reused: field number 3 and the name <code>found</code>.
+Field number 3 is reserved; do not use it.
 == Usage ==