network_create_server

This function creates a new network server for your game, using one of the permitted connection protocols (see the constants listed below).

You supply the server type, then give it a port to use, and finally the number of maximum connections that should be permitted at any one time to the server (note that this number is up to you, but too many connected clients will saturate the network or the device CPU won't be able to handle the processing of that number of players, so use with care). The function returns a unique id which should be used stored in a variable and used to identify the server in all further network functions, or a value of less than 0 if the connection fails.

Socket Type Constant
ConstantDescription
network_socket_tcpCreate a socket using TCP.
network_socket_udpCreate a socket using UDP.
network_socket_wsCreate a WebSocket using TCP. (NOTE: Use Async functions for connecting through WebSockets)

NOTE Secure WebSockets are not supported when creating a server, only as a client.

NOTE There is a maximum limit of 1024 sockets on Windows, macOS and Ubuntu, and 64 sockets on all other platforms.

 

Syntax:

network_create_server(type, port, max_client);

ArgumentTypeDescription
typeSocket Type ConstantThe type of server to create (see the constants listed above).
portRealThe port that the server will use.
max_clientRealThe maximum number of clients that can connect at once.

 

Returns:

Network Socket ID

 

Example:

var port = 6510;
server = network_create_server(network_socket_tcp, port, 32);
while (server < 0 && port < 65535)
{
    port++
    server = network_create_server(network_socket_tcp, port, 32);
}

The above code will try and create a server using TCP through port 6510. If that port is unavailable, it will then loop through the ports to find one that is.