Dokumentation zum Spielserver der Software Challenge

Transkript

1 Dokumentation zum Spielserver der Software Challenge Inhaltsverzeichnis: Programmoberfläche... 2 Ein neues Spiel erstellen... 2 Spielfeldoberfläche... 4 Spielwiederholung laden... 5 Testdurchläufe... 6 Forum... 7

2 Programmoberfläche Die Programmoberfläche besteht aus dem Menü, der Spielfläche und der Statusleiste. Über das Menü oben sind alle Funktionen des Servers erreichbar. Die Spielfläche in der Mitte mit den Steuerelementen dient zur Anzeige der Spiele. Die Statusleiste unten gibt kurze Statusinformationen zum Spiel aus. Zu Beginn ist die Spielfläche leer. Ein neues Spiel erstellen Um ein Spiel zu spielen, muss zunächst über das Menü Spiel Neues Spiel erstellen das folgende Fenster aufgerufen werden: 2

3 In diesem Fenster werden die Spieler ausgewählt, die an dem Spiel teilnehmen sollen. Die 4 Spalten sind folgendermaßen zu verstehen: Position: Stellt die Startpositionen der einzelnen Spieler dar (der Spieler an Position 1 beginnt). Name: Hier kann für jeden Spieler ein Name eingegeben werden, der dann im Spiel angezeigt wird. Spielertyp: Es kann zwischen 3 verschiedenen Spielertypen gewählt werden: 1. Mensch: Ein menschlicher Spieler, der über die Programmoberfläche spielt. 2. Computerspieler: Ein Computerspieler in Form eines separaten Programms, das beim Starten des Spiels automatisch vom Server gestartet wird. 3. Computerspieler (manuell): Ein Computerspieler in Form eines separaten Programms, das manuell durch den Benutzer gestartet werden muss. Dateiname (auswählbar für Computerspieler ): Bei Spielertyp Computerspieler ist eine Programmdatei auszuwählen, deren Name dann hier angezeigt wird. Bei anderen Spielertypen wird dort - angezeigt. Unten lässt sich der Port für das Spiel einstellen. Dieser wird zum Verbinden der Programme mit dem Server benötigt, insbesondere für diejenigen, die manuell gestartet werden. Standardmäßig ist eingestellt. Links daneben kann wahlweise das Zeitlimit für einen Zug für Computerspieler deaktiviert werden. Menschliche Spieler können immer unbeschränkt lange über ihren aktuellen Zug nachdenken. Das Zeitlimit ist abhängig vom ausgewählten Spieltyp (s.u. und entsprechende Dokumentation). Benötigt ein Computerspieler mehr Zeit für die Kalkulation eines Zuges, wird das Spiel automatisch vom Server beendet und der Computerspieler verliert das Spiel. Die Option Spiel aus Datei laden ermöglicht es, einen beliebigen Spielzustand aus einer XML-Datei zu laden. Die XML-Datei muss dabei den Regeln genügen, wie sie in der 3

4 Kommunikations-Dokumentation beschrieben sind. Das Spiel wird dann ausgehend von dem so geladenen Spielzustand fortgesetzt. Links unten kann der Spieltyp ausgewählt werden, d.h. insbesondere das aktuelle Spiel des Jahres (z.b. 2011: Schäfchen im Trockenen). Nach Eingabe der erforderlichen Werte kann das Spiel mithilfe des unteren Knopfs Spiel starten erstellt werden. Dabei erscheint der Dialog Warte auf Spieler solange, bis alle Computerspieler gestartet und mit dem Server verbunden wurden. Hinweis: Es kann immer nur höchstens ein Spiel zurzeit über den Server gespielt werden. Spielfeldoberfläche Die Spielfeldoberfläche setzt sich aus dem Spielbrett (der große zentrale Bereich) und den Spielsteuerelementen (unten) zusammen. Auf dem Spielbrett werden das eigentliche Spiel (hier z.b. Schäfchen im Trockenen ), die Züge und weitere für das Spiel wichtige Informationen dargestellt. Hier setzt der menschliche Spieler auch seine Züge. 4

5 Die Steuerelemente am unteren Rand haben folgende Bedeutung: Über den Geschwindigkeitsregler kann die Pausenlänge zwischen zwei Spielzügen eingestellt werden. Spielen 2 Computerspieler gegeneinander, ist es evtl. ratsam, diesen Wert z.b. auf 3 Sekunden einzustellen, damit die Partie besser am Bildschirm verfolgt werden kann. Ganz rechts unten am Rand kann ein laufendes Spiel mithilfe des Knopfes Abbrechen abgebrochen werden, wobei alle verbundenen Computerspieler vom Server getrennt werden. Damit das Spiel nicht versehentlich abgebrochen wird, erscheint vor dem Abbruch allerdings zunächst ein Warnhinweis. Dieser Warnhinweis kann über den Menüpunkt Optionen ausgeschaltet werden. Spielwiederholung laden Nachdem ein Spiel beendet wurde, sei es durch den Benutzer, aufgrund der Spielregeln oder aus einem anderen Grund, wird eine Wiederholungsdatei im Ordner Replay erstellt. Diese kann über das obige Menü unter Spiel Spielwiederholung laden ausgewählt werden. Dabei öffnet sich das folgende Fenster Wiederholung laden : Oben muss der Spieltyp der zu ladenden Wiederholung ausgewählt werden. Nach Betätigung des Knopfes Wiederholung auswählen kann die Replay-Datei des gewünschten Spiels gewählt werden. Die Dateinamen sind dabei nach folgendem Schema aufgebaut, wobei anstelle der kursiven Worte die Werte des betreffenden Spiels einzusetzen sind: replay_spielername1_spielername2 Datum Uhrzeit.xml.gz, also z.b. replay_jasper_johannes _10_16.xml.gz Mit Start wird dann die Wiederholung geladen und auf der zuvor beschriebenen Spielfeldoberfläche dargestellt. 5

6 Testdurchläufe Über das Menü Spiel Testdurchläufe gelangt man zum unten abgebildeten Konfigurationsfenster. Hier kann man Computerspieler (keine menschlichen Spieler) gegeneinander in mehreren Spielen hintereinander antreten lassen und erhält eine ausführliche Statistik über die absolvierten Spiele. Oben muss der Spieltyp ausgewählt, rechts daneben die Anzahl der Spiele eingegeben werden. Außerdem kann wieder optional das Zeitlimit deaktiviert werden. Darunter sind die Computerspieler auszuwählen. Anschließend kann der Test durch das Anklicken des entsprechenden Knopfes unten rechts gestartet werden. Sollte es während der Testdurchläufe zu einem fehlerhaften Spiel kommen, wird dieses als Replay-Datei gespeichert. Andere Spiele werden nicht gespeichert. Hinweis: Pro Sieg gibt es 2 Siegpunkte, pro unentschieden einen Siegpunkt. Somit gibt es im obigen Beispiel bei 20 Testspielen für beide Spieler zusammen 40 Siegpunkte. Mindestens ein Spiel muss unentschieden geendet haben. 6

7 Forum Wenn Fragen zu den beschriebenen oder anderen Funktionen des Servers auftreten sollten, steht das Forum auf der Homepage der CAU (Bereich Software Challenge) für die Klärung dieser Fragen zur Verfügung: 7