core.multiplayer package

Submodules

core.multiplayer.protocol module

Multiplayer protocol definitions. Defines message types and serialization for network communication.

class core.multiplayer.protocol.MessageType

Bases: object

CUSTOM = 'custom'

DESPAWN_ENTITY = 'despawn_entity'

DISCONNECT = 'disconnect'

GAME_START = 'game_start'

JOIN_ACCEPTED = 'join_accepted'

JOIN_REJECTED = 'join_rejected'

JOIN_REQUEST = 'join_request'

LOBBY_STATE = 'lobby_state'

OWNERSHIP_TRANSFER = 'ownership_transfer'

PING = 'ping'

PLAYER_JOINED = 'player_joined'

PLAYER_LEFT = 'player_left'

PLAYER_READY = 'player_ready'

PONG = 'pong'

RPC_CALL = 'rpc_call'

SPAWN_ENTITY = 'spawn_entity'

STATE_SYNC = 'state_sync'

STATE_UPDATE = 'state_update'

core.multiplayer.protocol.decode_message(raw: str) → dict | None

Decode a JSON string to a multiplayer message dict.

core.multiplayer.protocol.encode_message(msg_type: str, data: dict = None, sender_id: str = '') → str

Encode a multiplayer message to JSON string.

core.multiplayer.room module

Room and Player management for multiplayer sessions.

class core.multiplayer.room.Player(player_id: str = '', name: str = 'Player', client_id: int = 0, is_host: bool = False, is_local: bool = False)

Bases: object

Represents a connected player in a multiplayer session.

client_id

custom_data: dict

static from_dict(data: dict) → Player

id

is_host

is_local

is_ready

latency_ms

name

to_dict() → dict

class core.multiplayer.room.Room(room_name: str = 'Room', max_players: int = 8)

Bases: object

Manages a multiplayer room/lobby with player tracking.

add_player(player: Player) → bool

Add a player to the room. Returns False if full.

all_ready() → bool

Return True if all players are marked as ready.

static from_dict(data: dict) → Room

get_host() → Player | None

get_player(player_id: str) → Player | None

get_player_by_client(client_id: int) → Player | None

get_player_count() → int

is_full() → bool

players: dict[str, Player]

remove_player(player_id: str) → Player | None

Remove a player by ID. Returns the removed Player or None.

to_dict() → dict

Module contents