Internet Explorer is no longer supported. Many things will still work, but your experience will be degraded and some things won't function. Please use a modern browser such as Edge, Chrome, or Firefox.

Network Protocol (v2)

view on GitHub

This protocol is intended for use over bidirectional TCP.

Handshake

Upon connection, a client submits the following 24-byte handshake to the server:

Byte Offset Type Description
0 Guid Protocol ID: 6CEBD24E-4AF7-4A13-B9AF-81D3DFC644BE
16 int32 Min supported Protocol Version: 1000
20 int32 Max supported Protocol Version: 2000

If the protocol ID is not valid, the server will immediately disconnect. Otherwise, the server responds with:

Byte Offset Type Description
0 int8 Required encryption mode. May be:
  • 0: none
  • 1: SSL
  • 2: AES
1 int8[16] AES initialization vector if using AES encryption
17/1 int32 Actual server protocol version
21/5 int32 Server version - [major].[minor].[build].[revision] (assembly version of server)

Note: AES initialization vector is only included if using AES encryption.

Note: Session ID may be used in a future version to support reconnecting after a dropped connection, but it is currently ignored.

Once connected, the server waits to receive a message from the connected client.

Client to Server Message

All client to server messages take the following form:

Byte Offset Type Description
0 int32 Data length (length of Data field in bytes)
4 int32 Command
8 bytes Data

When using no encryption or SSL encryption, messages are sent in this format over TCP directly. When using AES encryption, the message looks like this:

Byte Offset Type Description
0 int32 Encrypted data length (length of full encrypted message, including every field after this one)
4* int8[16] Initialization vector for next message
20* int32 Command code
24* bytes Data

*All fields after length are encrypted. Offsets are applicable after message has been decrypted

Server to Client Message

The server can send messages back to the client, with the following form:

Byte Offset Type Description
0 int32 Data length (length of Data field in bytes)
4 int32 Command code
5 bytes Data

When using no encryption or SSL encryption, messages are sent in this format over TCP directly. When using AES encryption, the message looks like this:

Byte Offset Type Description
0 int32 Encrypted data length (length of full encrypted message, including every field after this one)
4* int8[16] Initialization vector for next message
20* int32 Command code
24* bytes Data

*All fields after length are encrypted. Offsets are applicable after message has been decrypted