Software-Challenge Dokumentation

Spielverlauf

Der Server startet (StandardIp: localhost 13050).

Nun gibt es zwei Varianten ein Spiel zu starten, eine durch einen Administratorclient die andere durch hinzufügen der Spieler zu einen Spieltyp:

Variante 1 (AdminClient ???)

Ein Computerspieler registriert sich als Administrator mit dem in server.properties festgelegten Passwort p:

<protocol><authenticate password="p" />

Dann kann ein Spiel angelegt werden:

<prepare gameType="swc_2019_piranhas">
  <slot displayName="p1" canTimeout="false" shouldBePaused="true" />
  <slot displayName="p2" canTimeout="false" shouldBePaused="true" />
</prepare>

Der Server antwortet darauf mit einer Nachricht, die die ROOM_ID und Reservierungscodes für die beiden Clients enthält:

<protocol>
  <prepared roomId="871faccb-5190-4e44-82fc-6cdcbb493726">
    <reservation>RC1</reservation>
    <reservation>RC2</reservation>
  </prepared>

Der Administratorclient kann nur ebenfalls als Observer des Spiels genutzt werden, indem ein entsprechender Request gesendet wird. Dadurch wird das derzeitge Spielfeld (???) ebenfalls an den Administratorclient gesendet.

<observe roomId="871faccb-5190-4e44-82fc-6cdcbb493726" />

Clients die auf dem Serverport (localhost 13050) gestartet werden können so über diesen Code joinen.

<protocol>
  <joinPrepared reservationCode="RC1" />
 
<protocol>
  <joinPrepared reservationCode="RC2" />

Variante 2 ((eventuell) ohne AdminClient ???)

Die Clients wurden auf dem Serverport (Standard: localhost 13050) gestartet.

Sie können sich mit folgender Anfrage einen bereits offenen Spiel gleichen Typs beitreten oder, falls kein Spiel des Typs vorhanden selbst eines starten:

<protocol>
  <join gameType="swc_2019_piranhas" />

Der Server antwortet mit:

<protocol>
  <joined roomId="871faccb-5190-4e44-82fc-6cdcbb493726" />

Weiterer Spielverlauf

Der Server antwortet jeweils mit der WelcomeMessage (???) und dem ersten GameState (???) sobald beide Spieler verbunden sind.

<room roomId="871faccb-5190-4e44-82fc-6cdcbb493726">
  <data class="welcomeMessage" color="red" />
</room>
<room roomId="871faccb-5190-4e44-82fc-6cdcbb493726">
  <data class="memento">
    <state class="state" startPlayerColor="RED" currentPlayerColor="RED" turn="0">
      <red displayName="Red" color="RED"/>
      <blue displayName="Blue" color="BLUE"/>
      <board>
        <fields>
          <null/>
          <null/>
          <null/>
          <null/>
          <null/>
          <field x="-5" y="0" z="5" isObstructed="false"/>
          <field x="-5" y="1" z="4" isObstructed="false"/>
          <field x="-5" y="2" z="3" isObstructed="false"/>
          <field x="-5" y="3" z="2" isObstructed="false"/>
          <field x="-5" y="4" z="1" isObstructed="false"/>
          <field x="-5" y="5" z="0" isObstructed="false"/>
        </fields>
        <fields>
          <null/>
          <null/>
          <null/>
          <null/>
          <field x="-4" y="-1" z="5" isObstructed="false"/>
          <field x="-4" y="0" z="4" isObstructed="false"/>
        </fields>
        ...
        <fields>
        ...
        </fields>
      </board>
    </state>
  </data>
</room>

Der erste Spieler erhält dann eine Zugaufforderung (???), falls in server.properties paused auf false gesetzt wurde. Falls das Spiel pausiert ist, muss das Spiel durch einen Administratorclient gestartet werden:

Verbinden des Administratorclients (falls es sich um die erste Kontaktaufnahme zum Server handelt, ansonsten <protocol> weglassen).

<protocol>
  <authenticate password="examplepassword" />

Pausierung aufheben:

<pause roomId="871faccb-5190-4e44-82fc-6cdcbb493726" pause="false" />

Daraufhin wird der erste Spieler aufgefordert einen Zug zu senden:

<room roomId="871faccb-5190-4e44-82fc-6cdcbb493726">
  <data class="sc.framework.plugins.protocol.MoveRequest" />
</room>

Der Computerspieler des CurrentPlayer sendet nun einen Zug (???):

<room roomId="871faccb-5190-4e44-82fc-6cdcbb493726">
  <data class="setmove">
    <piece owner="RED" type="BEETLE" />
    <destination x="-2" y="0" z="2"/>
  </data>
</room>

So geht es abwechselnd weiter, bis zum Spielende (???). Die letzte Nachricht des Servers endet mit:

</protocol>

Danach wird die Verbindung geschlossen.

spielverlauf