Computerspieler abgabefertig machen🔖

Damit das Wettkampfsystem mit dem Computerspieler arbeiten kann, muss er als ausführbares Programm in ein ZIP-Archiv gepackt werden.

Je nach Programmiersprache, in der der Computerspieler entwickelt wurde, sind unterschiedliche Schritte notwendig.

Offizielle Spielervorlagen🔖

• Java
• Ruby

Inoffizielle Spielervorlagen🔖

• C#
• C++
• Python
• Rust
• Swift

Wie man den abgabefertigen Computerspieler dann im Wettkampfsystem einsendet, ist unter Wettkampfsystem->Computerspieler beschrieben.

Andere Programmiersprache🔖

Bei Computerspielern in einer anderen Programmiersprache muss das ZIP-Archiv ein Shell-Script mit genauen Instruktionen zum Start des Computerspielers enthalten. Dieses muss nach dem Hochladen im Wettkampfystem als Hauptdatei ausgewählt werden.

Beachten Sie hierbei, dass diesem Script vom Wettkampfsystem Parameter übergeben werden, die an Ihr Programm weitergegeben werden müssen. Diese Parameter sind mindestens Host und Port des Spielservers sowie die Reservierungsnummer des Spiels, dem der Computerspieler beitreten soll. Ein Aufruf sieht also in etwa wie folgt aus (falls start.sh als Hauptdatei eingestellt ist):

start.sh -h gameserver -p 13050 -r 590e5e6f-cf93-488e-a12d-5c194ecf95c2

Die Parameter folgen dabei den GNU Getopt Konventionen. Das heißt, die drei Parameter können in beliebiger Reihenfolge und als kurze oder lange Version übergeben werden. Folgende Variante muss also auch von Ihrem Programm korrekt verarbeitet werden können:

start.sh --reservation 590e5e6f-cf93-488e-a12d-5c194ecf95c2 --host gameserver --port 13050

Auch der Server mit grafischer Oberfläche ruft Ihr Programm mit diesen Parametern auf. Ihr Programm wird also nur von der grafischen Oberfläche richtig gestartet, wenn es die Parameter richtig verarbeitet.

Für die meisten Programmiersprachen gibt es Bibliotheken, die die Kommandozeilenparameter nach diesem Schema verarbeiten können, sie müssen diese Funktion also nicht unbedingt selbst implementieren.

Weiterhin ist es wichtig, den Interpreter in der ersten Zeile des Script anzugeben, da das Script nicht von einer Shell aufgerufen wird. Ein start.sh Script sieht also in etwa so aus:

#!/bin/sh
chmod +x hauptprogramm_dateiname
./hauptprogramm_dateiname "$@"

• Script soll von /bin/sh interpretiert werden, es ist also ein einfaches Shell-Script.

• Die Binärdatei wird ausführbar gemacht (das ist nötig, da in einem ZIP-Archiv das Ausführbar-Attribut nicht gespeichert wird).

• Die Binärdatei wird aufgerufen und alle Parameter, die das Script bekommen hat, werden weitergereicht ("$@").

Die start.sh muss in UTF-8 und mit UNIX(LF) Zeilenenden kodiert sein. Andere Kodierungen führen zu Fehlern bei der Ausführung auf dem Server. In Notepad++ kann die Kodierung einfach in dem Tab Kodierung angepasst werden, die Zeilenenden in Bearbeiten > Format Zeilenende.

Bei compilierten Sprachen müssen die Computerspieler für 64bit Linux compiliert werden, bei interpretierten Sprachen muss ein passender Interpreter auf dem Wettkampfsystem vorhanden sein. Weiterhin müssen Abhängigkeiten wie z.B. genutzte Bibliotheken vorhanden sein oder mitgeliefert werden.