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.