PixelPAD 2D - multiplayer

init_multiplayer() -> None

Ejemplo
Descripción
Must be called in order to have a multiplayer project. Note that this does NOT connect you to a server, only initializes the other multiplayer functionality.
Parámetros
None
No parameters.

Devuelve
No return value.

create_server(size: int) -> None

Ejemplo
Descripción
Creates a multiplayer server. If no one has joined the server within 5 seconds it will be deleted.
Parámetros
size
The maximum number of players that can be connected to the server at any given time. Must be between 2 and 20 inclusive.

Devuelve
No return value. Because of delay the result of the function can be found with get_server_event(), where the event type will be "type": "server_created".

join_server(server_id: str) -> None

Ejemplo
Descripción
Attempts to connect to the server with the specified server id. If the user is already connected to a server they will be disconnected as you can only be connected to one server at a time.
Parámetros
server_id
The ID of the server the user should attempt to join.

Devuelve
No return value. Because of delay the result of the function can be found with get_server_event(), where the event type will be "type": "self_joined".

inspect_server(server_id: str) -> None

Ejemplo
Descripción
Gets information about a specific server without joining it
Parámetros
server_id
The ID of the server to get information about.

Devuelve
No return value. Because of delay the result of the function can be found with get_server_event(), where the event type will be "type": "server_info".

get_server_event() -> dict

Ejemplo
Descripción
Checks for asynchronous (delayed) responses from create_server(), join_server(), and inspect_server() on the current frame.
Parámetros
None
No parameters.

Devuelve
A dictionary with the type of event that was received on the frame, or None if there is no event. If the event type is not None, the dict will also contain the boolean field "status", detailing whether the request was successful or not, as well as the field "message", containing a string with the event message, such as a server id from a "server_created" event.

send_message(data: str) -> None

Ejemplo
Descripción
Sends data to all other users connected to the same server.
Parámetros
data
The string to send. Must be of length less than or equal to 256 characters.

Devuelve
No return value.

get_messages() -> list

Ejemplo
Descripción
Get all the messages that have been received from the current server since get_messages() was last called.
Parámetros
None
No parameters.

Devuelve
A list of string messages that have been received, in order from oldest to most recently received. Returns an empty list if no messages have been received.

get_player_count() -> int

Ejemplo
Descripción
Checks how many people are in the currently connected server.
Parámetros
None
No parameters.

Devuelve
The number of people connected to the current server, 0 if there is no connection.

leave_server() -> None

Ejemplo
Descripción
Disconnects the current user from any servers they are in.
Parámetros
None
No parameters.

Devuelve
No return value.

get_servers() -> list

Ejemplo
Descripción
Gets a list of existing servers for the current project
Parámetros
None
No parameters.

Devuelve
A list with all active server IDs for the same project, or an empty list if there are none.

Multiplayer and Servers

Multiplayer projects are projects you can play together with other people. Sometimes this is done by having multiple people use the same keyboard, but in can also be done over the internet, so people can use their own computers and play projects together even when they are in different places. Pixelpad allows you to create such projects by using servers.

A server is a computer designed to process and respond to requests from other computers, often known as clients. Servers are used for a huge variety of purposes, including this website, but they are also used for making multiplayer projects. Pixelpad has functions to create and join servers, to inspect and see all servers for a project, and to send and receive messages in the servers.