Document bottleneck messages

server/gameconnection.py

@@ -505,7 +505,7 @@
         self.finished_sim = True
         await self.game.check_game_finish(self.player)
 
-    async def handle_rehost(self, *args: list[Any]):
+    async def handle_rehost(self, *args: Any):
         """
         Signals that the user has rehosted the game. This is currently unused but
         included for documentation purposes.
@@ -519,21 +519,54 @@
         """
         pass
 
-    async def handle_bottleneck(self, *args: list[Any]):
+    async def handle_bottleneck(self, code: str, *args: str):
         """
         Not sure what this command means. This is currently unused but
         included for documentation purposes.
         """
-        pass
-
-    async def handle_bottleneck_cleared(self, *args: list[Any]):
+        self._logger.debug("Bottleneck: %s", list((code, *args)))
+
+        if code == "ack":
+            # Example
+            # ```python
+            # {
+            #     "command": "Bottleneck",
+            #     "target": "game",
+            #     "args": ["ack", "17654", "466996,436136,443631,402513,302866", "14222.5"],
+            # }
+            # ```
+            pass
+        elif code == "data":
+            # Example
+            # ```python
+            # {
+            #     "command": "Bottleneck",
+            #     "target": "game",
+            #     "args": ["data", "19508", "517268,516974,344419", "5980.1"],
+            # }
+            # ```
+            # 517268,516974,344419 are the player ids of other players (not the sender)
+            # 5980.1 is an increasing value
+            pass
+        elif code == "readiness":
+            # Example
+            # ```python
+            # {
+            #     "command": "Bottleneck",
+            #     "target": "game",
+            #     "args": ["readiness", "1", "234112", "5220.7"],
+            # }
+            # ```
+            pass
+
+    async def handle_bottleneck_cleared(self):
         """
         Not sure what this command means. This is currently unused but
         included for documentation purposes.
         """
-        pass
+        self._logger.debug("BottleneckCleared")
 
-    async def handle_disconnected(self, *args: list[Any]):
+    async def handle_disconnected(self, *args: Any):
         """
         Not sure what this command means. This is currently unused but
         included for documentation purposes.