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)