Sessions

Récupération de la liste des instances disponibles avec pagination pour la navigation.

Le message Sessions permet aux clients de récupérer la liste des instances disponibles sur le serveur.

Il utilise un système de pagination pour gérer efficacement les grandes listes d'instances.

Priorité

Normal - Ce message a une priorité normale car il s'agit d'une consultation d'informations.

Le message Sessions requiert que le client ait complété le Handshake. Les requêtes envoyées avant le handshake seront ignorées par le serveur.

Requête Client → Serveur

Format du Payload

[pagination: byte]

Structure Détaillée

Type	Nom	Description
byte	Pagination	Numéro de page à récupérer (0-based)

Exemple de Requête

[0x00]                          // Pagination = 0 (première page)

Exemple de Requête - Page Suivante

[0x02]                          // Pagination = 2 (troisième page)

Réponse Serveur → Client

Format du Payload

[instance_count: byte]
[current_page: byte]
[total_pages: byte]
[instances: Instance[instance_count]]

Structure d'Instance

[flags: uint]
[internal_id: byte]
[master_id: uint]
[current_players: ushort]
[capacity: ushort]

Structure Détaillée

Type	Nom	Description
byte	InstanceCount	Nombre d'instances dans cette page
byte	CurrentPage	Numéro de la page actuelle
byte	TotalPages	Nombre total de pages disponibles
uint	Flags	Flags de configuration de l'instance
byte	InternalID	ID interne de l'instance sur ce relay
uint	MasterID	ID de l'instance sur le serveur maître
ushort	CurrentPlayers	Nombre de joueurs actuellement connectés
ushort	Capacity	Capacité maximale de l'instance

Instance Flags

Valeur	Nom	Description
0x01	IsPublic	Instance visible publiquement
0x02	UsePassword	Protection par mot de passe
0x04	UseWhitelist	Contrôle d'accès par liste blanche
0x08	AuthorizeBot	Autorise les connexions de bots
0x10	AllowOverload	Permet de dépasser la capacité

Exemple de Réponse - Page avec Instances

[0x02]                          // InstanceCount = 2
[0x00]                          // CurrentPage = 0
[0x01]                          // TotalPages = 1
// Instance 1
[0x00, 0x00, 0x00, 0x01]        // Flags = IsPublic
[0x05]                          // InternalID = 5
[0x00, 0x00, 0x04, 0x2A]        // MasterID = 1066
[0x00, 0x08]                    // CurrentPlayers = 8
[0x00, 0x20]                    // Capacity = 32
// Instance 2
[0x00, 0x00, 0x00, 0x03]        // Flags = IsPublic | UsePassword
[0x03]                          // InternalID = 3
[0x00, 0x00, 0x05, 0x39]        // MasterID = 1337
[0x00, 0x04]                    // CurrentPlayers = 4
[0x00, 0x10]                    // Capacity = 16

Exemple de Réponse - Page Vide

[0x00]                          // InstanceCount = 0
[0x02]                          // CurrentPage = 2
[0x02]                          // TotalPages = 2

Exemple de Réponse - Page Invalide

[0x00]                          // InstanceCount = 0
[0x05]                          // CurrentPage = 5 (demandée)
[0x03]                          // TotalPages = 3 (maximum disponible)