Administration
Mit einem authentifizierten Client kann man den Server steuern.
Verbindungsaufbau
Zuerst muss sich ein Client mit dem entsprechenden Passwort aus server.properties
authentifizieren:
<protocol><authenticate password="examplepassword"/>
Ein authentifizierter AdminClient wird benachrichtigt,
wenn sich ein Computerspieler über ein JoinRoomRequest
verbindet:
<joinedGameRoom roomId=ROOMID playerCount=X />
-
roomId: eine vom Server generierte Zeichenfolge, die die Partie identifiziert
-
playerCount: die Anzahl der Spieler im Raum nach dem Beitritt des neuen Spielers
Aktionen in einem Raum
Ein AdminClient kann sich als Beobachter eines Raums registrieren lassen, dadurch erhält er alle Nachrichten, die das Spiel betreffen:
<observe roomId=ROOMID />
Ein AdminClient kann ein Spiel pausieren oder fortsetzen:
<pause roomId=ROOMID pause="true/false" />
Ein AdminClient kann den nächsten Zug in einem pausierten Spiel anfordern:
<step roomId=ROOMID />
Ein AdminClient kann ein Spiel abbrechen:
<cancel roomId=ROOMID />
Ein AdminClient kann einen Spielraum vorbereiten:
<prepare gameType="pluginId" pause="true">
<slot displayName="p1" canTimeout="true" reserved="true"/>
<slot displayName="p2" canTimeout="true" reserved="true"/>
</prepare>
- pluginId: identifiziert das Spiel (für Hey, Danke für den Fisch:
swc_2023_pengins
) - pause: ob das angelegte Spiel nach Beitritt aller Spieler pausiert startet
Hierauf antwortet der Server ggf. mit Reservierungscodes für die Spieler zum Beitreten.
Servereinstellungen
Der Server lässt sich in der server.properties
Datei konfigurieren,
die zusammen mit dem Server heruntergeladen wird.
In ihr können folgende Werte konfiguriert werden:
- password: lokales Administratorpasswort (standardmäßig auf
examplepassword
) - paused: ob ein automatisch angelegtes Spiel anfangs pausiert sein soll oder nicht (standardmäßig pausiert)