PixelPAD 2D - multiplayer

init_multiplayer() -> None

例
説明
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.
パラメータ
None
No parameters.

戻り値
No return value.

create_server(size: int) -> None

例
説明
Creates a multiplayer server. If no one has joined the server within 5 seconds it will be deleted.
パラメータ
size
The maximum number of players that can be connected to the server at any given time. Must be between 2 and 20 inclusive.

戻り値
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

例
説明
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.
パラメータ
server_id
The ID of the server the user should attempt to join.

戻り値
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

例
説明
Gets information about a specific server without joining it
パラメータ
server_id
The ID of the server to get information about.

戻り値
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

例
説明
Checks for asynchronous (delayed) responses from create_server(), join_server(), and inspect_server() on the current frame.
パラメータ
None
No parameters.

戻り値
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

例
説明
Sends data to all other users connected to the same server.
パラメータ
data
The string to send. Must be of length less than or equal to 256 characters.

戻り値
No return value.

get_messages() -> list

例
説明
Get all the messages that have been received from the current server since get_messages() was last called.
パラメータ
None
No parameters.

戻り値
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

例
説明
Checks how many people are in the currently connected server.
パラメータ
None
No parameters.

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

leave_server() -> None

例
説明
Disconnects the current user from any servers they are in.
パラメータ
None
No parameters.

戻り値
No return value.

get_servers() -> list

例
説明
Gets a list of existing servers for the current project
パラメータ
None
No parameters.

戻り値
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.