Jared Miller
d253012122
Implements Phase 7 foundation: - gmcp.py module with package builders for Char.Vitals, Char.Status, Room.Info, Room.Map, and MSDP vitals - Player helper methods send_gmcp() and send_msdp() for convenience - Full test coverage for all GMCP/MSDP functions and edge cases
59 lines
1.9 KiB
Python
59 lines
1.9 KiB
Python
"""Player state and registry."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass, field
|
|
from typing import TYPE_CHECKING, Any
|
|
|
|
from mudlib.caps import ClientCaps
|
|
from mudlib.entity import Entity
|
|
|
|
if TYPE_CHECKING:
|
|
from mudlib.editor import Editor
|
|
from mudlib.embedded_if_session import EmbeddedIFSession
|
|
from mudlib.if_session import IFSession
|
|
|
|
|
|
@dataclass
|
|
class Player(Entity):
|
|
"""Represents a connected player."""
|
|
|
|
writer: Any = None # telnetlib3 TelnetWriter for sending output
|
|
reader: Any = None # telnetlib3 TelnetReader for reading input
|
|
flying: bool = False
|
|
mode_stack: list[str] = field(default_factory=lambda: ["normal"])
|
|
caps: ClientCaps = field(default_factory=lambda: ClientCaps(ansi=True))
|
|
editor: Editor | None = None
|
|
if_session: IFSession | EmbeddedIFSession | None = None
|
|
paint_mode: bool = False
|
|
painting: bool = False
|
|
paint_brush: str = "."
|
|
|
|
@property
|
|
def mode(self) -> str:
|
|
"""Current mode is the top of the stack."""
|
|
return self.mode_stack[-1]
|
|
|
|
@property
|
|
def color_depth(self) -> str:
|
|
"""Best available color mode: truecolor, 256, or 16."""
|
|
return self.caps.color_depth
|
|
|
|
async def send(self, message: str) -> None:
|
|
"""Send a message to the player via their telnet writer."""
|
|
self.writer.write(message)
|
|
await self.writer.drain()
|
|
|
|
def send_gmcp(self, package: str, data: Any = None) -> None:
|
|
"""Send a GMCP message to the client (no-op if unsupported)."""
|
|
if self.writer is not None:
|
|
self.writer.send_gmcp(package, data)
|
|
|
|
def send_msdp(self, variables: dict) -> None:
|
|
"""Send MSDP variables to the client (no-op if unsupported)."""
|
|
if self.writer is not None:
|
|
self.writer.send_msdp(variables)
|
|
|
|
|
|
# Global registry of connected players
|
|
players: dict[str, Player] = {}
|