serverlist.h

#ifndef LIBSPADES_SERVERLIST_H
#define LIBSPADES_SERVERLIST_H
#ifdef __cplusplus
extern "C" {
#endif
 
#include <enet/enet.h>
#include <stddef.h>
#include <time.h>
#include "datatypes.h"
 
struct ServerListConnection {
    ENetHost *host;
    char *domain;
    int enabled;
    uint16_t port;
    char serverName[32];
    char gameMode[8];
    char mapName[21];
    uint8_t maxPlayers;
    uint8_t currentPlayers;
};
 
struct ServerEntry {
    char name[32];                /* server name */
    char identifier[23];          /* aos identifier in format:
                                                        `aos://address:port:protocol`. address is a single
                                                        number, and anything after the address is optional,
                                                        but must be in the sequence shown. */
    char map[21];                 /* map name */
    char game_mode[8];            /* gamemode name */
    char country[2];              /* two-letter country code that should conform to ISO
                                                         3166-1 alpha-2. also see
                                                                                                                 `https://www.buildandshoot.com/assets/js/main.js`,
                                                         although it seems to be missing a few country codes
                                                         (specifically BQ). */
    int latency;                  /* the server's ping in milliseconds */
    uint_fast8_t players_current; /* usually the amount of clients connected to the
                                                                     server, regardless of whether they have
                                     actually "joined" the game or not */
    uint_fast8_t players_max;     /* the total amount of clients that can connect
                                                                 to the server at once */
    time_t last_updated;          /* the last time as a unix timestamp in seconds that the
                                                                 server reported a player count change or map change */
    char game_version[5];         /* the protocol version used by the server in format
                                                                 0.XX */
};
 
struct ServerList {
    size_t serverCount; /* amount of serverEntries */
    struct ServerEntry *serverEntries;
};
 
int libspades_get_server_list(struct ServerList *serverList);
void libspades_serverlist_major_update(const struct ServerListConnection *connection);
void libspades_serverlist_player_count_update(const struct ServerListConnection *connection);
int libspades_serverlist_connection_create2(struct ServerListConnection *connection, const char *domain);
int libspades_serverlist_connection_create(struct ServerListConnection *connection);
void libspades_serverlist_service(struct ServerListConnection *connection);
 
#ifdef __cplusplus
}
#endif
#endif