XML-Elemente des Spiels Mississippi Queen🔖

Diese Dokumentation beschreibt die spielspezifischen Elemente des XML-Protokolls für das Spiel Mississippi Queen.

Spielstatus🔖

Die folgende XML-Struktur beschreibt den regelmäßig mitgeteilten Spielstatus, der ein Spielfeld aus hexagonalen Feldern mittels kubischer Koordinaten sowie eine Liste der darauf verorteten Schiffe beschreibt. Das Spielfeld wird in Segmente unterteilt, wobei jedes Segment durch eine Richtung und ein Zentrum charakterisiert wird. Die Cube-Koordinaten ($q$, $r$ und $s$) ermöglichen die eindeutige Positionierung der Segmente im hexagonalen Raster und eine einfache Nutzung verschiedener Algorithmen innerhalb dieses Systems.

<state turn="0" currentTeam="ONE">
	<board nextDirection="RICHTUNG">
		<segments>
			<segment direction="RICHTUNG">
				<center q="INT" r="INT" s="INT" />
				<fields>
					<array>
						<water/>
						<island/>
						<passenger direction="RICHTUNG" passenger="INT"/>
						<!-- usw. für andere Felder -->
					</array>
					<!-- usw. für andere Arrays -->
				</fields>
			</segment>
			<!-- usw. für andere Segmente -->
		</segments>
	</board>
	<ships>
		<ship team="TEAM" points="INT" direction="RICHTUNG" speed="INT" coal="INT" passengers="INT" freeTurns="INT">
			<position q="INT" r="INT" s="INT" />
		</ship>
		<!-- usw. für das andere Schiff -->
	</ships>
</state>

• Die <state>-Ebene gibt Auskunft über den aktuellen Spielzustand, einschließlich des Spielzugs (turn) und des Teams (currentTeam), das gerade am Zug ist.
• Die <board>-Ebene enthält Informationen über das Spielfeld, darunter die Richtung des nächsten Segments (nextDirection), um die Strömung zuverlässig zu kalkulieren.
• Die <segments>-Ebene enthält eine Liste von Segmenten, die jeweils eine bestimmte Richtung und ein Zentrum haben. Jedes Segment kann verschiedene Feldtypen enthalten, wie Wasser, Inseln, Passagiere usw., die in Arrays organisiert sind.

• Die <ship>-Ebene enthält Informationen über Schiffe im Spiel. Jedes Schiff wird durch Teamzugehörigkeit (team), Punktzahl (points), Blickrichtung (direction), Geschwindigkeit (speed), Kohlebestand (coal), Anzahl der Passagiere (passengers) und verbleibende Runden mit freier Bewegung (freeTurns) charakterisiert. Die Position des Schiffs wird durch Cube-Koordinaten ($q$, $r$ und $s$) angegeben.

Richtungen🔖

Da Mississippi-Queen auf einem hexagonalen Spielfeld gespielt wird, folgen daraus die sechs Richtungen:

• RIGHT : q+1, r+0, s-1
• DOWN_RIGHT : q+0, r+1, s-1
• DOWN_LEFT : q-1, r+1, s+0
• LEFT : q-1, r+0, s+1
• UP_LEFT : q+0, r-1, s+1
• UP_RIGHT : q+1, r-1, s+0

Spielzug🔖

Ein Zug kann beispielhaft wie folgt aussehen:

<room roomId="ROOM_ID">
  <move>
      <actions>
          <acceleration acc="1" />
          <advance distance="2" />
          <push direction="RIGHT" />
          <turn direction="DOWN_RIGHT" />
      </actions>
  </move>
</room>

Ein Zug besteht immer aus einer Liste aus Aktionen. Die Reihenfolge dieser Liste bestimmt auch, in welcher Reihenfolge die Aktionen ausgeführt werden. Insbesondere muss die Beschleunigungsaktion immer als erstes kommen.