Die XML-Schnittstelle zum Server🔖

Der Spielleiter kommuniziert mit den Computerspielern über eine Netzwerkverbindung. Dadurch ist man aus technischer Sicht komplett flexibel, was die Wahl der Programmiersprache angeht. Die Computerspieler müssen lediglich das Kommunikationsprotokoll erfüllen.

Anfängern wird allerdings davon abgeraten, einen komplett eigenen Computerspieler zu schreiben. Es ist deutlich einfacher, auf einer bereitgestellten Spielervorlage aufzubauen, da man sich dabei nur um die Strategie und nicht um die Kommunikation kümmern muss. Außerdem wird vom Institut für Informatik die beste Unterstützung für Java/Kotlin geboten.

Spielspezifische Elemente werden in der Dokumentation des jeweiligen Spiels dokumentiert.

Der Aufbau🔖

Die Darstellung skizziert die Architektur unseres Spielsystems, bestehend aus dem Server als Spielleiter und zwei Spielern. Der Server verwaltet das Spielgeschehen und interagiert über das XML-Protokoll mit den beiden Spielern, die jeweils auf einer Spielervorlage aufbauen.

Das Spielprotokoll🔖

In diesem Abschnitt wird die spielunabhängige Kommunikationsschnittstelle für Spieler festgehalten, um das Schreiben eines komplett eigenen Clients zu ermöglichen.

Spiel betreten🔖

<protocol>

Dieses Tag eröffnet die Kommunikation mit dem Server. Dann gibt es drei Möglichkeiten, einer Spielpartie beizutreten.

Beliebige Partie🔖

Betritt eine beliebige offene Spielpartie:

<join />

Sollte kein Spiel offen sein, wird automatisch ein neues erstellt. Abhängig von der Einstellung paused in server.properties wird das Spiel pausiert, gestartet oder nicht.

Bestimmte Partie🔖

Einer bestimmten, bereits offenen, aber noch nicht gestarteten Partie kann durch Angabe der ROOM_ID beigetreten werden:

<joinRoom roomId="ROOM_ID" />

Mit Reservierung🔖

Unter Angabe eines Reservierungscodes kann man einen reservierten Platz in einer geplanten Partie einnehmen:

<joinPrepared reservationCode="RESERVATION" />

Antwort nach der Verbindung🔖

Der Server antwortet auf einen erfolgreichen Spielbeitritt mit:

<joined roomId="ROOM_ID" />

• ROOM_ID
  • Identifikationscode der Spielpartie

Spielverlauf🔖

Folgend werden die spiel spezifischen Punkte des XML-Protokolls erläutert, welche sich in jedem Jahr ändern und auch am Anfang der Saison noch Änderungen unterliegen kann.

Start🔖

Der Server eröffnet das Spiel mit einer Begrüßung und dem initialen Spielstatus, sobald beide Spieler verbunden sind.

• ROOM_ID

  • Identifikationscode der Spielpartie

• TEAMNUMBER

  • Spielernummer, eg. ONE, TWO

Syntax der Willkommensnachricht🔖

<room roomId="ROOM_ID">
  <data class="welcomeMessage" color="TEAMNUMBER"></data>
</room>
<room roomId="ROOM_ID">
  <data class="memento">
    SPIELSTATUS
  </data>
</room>

Spielablauf🔖

Der erste Spieler erhält dann eine Zugaufforderung:

<room roomId="ROOM_ID">
  <data class="moveRequest" />
</room>

Worauf dieser innerhalb der erlaubten Zeitspanne mit einem spielspezifischen Zug antwortet.