Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- modul:m321:kitten:bot [2025/03/05 13:23] – [Bombe gezogen] msuter
+++ modul:m321:kitten:bot [2025/03/18 10:58] (aktuell) – [Request] msuter
@@ Zeile 3: / Zeile 3: @@
 Ausserdem soll er seine Karten strategisch so ausspielen, dass er alle anderen Bots schlägt.
-===== Start =====
+===== Aufbau =====
-Beim Start muss sich dein Bot beim Clowder-Service registrieren.
+[[https://github.com/templates-python/m321-kitten-local.git|GitHub-Repository]]
+Dein Bot besteht aus zwei Teilen:
+==== Socket-Controller ====
+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.
-Öffne einen Socket mit diesem Port und höre dort auf die Nachrichten des Arena-Services.
-===== Spielen =====
+=== Request ===
+  * action: 'MEOW'
+  * ip: IP-Adresse des Bots
+  * name: Name des Bots
+  * type: 'bot'
+=== Response ===
+  * 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.
+==== Bot-Klasse ====
+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.
+===== Ablauf der Spielrunden =====
 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.
@@ Zeile 17: / Zeile 48: @@
 | NORMAL | Eine Karte ohne besondere Bedeutung. |
 | DEFUSE | Diese Karte entschärft die Bombe. Sie wird automatisch gespielt, wenn du eine EXPLODE-Karte ziehst. |
-| EXPLODE | Dein Bot explodiert, falls du keine DEFUSE-Karte spielst. |
+| EXPLODING_KITTEN | Dein Bot explodiert, falls du keine DEFUSE-Karte spielst. |
-| FUTURE | Mit "See the future" kannst du die nächsten 3 Karten auf dem Stapel sehen. |
+| SEE_THE_FUTURE | Mit "See the future" kannst du die nächsten 3 Karten auf dem Stapel sehen. |
 | SHUFFLE | Mit dieser Karte kannst du den Kartenstapel neu mischen. |
+===== Spielstart =====
+Dein Bot wird informiert, dass ein neues Spiel startet.
+==== Request ====
+  * action: "START"
+  * bots: Anzahl der Bots in dieser Spielrunde
+  * card_counts: Array mit der Anzahl der verschiedenen Karten
+=== Beispiel ===
+<code json>
+{
+  "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"
+}
+</code>
+==== Response ====
+  * ACK
 ===== Karte gezogen =====
@@ Zeile 28: / Zeile 90: @@
   * action: "DRAW"
   * card: Name der gezogenen Karte
+=== Beispiel ===
+''{"card": "DEFUSE", "action": "DRAW"}''
 ==== Response ====
@@ Zeile 34: / Zeile 99: @@
 ===== Dein Spielzug =====
 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.
 ==== Request ====
   * action: "PLAY"
+  * bots: Anzahl der verbliebenen Bots in Spielrunde
+  * deck: Anzahl der Karten im Deck
+=== Beispiel ===
+''{"action": "PLAY"}''
 ==== Response ====
-  * card: Name der auszuspielenden Karte **oder** "None"
+  * card: Name der auszuspielenden Karte **oder** "NONE"
-===== Karte abgelegt =====
+===== Aktionen der anderen Bots =====
-Ein anderer Bot hat eine Karte abgelegt.
+Ein Bot hat eine Aktion durchgeführt.
+Dein Bot wird über jede Aktion jedes Bots informiert, auch seine eigenen Aktionen.
 ==== Request ====
-  * action: "CARD"
+  * action: "INFORM"
-  * card: Name der abgelegten Karte
+  * event: "PLAY" oder "DRAW"
+  * card: Name der Karte
+=== Beispiele ===
+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"}''
 ==== Response ====
   * ACK
-===== Bombe gezogen =====
+===== Bombe entschärft =====
 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.
 ==== Request ====
-  * action: "PLACE"
+  * action: "DEFUSE"
-  * count: Anzahl der Karten im Stapel
+  * decksize: Anzahl der Karten im Stapel
+=== Beispiel ===
+''{"decksize": 3, "action": "DEFUSE"}''
 ==== Response ====
@@ Zeile 70: / Zeile 154: @@
   * cards: Liste mit den Namen der nächsten 3 Karten im Stapel.
+=== Beispiel ===
+''{"cards": ["EXPLODING_KITTEN", "SEE_THE_FUTURE", "NORMAL"], "action": "FUTURE"}''
 ==== Response ====
   * ACK
@@ Zeile 78: / Zeile 164: @@
 ==== Request ====
-  * action: "EXPLODED"
+  * action: "EXPLODE"
+=== Beispiel ===
+''{"action": "EXPLODE"}''
 ==== Response ====
   * ACK
@@ Zeile 88: / Zeile 176: @@
 ==== Request ====
   * action: "GAMEOVER"
-  * FIXME
+  * ranks: Die Rangliste der Bots vom ersten bis zum letzten Platz
+=== Beispiel ===
+''{"ranks": ["cutekitty", "randombot"], "action": "GAMEOVER"}''
 ==== Response ====
   * ACK