B) Kitten-Bot

Dein Exploding Kitten-Bot muss in der Lage sein, korrekt mit den Services zu kommunizieren. Ausserdem soll er seine Karten strategisch so ausspielen, dass er alle anderen Bots schlägt.

GitHub-Repository

Dein Bot besteht aus zwei Teilen:

Der Socket-Controller steuert die Kommunikation mit den Services. Er erzeugt auch ein Objekt deiner Bot-Klasse.

Beim Start registriert der Socket-Controller deinen Bot beim Clowder-Service. Als Response erhält er einen Port.

• action: 'MEOW'
• ip: IP-Adresse des Bots
• name: Name des Bots
• type: 'bot'

• Port: Eine zufällige Portnummer. Unter dieser Portnummer muss der Bot einen Socket öffnen und auf Nachrichten warten.

Danach öffnet er einen Socket mit diesem Port und hört dort auf die Nachrichten des Arena-Services.

Sobald ein Request eintrifft, wird dieser analysiert und die korrekte Methode in der Bot-Klasse aufgerufen.

Die Bot-Klasse enthält die Logik zur Steuerung deines Bots. Im Vorlage-Repository findest du zwei Bots:

• TemplateBot: Eine Kopiervorlage für deine eigenen Bots
• RandomBot: Ein vollständiger Bot, der seine Entscheidungen anhand des Zufallsprinzips trifft.

Beide Beispiele enthalten eine Helfer-Klasse, welche die Methode request(self, data) implementiert. Diese Helfer-Klasse wird benötigt, um deine Bots mit der lokalen Version der Arena auszuführen. Sie ersetzen dabei den Socket-Controller.

Immer wenn eine relevante Aktion im Spiel stattfindet, sendet der Arena-Service einen Request an deinen Bot. Er muss innerhalb einer Sekunde eine gültige Reponse an den Server senden. Andernfalls scheidet dein Bot aus.

Dein Bot wird informiert, dass ein neues Spiel startet.

• action: „START“
• bots: Anzahl der Bots in dieser Spielrunde
• card_counts: Array mit der Anzahl der verschiedenen Karten

{
  "card_counts": [
    {"name": "DEFUSE", "count": 2}, 
    {"name": "EXPLODING_KITTEN", "count": 1}, 
    {"name": "NORMAL", "count": 10}, 
    {"name": "SEE_THE_FUTURE", "count": 4}, 
    {"name": "SHUFFLE", "count": 3}, 
    {"name": "SKIP", "count": 8}
  ], 
  "bots": [
    "cutekitty", 
    "randombot"
  ], 
  "action": "START"
}

• ACK

Dein Bot hat eine Karte vom Stapel gezogen.

• action: „DRAW“
• card: Name der gezogenen Karte

{„card“: „DEFUSE“, „action“: „DRAW“}

• ACK

Dein Bot ist am Zug und kann eine Karte ausspielen oder nicht. Dein Bot ist solange am Zug, bis er keine Karte mehr spielt. Er wird also mehrmals hintereinander mit dieser Aktion aufgerufen.

Die Ausnahme ist, wenn dein Bot die Karte „Skip“ ausspielt. Nach dieser Karte macht es keinen Sinn, dass er weitere Karten spielt.

• action: „PLAY“
• bots: Anzahl der verbliebenen Bots in Spielrunde
• deck: Anzahl der Karten im Deck

{„action“: „PLAY“}

• card: Name der auszuspielenden Karte oder „NONE“

Ein Bot hat eine Aktion durchgeführt. Dein Bot wird über jede Aktion jedes Bots informiert, auch seine eigenen Aktionen.

• action: „INFORM“
• event: „PLAY“ oder „DRAW“
• card: Name der Karte

Ein Bot hat …

• … eine Karte gespielt: {„botname“: „cutekitty“, „event“: „PLAY“, „data“: „NORMAL“, „action“: „INFORM“}
• … eine Karte gezogen: {„botname“: „cutekitty“, „event“: „DRAW“, „data“: „null“, „action“: „INFORM“}

• ACK

Dein Bot hat soeben eine „Exploding Kitten“ Karte gezogen und mit „Defuse“ entschärft. Du kannst nun die „Exploding Kitten“ Karte an einer beliebigen Stelle im Kartenstapel platzieren.

• action: „DEFUSE“
• decksize: Anzahl der Karten im Stapel

{„decksize“: 3, „action“: „DEFUSE“}

• position: Position innerhalb des Kartenstapels

Dein Bot hat die Karte „See the future“ gespielt. Er sieht nun die nächsten 3 Karten im Stapel.

• action: „FUTURE“
• cards: Liste mit den Namen der nächsten 3 Karten im Stapel.

{„cards“: [„EXPLODING_KITTEN“, „SEE_THE_FUTURE“, „NORMAL“], „action“: „FUTURE“}

• ACK

Dein Bot hat soeben eine „Exploding Kitten“ Karte gezogen und hatte keine „Defuse“ Karte. Damit ist dein Bot ausgeschieden.

• action: „EXPLODE“

{„action“: „EXPLODE“}

• ACK

Am Ende einer Spielrunde erfährt dein Bot das Resultat.

• action: „GAMEOVER“
• ranks: Die Rangliste der Bots vom ersten bis zum letzten Platz

{„ranks“: [„cutekitty“, „randombot“], „action“: „GAMEOVER“}

• ACK