Jump to content

Launcher protocol: Difference between revisions

3.1 is released, so Devfeature templates have been removed
(Add SQF2_COUNTRY information)
(3.1 is released, so Devfeature templates have been removed)
Line 172: Line 172:
| <tt>SQF_DEH</tt> || <tt>0x40000000</tt> || List of DEHACKED patches loaded by the server.
| <tt>SQF_DEH</tt> || <tt>0x40000000</tt> || List of DEHACKED patches loaded by the server.
|-
|-
| <tt>SQF_EXTENDED_INFO</tt> || <tt>0x80000000</tt> || {{Devfeature|3.1|alpha-180901-1533}} Additional server information, see the table below for more information.
| <tt>SQF_EXTENDED_INFO</tt> || <tt>0x80000000</tt> || Additional server information, see the table below for more information.
|}
|}


=== Extended flags ===
=== Extended flags ===
{{Devfeature|3.1|alpha-180901-1533}}
{| class="wikitable"
{| class="wikitable"
! Name || Value || Description
! Name || Value || Description
Line 200: Line 199:
|Long || Time || Current time, this will be sent back to you so you can determine ping.
|Long || Time || Current time, this will be sent back to you so you can determine ping.
|-
|-
|Long || Flags2 || {{Devfeature|3.1|alpha-180901-1533}} The extended information you want. Ensure you specify <tt>SQF_EXTENDED_INFO</tt> in the normal Flags field as well. This field is optional - if this field is not present, its value is inferred to be 0. Older servers will ignore this field.
|Long || Flags2 || The extended information you want. Ensure you specify <tt>SQF_EXTENDED_INFO</tt> in the normal Flags field as well. This field is optional - if this field is not present, its value is inferred to be 0. Older servers will ignore this field.
|}
|}


Line 439: Line 438:
| Long
| Long
| <tt>SQF_EXTENDED_INFO</tt>
| <tt>SQF_EXTENDED_INFO</tt>
| {{Devfeature|3.1|alpha-180901-1533}} The flags specifying extended server information you will receive. Check all <tt>SQF2</tt> values against this field.
| The flags specifying extended server information you will receive. Check all <tt>SQF2</tt> values against this field.
|-
|-
| Byte
| Byte
| <tt>SQF2_PWAD_HASHES</tt>
| <tt>SQF2_PWAD_HASHES</tt>
| {{Devfeature|3.1|alpha-180901-1533}} The number of hashes sent.
| The number of hashes sent.
|-
|-
| String
| String
| <tt>SQF2_PWAD_HASHES</tt>
| <tt>SQF2_PWAD_HASHES</tt>
| {{Devfeature|3.1|alpha-180901-1533}} The hash of the PWAD, sent for each PWAD. The indices are the same as sent in <tt>SQF_PWADS</tt>
| The hash of the PWAD, sent for each PWAD. The indices are the same as sent in <tt>SQF_PWADS</tt>
|-
|-
| Byte[3]
| Byte[3]
| <tt>SQF2_COUNTRY</tt>
| <tt>SQF2_COUNTRY</tt>
| {{Devfeature|3.1|alpha}} The server's ISO 3166-1 alpha-3 country code. This is sent as a raw char array of 3 length, there is no null terminator. Zandronum also has two special values for this field, <tt>XIP</tt> and <tt>XUN</tt>. See [[#Country codes]] below for how to handle this field.
| The server's ISO 3166-1 alpha-3 country code. This is sent as a raw char array of 3 length, there is no null terminator. Zandronum also has two special values for this field, <tt>XIP</tt> and <tt>XUN</tt>. See [[#Country codes]] below for how to handle this field.
|}
|}