capture

examples/ai_testing/README.md

@@ -0,0 +1,249 @@
+# 🤖 AI Testing Tools
+
+כלים לבדיקת יכולת ה-AI להבין מצבי משחק באמצעות Web Visualizer.
+
+## 🎯 מטרה
+
+הכלים האלה מאפשרים:
+1. **לתפוס מצב משחק אמיתי** מתוך משחק רץ
+2. **לראות את ה-JSON המדויק והמלא** שעובר לוויזואליזציה (זה מה שנשלח ל-AI)
+3. **להציג מצב משחק ספציפי** ב-Web Visualizer
+4. **לבדוק אם AI מבין את מצב הלוח** לפני שמפתחים אותו
+
+## 📁 קבצים
+
+```
+ai_testing/
+├── capture_with_web.py         # תופס JSON + פותח דפדפן 🌟 BEST FOR VIEWING!
+├── show_complete_state.py      # מציג מצב מלא וסיכום (ללא דפדפן)
+├── simple_capture.py           # תופס JSON בלבד (מהיר)
+├── visualize_game_state.py     # מציג JSON קיים בדפדפן
+├── sample_states/              # קבצי JSON לדוגמה
+│   ├── captured_game.json      # מצב שנתפס ממשחק אמיתי ✅
+│   └── ...
+├── captured_states/            # כל המצבים שנתפסו
+│   ├── state_001_initial.json
+│   └── state_XXX_final.json
+└── README.md                   # התיעוד הזה
+```
+
+## 🚀 שימוש מומלץ
+
+### אופציה 1: תפיסה + צפייה (מומלץ!)
+
+**הדרך הטובה ביותר אם אתה רוצה לראות את הלוח:**
+
+```bash
+py examples/ai_testing/capture_with_web.py examples/data/game_moves_3Players.txt
+```
+
+**מה זה עושה:**
+1. ✅ מריץ משחק עם האינפוטים
+2. 🌐 פותח דפדפן עם Web Visualizer
+3. 📸 תופס את כל ה-JSON בשקט ברקע
+4. 💾 שומר את המצב המלא (כולל points + adjacency!)
+5. 🎯 השרת נשאר פעיל - תוכל לראות את הלוח
+
+**בסוף תקבל:**
+- הלוח מוצג בדפדפן ✨
+- JSON מלא עם כל המידע שמור בקובץ
+- אפשר ללחוץ Ctrl+C לסגור
+
+### אופציה 2: תפיסה בלי דפדפן (מהיר)
+
+**אם אתה רק רוצה את ה-JSON בלי להפעיל דפדפן:**
+
+```bash
+py examples/ai_testing/show_complete_state.py examples/data/game_moves_3Players.txt
+```
+
+**מה זה עושה:**
+- מריץ משחק בלי דפדפן
+- מדפיס את כל ה-JSON בסוף
+- שומר את המצבים לקבצים
+
+### אופציה 3: הצגת JSON קיים בדפדפן
+
+**אם יש לך כבר JSON ואתה רוצה לראות אותו:**
+
+```bash
+py examples/ai_testing/visualize_game_state.py --state-file examples/ai_testing/sample_states/captured_game.json
+```
+
+---
+
+## 📊 מה כולל ה-JSON המלא?
+
+כדי ליצור מצב משחק משלך:
+
+1. **צור קובץ טקסט** עם פקודות משחק:
+```
+3          # מספר שחקנים
+Alice
+Bob
+Charlie
+s 10       # settlement בנקודה 10
+rd 10 11   # road מ-10 ל-11
+...
+```
+
+2. **הרץ את simple_capture**:
+```bash
+py examples/ai_testing/simple_capture.py your_inputs.txt
+```
+
+3. **תראה את ה-JSON** בקונסול ובקובץ
+
+## 📊 מה מודפס?
+
+### JSON מלא (לשליחה ל-AI)
+```json
+{
+  "hexes": [
+    {"id": 1, "type": "wood", "number": 12, ...}
+  ],
+  "settlements": [
+    {"point_id": 10, "owner": 0, "type": "SETTLEMENT"}
+  ],
+  "cities": [...],
+  "roads": [
+    {"start_point": 10, "end_point": 11, "owner": 0}
+  ],
+  "players": [
+    {
+      "id": 0,
+      "name": "Alice",
+      "cards": ["WOOD", "BRICK"],
+      "victory_points": 2,
+      ...
+    }
+  ],
+  "current_player": 0,
+  "current_phase": "NORMAL_PLAY",
+  "robber_position": {"q": 0, "r": 0}
+}
+```
+
+## 🎮 מבנה ה-JSON
+
+### Hexes (משושים)
+```json
+{
+  "coords": [0, 0],
+  "type": "HILLS",
+  "number": 3,
+  "has_robber": false
+}
+```
+
+### Buildings (התנחלויות וערים)
+```json
+{
+  "point_id": 5,
+  "owner": 0,
+  "type": "SETTLEMENT"  // או "CITY"
+}
+```
+
+### Roads (דרכים)
+```json
+{
+  "start_point": 5,
+  "end_point": 8,
+  "owner": 0
+}
+```
+
+### Players (שחקנים)
+```json
+{
+  "id": 0,
+  "name": "Player 0",
+  "cards": ["WOOD", "BRICK"],
+  "dev_cards": ["KNIGHT"],
+  "victory_points": 6,
+  "has_longest_road": true,
+  "has_largest_army": false,
+  "knights_played": 1
+}
+```
+
+## 📝 יצירת קובץ JSON חדש
+
+כדי ליצור מצב משחק משלך:
+
+1. העתק אחד מהקבצים ב-`sample_states/`
+2. ערוך את הערכים:
+   - `tiles` - המשושים בלוח
+   - `buildings` - התנחלויות וערים
+   - `roads` - דרכים
+   - `players_state` - מידע על כל שחקן
+3. שמור עם שם תיאורי
+4. הרץ: `python visualize_game_state.py --state-file your_file.json`
+
+## 🔍 למה זה חשוב ל-AI?
+
+1. **AI צריך להבין את הלוח** - ה-JSON הזה מכיל את **כל המידע** שהוא יקבל
+2. **בדיקת הבנה** - אפשר לבדוק א�� AI מבין מצבים שונים לפני שבונים אותו
+3. **תיעוד מדויק** - רואים בדיוק איזה מידע זמין לקבלת החלטות
+
+## 💡 טיפים
+
+- **הרץ את הסקריפט** בכל שלב של משחק רגיל כדי לראות איך המידע משתנה
+- **שמור JSON** ממצבי משחק מעניינים לבדיקה מאוחר יותר
+- **השווה בין מצבים** - ראה איך הלוח משתנה במהלך המשחק
+
+## 🛠️ שילוב עם AI
+
+כשתבנה AI agent:
+
+```python
+from examples.ai_testing.visualize_game_state import game_to_game_state
+
+# צור מצב משחק
+game_state = game_to_game_state(game)
+
+# המר לפורמט web (זה מה שה-AI יקבל)
+web_format = web_viz._convert_game_state(game_state)
+
+# שלח ל-AI
+ai_decision = ai_agent.decide(web_format)
+```
+
+---
+
+**עכשיו יש לך את כל הכלים כדי לבדוק שה-AI מבין את הלוח!** 🎯
+
+## 🎯 המידע המלא שה-AI מקבל - עכשיו עם Points!
+
+### ⭐ חשוב! מידע חדש שהוספנו:
+
+#### 📍 Points (54 נקודות)
+כל נקודה כוללת:
+- `point_id` - מזהה (1-54)
+- `adjacent_points` - רשימת נקודות מחוברות (לדרכים!)
+- `adjacent_hexes` - רשימת משושים צמודים (למשאבים!)
+
+**דוגמה:**
+```json
+{
+  "point_id": 10,
+  "adjacent_points": [9, 11, 20],  // יכול לבנות דרך לכיוון אלה
+  "adjacent_hexes": [5, 4, 1]       // יקבל משאבים מאלה
+}
+```
+
+#### 🗺️ Board Graph
+```json
+{
+  "adjacency": {"10": [9, 11, 20]},        // גרף קישוריות מלא
+  "hex_to_points": {"5": [9,10,11,19,20,21]}  // נקודות על כל משושה
+}
+```
+
+**למה זה קריטי:**
+- 🛣️ חישוב הדרך הארוכה ביותר
+- 🎯 מציאת נקודות חסימה
+- 📊 אסטרטגיה - אילו נקודות כדאי לתפוס
+
+---

examples/ai_testing/USAGE.md

@@ -0,0 +1,147 @@
+# AI Testing - Usage Examples
+
+## דוגמאות שימוש מהירות
+
+### 1. תפיסת JSON ממשחק קיים
+
+```bash
+# שימוש בקובץ אינפוטים קיים
+py examples/ai_testing/simple_capture.py examples/data/game_moves_3Players.txt
+
+# הפלט:
+# - JSON מודפס לקונסול בכל עדכון
+# - המצב האחרון נשמר ל: examples/ai_testing/sample_states/captured_game.json
+```
+
+### 2. הצגת המצב שנתפס
+
+```bash
+# הצג את המצב בדפדפן
+py examples/ai_testing/visualize_game_state.py --state-file examples/ai_testing/sample_states/captured_game.json
+```
+
+### 3. שמירת כל הפלט לקובץ
+
+```bash
+# שמור את כל הפלט (כולל כל ה-JSONs) לקובץ
+py examples/ai_testing/simple_capture.py examples/data/game_moves_3Players.txt > output.txt 2>&1
+```
+
+## מבנה ה-JSON
+
+### Hexes (משושים)
+כל משושה מכיל:
+- `id` - מזהה ייחודי (1-19)
+- `type` - סוג המשאב: "wood", "brick", "sheep", "wheat", "ore", "desert"
+- `number` - המספר על המשושה (2-12, או null למדבר)
+- `has_robber` - האם השודד נמצא שם
+- `position` - [row, col] - מיקום בלוח המקורי
+- `axial_coords` / `q`, `r` - קואורדינטות hexagonal
+
+### Buildings (מבנים)
+```json
+{
+  "settlements": [
+    {
+      "point_id": 10,
+      "owner": 0,
+      "type": "SETTLEMENT"
+    }
+  ],
+  "cities": [
+    {
+      "point_id": 14,
+      "owner": 1,
+      "type": "CITY"
+    }
+  ]
+}
+```
+
+### Roads (דרכים)
+```json
+{
+  "roads": [
+    {
+      "start_point": 10,
+      "end_point": 11,
+      "owner": 0
+    }
+  ]
+}
+```
+
+### Players (שחקנים)
+```json
+{
+  "players": [
+    {
+      "id": 0,
+      "name": "Alice",
+      "cards": ["WOOD", "BRICK", "SHEEP"],  // משאבים בידיים
+      "dev_cards": ["KNIGHT"],               // קלפי פיתוח
+      "victory_points": 3,
+      "has_longest_road": false,
+      "has_largest_army": false,
+      "knights_played": 1
+    }
+  ]
+}
+```
+
+### Game State (מצב משחק כללי)
+```json
+{
+  "current_player": 0,          // מי התור
+  "current_phase": "NORMAL_PLAY",  // שלב המשחק
+  "robber_position": {          // איפה השודד
+    "q": 0,
+    "r": 0
+  }
+}
+```
+
+## טיפים לשימוש
+
+### יצירת מצבי בדיקה
+
+1. **ערוך קובץ אינפוט** - צור משחק עם המצב הרצוי
+2. **הרץ simple_capture** - תפוס את המצב
+3. **שמור את ה-JSON** - יש לך עכשיו מצב לבדיקה
+
+### בדיקת הבנת AI
+
+1. **תפוס מצב** מעניין ממשחק
+2. **שלח ל-AI** את ה-JSON
+3. **בקש החלטה** - מה הפעולה הטובה ביותר?
+4. **הצג בדפדפן** - ראה את אותו המצב ויזואלית
+
+### דיבוג
+
+אם AI מקבל החלטות מוזרות:
+1. הדפס את ה-JSON שהוא קיבל
+2. הצג אותו ב-visualizer
+3. ראה מה הוא אמור לראות
+4. זהה פערים בהבנה
+
+## דוגמה מלאה
+
+```bash
+# 1. תפוס מצב ממשחק
+py examples/ai_testing/simple_capture.py examples/data/game_moves_3Players.txt
+
+# 2. הקובץ נשמר ב:
+# examples/ai_testing/sample_states/captured_game.json
+
+# 3. הצג אותו בדפדפן
+py examples/ai_testing/visualize_game_state.py --state-file examples/ai_testing/sample_states/captured_game.json
+
+# 4. עכשיו אתה יכול:
+#    - לראות את הלוח ויזואלית
+#    - לקרוא את ה-JSON
+#    - לשלוח ל-AI לבדיקה
+```
+
+---
+
+**עכשיו יש לך את כל הכלים כדי לבדוק שה-AI מבין את הלוח!** 🎯

examples/ai_testing/__init__.py

@@ -0,0 +1,8 @@
+"""
+AI Testing Tools
+----------------
+Tools for testing AI understanding of game state via Web Visualizer.
+
+This package helps visualize game states and capture the JSON data
+that would be sent to an AI agent for decision making.
+"""

examples/ai_testing/capture_game_state.py

@@ -0,0 +1,260 @@
+"""
+Capture Game State from Real Game
+----------------------------------
+This script runs a real game with predefined inputs and captures the JSON
+data that is sent to the Web Visualizer. This is exactly what an AI would see.
+
+Usage:
+    python capture_game_state.py [--input-file INPUT_FILE] [--output-file OUTPUT_FILE]
+"""
+
+import sys
+import json
+import time
+from pathlib import Path
+from io import StringIO
+
+# Add parent directory to path for imports
+sys.path.insert(0, str(Path(__file__).parent.parent.parent))
+
+from pycatan.visualizations.web_visualization import WebVisualization
+from pycatan.management.game_manager import GameManager
+from pycatan.players.human_user import HumanUser
+
+
+class StateCapturingWebViz(WebVisualization):
+    """
+    Extended WebVisualization that captures all state updates.
+    """
+    
+    def __init__(self, *args, **kwargs):
+        # Don't start the server automatically
+        kwargs['auto_open'] = False
+        super().__init__(*args, **kwargs)
+        
+        self.captured_states = []
+        self.captured_actions = []
+        self.turn_states = {}  # Maps turn number to state
+        
+    def update_full_state(self, game_state):
+        """Override to capture state updates."""
+        # Call parent to do the conversion
+        super().update_full_state(game_state)
+        
+        # Capture the converted state
+        if self.current_game_state:
+            state_copy = json.loads(json.dumps(self.current_game_state))
+            self.captured_states.append(state_copy)
+            
+            # Store by turn number if available
+            turn_num = state_copy.get('turn_number', len(self.captured_states))
+            self.turn_states[turn_num] = state_copy
+            
+            print(f"\n📸 Captured state for turn {turn_num}")
+            
+    def display_action(self, action, result):
+        """Override to capture actions."""
+        super().display_action(action, result)
+        
+        action_data = {
+            'action_type': str(action.action_type) if hasattr(action, 'action_type') else 'unknown',
+            'player_id': action.player_id if hasattr(action, 'player_id') else None,
+            'success': result.success if hasattr(result, 'success') else None,
+            'timestamp': str(action.timestamp) if hasattr(action, 'timestamp') else None
+        }
+        self.captured_actions.append(action_data)
+    
+    def get_latest_state(self):
+        """Get the most recent captured state."""
+        return self.captured_states[-1] if self.captured_states else None
+    
+    def get_state_at_turn(self, turn_number):
+        """Get state at a specific turn."""
+        return self.turn_states.get(turn_number)
+    
+    def print_latest_state(self):
+        """Print the latest state as formatted JSON."""
+        latest = self.get_latest_state()
+        if latest:
+            print("\n" + "="*80)
+            print("📊 LATEST GAME STATE JSON")
+            print("="*80)
+            print(json.dumps(latest, indent=2, ensure_ascii=False))
+            print("="*80)
+            
+            # Print summary
+            self._print_summary(latest)
+    
+    def _print_summary(self, state_data):
+        """Print a human-readable summary."""
+        print("\n" + "="*80)
+        print("📈 SUMMARY")
+        print("="*80)
+        print(f"Current Player: {state_data.get('current_player', 0)}")
+        print(f"Game Phase: {state_data.get('current_phase', 'UNKNOWN')}")
+        print(f"Robber Position: {state_data.get('robber_position', 'Unknown')}")
+        
+        if state_data.get('dice_result'):
+            print(f"Last Dice Roll: {state_data['dice_result']}")
+        
+        print(f"\nBoard:")
+        print(f"  - Hexes: {len(state_data.get('hexes', []))}")
+        print(f"  - Settlements: {len(state_data.get('settlements', []))}")
+        print(f"  - Cities: {len(state_data.get('cities', []))}")
+        print(f"  - Roads: {len(state_data.get('roads', []))}")
+        
+        print(f"\nPlayers: {len(state_data.get('players', []))}")
+        for player in state_data.get('players', []):
+            print(f"  Player {player.get('id', '?')}: {player.get('name', 'Unknown')}")
+            print(f"    - Victory Points: {player.get('victory_points', 0)}")
+            print(f"    - Resources: {len(player.get('cards', []))}")
+            print(f"    - Dev Cards: {len(player.get('dev_cards', []))}")
+            if player.get('has_longest_road'):
+                print(f"    - Has Longest Road!")
+            if player.get('has_largest_army'):
+                print(f"    - Has Largest Army!")
+        print("="*80)
+    
+    def save_state_to_file(self, filepath, turn_number=None):
+        """Save a specific state to JSON file."""
+        if turn_number is not None:
+            state = self.get_state_at_turn(turn_number)
+            if not state:
+                print(f"❌ No state captured for turn {turn_number}")
+                return False
+        else:
+            state = self.get_latest_state()
+            
+        if not state:
+            print("❌ No state to save")
+            return False
+        
+        with open(filepath, 'w', encoding='utf-8') as f:
+            json.dump(state, f, indent=2, ensure_ascii=False)
+        
+        print(f"✅ State saved to: {filepath}")
+        return True
+
+
+def run_game_with_inputs(input_lines):
+    """
+    Run a game with predefined inputs and capture states.
+    
+    Args:
+        input_lines: List of input strings to feed to the game
+        
+    Returns:
+        StateCapturingWebViz: The visualizer with captured states
+    """
+    # Create input stream from the lines
+    input_stream = StringIO('\n'.join(input_lines))
+    
+    # Temporarily redirect stdin
+    original_stdin = sys.stdin
+    sys.stdin = input_stream
+    
+    try:
+        # Create capturing visualizer
+        viz = StateCapturingWebViz(port=5555, auto_open=False)
+        
+        # Create game manager with visualization
+        # We'll create simple users - the input will come from our stream
+        users = []  # Will be populated by game manager from input
+        
+        print("\n🎮 Starting game with captured inputs...")
+        print(f"   Total input lines: {len(input_lines)}")
+        print("="*80)
+        
+        # Start game - this will consume the inputs
+        game_manager = GameManager(users=None, visualizations=[viz])
+        
+        # The game will read from our input stream
+        game_manager.start_game()
+        
+        print("\n✅ Game completed!")
+        print(f"📸 Captured {len(viz.captured_states)} states")
+        
+        return viz
+        
+    except EOFError:
+        print("\n⚠️  Input ended - game may be incomplete")
+        return viz
+    except Exception as e:
+        print(f"\n❌ Error running game: {e}")
+        import traceback
+        traceback.print_exc()
+        return None
+    finally:
+        # Restore stdin
+        sys.stdin = original_stdin
+
+
+def main():
+    """Main function to capture game states."""
+    import argparse
+    
+    parser = argparse.ArgumentParser(description='Capture game state from real game')
+    parser.add_argument('--input-file', type=str, 
+                       default='examples/data/game_moves_3Players.txt',
+                       help='Path to file with game inputs')
+    parser.add_argument('--output-file', type=str,
+                       help='Path to save captured state JSON')
+    parser.add_argument('--turn', type=int,
+                       help='Capture state at specific turn number')
+    parser.add_argument('--all-turns', action='store_true',
+                       help='Save all turn states to separate files')
+    
+    args = parser.parse_args()
+    
+    # Read input file
+    input_file = Path(args.input_file)
+    if not input_file.exists():
+        print(f"❌ Input file not found: {input_file}")
+        return
+    
+    with open(input_file, 'r', encoding='utf-8') as f:
+        input_lines = [line.strip() for line in f if line.strip()]
+    
+    print(f"📂 Loaded inputs from: {input_file}")
+    print(f"   Lines: {len(input_lines)}")
+    
+    # Run game and capture states
+    viz = run_game_with_inputs(input_lines)
+    
+    if not viz:
+        print("❌ Failed to capture game states")
+        return
+    
+    # Print latest state
+    viz.print_latest_state()
+    
+    # Save states
+    if args.all_turns:
+        output_dir = Path('examples/ai_testing/captured_states')
+        output_dir.mkdir(exist_ok=True)
+        
+        print(f"\n💾 Saving all turn states to: {output_dir}")
+        for turn_num, state in viz.turn_states.items():
+            output_file = output_dir / f"turn_{turn_num:03d}.json"
+            with open(output_file, 'w', encoding='utf-8') as f:
+                json.dump(state, f, indent=2, ensure_ascii=False)
+            print(f"   ✅ Saved turn {turn_num}")
+        
+    elif args.output_file:
+        viz.save_state_to_file(args.output_file, args.turn)
+    
+    else:
+        # Default: save latest state
+        output_file = Path('examples/ai_testing/sample_states/captured_game.json')
+        viz.save_state_to_file(str(output_file))
+    
+    print("\n" + "="*80)
+    print("✨ CAPTURE COMPLETE")
+    print("="*80)
+    print("You now have the exact JSON that would be sent to an AI agent!")
+    print("Use visualize_game_state.py to view it in the browser.")
+    print("="*80)
+
+
+if __name__ == '__main__':
+    main()

examples/ai_testing/capture_with_web.py

@@ -0,0 +1,160 @@
+"""
+Capture Game State WITH Web Visualizer
+---------------------------------------
+Runs a game with predefined inputs, captures the JSON data,
+AND displays it in the web browser so you can see the board visually.
+"""
+
+import sys
+from pathlib import Path
+import os
+import json
+import time
+import threading
+
+# Add parent directory to path
+sys.path.insert(0, str(Path(__file__).parent.parent.parent))
+
+from pycatan.visualizations.web_visualization import WebVisualization
+
+# Capture states
+captured_states = []
+update_counter = 0
+
+original_update = WebVisualization.update_full_state
+
+def capturing_update(self, game_state):
+    """Capture and save all states."""
+    global update_counter
+    original_update(self, game_state)
+    
+    if hasattr(self, 'current_game_state') and self.current_game_state:
+        update_counter += 1
+        state_copy = json.loads(json.dumps(self.current_game_state))
+        captured_states.append(state_copy)
+        
+        # Print just a notification (not the full JSON to keep output clean)
+        print(f"[State #{update_counter} captured]", end=' ', flush=True)
+
+# Apply patch
+WebVisualization.update_full_state = capturing_update
+
+
+def save_captured_states():
+    """Save all captured states to files."""
+    if not captured_states:
+        print("\n\nNo states were captured!")
+        return False
+    
+    # Create output directory
+    output_dir = Path('examples/ai_testing/captured_states')
+    output_dir.mkdir(exist_ok=True)
+    
+    # Save first state
+    first_state = captured_states[0]
+    first_file = output_dir / 'state_001_initial.json'
+    with open(first_file, 'w', encoding='utf-8') as f:
+        json.dump(first_state, f, indent=2, ensure_ascii=False)
+    
+    # Save last state
+    last_state = captured_states[-1]
+    last_file = output_dir / f'state_{len(captured_states):03d}_final.json'
+    with open(last_file, 'w', encoding='utf-8') as f:
+        json.dump(last_state, f, indent=2, ensure_ascii=False)
+    
+    # Also save to sample_states for compatibility
+    sample_file = Path('examples/ai_testing/sample_states/captured_game.json')
+    sample_file.parent.mkdir(exist_ok=True)
+    with open(sample_file, 'w', encoding='utf-8') as f:
+        json.dump(last_state, f, indent=2, ensure_ascii=False)
+    
+    print(f"\n\n{'='*80}")
+    print(f"Captured {len(captured_states)} states total")
+    print("="*80)
+    print(f"\nSaved states:")
+    print(f"  - First: {first_file}")
+    print(f"  - Last:  {last_file}")
+    print(f"  - Main:  {sample_file}")
+    
+    # Print summary of last state
+    print("\n" + "="*80)
+    print("FINAL GAME STATE SUMMARY")
+    print("="*80)
+    
+    print(f"\nBoard:")
+    print(f"  Hexes: {len(last_state.get('hexes', []))}")
+    print(f"  Points: {len(last_state.get('points', []))} (with adjacency info)")
+    print(f"  Settlements: {len(last_state.get('settlements', []))}")
+    print(f"  Cities: {len(last_state.get('cities', []))}")
+    print(f"  Roads: {len(last_state.get('roads', []))}")
+    
+    print(f"\nPlayers:")
+    for player in last_state.get('players', []):
+        print(f"  Player {player.get('id')}: {player.get('name')}")
+        print(f"    VP: {player.get('victory_points', 0)}, Resources: {len(player.get('cards_list', []))}")
+    
+    print(f"\nGame Info:")
+    print(f"  Current Player: {last_state.get('current_player')}")
+    print(f"  Phase: {last_state.get('current_phase')}")
+    
+    print("\n" + "="*80)
+    
+    return True
+
+
+def main():
+    if len(sys.argv) > 1:
+        input_file = sys.argv[1]
+    else:
+        input_file = 'examples/data/game_moves_3Players.txt'
+    
+    print(f"\nRunning game with: {input_file}")
+    print("Web Visualizer will open in browser...")
+    print("States are being captured in the background...")
+    print("="*80 + "\n")
+    
+    # Read inputs
+    with open(input_file, 'r', encoding='utf-8') as f:
+        inputs = f.read()
+    
+    from io import StringIO
+    sys.stdin = StringIO(inputs)
+    
+    try:
+        from pycatan import RealGame
+        game = RealGame()
+        
+        # The game will run with web server active
+        game.run()
+        
+    except (EOFError, KeyboardInterrupt):
+        print("\n\nGame stopped by user")
+    except Exception as e:
+        print(f"\n\nError: {e}")
+        import traceback
+        traceback.print_exc()
+    
+    # Save captured states
+    if save_captured_states():
+        print("\n" + "="*80)
+        print("SUCCESS!")
+        print("="*80)
+        print("\nThe web visualizer should still be open in your browser.")
+        print("You can see the final board state there.")
+        print("\nThe complete JSON (with points and adjacency info) is saved in:")
+        print("  examples/ai_testing/sample_states/captured_game.json")
+        print("\nTo see the full JSON, run:")
+        print("  Get-Content examples/ai_testing/sample_states/captured_game.json")
+        print("="*80)
+    
+    # Keep the script alive so web server stays up
+    print("\n\nPress Ctrl+C to stop the web server and exit...")
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        print("\n\nShutting down...")
+
+
+if __name__ == '__main__':
+    main()

examples/ai_testing/my_games/game_20251223_203724_final.json

@@ -0,0 +1,1850 @@
+{
+  "hexes": [
+    {
+      "id": 1,
+      "q": 0,
+      "r": -2,
+      "type": "wood",
+      "number": 12,
+      "has_robber": false,
+      "position": [
+        0,
+        0
+      ],
+      "axial_coords": [
+        0,
+        -2
+      ]
+    },
+    {
+      "id": 2,
+      "q": 1,
+      "r": -2,
+      "type": "sheep",
+      "number": 5,
+      "has_robber": false,
+      "position": [
+        0,
+        1
+      ],
+      "axial_coords": [
+        1,
+        -2
+      ]
+    },
+    {
+      "id": 3,
+      "q": 2,
+      "r": -2,
+      "type": "wood",
+      "number": 4,
+      "has_robber": false,
+      "position": [
+        0,
+        2
+      ],
+      "axial_coords": [
+        2,
+        -2
+      ]
+    },
+    {
+      "id": 4,
+      "q": -1,
+      "r": -1,
+      "type": "sheep",
+      "number": 8,
+      "has_robber": false,
+      "position": [
+        1,
+        0
+      ],
+      "axial_coords": [
+        -1,
+        -1
+      ]
+    },
+    {
+      "id": 5,
+      "q": 0,
+      "r": -1,
+      "type": "brick",
+      "number": 6,
+      "has_robber": false,
+      "position": [
+        1,
+        1
+      ],
+      "axial_coords": [
+        0,
+        -1
+      ]
+    },
+    {
+      "id": 6,
+      "q": 1,
+      "r": -1,
+      "type": "wood",
+      "number": 3,
+      "has_robber": false,
+      "position": [
+        1,
+        2
+      ],
+      "axial_coords": [
+        1,
+        -1
+      ]
+    },
+    {
+      "id": 7,
+      "q": 2,
+      "r": -1,
+      "type": "wheat",
+      "number": 8,
+      "has_robber": false,
+      "position": [
+        1,
+        3
+      ],
+      "axial_coords": [
+        2,
+        -1
+      ]
+    },
+    {
+      "id": 8,
+      "q": -2,
+      "r": 0,
+      "type": "brick",
+      "number": 10,
+      "has_robber": false,
+      "position": [
+        2,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        0
+      ]
+    },
+    {
+      "id": 9,
+      "q": -1,
+      "r": 0,
+      "type": "wood",
+      "number": 11,
+      "has_robber": false,
+      "position": [
+        2,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        0
+      ]
+    },
+    {
+      "id": 10,
+      "q": 0,
+      "r": 0,
+      "type": "desert",
+      "number": null,
+      "has_robber": true,
+      "position": [
+        2,
+        2
+      ],
+      "axial_coords": [
+        0,
+        0
+      ]
+    },
+    {
+      "id": 11,
+      "q": 1,
+      "r": 0,
+      "type": "ore",
+      "number": 3,
+      "has_robber": false,
+      "position": [
+        2,
+        3
+      ],
+      "axial_coords": [
+        1,
+        0
+      ]
+    },
+    {
+      "id": 12,
+      "q": 2,
+      "r": 0,
+      "type": "sheep",
+      "number": 4,
+      "has_robber": false,
+      "position": [
+        2,
+        4
+      ],
+      "axial_coords": [
+        2,
+        0
+      ]
+    },
+    {
+      "id": 13,
+      "q": -2,
+      "r": 1,
+      "type": "brick",
+      "number": 10,
+      "has_robber": false,
+      "position": [
+        3,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        1
+      ]
+    },
+    {
+      "id": 14,
+      "q": -1,
+      "r": 1,
+      "type": "wheat",
+      "number": 9,
+      "has_robber": false,
+      "position": [
+        3,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        1
+      ]
+    },
+    {
+      "id": 15,
+      "q": 0,
+      "r": 1,
+      "type": "wheat",
+      "number": 6,
+      "has_robber": false,
+      "position": [
+        3,
+        2
+      ],
+      "axial_coords": [
+        0,
+        1
+      ]
+    },
+    {
+      "id": 16,
+      "q": 1,
+      "r": 1,
+      "type": "sheep",
+      "number": 11,
+      "has_robber": false,
+      "position": [
+        3,
+        3
+      ],
+      "axial_coords": [
+        1,
+        1
+      ]
+    },
+    {
+      "id": 17,
+      "q": -2,
+      "r": 2,
+      "type": "ore",
+      "number": 5,
+      "has_robber": false,
+      "position": [
+        4,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        2
+      ]
+    },
+    {
+      "id": 18,
+      "q": -1,
+      "r": 2,
+      "type": "wheat",
+      "number": 9,
+      "has_robber": false,
+      "position": [
+        4,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        2
+      ]
+    },
+    {
+      "id": 19,
+      "q": 0,
+      "r": 2,
+      "type": "ore",
+      "number": 2,
+      "has_robber": false,
+      "position": [
+        4,
+        2
+      ],
+      "axial_coords": [
+        0,
+        2
+      ]
+    }
+  ],
+  "settlements": [],
+  "cities": [],
+  "roads": [],
+  "players": [
+    {
+      "id": 0,
+      "name": "a",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    },
+    {
+      "id": 1,
+      "name": "b",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    },
+    {
+      "id": 2,
+      "name": "c",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    }
+  ],
+  "current_player": 0,
+  "current_phase": "SETUP_FIRST_ROUND",
+  "robber_position": [
+    2,
+    2
+  ],
+  "dice_result": null,
+  "points": [
+    {
+      "point_id": 1,
+      "game_coords": [
+        0,
+        0
+      ],
+      "adjacent_points": [
+        2,
+        9
+      ],
+      "adjacent_hexes": [
+        1
+      ],
+      "pixel_coords": [
+        377.5,
+        105.14428414850131
+      ]
+    },
+    {
+      "point_id": 2,
+      "game_coords": [
+        0,
+        1
+      ],
+      "adjacent_points": [
+        1,
+        3
+      ],
+      "adjacent_hexes": [
+        1
+      ],
+      "pixel_coords": [
+        422.5,
+        105.14428414850128
+      ]
+    },
+    {
+      "point_id": 3,
+      "game_coords": [
+        0,
+        2
+      ],
+      "adjacent_points": [
+        2,
+        4,
+        11
+      ],
+      "adjacent_hexes": [
+        2,
+        1
+      ],
+      "pixel_coords": [
+        445,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 4,
+      "game_coords": [
+        0,
+        3
+      ],
+      "adjacent_points": [
+        3,
+        5
+      ],
+      "adjacent_hexes": [
+        2
+      ],
+      "pixel_coords": [
+        490,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 5,
+      "game_coords": [
+        0,
+        4
+      ],
+      "adjacent_points": [
+        4,
+        6,
+        13
+      ],
+      "adjacent_hexes": [
+        3,
+        2
+      ],
+      "pixel_coords": [
+        512.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 6,
+      "game_coords": [
+        0,
+        5
+      ],
+      "adjacent_points": [
+        5,
+        7
+      ],
+      "adjacent_hexes": [
+        3
+      ],
+      "pixel_coords": [
+        557.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 7,
+      "game_coords": [
+        0,
+        6
+      ],
+      "adjacent_points": [
+        6,
+        15
+      ],
+      "adjacent_hexes": [
+        3
+      ],
+      "pixel_coords": [
+        580,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 8,
+      "game_coords": [
+        1,
+        0
+      ],
+      "adjacent_points": [
+        9,
+        18
+      ],
+      "adjacent_hexes": [
+        4
+      ],
+      "pixel_coords": [
+        310,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 9,
+      "game_coords": [
+        1,
+        1
+      ],
+      "adjacent_points": [
+        8,
+        10,
+        1
+      ],
+      "adjacent_hexes": [
+        4,
+        1
+      ],
+      "pixel_coords": [
+        355,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 10,
+      "game_coords": [
+        1,
+        2
+      ],
+      "adjacent_points": [
+        9,
+        11,
+        20
+      ],
+      "adjacent_hexes": [
+        5,
+        4,
+        1
+      ],
+      "pixel_coords": [
+        377.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 11,
+      "game_coords": [
+        1,
+        3
+      ],
+      "adjacent_points": [
+        10,
+        12,
+        3
+      ],
+      "adjacent_hexes": [
+        5,
+        2,
+        1
+      ],
+      "pixel_coords": [
+        422.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 12,
+      "game_coords": [
+        1,
+        4
+      ],
+      "adjacent_points": [
+        11,
+        13,
+        22
+      ],
+      "adjacent_hexes": [
+        6,
+        5,
+        2
+      ],
+      "pixel_coords": [
+        445,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 13,
+      "game_coords": [
+        1,
+        5
+      ],
+      "adjacent_points": [
+        12,
+        14,
+        5
+      ],
+      "adjacent_hexes": [
+        6,
+        3,
+        2
+      ],
+      "pixel_coords": [
+        490,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 14,
+      "game_coords": [
+        1,
+        6
+      ],
+      "adjacent_points": [
+        13,
+        15,
+        24
+      ],
+      "adjacent_hexes": [
+        7,
+        6,
+        3
+      ],
+      "pixel_coords": [
+        512.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 15,
+      "game_coords": [
+        1,
+        7
+      ],
+      "adjacent_points": [
+        14,
+        16,
+        7
+      ],
+      "adjacent_hexes": [
+        7,
+        3
+      ],
+      "pixel_coords": [
+        557.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 16,
+      "game_coords": [
+        1,
+        8
+      ],
+      "adjacent_points": [
+        15,
+        26
+      ],
+      "adjacent_hexes": [
+        7
+      ],
+      "pixel_coords": [
+        580,
+        300
+      ]
+    },
+    {
+      "point_id": 17,
+      "game_coords": [
+        2,
+        0
+      ],
+      "adjacent_points": [
+        18,
+        28
+      ],
+      "adjacent_hexes": [
+        8
+      ],
+      "pixel_coords": [
+        242.49999999999997,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 18,
+      "game_coords": [
+        2,
+        1
+      ],
+      "adjacent_points": [
+        17,
+        19,
+        8
+      ],
+      "adjacent_hexes": [
+        8,
+        4
+      ],
+      "pixel_coords": [
+        287.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 19,
+      "game_coords": [
+        2,
+        2
+      ],
+      "adjacent_points": [
+        18,
+        20,
+        30
+      ],
+      "adjacent_hexes": [
+        9,
+        8,
+        4
+      ],
+      "pixel_coords": [
+        310,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 20,
+      "game_coords": [
+        2,
+        3
+      ],
+      "adjacent_points": [
+        19,
+        21,
+        10
+      ],
+      "adjacent_hexes": [
+        9,
+        5,
+        4
+      ],
+      "pixel_coords": [
+        355,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 21,
+      "game_coords": [
+        2,
+        4
+      ],
+      "adjacent_points": [
+        20,
+        22,
+        32
+      ],
+      "adjacent_hexes": [
+        10,
+        9,
+        5
+      ],
+      "pixel_coords": [
+        377.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 22,
+      "game_coords": [
+        2,
+        5
+      ],
+      "adjacent_points": [
+        21,
+        23,
+        12
+      ],
+      "adjacent_hexes": [
+        10,
+        6,
+        5
+      ],
+      "pixel_coords": [
+        422.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 23,
+      "game_coords": [
+        2,
+        6
+      ],
+      "adjacent_points": [
+        22,
+        24,
+        34
+      ],
+      "adjacent_hexes": [
+        11,
+        10,
+        6
+      ],
+      "pixel_coords": [
+        445,
+        300
+      ]
+    },
+    {
+      "point_id": 24,
+      "game_coords": [
+        2,
+        7
+      ],
+      "adjacent_points": [
+        23,
+        25,
+        14
+      ],
+      "adjacent_hexes": [
+        11,
+        7,
+        6
+      ],
+      "pixel_coords": [
+        490,
+        300
+      ]
+    },
+    {
+      "point_id": 25,
+      "game_coords": [
+        2,
+        8
+      ],
+      "adjacent_points": [
+        24,
+        26,
+        36
+      ],
+      "adjacent_hexes": [
+        12,
+        11,
+        7
+      ],
+      "pixel_coords": [
+        512.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 26,
+      "game_coords": [
+        2,
+        9
+      ],
+      "adjacent_points": [
+        25,
+        27,
+        16
+      ],
+      "adjacent_hexes": [
+        12,
+        7
+      ],
+      "pixel_coords": [
+        557.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 27,
+      "game_coords": [
+        2,
+        10
+      ],
+      "adjacent_points": [
+        26,
+        38
+      ],
+      "adjacent_hexes": [
+        12
+      ],
+      "pixel_coords": [
+        580,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 28,
+      "game_coords": [
+        3,
+        0
+      ],
+      "adjacent_points": [
+        29,
+        17
+      ],
+      "adjacent_hexes": [
+        8
+      ],
+      "pixel_coords": [
+        220,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 29,
+      "game_coords": [
+        3,
+        1
+      ],
+      "adjacent_points": [
+        28,
+        30,
+        39
+      ],
+      "adjacent_hexes": [
+        13,
+        8
+      ],
+      "pixel_coords": [
+        242.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 30,
+      "game_coords": [
+        3,
+        2
+      ],
+      "adjacent_points": [
+        29,
+        31,
+        19
+      ],
+      "adjacent_hexes": [
+        13,
+        9,
+        8
+      ],
+      "pixel_coords": [
+        287.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 31,
+      "game_coords": [
+        3,
+        3
+      ],
+      "adjacent_points": [
+        30,
+        32,
+        41
+      ],
+      "adjacent_hexes": [
+        14,
+        13,
+        9
+      ],
+      "pixel_coords": [
+        310,
+        300
+      ]
+    },
+    {
+      "point_id": 32,
+      "game_coords": [
+        3,
+        4
+      ],
+      "adjacent_points": [
+        31,
+        33,
+        21
+      ],
+      "adjacent_hexes": [
+        14,
+        10,
+        9
+      ],
+      "pixel_coords": [
+        355,
+        300
+      ]
+    },
+    {
+      "point_id": 33,
+      "game_coords": [
+        3,
+        5
+      ],
+      "adjacent_points": [
+        32,
+        34,
+        43
+      ],
+      "adjacent_hexes": [
+        15,
+        14,
+        10
+      ],
+      "pixel_coords": [
+        377.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 34,
+      "game_coords": [
+        3,
+        6
+      ],
+      "adjacent_points": [
+        33,
+        35,
+        23
+      ],
+      "adjacent_hexes": [
+        15,
+        11,
+        10
+      ],
+      "pixel_coords": [
+        422.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 35,
+      "game_coords": [
+        3,
+        7
+      ],
+      "adjacent_points": [
+        34,
+        36,
+        45
+      ],
+      "adjacent_hexes": [
+        16,
+        15,
+        11
+      ],
+      "pixel_coords": [
+        445,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 36,
+      "game_coords": [
+        3,
+        8
+      ],
+      "adjacent_points": [
+        35,
+        37,
+        25
+      ],
+      "adjacent_hexes": [
+        16,
+        12,
+        11
+      ],
+      "pixel_coords": [
+        490,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 37,
+      "game_coords": [
+        3,
+        9
+      ],
+      "adjacent_points": [
+        36,
+        38,
+        47
+      ],
+      "adjacent_hexes": [
+        16,
+        12
+      ],
+      "pixel_coords": [
+        512.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 38,
+      "game_coords": [
+        3,
+        10
+      ],
+      "adjacent_points": [
+        37,
+        27
+      ],
+      "adjacent_hexes": [
+        12
+      ],
+      "pixel_coords": [
+        557.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 39,
+      "game_coords": [
+        4,
+        0
+      ],
+      "adjacent_points": [
+        40,
+        29
+      ],
+      "adjacent_hexes": [
+        13
+      ],
+      "pixel_coords": [
+        220,
+        300
+      ]
+    },
+    {
+      "point_id": 40,
+      "game_coords": [
+        4,
+        1
+      ],
+      "adjacent_points": [
+        39,
+        41,
+        48
+      ],
+      "adjacent_hexes": [
+        17,
+        13
+      ],
+      "pixel_coords": [
+        242.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 41,
+      "game_coords": [
+        4,
+        2
+      ],
+      "adjacent_points": [
+        40,
+        42,
+        31
+      ],
+      "adjacent_hexes": [
+        17,
+        14,
+        13
+      ],
+      "pixel_coords": [
+        287.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 42,
+      "game_coords": [
+        4,
+        3
+      ],
+      "adjacent_points": [
+        41,
+        43,
+        50
+      ],
+      "adjacent_hexes": [
+        18,
+        17,
+        14
+      ],
+      "pixel_coords": [
+        310,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 43,
+      "game_coords": [
+        4,
+        4
+      ],
+      "adjacent_points": [
+        42,
+        44,
+        33
+      ],
+      "adjacent_hexes": [
+        18,
+        15,
+        14
+      ],
+      "pixel_coords": [
+        355,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 44,
+      "game_coords": [
+        4,
+        5
+      ],
+      "adjacent_points": [
+        43,
+        45,
+        52
+      ],
+      "adjacent_hexes": [
+        19,
+        18,
+        15
+      ],
+      "pixel_coords": [
+        377.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 45,
+      "game_coords": [
+        4,
+        6
+      ],
+      "adjacent_points": [
+        44,
+        46,
+        35
+      ],
+      "adjacent_hexes": [
+        19,
+        16,
+        15
+      ],
+      "pixel_coords": [
+        422.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 46,
+      "game_coords": [
+        4,
+        7
+      ],
+      "adjacent_points": [
+        45,
+        47,
+        54
+      ],
+      "adjacent_hexes": [
+        19,
+        16
+      ],
+      "pixel_coords": [
+        445,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 47,
+      "game_coords": [
+        4,
+        8
+      ],
+      "adjacent_points": [
+        46,
+        37
+      ],
+      "adjacent_hexes": [
+        16
+      ],
+      "pixel_coords": [
+        490,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 48,
+      "game_coords": [
+        5,
+        0
+      ],
+      "adjacent_points": [
+        49,
+        40
+      ],
+      "adjacent_hexes": [
+        17
+      ],
+      "pixel_coords": [
+        220,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 49,
+      "game_coords": [
+        5,
+        1
+      ],
+      "adjacent_points": [
+        48,
+        50
+      ],
+      "adjacent_hexes": [
+        17
+      ],
+      "pixel_coords": [
+        242.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 50,
+      "game_coords": [
+        5,
+        2
+      ],
+      "adjacent_points": [
+        49,
+        51,
+        42
+      ],
+      "adjacent_hexes": [
+        18,
+        17
+      ],
+      "pixel_coords": [
+        287.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 51,
+      "game_coords": [
+        5,
+        3
+      ],
+      "adjacent_points": [
+        50,
+        52
+      ],
+      "adjacent_hexes": [
+        18
+      ],
+      "pixel_coords": [
+        310,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 52,
+      "game_coords": [
+        5,
+        4
+      ],
+      "adjacent_points": [
+        51,
+        53,
+        44
+      ],
+      "adjacent_hexes": [
+        19,
+        18
+      ],
+      "pixel_coords": [
+        355,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 53,
+      "game_coords": [
+        5,
+        5
+      ],
+      "adjacent_points": [
+        52,
+        54
+      ],
+      "adjacent_hexes": [
+        19
+      ],
+      "pixel_coords": [
+        377.5,
+        494.8557158514987
+      ]
+    },
+    {
+      "point_id": 54,
+      "game_coords": [
+        5,
+        6
+      ],
+      "adjacent_points": [
+        53,
+        46
+      ],
+      "adjacent_hexes": [
+        19
+      ],
+      "pixel_coords": [
+        422.5,
+        494.8557158514987
+      ]
+    }
+  ],
+  "board_graph": {
+    "adjacency": {
+      "1": [
+        2,
+        9
+      ],
+      "2": [
+        1,
+        3
+      ],
+      "3": [
+        2,
+        4,
+        11
+      ],
+      "4": [
+        3,
+        5
+      ],
+      "5": [
+        4,
+        6,
+        13
+      ],
+      "6": [
+        5,
+        7
+      ],
+      "7": [
+        6,
+        15
+      ],
+      "8": [
+        9,
+        18
+      ],
+      "9": [
+        8,
+        10,
+        1
+      ],
+      "10": [
+        9,
+        11,
+        20
+      ],
+      "11": [
+        10,
+        12,
+        3
+      ],
+      "12": [
+        11,
+        13,
+        22
+      ],
+      "13": [
+        12,
+        14,
+        5
+      ],
+      "14": [
+        13,
+        15,
+        24
+      ],
+      "15": [
+        14,
+        16,
+        7
+      ],
+      "16": [
+        15,
+        26
+      ],
+      "17": [
+        18,
+        28
+      ],
+      "18": [
+        17,
+        19,
+        8
+      ],
+      "19": [
+        18,
+        20,
+        30
+      ],
+      "20": [
+        19,
+        21,
+        10
+      ],
+      "21": [
+        20,
+        22,
+        32
+      ],
+      "22": [
+        21,
+        23,
+        12
+      ],
+      "23": [
+        22,
+        24,
+        34
+      ],
+      "24": [
+        23,
+        25,
+        14
+      ],
+      "25": [
+        24,
+        26,
+        36
+      ],
+      "26": [
+        25,
+        27,
+        16
+      ],
+      "27": [
+        26,
+        38
+      ],
+      "28": [
+        29,
+        17
+      ],
+      "29": [
+        28,
+        30,
+        39
+      ],
+      "30": [
+        29,
+        31,
+        19
+      ],
+      "31": [
+        30,
+        32,
+        41
+      ],
+      "32": [
+        31,
+        33,
+        21
+      ],
+      "33": [
+        32,
+        34,
+        43
+      ],
+      "34": [
+        33,
+        35,
+        23
+      ],
+      "35": [
+        34,
+        36,
+        45
+      ],
+      "36": [
+        35,
+        37,
+        25
+      ],
+      "37": [
+        36,
+        38,
+        47
+      ],
+      "38": [
+        37,
+        27
+      ],
+      "39": [
+        40,
+        29
+      ],
+      "40": [
+        39,
+        41,
+        48
+      ],
+      "41": [
+        40,
+        42,
+        31
+      ],
+      "42": [
+        41,
+        43,
+        50
+      ],
+      "43": [
+        42,
+        44,
+        33
+      ],
+      "44": [
+        43,
+        45,
+        52
+      ],
+      "45": [
+        44,
+        46,
+        35
+      ],
+      "46": [
+        45,
+        47,
+        54
+      ],
+      "47": [
+        46,
+        37
+      ],
+      "48": [
+        49,
+        40
+      ],
+      "49": [
+        48,
+        50
+      ],
+      "50": [
+        49,
+        51,
+        42
+      ],
+      "51": [
+        50,
+        52
+      ],
+      "52": [
+        51,
+        53,
+        44
+      ],
+      "53": [
+        52,
+        54
+      ],
+      "54": [
+        53,
+        46
+      ]
+    },
+    "hex_to_points": {
+      "1": [
+        1,
+        2,
+        3,
+        9,
+        10,
+        11
+      ],
+      "2": [
+        3,
+        4,
+        5,
+        11,
+        12,
+        13
+      ],
+      "3": [
+        5,
+        6,
+        7,
+        13,
+        14,
+        15
+      ],
+      "4": [
+        8,
+        9,
+        10,
+        18,
+        19,
+        20
+      ],
+      "5": [
+        10,
+        11,
+        12,
+        20,
+        21,
+        22
+      ],
+      "6": [
+        12,
+        13,
+        14,
+        22,
+        23,
+        24
+      ],
+      "7": [
+        14,
+        15,
+        16,
+        24,
+        25,
+        26
+      ],
+      "8": [
+        17,
+        18,
+        19,
+        28,
+        29,
+        30
+      ],
+      "9": [
+        19,
+        20,
+        21,
+        30,
+        31,
+        32
+      ],
+      "10": [
+        21,
+        22,
+        23,
+        32,
+        33,
+        34
+      ],
+      "11": [
+        23,
+        24,
+        25,
+        34,
+        35,
+        36
+      ],
+      "12": [
+        25,
+        26,
+        27,
+        36,
+        37,
+        38
+      ],
+      "13": [
+        29,
+        30,
+        31,
+        39,
+        40,
+        41
+      ],
+      "14": [
+        31,
+        32,
+        33,
+        41,
+        42,
+        43
+      ],
+      "15": [
+        33,
+        34,
+        35,
+        43,
+        44,
+        45
+      ],
+      "16": [
+        35,
+        36,
+        37,
+        45,
+        46,
+        47
+      ],
+      "17": [
+        40,
+        41,
+        42,
+        48,
+        49,
+        50
+      ],
+      "18": [
+        42,
+        43,
+        44,
+        50,
+        51,
+        52
+      ],
+      "19": [
+        44,
+        45,
+        46,
+        52,
+        53,
+        54
+      ]
+    },
+    "total_points": 54,
+    "total_hexes": 19
+  }
+}

examples/ai_testing/my_games/game_20251223_203724_full.json

@@ -0,0 +1,1856 @@
+{
+  "total_states": 1,
+  "timestamp": "20251223_203724",
+  "states": [
+    {
+      "hexes": [
+        {
+          "id": 1,
+          "q": 0,
+          "r": -2,
+          "type": "wood",
+          "number": 12,
+          "has_robber": false,
+          "position": [
+            0,
+            0
+          ],
+          "axial_coords": [
+            0,
+            -2
+          ]
+        },
+        {
+          "id": 2,
+          "q": 1,
+          "r": -2,
+          "type": "sheep",
+          "number": 5,
+          "has_robber": false,
+          "position": [
+            0,
+            1
+          ],
+          "axial_coords": [
+            1,
+            -2
+          ]
+        },
+        {
+          "id": 3,
+          "q": 2,
+          "r": -2,
+          "type": "wood",
+          "number": 4,
+          "has_robber": false,
+          "position": [
+            0,
+            2
+          ],
+          "axial_coords": [
+            2,
+            -2
+          ]
+        },
+        {
+          "id": 4,
+          "q": -1,
+          "r": -1,
+          "type": "sheep",
+          "number": 8,
+          "has_robber": false,
+          "position": [
+            1,
+            0
+          ],
+          "axial_coords": [
+            -1,
+            -1
+          ]
+        },
+        {
+          "id": 5,
+          "q": 0,
+          "r": -1,
+          "type": "brick",
+          "number": 6,
+          "has_robber": false,
+          "position": [
+            1,
+            1
+          ],
+          "axial_coords": [
+            0,
+            -1
+          ]
+        },
+        {
+          "id": 6,
+          "q": 1,
+          "r": -1,
+          "type": "wood",
+          "number": 3,
+          "has_robber": false,
+          "position": [
+            1,
+            2
+          ],
+          "axial_coords": [
+            1,
+            -1
+          ]
+        },
+        {
+          "id": 7,
+          "q": 2,
+          "r": -1,
+          "type": "wheat",
+          "number": 8,
+          "has_robber": false,
+          "position": [
+            1,
+            3
+          ],
+          "axial_coords": [
+            2,
+            -1
+          ]
+        },
+        {
+          "id": 8,
+          "q": -2,
+          "r": 0,
+          "type": "brick",
+          "number": 10,
+          "has_robber": false,
+          "position": [
+            2,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            0
+          ]
+        },
+        {
+          "id": 9,
+          "q": -1,
+          "r": 0,
+          "type": "wood",
+          "number": 11,
+          "has_robber": false,
+          "position": [
+            2,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            0
+          ]
+        },
+        {
+          "id": 10,
+          "q": 0,
+          "r": 0,
+          "type": "desert",
+          "number": null,
+          "has_robber": true,
+          "position": [
+            2,
+            2
+          ],
+          "axial_coords": [
+            0,
+            0
+          ]
+        },
+        {
+          "id": 11,
+          "q": 1,
+          "r": 0,
+          "type": "ore",
+          "number": 3,
+          "has_robber": false,
+          "position": [
+            2,
+            3
+          ],
+          "axial_coords": [
+            1,
+            0
+          ]
+        },
+        {
+          "id": 12,
+          "q": 2,
+          "r": 0,
+          "type": "sheep",
+          "number": 4,
+          "has_robber": false,
+          "position": [
+            2,
+            4
+          ],
+          "axial_coords": [
+            2,
+            0
+          ]
+        },
+        {
+          "id": 13,
+          "q": -2,
+          "r": 1,
+          "type": "brick",
+          "number": 10,
+          "has_robber": false,
+          "position": [
+            3,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            1
+          ]
+        },
+        {
+          "id": 14,
+          "q": -1,
+          "r": 1,
+          "type": "wheat",
+          "number": 9,
+          "has_robber": false,
+          "position": [
+            3,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            1
+          ]
+        },
+        {
+          "id": 15,
+          "q": 0,
+          "r": 1,
+          "type": "wheat",
+          "number": 6,
+          "has_robber": false,
+          "position": [
+            3,
+            2
+          ],
+          "axial_coords": [
+            0,
+            1
+          ]
+        },
+        {
+          "id": 16,
+          "q": 1,
+          "r": 1,
+          "type": "sheep",
+          "number": 11,
+          "has_robber": false,
+          "position": [
+            3,
+            3
+          ],
+          "axial_coords": [
+            1,
+            1
+          ]
+        },
+        {
+          "id": 17,
+          "q": -2,
+          "r": 2,
+          "type": "ore",
+          "number": 5,
+          "has_robber": false,
+          "position": [
+            4,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            2
+          ]
+        },
+        {
+          "id": 18,
+          "q": -1,
+          "r": 2,
+          "type": "wheat",
+          "number": 9,
+          "has_robber": false,
+          "position": [
+            4,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            2
+          ]
+        },
+        {
+          "id": 19,
+          "q": 0,
+          "r": 2,
+          "type": "ore",
+          "number": 2,
+          "has_robber": false,
+          "position": [
+            4,
+            2
+          ],
+          "axial_coords": [
+            0,
+            2
+          ]
+        }
+      ],
+      "settlements": [],
+      "cities": [],
+      "roads": [],
+      "players": [
+        {
+          "id": 0,
+          "name": "a",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        },
+        {
+          "id": 1,
+          "name": "b",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        },
+        {
+          "id": 2,
+          "name": "c",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        }
+      ],
+      "current_player": 0,
+      "current_phase": "SETUP_FIRST_ROUND",
+      "robber_position": [
+        2,
+        2
+      ],
+      "dice_result": null,
+      "points": [
+        {
+          "point_id": 1,
+          "game_coords": [
+            0,
+            0
+          ],
+          "adjacent_points": [
+            2,
+            9
+          ],
+          "adjacent_hexes": [
+            1
+          ],
+          "pixel_coords": [
+            377.5,
+            105.14428414850131
+          ]
+        },
+        {
+          "point_id": 2,
+          "game_coords": [
+            0,
+            1
+          ],
+          "adjacent_points": [
+            1,
+            3
+          ],
+          "adjacent_hexes": [
+            1
+          ],
+          "pixel_coords": [
+            422.5,
+            105.14428414850128
+          ]
+        },
+        {
+          "point_id": 3,
+          "game_coords": [
+            0,
+            2
+          ],
+          "adjacent_points": [
+            2,
+            4,
+            11
+          ],
+          "adjacent_hexes": [
+            2,
+            1
+          ],
+          "pixel_coords": [
+            445,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 4,
+          "game_coords": [
+            0,
+            3
+          ],
+          "adjacent_points": [
+            3,
+            5
+          ],
+          "adjacent_hexes": [
+            2
+          ],
+          "pixel_coords": [
+            490,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 5,
+          "game_coords": [
+            0,
+            4
+          ],
+          "adjacent_points": [
+            4,
+            6,
+            13
+          ],
+          "adjacent_hexes": [
+            3,
+            2
+          ],
+          "pixel_coords": [
+            512.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 6,
+          "game_coords": [
+            0,
+            5
+          ],
+          "adjacent_points": [
+            5,
+            7
+          ],
+          "adjacent_hexes": [
+            3
+          ],
+          "pixel_coords": [
+            557.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 7,
+          "game_coords": [
+            0,
+            6
+          ],
+          "adjacent_points": [
+            6,
+            15
+          ],
+          "adjacent_hexes": [
+            3
+          ],
+          "pixel_coords": [
+            580,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 8,
+          "game_coords": [
+            1,
+            0
+          ],
+          "adjacent_points": [
+            9,
+            18
+          ],
+          "adjacent_hexes": [
+            4
+          ],
+          "pixel_coords": [
+            310,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 9,
+          "game_coords": [
+            1,
+            1
+          ],
+          "adjacent_points": [
+            8,
+            10,
+            1
+          ],
+          "adjacent_hexes": [
+            4,
+            1
+          ],
+          "pixel_coords": [
+            355,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 10,
+          "game_coords": [
+            1,
+            2
+          ],
+          "adjacent_points": [
+            9,
+            11,
+            20
+          ],
+          "adjacent_hexes": [
+            5,
+            4,
+            1
+          ],
+          "pixel_coords": [
+            377.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 11,
+          "game_coords": [
+            1,
+            3
+          ],
+          "adjacent_points": [
+            10,
+            12,
+            3
+          ],
+          "adjacent_hexes": [
+            5,
+            2,
+            1
+          ],
+          "pixel_coords": [
+            422.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 12,
+          "game_coords": [
+            1,
+            4
+          ],
+          "adjacent_points": [
+            11,
+            13,
+            22
+          ],
+          "adjacent_hexes": [
+            6,
+            5,
+            2
+          ],
+          "pixel_coords": [
+            445,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 13,
+          "game_coords": [
+            1,
+            5
+          ],
+          "adjacent_points": [
+            12,
+            14,
+            5
+          ],
+          "adjacent_hexes": [
+            6,
+            3,
+            2
+          ],
+          "pixel_coords": [
+            490,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 14,
+          "game_coords": [
+            1,
+            6
+          ],
+          "adjacent_points": [
+            13,
+            15,
+            24
+          ],
+          "adjacent_hexes": [
+            7,
+            6,
+            3
+          ],
+          "pixel_coords": [
+            512.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 15,
+          "game_coords": [
+            1,
+            7
+          ],
+          "adjacent_points": [
+            14,
+            16,
+            7
+          ],
+          "adjacent_hexes": [
+            7,
+            3
+          ],
+          "pixel_coords": [
+            557.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 16,
+          "game_coords": [
+            1,
+            8
+          ],
+          "adjacent_points": [
+            15,
+            26
+          ],
+          "adjacent_hexes": [
+            7
+          ],
+          "pixel_coords": [
+            580,
+            300
+          ]
+        },
+        {
+          "point_id": 17,
+          "game_coords": [
+            2,
+            0
+          ],
+          "adjacent_points": [
+            18,
+            28
+          ],
+          "adjacent_hexes": [
+            8
+          ],
+          "pixel_coords": [
+            242.49999999999997,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 18,
+          "game_coords": [
+            2,
+            1
+          ],
+          "adjacent_points": [
+            17,
+            19,
+            8
+          ],
+          "adjacent_hexes": [
+            8,
+            4
+          ],
+          "pixel_coords": [
+            287.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 19,
+          "game_coords": [
+            2,
+            2
+          ],
+          "adjacent_points": [
+            18,
+            20,
+            30
+          ],
+          "adjacent_hexes": [
+            9,
+            8,
+            4
+          ],
+          "pixel_coords": [
+            310,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 20,
+          "game_coords": [
+            2,
+            3
+          ],
+          "adjacent_points": [
+            19,
+            21,
+            10
+          ],
+          "adjacent_hexes": [
+            9,
+            5,
+            4
+          ],
+          "pixel_coords": [
+            355,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 21,
+          "game_coords": [
+            2,
+            4
+          ],
+          "adjacent_points": [
+            20,
+            22,
+            32
+          ],
+          "adjacent_hexes": [
+            10,
+            9,
+            5
+          ],
+          "pixel_coords": [
+            377.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 22,
+          "game_coords": [
+            2,
+            5
+          ],
+          "adjacent_points": [
+            21,
+            23,
+            12
+          ],
+          "adjacent_hexes": [
+            10,
+            6,
+            5
+          ],
+          "pixel_coords": [
+            422.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 23,
+          "game_coords": [
+            2,
+            6
+          ],
+          "adjacent_points": [
+            22,
+            24,
+            34
+          ],
+          "adjacent_hexes": [
+            11,
+            10,
+            6
+          ],
+          "pixel_coords": [
+            445,
+            300
+          ]
+        },
+        {
+          "point_id": 24,
+          "game_coords": [
+            2,
+            7
+          ],
+          "adjacent_points": [
+            23,
+            25,
+            14
+          ],
+          "adjacent_hexes": [
+            11,
+            7,
+            6
+          ],
+          "pixel_coords": [
+            490,
+            300
+          ]
+        },
+        {
+          "point_id": 25,
+          "game_coords": [
+            2,
+            8
+          ],
+          "adjacent_points": [
+            24,
+            26,
+            36
+          ],
+          "adjacent_hexes": [
+            12,
+            11,
+            7
+          ],
+          "pixel_coords": [
+            512.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 26,
+          "game_coords": [
+            2,
+            9
+          ],
+          "adjacent_points": [
+            25,
+            27,
+            16
+          ],
+          "adjacent_hexes": [
+            12,
+            7
+          ],
+          "pixel_coords": [
+            557.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 27,
+          "game_coords": [
+            2,
+            10
+          ],
+          "adjacent_points": [
+            26,
+            38
+          ],
+          "adjacent_hexes": [
+            12
+          ],
+          "pixel_coords": [
+            580,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 28,
+          "game_coords": [
+            3,
+            0
+          ],
+          "adjacent_points": [
+            29,
+            17
+          ],
+          "adjacent_hexes": [
+            8
+          ],
+          "pixel_coords": [
+            220,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 29,
+          "game_coords": [
+            3,
+            1
+          ],
+          "adjacent_points": [
+            28,
+            30,
+            39
+          ],
+          "adjacent_hexes": [
+            13,
+            8
+          ],
+          "pixel_coords": [
+            242.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 30,
+          "game_coords": [
+            3,
+            2
+          ],
+          "adjacent_points": [
+            29,
+            31,
+            19
+          ],
+          "adjacent_hexes": [
+            13,
+            9,
+            8
+          ],
+          "pixel_coords": [
+            287.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 31,
+          "game_coords": [
+            3,
+            3
+          ],
+          "adjacent_points": [
+            30,
+            32,
+            41
+          ],
+          "adjacent_hexes": [
+            14,
+            13,
+            9
+          ],
+          "pixel_coords": [
+            310,
+            300
+          ]
+        },
+        {
+          "point_id": 32,
+          "game_coords": [
+            3,
+            4
+          ],
+          "adjacent_points": [
+            31,
+            33,
+            21
+          ],
+          "adjacent_hexes": [
+            14,
+            10,
+            9
+          ],
+          "pixel_coords": [
+            355,
+            300
+          ]
+        },
+        {
+          "point_id": 33,
+          "game_coords": [
+            3,
+            5
+          ],
+          "adjacent_points": [
+            32,
+            34,
+            43
+          ],
+          "adjacent_hexes": [
+            15,
+            14,
+            10
+          ],
+          "pixel_coords": [
+            377.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 34,
+          "game_coords": [
+            3,
+            6
+          ],
+          "adjacent_points": [
+            33,
+            35,
+            23
+          ],
+          "adjacent_hexes": [
+            15,
+            11,
+            10
+          ],
+          "pixel_coords": [
+            422.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 35,
+          "game_coords": [
+            3,
+            7
+          ],
+          "adjacent_points": [
+            34,
+            36,
+            45
+          ],
+          "adjacent_hexes": [
+            16,
+            15,
+            11
+          ],
+          "pixel_coords": [
+            445,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 36,
+          "game_coords": [
+            3,
+            8
+          ],
+          "adjacent_points": [
+            35,
+            37,
+            25
+          ],
+          "adjacent_hexes": [
+            16,
+            12,
+            11
+          ],
+          "pixel_coords": [
+            490,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 37,
+          "game_coords": [
+            3,
+            9
+          ],
+          "adjacent_points": [
+            36,
+            38,
+            47
+          ],
+          "adjacent_hexes": [
+            16,
+            12
+          ],
+          "pixel_coords": [
+            512.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 38,
+          "game_coords": [
+            3,
+            10
+          ],
+          "adjacent_points": [
+            37,
+            27
+          ],
+          "adjacent_hexes": [
+            12
+          ],
+          "pixel_coords": [
+            557.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 39,
+          "game_coords": [
+            4,
+            0
+          ],
+          "adjacent_points": [
+            40,
+            29
+          ],
+          "adjacent_hexes": [
+            13
+          ],
+          "pixel_coords": [
+            220,
+            300
+          ]
+        },
+        {
+          "point_id": 40,
+          "game_coords": [
+            4,
+            1
+          ],
+          "adjacent_points": [
+            39,
+            41,
+            48
+          ],
+          "adjacent_hexes": [
+            17,
+            13
+          ],
+          "pixel_coords": [
+            242.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 41,
+          "game_coords": [
+            4,
+            2
+          ],
+          "adjacent_points": [
+            40,
+            42,
+            31
+          ],
+          "adjacent_hexes": [
+            17,
+            14,
+            13
+          ],
+          "pixel_coords": [
+            287.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 42,
+          "game_coords": [
+            4,
+            3
+          ],
+          "adjacent_points": [
+            41,
+            43,
+            50
+          ],
+          "adjacent_hexes": [
+            18,
+            17,
+            14
+          ],
+          "pixel_coords": [
+            310,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 43,
+          "game_coords": [
+            4,
+            4
+          ],
+          "adjacent_points": [
+            42,
+            44,
+            33
+          ],
+          "adjacent_hexes": [
+            18,
+            15,
+            14
+          ],
+          "pixel_coords": [
+            355,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 44,
+          "game_coords": [
+            4,
+            5
+          ],
+          "adjacent_points": [
+            43,
+            45,
+            52
+          ],
+          "adjacent_hexes": [
+            19,
+            18,
+            15
+          ],
+          "pixel_coords": [
+            377.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 45,
+          "game_coords": [
+            4,
+            6
+          ],
+          "adjacent_points": [
+            44,
+            46,
+            35
+          ],
+          "adjacent_hexes": [
+            19,
+            16,
+            15
+          ],
+          "pixel_coords": [
+            422.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 46,
+          "game_coords": [
+            4,
+            7
+          ],
+          "adjacent_points": [
+            45,
+            47,
+            54
+          ],
+          "adjacent_hexes": [
+            19,
+            16
+          ],
+          "pixel_coords": [
+            445,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 47,
+          "game_coords": [
+            4,
+            8
+          ],
+          "adjacent_points": [
+            46,
+            37
+          ],
+          "adjacent_hexes": [
+            16
+          ],
+          "pixel_coords": [
+            490,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 48,
+          "game_coords": [
+            5,
+            0
+          ],
+          "adjacent_points": [
+            49,
+            40
+          ],
+          "adjacent_hexes": [
+            17
+          ],
+          "pixel_coords": [
+            220,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 49,
+          "game_coords": [
+            5,
+            1
+          ],
+          "adjacent_points": [
+            48,
+            50
+          ],
+          "adjacent_hexes": [
+            17
+          ],
+          "pixel_coords": [
+            242.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 50,
+          "game_coords": [
+            5,
+            2
+          ],
+          "adjacent_points": [
+            49,
+            51,
+            42
+          ],
+          "adjacent_hexes": [
+            18,
+            17
+          ],
+          "pixel_coords": [
+            287.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 51,
+          "game_coords": [
+            5,
+            3
+          ],
+          "adjacent_points": [
+            50,
+            52
+          ],
+          "adjacent_hexes": [
+            18
+          ],
+          "pixel_coords": [
+            310,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 52,
+          "game_coords": [
+            5,
+            4
+          ],
+          "adjacent_points": [
+            51,
+            53,
+            44
+          ],
+          "adjacent_hexes": [
+            19,
+            18
+          ],
+          "pixel_coords": [
+            355,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 53,
+          "game_coords": [
+            5,
+            5
+          ],
+          "adjacent_points": [
+            52,
+            54
+          ],
+          "adjacent_hexes": [
+            19
+          ],
+          "pixel_coords": [
+            377.5,
+            494.8557158514987
+          ]
+        },
+        {
+          "point_id": 54,
+          "game_coords": [
+            5,
+            6
+          ],
+          "adjacent_points": [
+            53,
+            46
+          ],
+          "adjacent_hexes": [
+            19
+          ],
+          "pixel_coords": [
+            422.5,
+            494.8557158514987
+          ]
+        }
+      ],
+      "board_graph": {
+        "adjacency": {
+          "1": [
+            2,
+            9
+          ],
+          "2": [
+            1,
+            3
+          ],
+          "3": [
+            2,
+            4,
+            11
+          ],
+          "4": [
+            3,
+            5
+          ],
+          "5": [
+            4,
+            6,
+            13
+          ],
+          "6": [
+            5,
+            7
+          ],
+          "7": [
+            6,
+            15
+          ],
+          "8": [
+            9,
+            18
+          ],
+          "9": [
+            8,
+            10,
+            1
+          ],
+          "10": [
+            9,
+            11,
+            20
+          ],
+          "11": [
+            10,
+            12,
+            3
+          ],
+          "12": [
+            11,
+            13,
+            22
+          ],
+          "13": [
+            12,
+            14,
+            5
+          ],
+          "14": [
+            13,
+            15,
+            24
+          ],
+          "15": [
+            14,
+            16,
+            7
+          ],
+          "16": [
+            15,
+            26
+          ],
+          "17": [
+            18,
+            28
+          ],
+          "18": [
+            17,
+            19,
+            8
+          ],
+          "19": [
+            18,
+            20,
+            30
+          ],
+          "20": [
+            19,
+            21,
+            10
+          ],
+          "21": [
+            20,
+            22,
+            32
+          ],
+          "22": [
+            21,
+            23,
+            12
+          ],
+          "23": [
+            22,
+            24,
+            34
+          ],
+          "24": [
+            23,
+            25,
+            14
+          ],
+          "25": [
+            24,
+            26,
+            36
+          ],
+          "26": [
+            25,
+            27,
+            16
+          ],
+          "27": [
+            26,
+            38
+          ],
+          "28": [
+            29,
+            17
+          ],
+          "29": [
+            28,
+            30,
+            39
+          ],
+          "30": [
+            29,
+            31,
+            19
+          ],
+          "31": [
+            30,
+            32,
+            41
+          ],
+          "32": [
+            31,
+            33,
+            21
+          ],
+          "33": [
+            32,
+            34,
+            43
+          ],
+          "34": [
+            33,
+            35,
+            23
+          ],
+          "35": [
+            34,
+            36,
+            45
+          ],
+          "36": [
+            35,
+            37,
+            25
+          ],
+          "37": [
+            36,
+            38,
+            47
+          ],
+          "38": [
+            37,
+            27
+          ],
+          "39": [
+            40,
+            29
+          ],
+          "40": [
+            39,
+            41,
+            48
+          ],
+          "41": [
+            40,
+            42,
+            31
+          ],
+          "42": [
+            41,
+            43,
+            50
+          ],
+          "43": [
+            42,
+            44,
+            33
+          ],
+          "44": [
+            43,
+            45,
+            52
+          ],
+          "45": [
+            44,
+            46,
+            35
+          ],
+          "46": [
+            45,
+            47,
+            54
+          ],
+          "47": [
+            46,
+            37
+          ],
+          "48": [
+            49,
+            40
+          ],
+          "49": [
+            48,
+            50
+          ],
+          "50": [
+            49,
+            51,
+            42
+          ],
+          "51": [
+            50,
+            52
+          ],
+          "52": [
+            51,
+            53,
+            44
+          ],
+          "53": [
+            52,
+            54
+          ],
+          "54": [
+            53,
+            46
+          ]
+        },
+        "hex_to_points": {
+          "1": [
+            1,
+            2,
+            3,
+            9,
+            10,
+            11
+          ],
+          "2": [
+            3,
+            4,
+            5,
+            11,
+            12,
+            13
+          ],
+          "3": [
+            5,
+            6,
+            7,
+            13,
+            14,
+            15
+          ],
+          "4": [
+            8,
+            9,
+            10,
+            18,
+            19,
+            20
+          ],
+          "5": [
+            10,
+            11,
+            12,
+            20,
+            21,
+            22
+          ],
+          "6": [
+            12,
+            13,
+            14,
+            22,
+            23,
+            24
+          ],
+          "7": [
+            14,
+            15,
+            16,
+            24,
+            25,
+            26
+          ],
+          "8": [
+            17,
+            18,
+            19,
+            28,
+            29,
+            30
+          ],
+          "9": [
+            19,
+            20,
+            21,
+            30,
+            31,
+            32
+          ],
+          "10": [
+            21,
+            22,
+            23,
+            32,
+            33,
+            34
+          ],
+          "11": [
+            23,
+            24,
+            25,
+            34,
+            35,
+            36
+          ],
+          "12": [
+            25,
+            26,
+            27,
+            36,
+            37,
+            38
+          ],
+          "13": [
+            29,
+            30,
+            31,
+            39,
+            40,
+            41
+          ],
+          "14": [
+            31,
+            32,
+            33,
+            41,
+            42,
+            43
+          ],
+          "15": [
+            33,
+            34,
+            35,
+            43,
+            44,
+            45
+          ],
+          "16": [
+            35,
+            36,
+            37,
+            45,
+            46,
+            47
+          ],
+          "17": [
+            40,
+            41,
+            42,
+            48,
+            49,
+            50
+          ],
+          "18": [
+            42,
+            43,
+            44,
+            50,
+            51,
+            52
+          ],
+          "19": [
+            44,
+            45,
+            46,
+            52,
+            53,
+            54
+          ]
+        },
+        "total_points": 54,
+        "total_hexes": 19
+      }
+    }
+  ]
+}

examples/ai_testing/my_games/game_20251223_204416_final.json

@@ -0,0 +1,1850 @@
+{
+  "hexes": [
+    {
+      "id": 1,
+      "q": 0,
+      "r": -2,
+      "type": "wood",
+      "number": 12,
+      "has_robber": false,
+      "position": [
+        0,
+        0
+      ],
+      "axial_coords": [
+        0,
+        -2
+      ]
+    },
+    {
+      "id": 2,
+      "q": 1,
+      "r": -2,
+      "type": "sheep",
+      "number": 5,
+      "has_robber": false,
+      "position": [
+        0,
+        1
+      ],
+      "axial_coords": [
+        1,
+        -2
+      ]
+    },
+    {
+      "id": 3,
+      "q": 2,
+      "r": -2,
+      "type": "wood",
+      "number": 4,
+      "has_robber": false,
+      "position": [
+        0,
+        2
+      ],
+      "axial_coords": [
+        2,
+        -2
+      ]
+    },
+    {
+      "id": 4,
+      "q": -1,
+      "r": -1,
+      "type": "sheep",
+      "number": 8,
+      "has_robber": false,
+      "position": [
+        1,
+        0
+      ],
+      "axial_coords": [
+        -1,
+        -1
+      ]
+    },
+    {
+      "id": 5,
+      "q": 0,
+      "r": -1,
+      "type": "brick",
+      "number": 6,
+      "has_robber": false,
+      "position": [
+        1,
+        1
+      ],
+      "axial_coords": [
+        0,
+        -1
+      ]
+    },
+    {
+      "id": 6,
+      "q": 1,
+      "r": -1,
+      "type": "wood",
+      "number": 3,
+      "has_robber": false,
+      "position": [
+        1,
+        2
+      ],
+      "axial_coords": [
+        1,
+        -1
+      ]
+    },
+    {
+      "id": 7,
+      "q": 2,
+      "r": -1,
+      "type": "wheat",
+      "number": 8,
+      "has_robber": false,
+      "position": [
+        1,
+        3
+      ],
+      "axial_coords": [
+        2,
+        -1
+      ]
+    },
+    {
+      "id": 8,
+      "q": -2,
+      "r": 0,
+      "type": "brick",
+      "number": 10,
+      "has_robber": false,
+      "position": [
+        2,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        0
+      ]
+    },
+    {
+      "id": 9,
+      "q": -1,
+      "r": 0,
+      "type": "wood",
+      "number": 11,
+      "has_robber": false,
+      "position": [
+        2,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        0
+      ]
+    },
+    {
+      "id": 10,
+      "q": 0,
+      "r": 0,
+      "type": "desert",
+      "number": null,
+      "has_robber": true,
+      "position": [
+        2,
+        2
+      ],
+      "axial_coords": [
+        0,
+        0
+      ]
+    },
+    {
+      "id": 11,
+      "q": 1,
+      "r": 0,
+      "type": "ore",
+      "number": 3,
+      "has_robber": false,
+      "position": [
+        2,
+        3
+      ],
+      "axial_coords": [
+        1,
+        0
+      ]
+    },
+    {
+      "id": 12,
+      "q": 2,
+      "r": 0,
+      "type": "sheep",
+      "number": 4,
+      "has_robber": false,
+      "position": [
+        2,
+        4
+      ],
+      "axial_coords": [
+        2,
+        0
+      ]
+    },
+    {
+      "id": 13,
+      "q": -2,
+      "r": 1,
+      "type": "brick",
+      "number": 10,
+      "has_robber": false,
+      "position": [
+        3,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        1
+      ]
+    },
+    {
+      "id": 14,
+      "q": -1,
+      "r": 1,
+      "type": "wheat",
+      "number": 9,
+      "has_robber": false,
+      "position": [
+        3,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        1
+      ]
+    },
+    {
+      "id": 15,
+      "q": 0,
+      "r": 1,
+      "type": "wheat",
+      "number": 6,
+      "has_robber": false,
+      "position": [
+        3,
+        2
+      ],
+      "axial_coords": [
+        0,
+        1
+      ]
+    },
+    {
+      "id": 16,
+      "q": 1,
+      "r": 1,
+      "type": "sheep",
+      "number": 11,
+      "has_robber": false,
+      "position": [
+        3,
+        3
+      ],
+      "axial_coords": [
+        1,
+        1
+      ]
+    },
+    {
+      "id": 17,
+      "q": -2,
+      "r": 2,
+      "type": "ore",
+      "number": 5,
+      "has_robber": false,
+      "position": [
+        4,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        2
+      ]
+    },
+    {
+      "id": 18,
+      "q": -1,
+      "r": 2,
+      "type": "wheat",
+      "number": 9,
+      "has_robber": false,
+      "position": [
+        4,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        2
+      ]
+    },
+    {
+      "id": 19,
+      "q": 0,
+      "r": 2,
+      "type": "ore",
+      "number": 2,
+      "has_robber": false,
+      "position": [
+        4,
+        2
+      ],
+      "axial_coords": [
+        0,
+        2
+      ]
+    }
+  ],
+  "settlements": [],
+  "cities": [],
+  "roads": [],
+  "players": [
+    {
+      "id": 0,
+      "name": "a",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    },
+    {
+      "id": 1,
+      "name": "b",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    },
+    {
+      "id": 2,
+      "name": "c",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    }
+  ],
+  "current_player": 0,
+  "current_phase": "SETUP_FIRST_ROUND",
+  "robber_position": [
+    2,
+    2
+  ],
+  "dice_result": null,
+  "points": [
+    {
+      "point_id": 1,
+      "game_coords": [
+        0,
+        0
+      ],
+      "adjacent_points": [
+        2,
+        9
+      ],
+      "adjacent_hexes": [
+        1
+      ],
+      "pixel_coords": [
+        377.5,
+        105.14428414850131
+      ]
+    },
+    {
+      "point_id": 2,
+      "game_coords": [
+        0,
+        1
+      ],
+      "adjacent_points": [
+        1,
+        3
+      ],
+      "adjacent_hexes": [
+        1
+      ],
+      "pixel_coords": [
+        422.5,
+        105.14428414850128
+      ]
+    },
+    {
+      "point_id": 3,
+      "game_coords": [
+        0,
+        2
+      ],
+      "adjacent_points": [
+        2,
+        4,
+        11
+      ],
+      "adjacent_hexes": [
+        2,
+        1
+      ],
+      "pixel_coords": [
+        445,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 4,
+      "game_coords": [
+        0,
+        3
+      ],
+      "adjacent_points": [
+        3,
+        5
+      ],
+      "adjacent_hexes": [
+        2
+      ],
+      "pixel_coords": [
+        490,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 5,
+      "game_coords": [
+        0,
+        4
+      ],
+      "adjacent_points": [
+        4,
+        6,
+        13
+      ],
+      "adjacent_hexes": [
+        3,
+        2
+      ],
+      "pixel_coords": [
+        512.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 6,
+      "game_coords": [
+        0,
+        5
+      ],
+      "adjacent_points": [
+        5,
+        7
+      ],
+      "adjacent_hexes": [
+        3
+      ],
+      "pixel_coords": [
+        557.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 7,
+      "game_coords": [
+        0,
+        6
+      ],
+      "adjacent_points": [
+        6,
+        15
+      ],
+      "adjacent_hexes": [
+        3
+      ],
+      "pixel_coords": [
+        580,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 8,
+      "game_coords": [
+        1,
+        0
+      ],
+      "adjacent_points": [
+        9,
+        18
+      ],
+      "adjacent_hexes": [
+        4
+      ],
+      "pixel_coords": [
+        310,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 9,
+      "game_coords": [
+        1,
+        1
+      ],
+      "adjacent_points": [
+        8,
+        10,
+        1
+      ],
+      "adjacent_hexes": [
+        4,
+        1
+      ],
+      "pixel_coords": [
+        355,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 10,
+      "game_coords": [
+        1,
+        2
+      ],
+      "adjacent_points": [
+        9,
+        11,
+        20
+      ],
+      "adjacent_hexes": [
+        5,
+        4,
+        1
+      ],
+      "pixel_coords": [
+        377.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 11,
+      "game_coords": [
+        1,
+        3
+      ],
+      "adjacent_points": [
+        10,
+        12,
+        3
+      ],
+      "adjacent_hexes": [
+        5,
+        2,
+        1
+      ],
+      "pixel_coords": [
+        422.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 12,
+      "game_coords": [
+        1,
+        4
+      ],
+      "adjacent_points": [
+        11,
+        13,
+        22
+      ],
+      "adjacent_hexes": [
+        6,
+        5,
+        2
+      ],
+      "pixel_coords": [
+        445,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 13,
+      "game_coords": [
+        1,
+        5
+      ],
+      "adjacent_points": [
+        12,
+        14,
+        5
+      ],
+      "adjacent_hexes": [
+        6,
+        3,
+        2
+      ],
+      "pixel_coords": [
+        490,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 14,
+      "game_coords": [
+        1,
+        6
+      ],
+      "adjacent_points": [
+        13,
+        15,
+        24
+      ],
+      "adjacent_hexes": [
+        7,
+        6,
+        3
+      ],
+      "pixel_coords": [
+        512.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 15,
+      "game_coords": [
+        1,
+        7
+      ],
+      "adjacent_points": [
+        14,
+        16,
+        7
+      ],
+      "adjacent_hexes": [
+        7,
+        3
+      ],
+      "pixel_coords": [
+        557.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 16,
+      "game_coords": [
+        1,
+        8
+      ],
+      "adjacent_points": [
+        15,
+        26
+      ],
+      "adjacent_hexes": [
+        7
+      ],
+      "pixel_coords": [
+        580,
+        300
+      ]
+    },
+    {
+      "point_id": 17,
+      "game_coords": [
+        2,
+        0
+      ],
+      "adjacent_points": [
+        18,
+        28
+      ],
+      "adjacent_hexes": [
+        8
+      ],
+      "pixel_coords": [
+        242.49999999999997,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 18,
+      "game_coords": [
+        2,
+        1
+      ],
+      "adjacent_points": [
+        17,
+        19,
+        8
+      ],
+      "adjacent_hexes": [
+        8,
+        4
+      ],
+      "pixel_coords": [
+        287.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 19,
+      "game_coords": [
+        2,
+        2
+      ],
+      "adjacent_points": [
+        18,
+        20,
+        30
+      ],
+      "adjacent_hexes": [
+        9,
+        8,
+        4
+      ],
+      "pixel_coords": [
+        310,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 20,
+      "game_coords": [
+        2,
+        3
+      ],
+      "adjacent_points": [
+        19,
+        21,
+        10
+      ],
+      "adjacent_hexes": [
+        9,
+        5,
+        4
+      ],
+      "pixel_coords": [
+        355,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 21,
+      "game_coords": [
+        2,
+        4
+      ],
+      "adjacent_points": [
+        20,
+        22,
+        32
+      ],
+      "adjacent_hexes": [
+        10,
+        9,
+        5
+      ],
+      "pixel_coords": [
+        377.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 22,
+      "game_coords": [
+        2,
+        5
+      ],
+      "adjacent_points": [
+        21,
+        23,
+        12
+      ],
+      "adjacent_hexes": [
+        10,
+        6,
+        5
+      ],
+      "pixel_coords": [
+        422.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 23,
+      "game_coords": [
+        2,
+        6
+      ],
+      "adjacent_points": [
+        22,
+        24,
+        34
+      ],
+      "adjacent_hexes": [
+        11,
+        10,
+        6
+      ],
+      "pixel_coords": [
+        445,
+        300
+      ]
+    },
+    {
+      "point_id": 24,
+      "game_coords": [
+        2,
+        7
+      ],
+      "adjacent_points": [
+        23,
+        25,
+        14
+      ],
+      "adjacent_hexes": [
+        11,
+        7,
+        6
+      ],
+      "pixel_coords": [
+        490,
+        300
+      ]
+    },
+    {
+      "point_id": 25,
+      "game_coords": [
+        2,
+        8
+      ],
+      "adjacent_points": [
+        24,
+        26,
+        36
+      ],
+      "adjacent_hexes": [
+        12,
+        11,
+        7
+      ],
+      "pixel_coords": [
+        512.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 26,
+      "game_coords": [
+        2,
+        9
+      ],
+      "adjacent_points": [
+        25,
+        27,
+        16
+      ],
+      "adjacent_hexes": [
+        12,
+        7
+      ],
+      "pixel_coords": [
+        557.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 27,
+      "game_coords": [
+        2,
+        10
+      ],
+      "adjacent_points": [
+        26,
+        38
+      ],
+      "adjacent_hexes": [
+        12
+      ],
+      "pixel_coords": [
+        580,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 28,
+      "game_coords": [
+        3,
+        0
+      ],
+      "adjacent_points": [
+        29,
+        17
+      ],
+      "adjacent_hexes": [
+        8
+      ],
+      "pixel_coords": [
+        220,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 29,
+      "game_coords": [
+        3,
+        1
+      ],
+      "adjacent_points": [
+        28,
+        30,
+        39
+      ],
+      "adjacent_hexes": [
+        13,
+        8
+      ],
+      "pixel_coords": [
+        242.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 30,
+      "game_coords": [
+        3,
+        2
+      ],
+      "adjacent_points": [
+        29,
+        31,
+        19
+      ],
+      "adjacent_hexes": [
+        13,
+        9,
+        8
+      ],
+      "pixel_coords": [
+        287.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 31,
+      "game_coords": [
+        3,
+        3
+      ],
+      "adjacent_points": [
+        30,
+        32,
+        41
+      ],
+      "adjacent_hexes": [
+        14,
+        13,
+        9
+      ],
+      "pixel_coords": [
+        310,
+        300
+      ]
+    },
+    {
+      "point_id": 32,
+      "game_coords": [
+        3,
+        4
+      ],
+      "adjacent_points": [
+        31,
+        33,
+        21
+      ],
+      "adjacent_hexes": [
+        14,
+        10,
+        9
+      ],
+      "pixel_coords": [
+        355,
+        300
+      ]
+    },
+    {
+      "point_id": 33,
+      "game_coords": [
+        3,
+        5
+      ],
+      "adjacent_points": [
+        32,
+        34,
+        43
+      ],
+      "adjacent_hexes": [
+        15,
+        14,
+        10
+      ],
+      "pixel_coords": [
+        377.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 34,
+      "game_coords": [
+        3,
+        6
+      ],
+      "adjacent_points": [
+        33,
+        35,
+        23
+      ],
+      "adjacent_hexes": [
+        15,
+        11,
+        10
+      ],
+      "pixel_coords": [
+        422.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 35,
+      "game_coords": [
+        3,
+        7
+      ],
+      "adjacent_points": [
+        34,
+        36,
+        45
+      ],
+      "adjacent_hexes": [
+        16,
+        15,
+        11
+      ],
+      "pixel_coords": [
+        445,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 36,
+      "game_coords": [
+        3,
+        8
+      ],
+      "adjacent_points": [
+        35,
+        37,
+        25
+      ],
+      "adjacent_hexes": [
+        16,
+        12,
+        11
+      ],
+      "pixel_coords": [
+        490,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 37,
+      "game_coords": [
+        3,
+        9
+      ],
+      "adjacent_points": [
+        36,
+        38,
+        47
+      ],
+      "adjacent_hexes": [
+        16,
+        12
+      ],
+      "pixel_coords": [
+        512.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 38,
+      "game_coords": [
+        3,
+        10
+      ],
+      "adjacent_points": [
+        37,
+        27
+      ],
+      "adjacent_hexes": [
+        12
+      ],
+      "pixel_coords": [
+        557.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 39,
+      "game_coords": [
+        4,
+        0
+      ],
+      "adjacent_points": [
+        40,
+        29
+      ],
+      "adjacent_hexes": [
+        13
+      ],
+      "pixel_coords": [
+        220,
+        300
+      ]
+    },
+    {
+      "point_id": 40,
+      "game_coords": [
+        4,
+        1
+      ],
+      "adjacent_points": [
+        39,
+        41,
+        48
+      ],
+      "adjacent_hexes": [
+        17,
+        13
+      ],
+      "pixel_coords": [
+        242.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 41,
+      "game_coords": [
+        4,
+        2
+      ],
+      "adjacent_points": [
+        40,
+        42,
+        31
+      ],
+      "adjacent_hexes": [
+        17,
+        14,
+        13
+      ],
+      "pixel_coords": [
+        287.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 42,
+      "game_coords": [
+        4,
+        3
+      ],
+      "adjacent_points": [
+        41,
+        43,
+        50
+      ],
+      "adjacent_hexes": [
+        18,
+        17,
+        14
+      ],
+      "pixel_coords": [
+        310,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 43,
+      "game_coords": [
+        4,
+        4
+      ],
+      "adjacent_points": [
+        42,
+        44,
+        33
+      ],
+      "adjacent_hexes": [
+        18,
+        15,
+        14
+      ],
+      "pixel_coords": [
+        355,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 44,
+      "game_coords": [
+        4,
+        5
+      ],
+      "adjacent_points": [
+        43,
+        45,
+        52
+      ],
+      "adjacent_hexes": [
+        19,
+        18,
+        15
+      ],
+      "pixel_coords": [
+        377.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 45,
+      "game_coords": [
+        4,
+        6
+      ],
+      "adjacent_points": [
+        44,
+        46,
+        35
+      ],
+      "adjacent_hexes": [
+        19,
+        16,
+        15
+      ],
+      "pixel_coords": [
+        422.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 46,
+      "game_coords": [
+        4,
+        7
+      ],
+      "adjacent_points": [
+        45,
+        47,
+        54
+      ],
+      "adjacent_hexes": [
+        19,
+        16
+      ],
+      "pixel_coords": [
+        445,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 47,
+      "game_coords": [
+        4,
+        8
+      ],
+      "adjacent_points": [
+        46,
+        37
+      ],
+      "adjacent_hexes": [
+        16
+      ],
+      "pixel_coords": [
+        490,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 48,
+      "game_coords": [
+        5,
+        0
+      ],
+      "adjacent_points": [
+        49,
+        40
+      ],
+      "adjacent_hexes": [
+        17
+      ],
+      "pixel_coords": [
+        220,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 49,
+      "game_coords": [
+        5,
+        1
+      ],
+      "adjacent_points": [
+        48,
+        50
+      ],
+      "adjacent_hexes": [
+        17
+      ],
+      "pixel_coords": [
+        242.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 50,
+      "game_coords": [
+        5,
+        2
+      ],
+      "adjacent_points": [
+        49,
+        51,
+        42
+      ],
+      "adjacent_hexes": [
+        18,
+        17
+      ],
+      "pixel_coords": [
+        287.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 51,
+      "game_coords": [
+        5,
+        3
+      ],
+      "adjacent_points": [
+        50,
+        52
+      ],
+      "adjacent_hexes": [
+        18
+      ],
+      "pixel_coords": [
+        310,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 52,
+      "game_coords": [
+        5,
+        4
+      ],
+      "adjacent_points": [
+        51,
+        53,
+        44
+      ],
+      "adjacent_hexes": [
+        19,
+        18
+      ],
+      "pixel_coords": [
+        355,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 53,
+      "game_coords": [
+        5,
+        5
+      ],
+      "adjacent_points": [
+        52,
+        54
+      ],
+      "adjacent_hexes": [
+        19
+      ],
+      "pixel_coords": [
+        377.5,
+        494.8557158514987
+      ]
+    },
+    {
+      "point_id": 54,
+      "game_coords": [
+        5,
+        6
+      ],
+      "adjacent_points": [
+        53,
+        46
+      ],
+      "adjacent_hexes": [
+        19
+      ],
+      "pixel_coords": [
+        422.5,
+        494.8557158514987
+      ]
+    }
+  ],
+  "board_graph": {
+    "adjacency": {
+      "1": [
+        2,
+        9
+      ],
+      "2": [
+        1,
+        3
+      ],
+      "3": [
+        2,
+        4,
+        11
+      ],
+      "4": [
+        3,
+        5
+      ],
+      "5": [
+        4,
+        6,
+        13
+      ],
+      "6": [
+        5,
+        7
+      ],
+      "7": [
+        6,
+        15
+      ],
+      "8": [
+        9,
+        18
+      ],
+      "9": [
+        8,
+        10,
+        1
+      ],
+      "10": [
+        9,
+        11,
+        20
+      ],
+      "11": [
+        10,
+        12,
+        3
+      ],
+      "12": [
+        11,
+        13,
+        22
+      ],
+      "13": [
+        12,
+        14,
+        5
+      ],
+      "14": [
+        13,
+        15,
+        24
+      ],
+      "15": [
+        14,
+        16,
+        7
+      ],
+      "16": [
+        15,
+        26
+      ],
+      "17": [
+        18,
+        28
+      ],
+      "18": [
+        17,
+        19,
+        8
+      ],
+      "19": [
+        18,
+        20,
+        30
+      ],
+      "20": [
+        19,
+        21,
+        10
+      ],
+      "21": [
+        20,
+        22,
+        32
+      ],
+      "22": [
+        21,
+        23,
+        12
+      ],
+      "23": [
+        22,
+        24,
+        34
+      ],
+      "24": [
+        23,
+        25,
+        14
+      ],
+      "25": [
+        24,
+        26,
+        36
+      ],
+      "26": [
+        25,
+        27,
+        16
+      ],
+      "27": [
+        26,
+        38
+      ],
+      "28": [
+        29,
+        17
+      ],
+      "29": [
+        28,
+        30,
+        39
+      ],
+      "30": [
+        29,
+        31,
+        19
+      ],
+      "31": [
+        30,
+        32,
+        41
+      ],
+      "32": [
+        31,
+        33,
+        21
+      ],
+      "33": [
+        32,
+        34,
+        43
+      ],
+      "34": [
+        33,
+        35,
+        23
+      ],
+      "35": [
+        34,
+        36,
+        45
+      ],
+      "36": [
+        35,
+        37,
+        25
+      ],
+      "37": [
+        36,
+        38,
+        47
+      ],
+      "38": [
+        37,
+        27
+      ],
+      "39": [
+        40,
+        29
+      ],
+      "40": [
+        39,
+        41,
+        48
+      ],
+      "41": [
+        40,
+        42,
+        31
+      ],
+      "42": [
+        41,
+        43,
+        50
+      ],
+      "43": [
+        42,
+        44,
+        33
+      ],
+      "44": [
+        43,
+        45,
+        52
+      ],
+      "45": [
+        44,
+        46,
+        35
+      ],
+      "46": [
+        45,
+        47,
+        54
+      ],
+      "47": [
+        46,
+        37
+      ],
+      "48": [
+        49,
+        40
+      ],
+      "49": [
+        48,
+        50
+      ],
+      "50": [
+        49,
+        51,
+        42
+      ],
+      "51": [
+        50,
+        52
+      ],
+      "52": [
+        51,
+        53,
+        44
+      ],
+      "53": [
+        52,
+        54
+      ],
+      "54": [
+        53,
+        46
+      ]
+    },
+    "hex_to_points": {
+      "1": [
+        1,
+        2,
+        3,
+        9,
+        10,
+        11
+      ],
+      "2": [
+        3,
+        4,
+        5,
+        11,
+        12,
+        13
+      ],
+      "3": [
+        5,
+        6,
+        7,
+        13,
+        14,
+        15
+      ],
+      "4": [
+        8,
+        9,
+        10,
+        18,
+        19,
+        20
+      ],
+      "5": [
+        10,
+        11,
+        12,
+        20,
+        21,
+        22
+      ],
+      "6": [
+        12,
+        13,
+        14,
+        22,
+        23,
+        24
+      ],
+      "7": [
+        14,
+        15,
+        16,
+        24,
+        25,
+        26
+      ],
+      "8": [
+        17,
+        18,
+        19,
+        28,
+        29,
+        30
+      ],
+      "9": [
+        19,
+        20,
+        21,
+        30,
+        31,
+        32
+      ],
+      "10": [
+        21,
+        22,
+        23,
+        32,
+        33,
+        34
+      ],
+      "11": [
+        23,
+        24,
+        25,
+        34,
+        35,
+        36
+      ],
+      "12": [
+        25,
+        26,
+        27,
+        36,
+        37,
+        38
+      ],
+      "13": [
+        29,
+        30,
+        31,
+        39,
+        40,
+        41
+      ],
+      "14": [
+        31,
+        32,
+        33,
+        41,
+        42,
+        43
+      ],
+      "15": [
+        33,
+        34,
+        35,
+        43,
+        44,
+        45
+      ],
+      "16": [
+        35,
+        36,
+        37,
+        45,
+        46,
+        47
+      ],
+      "17": [
+        40,
+        41,
+        42,
+        48,
+        49,
+        50
+      ],
+      "18": [
+        42,
+        43,
+        44,
+        50,
+        51,
+        52
+      ],
+      "19": [
+        44,
+        45,
+        46,
+        52,
+        53,
+        54
+      ]
+    },
+    "total_points": 54,
+    "total_hexes": 19
+  }
+}

examples/ai_testing/my_games/game_20251223_204416_full.json

@@ -0,0 +1,1856 @@
+{
+  "total_states": 1,
+  "timestamp": "20251223_204416",
+  "states": [
+    {
+      "hexes": [
+        {
+          "id": 1,
+          "q": 0,
+          "r": -2,
+          "type": "wood",
+          "number": 12,
+          "has_robber": false,
+          "position": [
+            0,
+            0
+          ],
+          "axial_coords": [
+            0,
+            -2
+          ]
+        },
+        {
+          "id": 2,
+          "q": 1,
+          "r": -2,
+          "type": "sheep",
+          "number": 5,
+          "has_robber": false,
+          "position": [
+            0,
+            1
+          ],
+          "axial_coords": [
+            1,
+            -2
+          ]
+        },
+        {
+          "id": 3,
+          "q": 2,
+          "r": -2,
+          "type": "wood",
+          "number": 4,
+          "has_robber": false,
+          "position": [
+            0,
+            2
+          ],
+          "axial_coords": [
+            2,
+            -2
+          ]
+        },
+        {
+          "id": 4,
+          "q": -1,
+          "r": -1,
+          "type": "sheep",
+          "number": 8,
+          "has_robber": false,
+          "position": [
+            1,
+            0
+          ],
+          "axial_coords": [
+            -1,
+            -1
+          ]
+        },
+        {
+          "id": 5,
+          "q": 0,
+          "r": -1,
+          "type": "brick",
+          "number": 6,
+          "has_robber": false,
+          "position": [
+            1,
+            1
+          ],
+          "axial_coords": [
+            0,
+            -1
+          ]
+        },
+        {
+          "id": 6,
+          "q": 1,
+          "r": -1,
+          "type": "wood",
+          "number": 3,
+          "has_robber": false,
+          "position": [
+            1,
+            2
+          ],
+          "axial_coords": [
+            1,
+            -1
+          ]
+        },
+        {
+          "id": 7,
+          "q": 2,
+          "r": -1,
+          "type": "wheat",
+          "number": 8,
+          "has_robber": false,
+          "position": [
+            1,
+            3
+          ],
+          "axial_coords": [
+            2,
+            -1
+          ]
+        },
+        {
+          "id": 8,
+          "q": -2,
+          "r": 0,
+          "type": "brick",
+          "number": 10,
+          "has_robber": false,
+          "position": [
+            2,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            0
+          ]
+        },
+        {
+          "id": 9,
+          "q": -1,
+          "r": 0,
+          "type": "wood",
+          "number": 11,
+          "has_robber": false,
+          "position": [
+            2,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            0
+          ]
+        },
+        {
+          "id": 10,
+          "q": 0,
+          "r": 0,
+          "type": "desert",
+          "number": null,
+          "has_robber": true,
+          "position": [
+            2,
+            2
+          ],
+          "axial_coords": [
+            0,
+            0
+          ]
+        },
+        {
+          "id": 11,
+          "q": 1,
+          "r": 0,
+          "type": "ore",
+          "number": 3,
+          "has_robber": false,
+          "position": [
+            2,
+            3
+          ],
+          "axial_coords": [
+            1,
+            0
+          ]
+        },
+        {
+          "id": 12,
+          "q": 2,
+          "r": 0,
+          "type": "sheep",
+          "number": 4,
+          "has_robber": false,
+          "position": [
+            2,
+            4
+          ],
+          "axial_coords": [
+            2,
+            0
+          ]
+        },
+        {
+          "id": 13,
+          "q": -2,
+          "r": 1,
+          "type": "brick",
+          "number": 10,
+          "has_robber": false,
+          "position": [
+            3,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            1
+          ]
+        },
+        {
+          "id": 14,
+          "q": -1,
+          "r": 1,
+          "type": "wheat",
+          "number": 9,
+          "has_robber": false,
+          "position": [
+            3,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            1
+          ]
+        },
+        {
+          "id": 15,
+          "q": 0,
+          "r": 1,
+          "type": "wheat",
+          "number": 6,
+          "has_robber": false,
+          "position": [
+            3,
+            2
+          ],
+          "axial_coords": [
+            0,
+            1
+          ]
+        },
+        {
+          "id": 16,
+          "q": 1,
+          "r": 1,
+          "type": "sheep",
+          "number": 11,
+          "has_robber": false,
+          "position": [
+            3,
+            3
+          ],
+          "axial_coords": [
+            1,
+            1
+          ]
+        },
+        {
+          "id": 17,
+          "q": -2,
+          "r": 2,
+          "type": "ore",
+          "number": 5,
+          "has_robber": false,
+          "position": [
+            4,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            2
+          ]
+        },
+        {
+          "id": 18,
+          "q": -1,
+          "r": 2,
+          "type": "wheat",
+          "number": 9,
+          "has_robber": false,
+          "position": [
+            4,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            2
+          ]
+        },
+        {
+          "id": 19,
+          "q": 0,
+          "r": 2,
+          "type": "ore",
+          "number": 2,
+          "has_robber": false,
+          "position": [
+            4,
+            2
+          ],
+          "axial_coords": [
+            0,
+            2
+          ]
+        }
+      ],
+      "settlements": [],
+      "cities": [],
+      "roads": [],
+      "players": [
+        {
+          "id": 0,
+          "name": "a",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        },
+        {
+          "id": 1,
+          "name": "b",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        },
+        {
+          "id": 2,
+          "name": "c",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        }
+      ],
+      "current_player": 0,
+      "current_phase": "SETUP_FIRST_ROUND",
+      "robber_position": [
+        2,
+        2
+      ],
+      "dice_result": null,
+      "points": [
+        {
+          "point_id": 1,
+          "game_coords": [
+            0,
+            0
+          ],
+          "adjacent_points": [
+            2,
+            9
+          ],
+          "adjacent_hexes": [
+            1
+          ],
+          "pixel_coords": [
+            377.5,
+            105.14428414850131
+          ]
+        },
+        {
+          "point_id": 2,
+          "game_coords": [
+            0,
+            1
+          ],
+          "adjacent_points": [
+            1,
+            3
+          ],
+          "adjacent_hexes": [
+            1
+          ],
+          "pixel_coords": [
+            422.5,
+            105.14428414850128
+          ]
+        },
+        {
+          "point_id": 3,
+          "game_coords": [
+            0,
+            2
+          ],
+          "adjacent_points": [
+            2,
+            4,
+            11
+          ],
+          "adjacent_hexes": [
+            2,
+            1
+          ],
+          "pixel_coords": [
+            445,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 4,
+          "game_coords": [
+            0,
+            3
+          ],
+          "adjacent_points": [
+            3,
+            5
+          ],
+          "adjacent_hexes": [
+            2
+          ],
+          "pixel_coords": [
+            490,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 5,
+          "game_coords": [
+            0,
+            4
+          ],
+          "adjacent_points": [
+            4,
+            6,
+            13
+          ],
+          "adjacent_hexes": [
+            3,
+            2
+          ],
+          "pixel_coords": [
+            512.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 6,
+          "game_coords": [
+            0,
+            5
+          ],
+          "adjacent_points": [
+            5,
+            7
+          ],
+          "adjacent_hexes": [
+            3
+          ],
+          "pixel_coords": [
+            557.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 7,
+          "game_coords": [
+            0,
+            6
+          ],
+          "adjacent_points": [
+            6,
+            15
+          ],
+          "adjacent_hexes": [
+            3
+          ],
+          "pixel_coords": [
+            580,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 8,
+          "game_coords": [
+            1,
+            0
+          ],
+          "adjacent_points": [
+            9,
+            18
+          ],
+          "adjacent_hexes": [
+            4
+          ],
+          "pixel_coords": [
+            310,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 9,
+          "game_coords": [
+            1,
+            1
+          ],
+          "adjacent_points": [
+            8,
+            10,
+            1
+          ],
+          "adjacent_hexes": [
+            4,
+            1
+          ],
+          "pixel_coords": [
+            355,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 10,
+          "game_coords": [
+            1,
+            2
+          ],
+          "adjacent_points": [
+            9,
+            11,
+            20
+          ],
+          "adjacent_hexes": [
+            5,
+            4,
+            1
+          ],
+          "pixel_coords": [
+            377.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 11,
+          "game_coords": [
+            1,
+            3
+          ],
+          "adjacent_points": [
+            10,
+            12,
+            3
+          ],
+          "adjacent_hexes": [
+            5,
+            2,
+            1
+          ],
+          "pixel_coords": [
+            422.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 12,
+          "game_coords": [
+            1,
+            4
+          ],
+          "adjacent_points": [
+            11,
+            13,
+            22
+          ],
+          "adjacent_hexes": [
+            6,
+            5,
+            2
+          ],
+          "pixel_coords": [
+            445,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 13,
+          "game_coords": [
+            1,
+            5
+          ],
+          "adjacent_points": [
+            12,
+            14,
+            5
+          ],
+          "adjacent_hexes": [
+            6,
+            3,
+            2
+          ],
+          "pixel_coords": [
+            490,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 14,
+          "game_coords": [
+            1,
+            6
+          ],
+          "adjacent_points": [
+            13,
+            15,
+            24
+          ],
+          "adjacent_hexes": [
+            7,
+            6,
+            3
+          ],
+          "pixel_coords": [
+            512.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 15,
+          "game_coords": [
+            1,
+            7
+          ],
+          "adjacent_points": [
+            14,
+            16,
+            7
+          ],
+          "adjacent_hexes": [
+            7,
+            3
+          ],
+          "pixel_coords": [
+            557.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 16,
+          "game_coords": [
+            1,
+            8
+          ],
+          "adjacent_points": [
+            15,
+            26
+          ],
+          "adjacent_hexes": [
+            7
+          ],
+          "pixel_coords": [
+            580,
+            300
+          ]
+        },
+        {
+          "point_id": 17,
+          "game_coords": [
+            2,
+            0
+          ],
+          "adjacent_points": [
+            18,
+            28
+          ],
+          "adjacent_hexes": [
+            8
+          ],
+          "pixel_coords": [
+            242.49999999999997,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 18,
+          "game_coords": [
+            2,
+            1
+          ],
+          "adjacent_points": [
+            17,
+            19,
+            8
+          ],
+          "adjacent_hexes": [
+            8,
+            4
+          ],
+          "pixel_coords": [
+            287.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 19,
+          "game_coords": [
+            2,
+            2
+          ],
+          "adjacent_points": [
+            18,
+            20,
+            30
+          ],
+          "adjacent_hexes": [
+            9,
+            8,
+            4
+          ],
+          "pixel_coords": [
+            310,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 20,
+          "game_coords": [
+            2,
+            3
+          ],
+          "adjacent_points": [
+            19,
+            21,
+            10
+          ],
+          "adjacent_hexes": [
+            9,
+            5,
+            4
+          ],
+          "pixel_coords": [
+            355,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 21,
+          "game_coords": [
+            2,
+            4
+          ],
+          "adjacent_points": [
+            20,
+            22,
+            32
+          ],
+          "adjacent_hexes": [
+            10,
+            9,
+            5
+          ],
+          "pixel_coords": [
+            377.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 22,
+          "game_coords": [
+            2,
+            5
+          ],
+          "adjacent_points": [
+            21,
+            23,
+            12
+          ],
+          "adjacent_hexes": [
+            10,
+            6,
+            5
+          ],
+          "pixel_coords": [
+            422.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 23,
+          "game_coords": [
+            2,
+            6
+          ],
+          "adjacent_points": [
+            22,
+            24,
+            34
+          ],
+          "adjacent_hexes": [
+            11,
+            10,
+            6
+          ],
+          "pixel_coords": [
+            445,
+            300
+          ]
+        },
+        {
+          "point_id": 24,
+          "game_coords": [
+            2,
+            7
+          ],
+          "adjacent_points": [
+            23,
+            25,
+            14
+          ],
+          "adjacent_hexes": [
+            11,
+            7,
+            6
+          ],
+          "pixel_coords": [
+            490,
+            300
+          ]
+        },
+        {
+          "point_id": 25,
+          "game_coords": [
+            2,
+            8
+          ],
+          "adjacent_points": [
+            24,
+            26,
+            36
+          ],
+          "adjacent_hexes": [
+            12,
+            11,
+            7
+          ],
+          "pixel_coords": [
+            512.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 26,
+          "game_coords": [
+            2,
+            9
+          ],
+          "adjacent_points": [
+            25,
+            27,
+            16
+          ],
+          "adjacent_hexes": [
+            12,
+            7
+          ],
+          "pixel_coords": [
+            557.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 27,
+          "game_coords": [
+            2,
+            10
+          ],
+          "adjacent_points": [
+            26,
+            38
+          ],
+          "adjacent_hexes": [
+            12
+          ],
+          "pixel_coords": [
+            580,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 28,
+          "game_coords": [
+            3,
+            0
+          ],
+          "adjacent_points": [
+            29,
+            17
+          ],
+          "adjacent_hexes": [
+            8
+          ],
+          "pixel_coords": [
+            220,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 29,
+          "game_coords": [
+            3,
+            1
+          ],
+          "adjacent_points": [
+            28,
+            30,
+            39
+          ],
+          "adjacent_hexes": [
+            13,
+            8
+          ],
+          "pixel_coords": [
+            242.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 30,
+          "game_coords": [
+            3,
+            2
+          ],
+          "adjacent_points": [
+            29,
+            31,
+            19
+          ],
+          "adjacent_hexes": [
+            13,
+            9,
+            8
+          ],
+          "pixel_coords": [
+            287.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 31,
+          "game_coords": [
+            3,
+            3
+          ],
+          "adjacent_points": [
+            30,
+            32,
+            41
+          ],
+          "adjacent_hexes": [
+            14,
+            13,
+            9
+          ],
+          "pixel_coords": [
+            310,
+            300
+          ]
+        },
+        {
+          "point_id": 32,
+          "game_coords": [
+            3,
+            4
+          ],
+          "adjacent_points": [
+            31,
+            33,
+            21
+          ],
+          "adjacent_hexes": [
+            14,
+            10,
+            9
+          ],
+          "pixel_coords": [
+            355,
+            300
+          ]
+        },
+        {
+          "point_id": 33,
+          "game_coords": [
+            3,
+            5
+          ],
+          "adjacent_points": [
+            32,
+            34,
+            43
+          ],
+          "adjacent_hexes": [
+            15,
+            14,
+            10
+          ],
+          "pixel_coords": [
+            377.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 34,
+          "game_coords": [
+            3,
+            6
+          ],
+          "adjacent_points": [
+            33,
+            35,
+            23
+          ],
+          "adjacent_hexes": [
+            15,
+            11,
+            10
+          ],
+          "pixel_coords": [
+            422.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 35,
+          "game_coords": [
+            3,
+            7
+          ],
+          "adjacent_points": [
+            34,
+            36,
+            45
+          ],
+          "adjacent_hexes": [
+            16,
+            15,
+            11
+          ],
+          "pixel_coords": [
+            445,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 36,
+          "game_coords": [
+            3,
+            8
+          ],
+          "adjacent_points": [
+            35,
+            37,
+            25
+          ],
+          "adjacent_hexes": [
+            16,
+            12,
+            11
+          ],
+          "pixel_coords": [
+            490,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 37,
+          "game_coords": [
+            3,
+            9
+          ],
+          "adjacent_points": [
+            36,
+            38,
+            47
+          ],
+          "adjacent_hexes": [
+            16,
+            12
+          ],
+          "pixel_coords": [
+            512.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 38,
+          "game_coords": [
+            3,
+            10
+          ],
+          "adjacent_points": [
+            37,
+            27
+          ],
+          "adjacent_hexes": [
+            12
+          ],
+          "pixel_coords": [
+            557.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 39,
+          "game_coords": [
+            4,
+            0
+          ],
+          "adjacent_points": [
+            40,
+            29
+          ],
+          "adjacent_hexes": [
+            13
+          ],
+          "pixel_coords": [
+            220,
+            300
+          ]
+        },
+        {
+          "point_id": 40,
+          "game_coords": [
+            4,
+            1
+          ],
+          "adjacent_points": [
+            39,
+            41,
+            48
+          ],
+          "adjacent_hexes": [
+            17,
+            13
+          ],
+          "pixel_coords": [
+            242.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 41,
+          "game_coords": [
+            4,
+            2
+          ],
+          "adjacent_points": [
+            40,
+            42,
+            31
+          ],
+          "adjacent_hexes": [
+            17,
+            14,
+            13
+          ],
+          "pixel_coords": [
+            287.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 42,
+          "game_coords": [
+            4,
+            3
+          ],
+          "adjacent_points": [
+            41,
+            43,
+            50
+          ],
+          "adjacent_hexes": [
+            18,
+            17,
+            14
+          ],
+          "pixel_coords": [
+            310,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 43,
+          "game_coords": [
+            4,
+            4
+          ],
+          "adjacent_points": [
+            42,
+            44,
+            33
+          ],
+          "adjacent_hexes": [
+            18,
+            15,
+            14
+          ],
+          "pixel_coords": [
+            355,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 44,
+          "game_coords": [
+            4,
+            5
+          ],
+          "adjacent_points": [
+            43,
+            45,
+            52
+          ],
+          "adjacent_hexes": [
+            19,
+            18,
+            15
+          ],
+          "pixel_coords": [
+            377.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 45,
+          "game_coords": [
+            4,
+            6
+          ],
+          "adjacent_points": [
+            44,
+            46,
+            35
+          ],
+          "adjacent_hexes": [
+            19,
+            16,
+            15
+          ],
+          "pixel_coords": [
+            422.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 46,
+          "game_coords": [
+            4,
+            7
+          ],
+          "adjacent_points": [
+            45,
+            47,
+            54
+          ],
+          "adjacent_hexes": [
+            19,
+            16
+          ],
+          "pixel_coords": [
+            445,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 47,
+          "game_coords": [
+            4,
+            8
+          ],
+          "adjacent_points": [
+            46,
+            37
+          ],
+          "adjacent_hexes": [
+            16
+          ],
+          "pixel_coords": [
+            490,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 48,
+          "game_coords": [
+            5,
+            0
+          ],
+          "adjacent_points": [
+            49,
+            40
+          ],
+          "adjacent_hexes": [
+            17
+          ],
+          "pixel_coords": [
+            220,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 49,
+          "game_coords": [
+            5,
+            1
+          ],
+          "adjacent_points": [
+            48,
+            50
+          ],
+          "adjacent_hexes": [
+            17
+          ],
+          "pixel_coords": [
+            242.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 50,
+          "game_coords": [
+            5,
+            2
+          ],
+          "adjacent_points": [
+            49,
+            51,
+            42
+          ],
+          "adjacent_hexes": [
+            18,
+            17
+          ],
+          "pixel_coords": [
+            287.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 51,
+          "game_coords": [
+            5,
+            3
+          ],
+          "adjacent_points": [
+            50,
+            52
+          ],
+          "adjacent_hexes": [
+            18
+          ],
+          "pixel_coords": [
+            310,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 52,
+          "game_coords": [
+            5,
+            4
+          ],
+          "adjacent_points": [
+            51,
+            53,
+            44
+          ],
+          "adjacent_hexes": [
+            19,
+            18
+          ],
+          "pixel_coords": [
+            355,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 53,
+          "game_coords": [
+            5,
+            5
+          ],
+          "adjacent_points": [
+            52,
+            54
+          ],
+          "adjacent_hexes": [
+            19
+          ],
+          "pixel_coords": [
+            377.5,
+            494.8557158514987
+          ]
+        },
+        {
+          "point_id": 54,
+          "game_coords": [
+            5,
+            6
+          ],
+          "adjacent_points": [
+            53,
+            46
+          ],
+          "adjacent_hexes": [
+            19
+          ],
+          "pixel_coords": [
+            422.5,
+            494.8557158514987
+          ]
+        }
+      ],
+      "board_graph": {
+        "adjacency": {
+          "1": [
+            2,
+            9
+          ],
+          "2": [
+            1,
+            3
+          ],
+          "3": [
+            2,
+            4,
+            11
+          ],
+          "4": [
+            3,
+            5
+          ],
+          "5": [
+            4,
+            6,
+            13
+          ],
+          "6": [
+            5,
+            7
+          ],
+          "7": [
+            6,
+            15
+          ],
+          "8": [
+            9,
+            18
+          ],
+          "9": [
+            8,
+            10,
+            1
+          ],
+          "10": [
+            9,
+            11,
+            20
+          ],
+          "11": [
+            10,
+            12,
+            3
+          ],
+          "12": [
+            11,
+            13,
+            22
+          ],
+          "13": [
+            12,
+            14,
+            5
+          ],
+          "14": [
+            13,
+            15,
+            24
+          ],
+          "15": [
+            14,
+            16,
+            7
+          ],
+          "16": [
+            15,
+            26
+          ],
+          "17": [
+            18,
+            28
+          ],
+          "18": [
+            17,
+            19,
+            8
+          ],
+          "19": [
+            18,
+            20,
+            30
+          ],
+          "20": [
+            19,
+            21,
+            10
+          ],
+          "21": [
+            20,
+            22,
+            32
+          ],
+          "22": [
+            21,
+            23,
+            12
+          ],
+          "23": [
+            22,
+            24,
+            34
+          ],
+          "24": [
+            23,
+            25,
+            14
+          ],
+          "25": [
+            24,
+            26,
+            36
+          ],
+          "26": [
+            25,
+            27,
+            16
+          ],
+          "27": [
+            26,
+            38
+          ],
+          "28": [
+            29,
+            17
+          ],
+          "29": [
+            28,
+            30,
+            39
+          ],
+          "30": [
+            29,
+            31,
+            19
+          ],
+          "31": [
+            30,
+            32,
+            41
+          ],
+          "32": [
+            31,
+            33,
+            21
+          ],
+          "33": [
+            32,
+            34,
+            43
+          ],
+          "34": [
+            33,
+            35,
+            23
+          ],
+          "35": [
+            34,
+            36,
+            45
+          ],
+          "36": [
+            35,
+            37,
+            25
+          ],
+          "37": [
+            36,
+            38,
+            47
+          ],
+          "38": [
+            37,
+            27
+          ],
+          "39": [
+            40,
+            29
+          ],
+          "40": [
+            39,
+            41,
+            48
+          ],
+          "41": [
+            40,
+            42,
+            31
+          ],
+          "42": [
+            41,
+            43,
+            50
+          ],
+          "43": [
+            42,
+            44,
+            33
+          ],
+          "44": [
+            43,
+            45,
+            52
+          ],
+          "45": [
+            44,
+            46,
+            35
+          ],
+          "46": [
+            45,
+            47,
+            54
+          ],
+          "47": [
+            46,
+            37
+          ],
+          "48": [
+            49,
+            40
+          ],
+          "49": [
+            48,
+            50
+          ],
+          "50": [
+            49,
+            51,
+            42
+          ],
+          "51": [
+            50,
+            52
+          ],
+          "52": [
+            51,
+            53,
+            44
+          ],
+          "53": [
+            52,
+            54
+          ],
+          "54": [
+            53,
+            46
+          ]
+        },
+        "hex_to_points": {
+          "1": [
+            1,
+            2,
+            3,
+            9,
+            10,
+            11
+          ],
+          "2": [
+            3,
+            4,
+            5,
+            11,
+            12,
+            13
+          ],
+          "3": [
+            5,
+            6,
+            7,
+            13,
+            14,
+            15
+          ],
+          "4": [
+            8,
+            9,
+            10,
+            18,
+            19,
+            20
+          ],
+          "5": [
+            10,
+            11,
+            12,
+            20,
+            21,
+            22
+          ],
+          "6": [
+            12,
+            13,
+            14,
+            22,
+            23,
+            24
+          ],
+          "7": [
+            14,
+            15,
+            16,
+            24,
+            25,
+            26
+          ],
+          "8": [
+            17,
+            18,
+            19,
+            28,
+            29,
+            30
+          ],
+          "9": [
+            19,
+            20,
+            21,
+            30,
+            31,
+            32
+          ],
+          "10": [
+            21,
+            22,
+            23,
+            32,
+            33,
+            34
+          ],
+          "11": [
+            23,
+            24,
+            25,
+            34,
+            35,
+            36
+          ],
+          "12": [
+            25,
+            26,
+            27,
+            36,
+            37,
+            38
+          ],
+          "13": [
+            29,
+            30,
+            31,
+            39,
+            40,
+            41
+          ],
+          "14": [
+            31,
+            32,
+            33,
+            41,
+            42,
+            43
+          ],
+          "15": [
+            33,
+            34,
+            35,
+            43,
+            44,
+            45
+          ],
+          "16": [
+            35,
+            36,
+            37,
+            45,
+            46,
+            47
+          ],
+          "17": [
+            40,
+            41,
+            42,
+            48,
+            49,
+            50
+          ],
+          "18": [
+            42,
+            43,
+            44,
+            50,
+            51,
+            52
+          ],
+          "19": [
+            44,
+            45,
+            46,
+            52,
+            53,
+            54
+          ]
+        },
+        "total_points": 54,
+        "total_hexes": 19
+      }
+    }
+  ]
+}

examples/ai_testing/my_games/game_20251223_204440_final.json

@@ -0,0 +1,1850 @@
+{
+  "hexes": [
+    {
+      "id": 1,
+      "q": 0,
+      "r": -2,
+      "type": "wood",
+      "number": 12,
+      "has_robber": false,
+      "position": [
+        0,
+        0
+      ],
+      "axial_coords": [
+        0,
+        -2
+      ]
+    },
+    {
+      "id": 2,
+      "q": 1,
+      "r": -2,
+      "type": "sheep",
+      "number": 5,
+      "has_robber": false,
+      "position": [
+        0,
+        1
+      ],
+      "axial_coords": [
+        1,
+        -2
+      ]
+    },
+    {
+      "id": 3,
+      "q": 2,
+      "r": -2,
+      "type": "wood",
+      "number": 4,
+      "has_robber": false,
+      "position": [
+        0,
+        2
+      ],
+      "axial_coords": [
+        2,
+        -2
+      ]
+    },
+    {
+      "id": 4,
+      "q": -1,
+      "r": -1,
+      "type": "sheep",
+      "number": 8,
+      "has_robber": false,
+      "position": [
+        1,
+        0
+      ],
+      "axial_coords": [
+        -1,
+        -1
+      ]
+    },
+    {
+      "id": 5,
+      "q": 0,
+      "r": -1,
+      "type": "brick",
+      "number": 6,
+      "has_robber": false,
+      "position": [
+        1,
+        1
+      ],
+      "axial_coords": [
+        0,
+        -1
+      ]
+    },
+    {
+      "id": 6,
+      "q": 1,
+      "r": -1,
+      "type": "wood",
+      "number": 3,
+      "has_robber": false,
+      "position": [
+        1,
+        2
+      ],
+      "axial_coords": [
+        1,
+        -1
+      ]
+    },
+    {
+      "id": 7,
+      "q": 2,
+      "r": -1,
+      "type": "wheat",
+      "number": 8,
+      "has_robber": false,
+      "position": [
+        1,
+        3
+      ],
+      "axial_coords": [
+        2,
+        -1
+      ]
+    },
+    {
+      "id": 8,
+      "q": -2,
+      "r": 0,
+      "type": "brick",
+      "number": 10,
+      "has_robber": false,
+      "position": [
+        2,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        0
+      ]
+    },
+    {
+      "id": 9,
+      "q": -1,
+      "r": 0,
+      "type": "wood",
+      "number": 11,
+      "has_robber": false,
+      "position": [
+        2,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        0
+      ]
+    },
+    {
+      "id": 10,
+      "q": 0,
+      "r": 0,
+      "type": "desert",
+      "number": null,
+      "has_robber": true,
+      "position": [
+        2,
+        2
+      ],
+      "axial_coords": [
+        0,
+        0
+      ]
+    },
+    {
+      "id": 11,
+      "q": 1,
+      "r": 0,
+      "type": "ore",
+      "number": 3,
+      "has_robber": false,
+      "position": [
+        2,
+        3
+      ],
+      "axial_coords": [
+        1,
+        0
+      ]
+    },
+    {
+      "id": 12,
+      "q": 2,
+      "r": 0,
+      "type": "sheep",
+      "number": 4,
+      "has_robber": false,
+      "position": [
+        2,
+        4
+      ],
+      "axial_coords": [
+        2,
+        0
+      ]
+    },
+    {
+      "id": 13,
+      "q": -2,
+      "r": 1,
+      "type": "brick",
+      "number": 10,
+      "has_robber": false,
+      "position": [
+        3,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        1
+      ]
+    },
+    {
+      "id": 14,
+      "q": -1,
+      "r": 1,
+      "type": "wheat",
+      "number": 9,
+      "has_robber": false,
+      "position": [
+        3,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        1
+      ]
+    },
+    {
+      "id": 15,
+      "q": 0,
+      "r": 1,
+      "type": "wheat",
+      "number": 6,
+      "has_robber": false,
+      "position": [
+        3,
+        2
+      ],
+      "axial_coords": [
+        0,
+        1
+      ]
+    },
+    {
+      "id": 16,
+      "q": 1,
+      "r": 1,
+      "type": "sheep",
+      "number": 11,
+      "has_robber": false,
+      "position": [
+        3,
+        3
+      ],
+      "axial_coords": [
+        1,
+        1
+      ]
+    },
+    {
+      "id": 17,
+      "q": -2,
+      "r": 2,
+      "type": "ore",
+      "number": 5,
+      "has_robber": false,
+      "position": [
+        4,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        2
+      ]
+    },
+    {
+      "id": 18,
+      "q": -1,
+      "r": 2,
+      "type": "wheat",
+      "number": 9,
+      "has_robber": false,
+      "position": [
+        4,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        2
+      ]
+    },
+    {
+      "id": 19,
+      "q": 0,
+      "r": 2,
+      "type": "ore",
+      "number": 2,
+      "has_robber": false,
+      "position": [
+        4,
+        2
+      ],
+      "axial_coords": [
+        0,
+        2
+      ]
+    }
+  ],
+  "settlements": [],
+  "cities": [],
+  "roads": [],
+  "players": [
+    {
+      "id": 0,
+      "name": "a",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    },
+    {
+      "id": 1,
+      "name": "b",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    },
+    {
+      "id": 2,
+      "name": "c",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    }
+  ],
+  "current_player": 0,
+  "current_phase": "SETUP_FIRST_ROUND",
+  "robber_position": [
+    2,
+    2
+  ],
+  "dice_result": null,
+  "points": [
+    {
+      "point_id": 1,
+      "game_coords": [
+        0,
+        0
+      ],
+      "adjacent_points": [
+        2,
+        9
+      ],
+      "adjacent_hexes": [
+        1
+      ],
+      "pixel_coords": [
+        377.5,
+        105.14428414850131
+      ]
+    },
+    {
+      "point_id": 2,
+      "game_coords": [
+        0,
+        1
+      ],
+      "adjacent_points": [
+        1,
+        3
+      ],
+      "adjacent_hexes": [
+        1
+      ],
+      "pixel_coords": [
+        422.5,
+        105.14428414850128
+      ]
+    },
+    {
+      "point_id": 3,
+      "game_coords": [
+        0,
+        2
+      ],
+      "adjacent_points": [
+        2,
+        4,
+        11
+      ],
+      "adjacent_hexes": [
+        2,
+        1
+      ],
+      "pixel_coords": [
+        445,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 4,
+      "game_coords": [
+        0,
+        3
+      ],
+      "adjacent_points": [
+        3,
+        5
+      ],
+      "adjacent_hexes": [
+        2
+      ],
+      "pixel_coords": [
+        490,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 5,
+      "game_coords": [
+        0,
+        4
+      ],
+      "adjacent_points": [
+        4,
+        6,
+        13
+      ],
+      "adjacent_hexes": [
+        3,
+        2
+      ],
+      "pixel_coords": [
+        512.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 6,
+      "game_coords": [
+        0,
+        5
+      ],
+      "adjacent_points": [
+        5,
+        7
+      ],
+      "adjacent_hexes": [
+        3
+      ],
+      "pixel_coords": [
+        557.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 7,
+      "game_coords": [
+        0,
+        6
+      ],
+      "adjacent_points": [
+        6,
+        15
+      ],
+      "adjacent_hexes": [
+        3
+      ],
+      "pixel_coords": [
+        580,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 8,
+      "game_coords": [
+        1,
+        0
+      ],
+      "adjacent_points": [
+        9,
+        18
+      ],
+      "adjacent_hexes": [
+        4
+      ],
+      "pixel_coords": [
+        310,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 9,
+      "game_coords": [
+        1,
+        1
+      ],
+      "adjacent_points": [
+        8,
+        10,
+        1
+      ],
+      "adjacent_hexes": [
+        4,
+        1
+      ],
+      "pixel_coords": [
+        355,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 10,
+      "game_coords": [
+        1,
+        2
+      ],
+      "adjacent_points": [
+        9,
+        11,
+        20
+      ],
+      "adjacent_hexes": [
+        5,
+        4,
+        1
+      ],
+      "pixel_coords": [
+        377.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 11,
+      "game_coords": [
+        1,
+        3
+      ],
+      "adjacent_points": [
+        10,
+        12,
+        3
+      ],
+      "adjacent_hexes": [
+        5,
+        2,
+        1
+      ],
+      "pixel_coords": [
+        422.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 12,
+      "game_coords": [
+        1,
+        4
+      ],
+      "adjacent_points": [
+        11,
+        13,
+        22
+      ],
+      "adjacent_hexes": [
+        6,
+        5,
+        2
+      ],
+      "pixel_coords": [
+        445,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 13,
+      "game_coords": [
+        1,
+        5
+      ],
+      "adjacent_points": [
+        12,
+        14,
+        5
+      ],
+      "adjacent_hexes": [
+        6,
+        3,
+        2
+      ],
+      "pixel_coords": [
+        490,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 14,
+      "game_coords": [
+        1,
+        6
+      ],
+      "adjacent_points": [
+        13,
+        15,
+        24
+      ],
+      "adjacent_hexes": [
+        7,
+        6,
+        3
+      ],
+      "pixel_coords": [
+        512.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 15,
+      "game_coords": [
+        1,
+        7
+      ],
+      "adjacent_points": [
+        14,
+        16,
+        7
+      ],
+      "adjacent_hexes": [
+        7,
+        3
+      ],
+      "pixel_coords": [
+        557.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 16,
+      "game_coords": [
+        1,
+        8
+      ],
+      "adjacent_points": [
+        15,
+        26
+      ],
+      "adjacent_hexes": [
+        7
+      ],
+      "pixel_coords": [
+        580,
+        300
+      ]
+    },
+    {
+      "point_id": 17,
+      "game_coords": [
+        2,
+        0
+      ],
+      "adjacent_points": [
+        18,
+        28
+      ],
+      "adjacent_hexes": [
+        8
+      ],
+      "pixel_coords": [
+        242.49999999999997,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 18,
+      "game_coords": [
+        2,
+        1
+      ],
+      "adjacent_points": [
+        17,
+        19,
+        8
+      ],
+      "adjacent_hexes": [
+        8,
+        4
+      ],
+      "pixel_coords": [
+        287.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 19,
+      "game_coords": [
+        2,
+        2
+      ],
+      "adjacent_points": [
+        18,
+        20,
+        30
+      ],
+      "adjacent_hexes": [
+        9,
+        8,
+        4
+      ],
+      "pixel_coords": [
+        310,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 20,
+      "game_coords": [
+        2,
+        3
+      ],
+      "adjacent_points": [
+        19,
+        21,
+        10
+      ],
+      "adjacent_hexes": [
+        9,
+        5,
+        4
+      ],
+      "pixel_coords": [
+        355,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 21,
+      "game_coords": [
+        2,
+        4
+      ],
+      "adjacent_points": [
+        20,
+        22,
+        32
+      ],
+      "adjacent_hexes": [
+        10,
+        9,
+        5
+      ],
+      "pixel_coords": [
+        377.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 22,
+      "game_coords": [
+        2,
+        5
+      ],
+      "adjacent_points": [
+        21,
+        23,
+        12
+      ],
+      "adjacent_hexes": [
+        10,
+        6,
+        5
+      ],
+      "pixel_coords": [
+        422.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 23,
+      "game_coords": [
+        2,
+        6
+      ],
+      "adjacent_points": [
+        22,
+        24,
+        34
+      ],
+      "adjacent_hexes": [
+        11,
+        10,
+        6
+      ],
+      "pixel_coords": [
+        445,
+        300
+      ]
+    },
+    {
+      "point_id": 24,
+      "game_coords": [
+        2,
+        7
+      ],
+      "adjacent_points": [
+        23,
+        25,
+        14
+      ],
+      "adjacent_hexes": [
+        11,
+        7,
+        6
+      ],
+      "pixel_coords": [
+        490,
+        300
+      ]
+    },
+    {
+      "point_id": 25,
+      "game_coords": [
+        2,
+        8
+      ],
+      "adjacent_points": [
+        24,
+        26,
+        36
+      ],
+      "adjacent_hexes": [
+        12,
+        11,
+        7
+      ],
+      "pixel_coords": [
+        512.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 26,
+      "game_coords": [
+        2,
+        9
+      ],
+      "adjacent_points": [
+        25,
+        27,
+        16
+      ],
+      "adjacent_hexes": [
+        12,
+        7
+      ],
+      "pixel_coords": [
+        557.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 27,
+      "game_coords": [
+        2,
+        10
+      ],
+      "adjacent_points": [
+        26,
+        38
+      ],
+      "adjacent_hexes": [
+        12
+      ],
+      "pixel_coords": [
+        580,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 28,
+      "game_coords": [
+        3,
+        0
+      ],
+      "adjacent_points": [
+        29,
+        17
+      ],
+      "adjacent_hexes": [
+        8
+      ],
+      "pixel_coords": [
+        220,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 29,
+      "game_coords": [
+        3,
+        1
+      ],
+      "adjacent_points": [
+        28,
+        30,
+        39
+      ],
+      "adjacent_hexes": [
+        13,
+        8
+      ],
+      "pixel_coords": [
+        242.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 30,
+      "game_coords": [
+        3,
+        2
+      ],
+      "adjacent_points": [
+        29,
+        31,
+        19
+      ],
+      "adjacent_hexes": [
+        13,
+        9,
+        8
+      ],
+      "pixel_coords": [
+        287.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 31,
+      "game_coords": [
+        3,
+        3
+      ],
+      "adjacent_points": [
+        30,
+        32,
+        41
+      ],
+      "adjacent_hexes": [
+        14,
+        13,
+        9
+      ],
+      "pixel_coords": [
+        310,
+        300
+      ]
+    },
+    {
+      "point_id": 32,
+      "game_coords": [
+        3,
+        4
+      ],
+      "adjacent_points": [
+        31,
+        33,
+        21
+      ],
+      "adjacent_hexes": [
+        14,
+        10,
+        9
+      ],
+      "pixel_coords": [
+        355,
+        300
+      ]
+    },
+    {
+      "point_id": 33,
+      "game_coords": [
+        3,
+        5
+      ],
+      "adjacent_points": [
+        32,
+        34,
+        43
+      ],
+      "adjacent_hexes": [
+        15,
+        14,
+        10
+      ],
+      "pixel_coords": [
+        377.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 34,
+      "game_coords": [
+        3,
+        6
+      ],
+      "adjacent_points": [
+        33,
+        35,
+        23
+      ],
+      "adjacent_hexes": [
+        15,
+        11,
+        10
+      ],
+      "pixel_coords": [
+        422.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 35,
+      "game_coords": [
+        3,
+        7
+      ],
+      "adjacent_points": [
+        34,
+        36,
+        45
+      ],
+      "adjacent_hexes": [
+        16,
+        15,
+        11
+      ],
+      "pixel_coords": [
+        445,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 36,
+      "game_coords": [
+        3,
+        8
+      ],
+      "adjacent_points": [
+        35,
+        37,
+        25
+      ],
+      "adjacent_hexes": [
+        16,
+        12,
+        11
+      ],
+      "pixel_coords": [
+        490,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 37,
+      "game_coords": [
+        3,
+        9
+      ],
+      "adjacent_points": [
+        36,
+        38,
+        47
+      ],
+      "adjacent_hexes": [
+        16,
+        12
+      ],
+      "pixel_coords": [
+        512.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 38,
+      "game_coords": [
+        3,
+        10
+      ],
+      "adjacent_points": [
+        37,
+        27
+      ],
+      "adjacent_hexes": [
+        12
+      ],
+      "pixel_coords": [
+        557.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 39,
+      "game_coords": [
+        4,
+        0
+      ],
+      "adjacent_points": [
+        40,
+        29
+      ],
+      "adjacent_hexes": [
+        13
+      ],
+      "pixel_coords": [
+        220,
+        300
+      ]
+    },
+    {
+      "point_id": 40,
+      "game_coords": [
+        4,
+        1
+      ],
+      "adjacent_points": [
+        39,
+        41,
+        48
+      ],
+      "adjacent_hexes": [
+        17,
+        13
+      ],
+      "pixel_coords": [
+        242.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 41,
+      "game_coords": [
+        4,
+        2
+      ],
+      "adjacent_points": [
+        40,
+        42,
+        31
+      ],
+      "adjacent_hexes": [
+        17,
+        14,
+        13
+      ],
+      "pixel_coords": [
+        287.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 42,
+      "game_coords": [
+        4,
+        3
+      ],
+      "adjacent_points": [
+        41,
+        43,
+        50
+      ],
+      "adjacent_hexes": [
+        18,
+        17,
+        14
+      ],
+      "pixel_coords": [
+        310,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 43,
+      "game_coords": [
+        4,
+        4
+      ],
+      "adjacent_points": [
+        42,
+        44,
+        33
+      ],
+      "adjacent_hexes": [
+        18,
+        15,
+        14
+      ],
+      "pixel_coords": [
+        355,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 44,
+      "game_coords": [
+        4,
+        5
+      ],
+      "adjacent_points": [
+        43,
+        45,
+        52
+      ],
+      "adjacent_hexes": [
+        19,
+        18,
+        15
+      ],
+      "pixel_coords": [
+        377.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 45,
+      "game_coords": [
+        4,
+        6
+      ],
+      "adjacent_points": [
+        44,
+        46,
+        35
+      ],
+      "adjacent_hexes": [
+        19,
+        16,
+        15
+      ],
+      "pixel_coords": [
+        422.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 46,
+      "game_coords": [
+        4,
+        7
+      ],
+      "adjacent_points": [
+        45,
+        47,
+        54
+      ],
+      "adjacent_hexes": [
+        19,
+        16
+      ],
+      "pixel_coords": [
+        445,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 47,
+      "game_coords": [
+        4,
+        8
+      ],
+      "adjacent_points": [
+        46,
+        37
+      ],
+      "adjacent_hexes": [
+        16
+      ],
+      "pixel_coords": [
+        490,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 48,
+      "game_coords": [
+        5,
+        0
+      ],
+      "adjacent_points": [
+        49,
+        40
+      ],
+      "adjacent_hexes": [
+        17
+      ],
+      "pixel_coords": [
+        220,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 49,
+      "game_coords": [
+        5,
+        1
+      ],
+      "adjacent_points": [
+        48,
+        50
+      ],
+      "adjacent_hexes": [
+        17
+      ],
+      "pixel_coords": [
+        242.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 50,
+      "game_coords": [
+        5,
+        2
+      ],
+      "adjacent_points": [
+        49,
+        51,
+        42
+      ],
+      "adjacent_hexes": [
+        18,
+        17
+      ],
+      "pixel_coords": [
+        287.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 51,
+      "game_coords": [
+        5,
+        3
+      ],
+      "adjacent_points": [
+        50,
+        52
+      ],
+      "adjacent_hexes": [
+        18
+      ],
+      "pixel_coords": [
+        310,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 52,
+      "game_coords": [
+        5,
+        4
+      ],
+      "adjacent_points": [
+        51,
+        53,
+        44
+      ],
+      "adjacent_hexes": [
+        19,
+        18
+      ],
+      "pixel_coords": [
+        355,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 53,
+      "game_coords": [
+        5,
+        5
+      ],
+      "adjacent_points": [
+        52,
+        54
+      ],
+      "adjacent_hexes": [
+        19
+      ],
+      "pixel_coords": [
+        377.5,
+        494.8557158514987
+      ]
+    },
+    {
+      "point_id": 54,
+      "game_coords": [
+        5,
+        6
+      ],
+      "adjacent_points": [
+        53,
+        46
+      ],
+      "adjacent_hexes": [
+        19
+      ],
+      "pixel_coords": [
+        422.5,
+        494.8557158514987
+      ]
+    }
+  ],
+  "board_graph": {
+    "adjacency": {
+      "1": [
+        2,
+        9
+      ],
+      "2": [
+        1,
+        3
+      ],
+      "3": [
+        2,
+        4,
+        11
+      ],
+      "4": [
+        3,
+        5
+      ],
+      "5": [
+        4,
+        6,
+        13
+      ],
+      "6": [
+        5,
+        7
+      ],
+      "7": [
+        6,
+        15
+      ],
+      "8": [
+        9,
+        18
+      ],
+      "9": [
+        8,
+        10,
+        1
+      ],
+      "10": [
+        9,
+        11,
+        20
+      ],
+      "11": [
+        10,
+        12,
+        3
+      ],
+      "12": [
+        11,
+        13,
+        22
+      ],
+      "13": [
+        12,
+        14,
+        5
+      ],
+      "14": [
+        13,
+        15,
+        24
+      ],
+      "15": [
+        14,
+        16,
+        7
+      ],
+      "16": [
+        15,
+        26
+      ],
+      "17": [
+        18,
+        28
+      ],
+      "18": [
+        17,
+        19,
+        8
+      ],
+      "19": [
+        18,
+        20,
+        30
+      ],
+      "20": [
+        19,
+        21,
+        10
+      ],
+      "21": [
+        20,
+        22,
+        32
+      ],
+      "22": [
+        21,
+        23,
+        12
+      ],
+      "23": [
+        22,
+        24,
+        34
+      ],
+      "24": [
+        23,
+        25,
+        14
+      ],
+      "25": [
+        24,
+        26,
+        36
+      ],
+      "26": [
+        25,
+        27,
+        16
+      ],
+      "27": [
+        26,
+        38
+      ],
+      "28": [
+        29,
+        17
+      ],
+      "29": [
+        28,
+        30,
+        39
+      ],
+      "30": [
+        29,
+        31,
+        19
+      ],
+      "31": [
+        30,
+        32,
+        41
+      ],
+      "32": [
+        31,
+        33,
+        21
+      ],
+      "33": [
+        32,
+        34,
+        43
+      ],
+      "34": [
+        33,
+        35,
+        23
+      ],
+      "35": [
+        34,
+        36,
+        45
+      ],
+      "36": [
+        35,
+        37,
+        25
+      ],
+      "37": [
+        36,
+        38,
+        47
+      ],
+      "38": [
+        37,
+        27
+      ],
+      "39": [
+        40,
+        29
+      ],
+      "40": [
+        39,
+        41,
+        48
+      ],
+      "41": [
+        40,
+        42,
+        31
+      ],
+      "42": [
+        41,
+        43,
+        50
+      ],
+      "43": [
+        42,
+        44,
+        33
+      ],
+      "44": [
+        43,
+        45,
+        52
+      ],
+      "45": [
+        44,
+        46,
+        35
+      ],
+      "46": [
+        45,
+        47,
+        54
+      ],
+      "47": [
+        46,
+        37
+      ],
+      "48": [
+        49,
+        40
+      ],
+      "49": [
+        48,
+        50
+      ],
+      "50": [
+        49,
+        51,
+        42
+      ],
+      "51": [
+        50,
+        52
+      ],
+      "52": [
+        51,
+        53,
+        44
+      ],
+      "53": [
+        52,
+        54
+      ],
+      "54": [
+        53,
+        46
+      ]
+    },
+    "hex_to_points": {
+      "1": [
+        1,
+        2,
+        3,
+        9,
+        10,
+        11
+      ],
+      "2": [
+        3,
+        4,
+        5,
+        11,
+        12,
+        13
+      ],
+      "3": [
+        5,
+        6,
+        7,
+        13,
+        14,
+        15
+      ],
+      "4": [
+        8,
+        9,
+        10,
+        18,
+        19,
+        20
+      ],
+      "5": [
+        10,
+        11,
+        12,
+        20,
+        21,
+        22
+      ],
+      "6": [
+        12,
+        13,
+        14,
+        22,
+        23,
+        24
+      ],
+      "7": [
+        14,
+        15,
+        16,
+        24,
+        25,
+        26
+      ],
+      "8": [
+        17,
+        18,
+        19,
+        28,
+        29,
+        30
+      ],
+      "9": [
+        19,
+        20,
+        21,
+        30,
+        31,
+        32
+      ],
+      "10": [
+        21,
+        22,
+        23,
+        32,
+        33,
+        34
+      ],
+      "11": [
+        23,
+        24,
+        25,
+        34,
+        35,
+        36
+      ],
+      "12": [
+        25,
+        26,
+        27,
+        36,
+        37,
+        38
+      ],
+      "13": [
+        29,
+        30,
+        31,
+        39,
+        40,
+        41
+      ],
+      "14": [
+        31,
+        32,
+        33,
+        41,
+        42,
+        43
+      ],
+      "15": [
+        33,
+        34,
+        35,
+        43,
+        44,
+        45
+      ],
+      "16": [
+        35,
+        36,
+        37,
+        45,
+        46,
+        47
+      ],
+      "17": [
+        40,
+        41,
+        42,
+        48,
+        49,
+        50
+      ],
+      "18": [
+        42,
+        43,
+        44,
+        50,
+        51,
+        52
+      ],
+      "19": [
+        44,
+        45,
+        46,
+        52,
+        53,
+        54
+      ]
+    },
+    "total_points": 54,
+    "total_hexes": 19
+  }
+}

examples/ai_testing/my_games/game_20251223_204440_full.json

@@ -0,0 +1,1856 @@
+{
+  "total_states": 1,
+  "timestamp": "20251223_204440",
+  "states": [
+    {
+      "hexes": [
+        {
+          "id": 1,
+          "q": 0,
+          "r": -2,
+          "type": "wood",
+          "number": 12,
+          "has_robber": false,
+          "position": [
+            0,
+            0
+          ],
+          "axial_coords": [
+            0,
+            -2
+          ]
+        },
+        {
+          "id": 2,
+          "q": 1,
+          "r": -2,
+          "type": "sheep",
+          "number": 5,
+          "has_robber": false,
+          "position": [
+            0,
+            1
+          ],
+          "axial_coords": [
+            1,
+            -2
+          ]
+        },
+        {
+          "id": 3,
+          "q": 2,
+          "r": -2,
+          "type": "wood",
+          "number": 4,
+          "has_robber": false,
+          "position": [
+            0,
+            2
+          ],
+          "axial_coords": [
+            2,
+            -2
+          ]
+        },
+        {
+          "id": 4,
+          "q": -1,
+          "r": -1,
+          "type": "sheep",
+          "number": 8,
+          "has_robber": false,
+          "position": [
+            1,
+            0
+          ],
+          "axial_coords": [
+            -1,
+            -1
+          ]
+        },
+        {
+          "id": 5,
+          "q": 0,
+          "r": -1,
+          "type": "brick",
+          "number": 6,
+          "has_robber": false,
+          "position": [
+            1,
+            1
+          ],
+          "axial_coords": [
+            0,
+            -1
+          ]
+        },
+        {
+          "id": 6,
+          "q": 1,
+          "r": -1,
+          "type": "wood",
+          "number": 3,
+          "has_robber": false,
+          "position": [
+            1,
+            2
+          ],
+          "axial_coords": [
+            1,
+            -1
+          ]
+        },
+        {
+          "id": 7,
+          "q": 2,
+          "r": -1,
+          "type": "wheat",
+          "number": 8,
+          "has_robber": false,
+          "position": [
+            1,
+            3
+          ],
+          "axial_coords": [
+            2,
+            -1
+          ]
+        },
+        {
+          "id": 8,
+          "q": -2,
+          "r": 0,
+          "type": "brick",
+          "number": 10,
+          "has_robber": false,
+          "position": [
+            2,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            0
+          ]
+        },
+        {
+          "id": 9,
+          "q": -1,
+          "r": 0,
+          "type": "wood",
+          "number": 11,
+          "has_robber": false,
+          "position": [
+            2,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            0
+          ]
+        },
+        {
+          "id": 10,
+          "q": 0,
+          "r": 0,
+          "type": "desert",
+          "number": null,
+          "has_robber": true,
+          "position": [
+            2,
+            2
+          ],
+          "axial_coords": [
+            0,
+            0
+          ]
+        },
+        {
+          "id": 11,
+          "q": 1,
+          "r": 0,
+          "type": "ore",
+          "number": 3,
+          "has_robber": false,
+          "position": [
+            2,
+            3
+          ],
+          "axial_coords": [
+            1,
+            0
+          ]
+        },
+        {
+          "id": 12,
+          "q": 2,
+          "r": 0,
+          "type": "sheep",
+          "number": 4,
+          "has_robber": false,
+          "position": [
+            2,
+            4
+          ],
+          "axial_coords": [
+            2,
+            0
+          ]
+        },
+        {
+          "id": 13,
+          "q": -2,
+          "r": 1,
+          "type": "brick",
+          "number": 10,
+          "has_robber": false,
+          "position": [
+            3,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            1
+          ]
+        },
+        {
+          "id": 14,
+          "q": -1,
+          "r": 1,
+          "type": "wheat",
+          "number": 9,
+          "has_robber": false,
+          "position": [
+            3,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            1
+          ]
+        },
+        {
+          "id": 15,
+          "q": 0,
+          "r": 1,
+          "type": "wheat",
+          "number": 6,
+          "has_robber": false,
+          "position": [
+            3,
+            2
+          ],
+          "axial_coords": [
+            0,
+            1
+          ]
+        },
+        {
+          "id": 16,
+          "q": 1,
+          "r": 1,
+          "type": "sheep",
+          "number": 11,
+          "has_robber": false,
+          "position": [
+            3,
+            3
+          ],
+          "axial_coords": [
+            1,
+            1
+          ]
+        },
+        {
+          "id": 17,
+          "q": -2,
+          "r": 2,
+          "type": "ore",
+          "number": 5,
+          "has_robber": false,
+          "position": [
+            4,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            2
+          ]
+        },
+        {
+          "id": 18,
+          "q": -1,
+          "r": 2,
+          "type": "wheat",
+          "number": 9,
+          "has_robber": false,
+          "position": [
+            4,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            2
+          ]
+        },
+        {
+          "id": 19,
+          "q": 0,
+          "r": 2,
+          "type": "ore",
+          "number": 2,
+          "has_robber": false,
+          "position": [
+            4,
+            2
+          ],
+          "axial_coords": [
+            0,
+            2
+          ]
+        }
+      ],
+      "settlements": [],
+      "cities": [],
+      "roads": [],
+      "players": [
+        {
+          "id": 0,
+          "name": "a",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        },
+        {
+          "id": 1,
+          "name": "b",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        },
+        {
+          "id": 2,
+          "name": "c",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        }
+      ],
+      "current_player": 0,
+      "current_phase": "SETUP_FIRST_ROUND",
+      "robber_position": [
+        2,
+        2
+      ],
+      "dice_result": null,
+      "points": [
+        {
+          "point_id": 1,
+          "game_coords": [
+            0,
+            0
+          ],
+          "adjacent_points": [
+            2,
+            9
+          ],
+          "adjacent_hexes": [
+            1
+          ],
+          "pixel_coords": [
+            377.5,
+            105.14428414850131
+          ]
+        },
+        {
+          "point_id": 2,
+          "game_coords": [
+            0,
+            1
+          ],
+          "adjacent_points": [
+            1,
+            3
+          ],
+          "adjacent_hexes": [
+            1
+          ],
+          "pixel_coords": [
+            422.5,
+            105.14428414850128
+          ]
+        },
+        {
+          "point_id": 3,
+          "game_coords": [
+            0,
+            2
+          ],
+          "adjacent_points": [
+            2,
+            4,
+            11
+          ],
+          "adjacent_hexes": [
+            2,
+            1
+          ],
+          "pixel_coords": [
+            445,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 4,
+          "game_coords": [
+            0,
+            3
+          ],
+          "adjacent_points": [
+            3,
+            5
+          ],
+          "adjacent_hexes": [
+            2
+          ],
+          "pixel_coords": [
+            490,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 5,
+          "game_coords": [
+            0,
+            4
+          ],
+          "adjacent_points": [
+            4,
+            6,
+            13
+          ],
+          "adjacent_hexes": [
+            3,
+            2
+          ],
+          "pixel_coords": [
+            512.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 6,
+          "game_coords": [
+            0,
+            5
+          ],
+          "adjacent_points": [
+            5,
+            7
+          ],
+          "adjacent_hexes": [
+            3
+          ],
+          "pixel_coords": [
+            557.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 7,
+          "game_coords": [
+            0,
+            6
+          ],
+          "adjacent_points": [
+            6,
+            15
+          ],
+          "adjacent_hexes": [
+            3
+          ],
+          "pixel_coords": [
+            580,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 8,
+          "game_coords": [
+            1,
+            0
+          ],
+          "adjacent_points": [
+            9,
+            18
+          ],
+          "adjacent_hexes": [
+            4
+          ],
+          "pixel_coords": [
+            310,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 9,
+          "game_coords": [
+            1,
+            1
+          ],
+          "adjacent_points": [
+            8,
+            10,
+            1
+          ],
+          "adjacent_hexes": [
+            4,
+            1
+          ],
+          "pixel_coords": [
+            355,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 10,
+          "game_coords": [
+            1,
+            2
+          ],
+          "adjacent_points": [
+            9,
+            11,
+            20
+          ],
+          "adjacent_hexes": [
+            5,
+            4,
+            1
+          ],
+          "pixel_coords": [
+            377.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 11,
+          "game_coords": [
+            1,
+            3
+          ],
+          "adjacent_points": [
+            10,
+            12,
+            3
+          ],
+          "adjacent_hexes": [
+            5,
+            2,
+            1
+          ],
+          "pixel_coords": [
+            422.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 12,
+          "game_coords": [
+            1,
+            4
+          ],
+          "adjacent_points": [
+            11,
+            13,
+            22
+          ],
+          "adjacent_hexes": [
+            6,
+            5,
+            2
+          ],
+          "pixel_coords": [
+            445,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 13,
+          "game_coords": [
+            1,
+            5
+          ],
+          "adjacent_points": [
+            12,
+            14,
+            5
+          ],
+          "adjacent_hexes": [
+            6,
+            3,
+            2
+          ],
+          "pixel_coords": [
+            490,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 14,
+          "game_coords": [
+            1,
+            6
+          ],
+          "adjacent_points": [
+            13,
+            15,
+            24
+          ],
+          "adjacent_hexes": [
+            7,
+            6,
+            3
+          ],
+          "pixel_coords": [
+            512.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 15,
+          "game_coords": [
+            1,
+            7
+          ],
+          "adjacent_points": [
+            14,
+            16,
+            7
+          ],
+          "adjacent_hexes": [
+            7,
+            3
+          ],
+          "pixel_coords": [
+            557.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 16,
+          "game_coords": [
+            1,
+            8
+          ],
+          "adjacent_points": [
+            15,
+            26
+          ],
+          "adjacent_hexes": [
+            7
+          ],
+          "pixel_coords": [
+            580,
+            300
+          ]
+        },
+        {
+          "point_id": 17,
+          "game_coords": [
+            2,
+            0
+          ],
+          "adjacent_points": [
+            18,
+            28
+          ],
+          "adjacent_hexes": [
+            8
+          ],
+          "pixel_coords": [
+            242.49999999999997,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 18,
+          "game_coords": [
+            2,
+            1
+          ],
+          "adjacent_points": [
+            17,
+            19,
+            8
+          ],
+          "adjacent_hexes": [
+            8,
+            4
+          ],
+          "pixel_coords": [
+            287.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 19,
+          "game_coords": [
+            2,
+            2
+          ],
+          "adjacent_points": [
+            18,
+            20,
+            30
+          ],
+          "adjacent_hexes": [
+            9,
+            8,
+            4
+          ],
+          "pixel_coords": [
+            310,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 20,
+          "game_coords": [
+            2,
+            3
+          ],
+          "adjacent_points": [
+            19,
+            21,
+            10
+          ],
+          "adjacent_hexes": [
+            9,
+            5,
+            4
+          ],
+          "pixel_coords": [
+            355,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 21,
+          "game_coords": [
+            2,
+            4
+          ],
+          "adjacent_points": [
+            20,
+            22,
+            32
+          ],
+          "adjacent_hexes": [
+            10,
+            9,
+            5
+          ],
+          "pixel_coords": [
+            377.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 22,
+          "game_coords": [
+            2,
+            5
+          ],
+          "adjacent_points": [
+            21,
+            23,
+            12
+          ],
+          "adjacent_hexes": [
+            10,
+            6,
+            5
+          ],
+          "pixel_coords": [
+            422.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 23,
+          "game_coords": [
+            2,
+            6
+          ],
+          "adjacent_points": [
+            22,
+            24,
+            34
+          ],
+          "adjacent_hexes": [
+            11,
+            10,
+            6
+          ],
+          "pixel_coords": [
+            445,
+            300
+          ]
+        },
+        {
+          "point_id": 24,
+          "game_coords": [
+            2,
+            7
+          ],
+          "adjacent_points": [
+            23,
+            25,
+            14
+          ],
+          "adjacent_hexes": [
+            11,
+            7,
+            6
+          ],
+          "pixel_coords": [
+            490,
+            300
+          ]
+        },
+        {
+          "point_id": 25,
+          "game_coords": [
+            2,
+            8
+          ],
+          "adjacent_points": [
+            24,
+            26,
+            36
+          ],
+          "adjacent_hexes": [
+            12,
+            11,
+            7
+          ],
+          "pixel_coords": [
+            512.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 26,
+          "game_coords": [
+            2,
+            9
+          ],
+          "adjacent_points": [
+            25,
+            27,
+            16
+          ],
+          "adjacent_hexes": [
+            12,
+            7
+          ],
+          "pixel_coords": [
+            557.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 27,
+          "game_coords": [
+            2,
+            10
+          ],
+          "adjacent_points": [
+            26,
+            38
+          ],
+          "adjacent_hexes": [
+            12
+          ],
+          "pixel_coords": [
+            580,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 28,
+          "game_coords": [
+            3,
+            0
+          ],
+          "adjacent_points": [
+            29,
+            17
+          ],
+          "adjacent_hexes": [
+            8
+          ],
+          "pixel_coords": [
+            220,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 29,
+          "game_coords": [
+            3,
+            1
+          ],
+          "adjacent_points": [
+            28,
+            30,
+            39
+          ],
+          "adjacent_hexes": [
+            13,
+            8
+          ],
+          "pixel_coords": [
+            242.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 30,
+          "game_coords": [
+            3,
+            2
+          ],
+          "adjacent_points": [
+            29,
+            31,
+            19
+          ],
+          "adjacent_hexes": [
+            13,
+            9,
+            8
+          ],
+          "pixel_coords": [
+            287.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 31,
+          "game_coords": [
+            3,
+            3
+          ],
+          "adjacent_points": [
+            30,
+            32,
+            41
+          ],
+          "adjacent_hexes": [
+            14,
+            13,
+            9
+          ],
+          "pixel_coords": [
+            310,
+            300
+          ]
+        },
+        {
+          "point_id": 32,
+          "game_coords": [
+            3,
+            4
+          ],
+          "adjacent_points": [
+            31,
+            33,
+            21
+          ],
+          "adjacent_hexes": [
+            14,
+            10,
+            9
+          ],
+          "pixel_coords": [
+            355,
+            300
+          ]
+        },
+        {
+          "point_id": 33,
+          "game_coords": [
+            3,
+            5
+          ],
+          "adjacent_points": [
+            32,
+            34,
+            43
+          ],
+          "adjacent_hexes": [
+            15,
+            14,
+            10
+          ],
+          "pixel_coords": [
+            377.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 34,
+          "game_coords": [
+            3,
+            6
+          ],
+          "adjacent_points": [
+            33,
+            35,
+            23
+          ],
+          "adjacent_hexes": [
+            15,
+            11,
+            10
+          ],
+          "pixel_coords": [
+            422.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 35,
+          "game_coords": [
+            3,
+            7
+          ],
+          "adjacent_points": [
+            34,
+            36,
+            45
+          ],
+          "adjacent_hexes": [
+            16,
+            15,
+            11
+          ],
+          "pixel_coords": [
+            445,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 36,
+          "game_coords": [
+            3,
+            8
+          ],
+          "adjacent_points": [
+            35,
+            37,
+            25
+          ],
+          "adjacent_hexes": [
+            16,
+            12,
+            11
+          ],
+          "pixel_coords": [
+            490,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 37,
+          "game_coords": [
+            3,
+            9
+          ],
+          "adjacent_points": [
+            36,
+            38,
+            47
+          ],
+          "adjacent_hexes": [
+            16,
+            12
+          ],
+          "pixel_coords": [
+            512.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 38,
+          "game_coords": [
+            3,
+            10
+          ],
+          "adjacent_points": [
+            37,
+            27
+          ],
+          "adjacent_hexes": [
+            12
+          ],
+          "pixel_coords": [
+            557.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 39,
+          "game_coords": [
+            4,
+            0
+          ],
+          "adjacent_points": [
+            40,
+            29
+          ],
+          "adjacent_hexes": [
+            13
+          ],
+          "pixel_coords": [
+            220,
+            300
+          ]
+        },
+        {
+          "point_id": 40,
+          "game_coords": [
+            4,
+            1
+          ],
+          "adjacent_points": [
+            39,
+            41,
+            48
+          ],
+          "adjacent_hexes": [
+            17,
+            13
+          ],
+          "pixel_coords": [
+            242.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 41,
+          "game_coords": [
+            4,
+            2
+          ],
+          "adjacent_points": [
+            40,
+            42,
+            31
+          ],
+          "adjacent_hexes": [
+            17,
+            14,
+            13
+          ],
+          "pixel_coords": [
+            287.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 42,
+          "game_coords": [
+            4,
+            3
+          ],
+          "adjacent_points": [
+            41,
+            43,
+            50
+          ],
+          "adjacent_hexes": [
+            18,
+            17,
+            14
+          ],
+          "pixel_coords": [
+            310,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 43,
+          "game_coords": [
+            4,
+            4
+          ],
+          "adjacent_points": [
+            42,
+            44,
+            33
+          ],
+          "adjacent_hexes": [
+            18,
+            15,
+            14
+          ],
+          "pixel_coords": [
+            355,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 44,
+          "game_coords": [
+            4,
+            5
+          ],
+          "adjacent_points": [
+            43,
+            45,
+            52
+          ],
+          "adjacent_hexes": [
+            19,
+            18,
+            15
+          ],
+          "pixel_coords": [
+            377.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 45,
+          "game_coords": [
+            4,
+            6
+          ],
+          "adjacent_points": [
+            44,
+            46,
+            35
+          ],
+          "adjacent_hexes": [
+            19,
+            16,
+            15
+          ],
+          "pixel_coords": [
+            422.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 46,
+          "game_coords": [
+            4,
+            7
+          ],
+          "adjacent_points": [
+            45,
+            47,
+            54
+          ],
+          "adjacent_hexes": [
+            19,
+            16
+          ],
+          "pixel_coords": [
+            445,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 47,
+          "game_coords": [
+            4,
+            8
+          ],
+          "adjacent_points": [
+            46,
+            37
+          ],
+          "adjacent_hexes": [
+            16
+          ],
+          "pixel_coords": [
+            490,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 48,
+          "game_coords": [
+            5,
+            0
+          ],
+          "adjacent_points": [
+            49,
+            40
+          ],
+          "adjacent_hexes": [
+            17
+          ],
+          "pixel_coords": [
+            220,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 49,
+          "game_coords": [
+            5,
+            1
+          ],
+          "adjacent_points": [
+            48,
+            50
+          ],
+          "adjacent_hexes": [
+            17
+          ],
+          "pixel_coords": [
+            242.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 50,
+          "game_coords": [
+            5,
+            2
+          ],
+          "adjacent_points": [
+            49,
+            51,
+            42
+          ],
+          "adjacent_hexes": [
+            18,
+            17
+          ],
+          "pixel_coords": [
+            287.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 51,
+          "game_coords": [
+            5,
+            3
+          ],
+          "adjacent_points": [
+            50,
+            52
+          ],
+          "adjacent_hexes": [
+            18
+          ],
+          "pixel_coords": [
+            310,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 52,
+          "game_coords": [
+            5,
+            4
+          ],
+          "adjacent_points": [
+            51,
+            53,
+            44
+          ],
+          "adjacent_hexes": [
+            19,
+            18
+          ],
+          "pixel_coords": [
+            355,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 53,
+          "game_coords": [
+            5,
+            5
+          ],
+          "adjacent_points": [
+            52,
+            54
+          ],
+          "adjacent_hexes": [
+            19
+          ],
+          "pixel_coords": [
+            377.5,
+            494.8557158514987
+          ]
+        },
+        {
+          "point_id": 54,
+          "game_coords": [
+            5,
+            6
+          ],
+          "adjacent_points": [
+            53,
+            46
+          ],
+          "adjacent_hexes": [
+            19
+          ],
+          "pixel_coords": [
+            422.5,
+            494.8557158514987
+          ]
+        }
+      ],
+      "board_graph": {
+        "adjacency": {
+          "1": [
+            2,
+            9
+          ],
+          "2": [
+            1,
+            3
+          ],
+          "3": [
+            2,
+            4,
+            11
+          ],
+          "4": [
+            3,
+            5
+          ],
+          "5": [
+            4,
+            6,
+            13
+          ],
+          "6": [
+            5,
+            7
+          ],
+          "7": [
+            6,
+            15
+          ],
+          "8": [
+            9,
+            18
+          ],
+          "9": [
+            8,
+            10,
+            1
+          ],
+          "10": [
+            9,
+            11,
+            20
+          ],
+          "11": [
+            10,
+            12,
+            3
+          ],
+          "12": [
+            11,
+            13,
+            22
+          ],
+          "13": [
+            12,
+            14,
+            5
+          ],
+          "14": [
+            13,
+            15,
+            24
+          ],
+          "15": [
+            14,
+            16,
+            7
+          ],
+          "16": [
+            15,
+            26
+          ],
+          "17": [
+            18,
+            28
+          ],
+          "18": [
+            17,
+            19,
+            8
+          ],
+          "19": [
+            18,
+            20,
+            30
+          ],
+          "20": [
+            19,
+            21,
+            10
+          ],
+          "21": [
+            20,
+            22,
+            32
+          ],
+          "22": [
+            21,
+            23,
+            12
+          ],
+          "23": [
+            22,
+            24,
+            34
+          ],
+          "24": [
+            23,
+            25,
+            14
+          ],
+          "25": [
+            24,
+            26,
+            36
+          ],
+          "26": [
+            25,
+            27,
+            16
+          ],
+          "27": [
+            26,
+            38
+          ],
+          "28": [
+            29,
+            17
+          ],
+          "29": [
+            28,
+            30,
+            39
+          ],
+          "30": [
+            29,
+            31,
+            19
+          ],
+          "31": [
+            30,
+            32,
+            41
+          ],
+          "32": [
+            31,
+            33,
+            21
+          ],
+          "33": [
+            32,
+            34,
+            43
+          ],
+          "34": [
+            33,
+            35,
+            23
+          ],
+          "35": [
+            34,
+            36,
+            45
+          ],
+          "36": [
+            35,
+            37,
+            25
+          ],
+          "37": [
+            36,
+            38,
+            47
+          ],
+          "38": [
+            37,
+            27
+          ],
+          "39": [
+            40,
+            29
+          ],
+          "40": [
+            39,
+            41,
+            48
+          ],
+          "41": [
+            40,
+            42,
+            31
+          ],
+          "42": [
+            41,
+            43,
+            50
+          ],
+          "43": [
+            42,
+            44,
+            33
+          ],
+          "44": [
+            43,
+            45,
+            52
+          ],
+          "45": [
+            44,
+            46,
+            35
+          ],
+          "46": [
+            45,
+            47,
+            54
+          ],
+          "47": [
+            46,
+            37
+          ],
+          "48": [
+            49,
+            40
+          ],
+          "49": [
+            48,
+            50
+          ],
+          "50": [
+            49,
+            51,
+            42
+          ],
+          "51": [
+            50,
+            52
+          ],
+          "52": [
+            51,
+            53,
+            44
+          ],
+          "53": [
+            52,
+            54
+          ],
+          "54": [
+            53,
+            46
+          ]
+        },
+        "hex_to_points": {
+          "1": [
+            1,
+            2,
+            3,
+            9,
+            10,
+            11
+          ],
+          "2": [
+            3,
+            4,
+            5,
+            11,
+            12,
+            13
+          ],
+          "3": [
+            5,
+            6,
+            7,
+            13,
+            14,
+            15
+          ],
+          "4": [
+            8,
+            9,
+            10,
+            18,
+            19,
+            20
+          ],
+          "5": [
+            10,
+            11,
+            12,
+            20,
+            21,
+            22
+          ],
+          "6": [
+            12,
+            13,
+            14,
+            22,
+            23,
+            24
+          ],
+          "7": [
+            14,
+            15,
+            16,
+            24,
+            25,
+            26
+          ],
+          "8": [
+            17,
+            18,
+            19,
+            28,
+            29,
+            30
+          ],
+          "9": [
+            19,
+            20,
+            21,
+            30,
+            31,
+            32
+          ],
+          "10": [
+            21,
+            22,
+            23,
+            32,
+            33,
+            34
+          ],
+          "11": [
+            23,
+            24,
+            25,
+            34,
+            35,
+            36
+          ],
+          "12": [
+            25,
+            26,
+            27,
+            36,
+            37,
+            38
+          ],
+          "13": [
+            29,
+            30,
+            31,
+            39,
+            40,
+            41
+          ],
+          "14": [
+            31,
+            32,
+            33,
+            41,
+            42,
+            43
+          ],
+          "15": [
+            33,
+            34,
+            35,
+            43,
+            44,
+            45
+          ],
+          "16": [
+            35,
+            36,
+            37,
+            45,
+            46,
+            47
+          ],
+          "17": [
+            40,
+            41,
+            42,
+            48,
+            49,
+            50
+          ],
+          "18": [
+            42,
+            43,
+            44,
+            50,
+            51,
+            52
+          ],
+          "19": [
+            44,
+            45,
+            46,
+            52,
+            53,
+            54
+          ]
+        },
+        "total_points": 54,
+        "total_hexes": 19
+      }
+    }
+  ]
+}

examples/ai_testing/my_games/game_20251223_205200_final.json

@@ -0,0 +1,1850 @@
+{
+  "hexes": [
+    {
+      "id": 1,
+      "q": 0,
+      "r": -2,
+      "type": "wood",
+      "number": 12,
+      "has_robber": false,
+      "position": [
+        0,
+        0
+      ],
+      "axial_coords": [
+        0,
+        -2
+      ]
+    },
+    {
+      "id": 2,
+      "q": 1,
+      "r": -2,
+      "type": "sheep",
+      "number": 5,
+      "has_robber": false,
+      "position": [
+        0,
+        1
+      ],
+      "axial_coords": [
+        1,
+        -2
+      ]
+    },
+    {
+      "id": 3,
+      "q": 2,
+      "r": -2,
+      "type": "wood",
+      "number": 4,
+      "has_robber": false,
+      "position": [
+        0,
+        2
+      ],
+      "axial_coords": [
+        2,
+        -2
+      ]
+    },
+    {
+      "id": 4,
+      "q": -1,
+      "r": -1,
+      "type": "sheep",
+      "number": 8,
+      "has_robber": false,
+      "position": [
+        1,
+        0
+      ],
+      "axial_coords": [
+        -1,
+        -1
+      ]
+    },
+    {
+      "id": 5,
+      "q": 0,
+      "r": -1,
+      "type": "brick",
+      "number": 6,
+      "has_robber": false,
+      "position": [
+        1,
+        1
+      ],
+      "axial_coords": [
+        0,
+        -1
+      ]
+    },
+    {
+      "id": 6,
+      "q": 1,
+      "r": -1,
+      "type": "wood",
+      "number": 3,
+      "has_robber": false,
+      "position": [
+        1,
+        2
+      ],
+      "axial_coords": [
+        1,
+        -1
+      ]
+    },
+    {
+      "id": 7,
+      "q": 2,
+      "r": -1,
+      "type": "wheat",
+      "number": 8,
+      "has_robber": false,
+      "position": [
+        1,
+        3
+      ],
+      "axial_coords": [
+        2,
+        -1
+      ]
+    },
+    {
+      "id": 8,
+      "q": -2,
+      "r": 0,
+      "type": "brick",
+      "number": 10,
+      "has_robber": false,
+      "position": [
+        2,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        0
+      ]
+    },
+    {
+      "id": 9,
+      "q": -1,
+      "r": 0,
+      "type": "wood",
+      "number": 11,
+      "has_robber": false,
+      "position": [
+        2,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        0
+      ]
+    },
+    {
+      "id": 10,
+      "q": 0,
+      "r": 0,
+      "type": "desert",
+      "number": null,
+      "has_robber": true,
+      "position": [
+        2,
+        2
+      ],
+      "axial_coords": [
+        0,
+        0
+      ]
+    },
+    {
+      "id": 11,
+      "q": 1,
+      "r": 0,
+      "type": "ore",
+      "number": 3,
+      "has_robber": false,
+      "position": [
+        2,
+        3
+      ],
+      "axial_coords": [
+        1,
+        0
+      ]
+    },
+    {
+      "id": 12,
+      "q": 2,
+      "r": 0,
+      "type": "sheep",
+      "number": 4,
+      "has_robber": false,
+      "position": [
+        2,
+        4
+      ],
+      "axial_coords": [
+        2,
+        0
+      ]
+    },
+    {
+      "id": 13,
+      "q": -2,
+      "r": 1,
+      "type": "brick",
+      "number": 10,
+      "has_robber": false,
+      "position": [
+        3,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        1
+      ]
+    },
+    {
+      "id": 14,
+      "q": -1,
+      "r": 1,
+      "type": "wheat",
+      "number": 9,
+      "has_robber": false,
+      "position": [
+        3,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        1
+      ]
+    },
+    {
+      "id": 15,
+      "q": 0,
+      "r": 1,
+      "type": "wheat",
+      "number": 6,
+      "has_robber": false,
+      "position": [
+        3,
+        2
+      ],
+      "axial_coords": [
+        0,
+        1
+      ]
+    },
+    {
+      "id": 16,
+      "q": 1,
+      "r": 1,
+      "type": "sheep",
+      "number": 11,
+      "has_robber": false,
+      "position": [
+        3,
+        3
+      ],
+      "axial_coords": [
+        1,
+        1
+      ]
+    },
+    {
+      "id": 17,
+      "q": -2,
+      "r": 2,
+      "type": "ore",
+      "number": 5,
+      "has_robber": false,
+      "position": [
+        4,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        2
+      ]
+    },
+    {
+      "id": 18,
+      "q": -1,
+      "r": 2,
+      "type": "wheat",
+      "number": 9,
+      "has_robber": false,
+      "position": [
+        4,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        2
+      ]
+    },
+    {
+      "id": 19,
+      "q": 0,
+      "r": 2,
+      "type": "ore",
+      "number": 2,
+      "has_robber": false,
+      "position": [
+        4,
+        2
+      ],
+      "axial_coords": [
+        0,
+        2
+      ]
+    }
+  ],
+  "settlements": [],
+  "cities": [],
+  "roads": [],
+  "players": [
+    {
+      "id": 0,
+      "name": "A",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    },
+    {
+      "id": 1,
+      "name": "B",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    },
+    {
+      "id": 2,
+      "name": "C",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    }
+  ],
+  "current_player": 0,
+  "current_phase": "SETUP_FIRST_ROUND",
+  "robber_position": [
+    2,
+    2
+  ],
+  "dice_result": null,
+  "points": [
+    {
+      "point_id": 1,
+      "game_coords": [
+        0,
+        0
+      ],
+      "adjacent_points": [
+        2,
+        9
+      ],
+      "adjacent_hexes": [
+        1
+      ],
+      "pixel_coords": [
+        377.5,
+        105.14428414850131
+      ]
+    },
+    {
+      "point_id": 2,
+      "game_coords": [
+        0,
+        1
+      ],
+      "adjacent_points": [
+        1,
+        3
+      ],
+      "adjacent_hexes": [
+        1
+      ],
+      "pixel_coords": [
+        422.5,
+        105.14428414850128
+      ]
+    },
+    {
+      "point_id": 3,
+      "game_coords": [
+        0,
+        2
+      ],
+      "adjacent_points": [
+        2,
+        4,
+        11
+      ],
+      "adjacent_hexes": [
+        2,
+        1
+      ],
+      "pixel_coords": [
+        445,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 4,
+      "game_coords": [
+        0,
+        3
+      ],
+      "adjacent_points": [
+        3,
+        5
+      ],
+      "adjacent_hexes": [
+        2
+      ],
+      "pixel_coords": [
+        490,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 5,
+      "game_coords": [
+        0,
+        4
+      ],
+      "adjacent_points": [
+        4,
+        6,
+        13
+      ],
+      "adjacent_hexes": [
+        3,
+        2
+      ],
+      "pixel_coords": [
+        512.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 6,
+      "game_coords": [
+        0,
+        5
+      ],
+      "adjacent_points": [
+        5,
+        7
+      ],
+      "adjacent_hexes": [
+        3
+      ],
+      "pixel_coords": [
+        557.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 7,
+      "game_coords": [
+        0,
+        6
+      ],
+      "adjacent_points": [
+        6,
+        15
+      ],
+      "adjacent_hexes": [
+        3
+      ],
+      "pixel_coords": [
+        580,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 8,
+      "game_coords": [
+        1,
+        0
+      ],
+      "adjacent_points": [
+        9,
+        18
+      ],
+      "adjacent_hexes": [
+        4
+      ],
+      "pixel_coords": [
+        310,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 9,
+      "game_coords": [
+        1,
+        1
+      ],
+      "adjacent_points": [
+        8,
+        10,
+        1
+      ],
+      "adjacent_hexes": [
+        4,
+        1
+      ],
+      "pixel_coords": [
+        355,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 10,
+      "game_coords": [
+        1,
+        2
+      ],
+      "adjacent_points": [
+        9,
+        11,
+        20
+      ],
+      "adjacent_hexes": [
+        5,
+        4,
+        1
+      ],
+      "pixel_coords": [
+        377.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 11,
+      "game_coords": [
+        1,
+        3
+      ],
+      "adjacent_points": [
+        10,
+        12,
+        3
+      ],
+      "adjacent_hexes": [
+        5,
+        2,
+        1
+      ],
+      "pixel_coords": [
+        422.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 12,
+      "game_coords": [
+        1,
+        4
+      ],
+      "adjacent_points": [
+        11,
+        13,
+        22
+      ],
+      "adjacent_hexes": [
+        6,
+        5,
+        2
+      ],
+      "pixel_coords": [
+        445,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 13,
+      "game_coords": [
+        1,
+        5
+      ],
+      "adjacent_points": [
+        12,
+        14,
+        5
+      ],
+      "adjacent_hexes": [
+        6,
+        3,
+        2
+      ],
+      "pixel_coords": [
+        490,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 14,
+      "game_coords": [
+        1,
+        6
+      ],
+      "adjacent_points": [
+        13,
+        15,
+        24
+      ],
+      "adjacent_hexes": [
+        7,
+        6,
+        3
+      ],
+      "pixel_coords": [
+        512.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 15,
+      "game_coords": [
+        1,
+        7
+      ],
+      "adjacent_points": [
+        14,
+        16,
+        7
+      ],
+      "adjacent_hexes": [
+        7,
+        3
+      ],
+      "pixel_coords": [
+        557.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 16,
+      "game_coords": [
+        1,
+        8
+      ],
+      "adjacent_points": [
+        15,
+        26
+      ],
+      "adjacent_hexes": [
+        7
+      ],
+      "pixel_coords": [
+        580,
+        300
+      ]
+    },
+    {
+      "point_id": 17,
+      "game_coords": [
+        2,
+        0
+      ],
+      "adjacent_points": [
+        18,
+        28
+      ],
+      "adjacent_hexes": [
+        8
+      ],
+      "pixel_coords": [
+        242.49999999999997,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 18,
+      "game_coords": [
+        2,
+        1
+      ],
+      "adjacent_points": [
+        17,
+        19,
+        8
+      ],
+      "adjacent_hexes": [
+        8,
+        4
+      ],
+      "pixel_coords": [
+        287.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 19,
+      "game_coords": [
+        2,
+        2
+      ],
+      "adjacent_points": [
+        18,
+        20,
+        30
+      ],
+      "adjacent_hexes": [
+        9,
+        8,
+        4
+      ],
+      "pixel_coords": [
+        310,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 20,
+      "game_coords": [
+        2,
+        3
+      ],
+      "adjacent_points": [
+        19,
+        21,
+        10
+      ],
+      "adjacent_hexes": [
+        9,
+        5,
+        4
+      ],
+      "pixel_coords": [
+        355,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 21,
+      "game_coords": [
+        2,
+        4
+      ],
+      "adjacent_points": [
+        20,
+        22,
+        32
+      ],
+      "adjacent_hexes": [
+        10,
+        9,
+        5
+      ],
+      "pixel_coords": [
+        377.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 22,
+      "game_coords": [
+        2,
+        5
+      ],
+      "adjacent_points": [
+        21,
+        23,
+        12
+      ],
+      "adjacent_hexes": [
+        10,
+        6,
+        5
+      ],
+      "pixel_coords": [
+        422.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 23,
+      "game_coords": [
+        2,
+        6
+      ],
+      "adjacent_points": [
+        22,
+        24,
+        34
+      ],
+      "adjacent_hexes": [
+        11,
+        10,
+        6
+      ],
+      "pixel_coords": [
+        445,
+        300
+      ]
+    },
+    {
+      "point_id": 24,
+      "game_coords": [
+        2,
+        7
+      ],
+      "adjacent_points": [
+        23,
+        25,
+        14
+      ],
+      "adjacent_hexes": [
+        11,
+        7,
+        6
+      ],
+      "pixel_coords": [
+        490,
+        300
+      ]
+    },
+    {
+      "point_id": 25,
+      "game_coords": [
+        2,
+        8
+      ],
+      "adjacent_points": [
+        24,
+        26,
+        36
+      ],
+      "adjacent_hexes": [
+        12,
+        11,
+        7
+      ],
+      "pixel_coords": [
+        512.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 26,
+      "game_coords": [
+        2,
+        9
+      ],
+      "adjacent_points": [
+        25,
+        27,
+        16
+      ],
+      "adjacent_hexes": [
+        12,
+        7
+      ],
+      "pixel_coords": [
+        557.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 27,
+      "game_coords": [
+        2,
+        10
+      ],
+      "adjacent_points": [
+        26,
+        38
+      ],
+      "adjacent_hexes": [
+        12
+      ],
+      "pixel_coords": [
+        580,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 28,
+      "game_coords": [
+        3,
+        0
+      ],
+      "adjacent_points": [
+        29,
+        17
+      ],
+      "adjacent_hexes": [
+        8
+      ],
+      "pixel_coords": [
+        220,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 29,
+      "game_coords": [
+        3,
+        1
+      ],
+      "adjacent_points": [
+        28,
+        30,
+        39
+      ],
+      "adjacent_hexes": [
+        13,
+        8
+      ],
+      "pixel_coords": [
+        242.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 30,
+      "game_coords": [
+        3,
+        2
+      ],
+      "adjacent_points": [
+        29,
+        31,
+        19
+      ],
+      "adjacent_hexes": [
+        13,
+        9,
+        8
+      ],
+      "pixel_coords": [
+        287.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 31,
+      "game_coords": [
+        3,
+        3
+      ],
+      "adjacent_points": [
+        30,
+        32,
+        41
+      ],
+      "adjacent_hexes": [
+        14,
+        13,
+        9
+      ],
+      "pixel_coords": [
+        310,
+        300
+      ]
+    },
+    {
+      "point_id": 32,
+      "game_coords": [
+        3,
+        4
+      ],
+      "adjacent_points": [
+        31,
+        33,
+        21
+      ],
+      "adjacent_hexes": [
+        14,
+        10,
+        9
+      ],
+      "pixel_coords": [
+        355,
+        300
+      ]
+    },
+    {
+      "point_id": 33,
+      "game_coords": [
+        3,
+        5
+      ],
+      "adjacent_points": [
+        32,
+        34,
+        43
+      ],
+      "adjacent_hexes": [
+        15,
+        14,
+        10
+      ],
+      "pixel_coords": [
+        377.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 34,
+      "game_coords": [
+        3,
+        6
+      ],
+      "adjacent_points": [
+        33,
+        35,
+        23
+      ],
+      "adjacent_hexes": [
+        15,
+        11,
+        10
+      ],
+      "pixel_coords": [
+        422.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 35,
+      "game_coords": [
+        3,
+        7
+      ],
+      "adjacent_points": [
+        34,
+        36,
+        45
+      ],
+      "adjacent_hexes": [
+        16,
+        15,
+        11
+      ],
+      "pixel_coords": [
+        445,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 36,
+      "game_coords": [
+        3,
+        8
+      ],
+      "adjacent_points": [
+        35,
+        37,
+        25
+      ],
+      "adjacent_hexes": [
+        16,
+        12,
+        11
+      ],
+      "pixel_coords": [
+        490,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 37,
+      "game_coords": [
+        3,
+        9
+      ],
+      "adjacent_points": [
+        36,
+        38,
+        47
+      ],
+      "adjacent_hexes": [
+        16,
+        12
+      ],
+      "pixel_coords": [
+        512.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 38,
+      "game_coords": [
+        3,
+        10
+      ],
+      "adjacent_points": [
+        37,
+        27
+      ],
+      "adjacent_hexes": [
+        12
+      ],
+      "pixel_coords": [
+        557.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 39,
+      "game_coords": [
+        4,
+        0
+      ],
+      "adjacent_points": [
+        40,
+        29
+      ],
+      "adjacent_hexes": [
+        13
+      ],
+      "pixel_coords": [
+        220,
+        300
+      ]
+    },
+    {
+      "point_id": 40,
+      "game_coords": [
+        4,
+        1
+      ],
+      "adjacent_points": [
+        39,
+        41,
+        48
+      ],
+      "adjacent_hexes": [
+        17,
+        13
+      ],
+      "pixel_coords": [
+        242.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 41,
+      "game_coords": [
+        4,
+        2
+      ],
+      "adjacent_points": [
+        40,
+        42,
+        31
+      ],
+      "adjacent_hexes": [
+        17,
+        14,
+        13
+      ],
+      "pixel_coords": [
+        287.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 42,
+      "game_coords": [
+        4,
+        3
+      ],
+      "adjacent_points": [
+        41,
+        43,
+        50
+      ],
+      "adjacent_hexes": [
+        18,
+        17,
+        14
+      ],
+      "pixel_coords": [
+        310,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 43,
+      "game_coords": [
+        4,
+        4
+      ],
+      "adjacent_points": [
+        42,
+        44,
+        33
+      ],
+      "adjacent_hexes": [
+        18,
+        15,
+        14
+      ],
+      "pixel_coords": [
+        355,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 44,
+      "game_coords": [
+        4,
+        5
+      ],
+      "adjacent_points": [
+        43,
+        45,
+        52
+      ],
+      "adjacent_hexes": [
+        19,
+        18,
+        15
+      ],
+      "pixel_coords": [
+        377.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 45,
+      "game_coords": [
+        4,
+        6
+      ],
+      "adjacent_points": [
+        44,
+        46,
+        35
+      ],
+      "adjacent_hexes": [
+        19,
+        16,
+        15
+      ],
+      "pixel_coords": [
+        422.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 46,
+      "game_coords": [
+        4,
+        7
+      ],
+      "adjacent_points": [
+        45,
+        47,
+        54
+      ],
+      "adjacent_hexes": [
+        19,
+        16
+      ],
+      "pixel_coords": [
+        445,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 47,
+      "game_coords": [
+        4,
+        8
+      ],
+      "adjacent_points": [
+        46,
+        37
+      ],
+      "adjacent_hexes": [
+        16
+      ],
+      "pixel_coords": [
+        490,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 48,
+      "game_coords": [
+        5,
+        0
+      ],
+      "adjacent_points": [
+        49,
+        40
+      ],
+      "adjacent_hexes": [
+        17
+      ],
+      "pixel_coords": [
+        220,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 49,
+      "game_coords": [
+        5,
+        1
+      ],
+      "adjacent_points": [
+        48,
+        50
+      ],
+      "adjacent_hexes": [
+        17
+      ],
+      "pixel_coords": [
+        242.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 50,
+      "game_coords": [
+        5,
+        2
+      ],
+      "adjacent_points": [
+        49,
+        51,
+        42
+      ],
+      "adjacent_hexes": [
+        18,
+        17
+      ],
+      "pixel_coords": [
+        287.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 51,
+      "game_coords": [
+        5,
+        3
+      ],
+      "adjacent_points": [
+        50,
+        52
+      ],
+      "adjacent_hexes": [
+        18
+      ],
+      "pixel_coords": [
+        310,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 52,
+      "game_coords": [
+        5,
+        4
+      ],
+      "adjacent_points": [
+        51,
+        53,
+        44
+      ],
+      "adjacent_hexes": [
+        19,
+        18
+      ],
+      "pixel_coords": [
+        355,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 53,
+      "game_coords": [
+        5,
+        5
+      ],
+      "adjacent_points": [
+        52,
+        54
+      ],
+      "adjacent_hexes": [
+        19
+      ],
+      "pixel_coords": [
+        377.5,
+        494.8557158514987
+      ]
+    },
+    {
+      "point_id": 54,
+      "game_coords": [
+        5,
+        6
+      ],
+      "adjacent_points": [
+        53,
+        46
+      ],
+      "adjacent_hexes": [
+        19
+      ],
+      "pixel_coords": [
+        422.5,
+        494.8557158514987
+      ]
+    }
+  ],
+  "board_graph": {
+    "adjacency": {
+      "1": [
+        2,
+        9
+      ],
+      "2": [
+        1,
+        3
+      ],
+      "3": [
+        2,
+        4,
+        11
+      ],
+      "4": [
+        3,
+        5
+      ],
+      "5": [
+        4,
+        6,
+        13
+      ],
+      "6": [
+        5,
+        7
+      ],
+      "7": [
+        6,
+        15
+      ],
+      "8": [
+        9,
+        18
+      ],
+      "9": [
+        8,
+        10,
+        1
+      ],
+      "10": [
+        9,
+        11,
+        20
+      ],
+      "11": [
+        10,
+        12,
+        3
+      ],
+      "12": [
+        11,
+        13,
+        22
+      ],
+      "13": [
+        12,
+        14,
+        5
+      ],
+      "14": [
+        13,
+        15,
+        24
+      ],
+      "15": [
+        14,
+        16,
+        7
+      ],
+      "16": [
+        15,
+        26
+      ],
+      "17": [
+        18,
+        28
+      ],
+      "18": [
+        17,
+        19,
+        8
+      ],
+      "19": [
+        18,
+        20,
+        30
+      ],
+      "20": [
+        19,
+        21,
+        10
+      ],
+      "21": [
+        20,
+        22,
+        32
+      ],
+      "22": [
+        21,
+        23,
+        12
+      ],
+      "23": [
+        22,
+        24,
+        34
+      ],
+      "24": [
+        23,
+        25,
+        14
+      ],
+      "25": [
+        24,
+        26,
+        36
+      ],
+      "26": [
+        25,
+        27,
+        16
+      ],
+      "27": [
+        26,
+        38
+      ],
+      "28": [
+        29,
+        17
+      ],
+      "29": [
+        28,
+        30,
+        39
+      ],
+      "30": [
+        29,
+        31,
+        19
+      ],
+      "31": [
+        30,
+        32,
+        41
+      ],
+      "32": [
+        31,
+        33,
+        21
+      ],
+      "33": [
+        32,
+        34,
+        43
+      ],
+      "34": [
+        33,
+        35,
+        23
+      ],
+      "35": [
+        34,
+        36,
+        45
+      ],
+      "36": [
+        35,
+        37,
+        25
+      ],
+      "37": [
+        36,
+        38,
+        47
+      ],
+      "38": [
+        37,
+        27
+      ],
+      "39": [
+        40,
+        29
+      ],
+      "40": [
+        39,
+        41,
+        48
+      ],
+      "41": [
+        40,
+        42,
+        31
+      ],
+      "42": [
+        41,
+        43,
+        50
+      ],
+      "43": [
+        42,
+        44,
+        33
+      ],
+      "44": [
+        43,
+        45,
+        52
+      ],
+      "45": [
+        44,
+        46,
+        35
+      ],
+      "46": [
+        45,
+        47,
+        54
+      ],
+      "47": [
+        46,
+        37
+      ],
+      "48": [
+        49,
+        40
+      ],
+      "49": [
+        48,
+        50
+      ],
+      "50": [
+        49,
+        51,
+        42
+      ],
+      "51": [
+        50,
+        52
+      ],
+      "52": [
+        51,
+        53,
+        44
+      ],
+      "53": [
+        52,
+        54
+      ],
+      "54": [
+        53,
+        46
+      ]
+    },
+    "hex_to_points": {
+      "1": [
+        1,
+        2,
+        3,
+        9,
+        10,
+        11
+      ],
+      "2": [
+        3,
+        4,
+        5,
+        11,
+        12,
+        13
+      ],
+      "3": [
+        5,
+        6,
+        7,
+        13,
+        14,
+        15
+      ],
+      "4": [
+        8,
+        9,
+        10,
+        18,
+        19,
+        20
+      ],
+      "5": [
+        10,
+        11,
+        12,
+        20,
+        21,
+        22
+      ],
+      "6": [
+        12,
+        13,
+        14,
+        22,
+        23,
+        24
+      ],
+      "7": [
+        14,
+        15,
+        16,
+        24,
+        25,
+        26
+      ],
+      "8": [
+        17,
+        18,
+        19,
+        28,
+        29,
+        30
+      ],
+      "9": [
+        19,
+        20,
+        21,
+        30,
+        31,
+        32
+      ],
+      "10": [
+        21,
+        22,
+        23,
+        32,
+        33,
+        34
+      ],
+      "11": [
+        23,
+        24,
+        25,
+        34,
+        35,
+        36
+      ],
+      "12": [
+        25,
+        26,
+        27,
+        36,
+        37,
+        38
+      ],
+      "13": [
+        29,
+        30,
+        31,
+        39,
+        40,
+        41
+      ],
+      "14": [
+        31,
+        32,
+        33,
+        41,
+        42,
+        43
+      ],
+      "15": [
+        33,
+        34,
+        35,
+        43,
+        44,
+        45
+      ],
+      "16": [
+        35,
+        36,
+        37,
+        45,
+        46,
+        47
+      ],
+      "17": [
+        40,
+        41,
+        42,
+        48,
+        49,
+        50
+      ],
+      "18": [
+        42,
+        43,
+        44,
+        50,
+        51,
+        52
+      ],
+      "19": [
+        44,
+        45,
+        46,
+        52,
+        53,
+        54
+      ]
+    },
+    "total_points": 54,
+    "total_hexes": 19
+  }
+}

examples/ai_testing/my_games/game_20251223_205200_full.json

@@ -0,0 +1,1856 @@
+{
+  "total_states": 1,
+  "timestamp": "20251223_205200",
+  "states": [
+    {
+      "hexes": [
+        {
+          "id": 1,
+          "q": 0,
+          "r": -2,
+          "type": "wood",
+          "number": 12,
+          "has_robber": false,
+          "position": [
+            0,
+            0
+          ],
+          "axial_coords": [
+            0,
+            -2
+          ]
+        },
+        {
+          "id": 2,
+          "q": 1,
+          "r": -2,
+          "type": "sheep",
+          "number": 5,
+          "has_robber": false,
+          "position": [
+            0,
+            1
+          ],
+          "axial_coords": [
+            1,
+            -2
+          ]
+        },
+        {
+          "id": 3,
+          "q": 2,
+          "r": -2,
+          "type": "wood",
+          "number": 4,
+          "has_robber": false,
+          "position": [
+            0,
+            2
+          ],
+          "axial_coords": [
+            2,
+            -2
+          ]
+        },
+        {
+          "id": 4,
+          "q": -1,
+          "r": -1,
+          "type": "sheep",
+          "number": 8,
+          "has_robber": false,
+          "position": [
+            1,
+            0
+          ],
+          "axial_coords": [
+            -1,
+            -1
+          ]
+        },
+        {
+          "id": 5,
+          "q": 0,
+          "r": -1,
+          "type": "brick",
+          "number": 6,
+          "has_robber": false,
+          "position": [
+            1,
+            1
+          ],
+          "axial_coords": [
+            0,
+            -1
+          ]
+        },
+        {
+          "id": 6,
+          "q": 1,
+          "r": -1,
+          "type": "wood",
+          "number": 3,
+          "has_robber": false,
+          "position": [
+            1,
+            2
+          ],
+          "axial_coords": [
+            1,
+            -1
+          ]
+        },
+        {
+          "id": 7,
+          "q": 2,
+          "r": -1,
+          "type": "wheat",
+          "number": 8,
+          "has_robber": false,
+          "position": [
+            1,
+            3
+          ],
+          "axial_coords": [
+            2,
+            -1
+          ]
+        },
+        {
+          "id": 8,
+          "q": -2,
+          "r": 0,
+          "type": "brick",
+          "number": 10,
+          "has_robber": false,
+          "position": [
+            2,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            0
+          ]
+        },
+        {
+          "id": 9,
+          "q": -1,
+          "r": 0,
+          "type": "wood",
+          "number": 11,
+          "has_robber": false,
+          "position": [
+            2,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            0
+          ]
+        },
+        {
+          "id": 10,
+          "q": 0,
+          "r": 0,
+          "type": "desert",
+          "number": null,
+          "has_robber": true,
+          "position": [
+            2,
+            2
+          ],
+          "axial_coords": [
+            0,
+            0
+          ]
+        },
+        {
+          "id": 11,
+          "q": 1,
+          "r": 0,
+          "type": "ore",
+          "number": 3,
+          "has_robber": false,
+          "position": [
+            2,
+            3
+          ],
+          "axial_coords": [
+            1,
+            0
+          ]
+        },
+        {
+          "id": 12,
+          "q": 2,
+          "r": 0,
+          "type": "sheep",
+          "number": 4,
+          "has_robber": false,
+          "position": [
+            2,
+            4
+          ],
+          "axial_coords": [
+            2,
+            0
+          ]
+        },
+        {
+          "id": 13,
+          "q": -2,
+          "r": 1,
+          "type": "brick",
+          "number": 10,
+          "has_robber": false,
+          "position": [
+            3,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            1
+          ]
+        },
+        {
+          "id": 14,
+          "q": -1,
+          "r": 1,
+          "type": "wheat",
+          "number": 9,
+          "has_robber": false,
+          "position": [
+            3,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            1
+          ]
+        },
+        {
+          "id": 15,
+          "q": 0,
+          "r": 1,
+          "type": "wheat",
+          "number": 6,
+          "has_robber": false,
+          "position": [
+            3,
+            2
+          ],
+          "axial_coords": [
+            0,
+            1
+          ]
+        },
+        {
+          "id": 16,
+          "q": 1,
+          "r": 1,
+          "type": "sheep",
+          "number": 11,
+          "has_robber": false,
+          "position": [
+            3,
+            3
+          ],
+          "axial_coords": [
+            1,
+            1
+          ]
+        },
+        {
+          "id": 17,
+          "q": -2,
+          "r": 2,
+          "type": "ore",
+          "number": 5,
+          "has_robber": false,
+          "position": [
+            4,
+            0
+          ],
+          "axial_coords": [
+            -2,
+            2
+          ]
+        },
+        {
+          "id": 18,
+          "q": -1,
+          "r": 2,
+          "type": "wheat",
+          "number": 9,
+          "has_robber": false,
+          "position": [
+            4,
+            1
+          ],
+          "axial_coords": [
+            -1,
+            2
+          ]
+        },
+        {
+          "id": 19,
+          "q": 0,
+          "r": 2,
+          "type": "ore",
+          "number": 2,
+          "has_robber": false,
+          "position": [
+            4,
+            2
+          ],
+          "axial_coords": [
+            0,
+            2
+          ]
+        }
+      ],
+      "settlements": [],
+      "cities": [],
+      "roads": [],
+      "players": [
+        {
+          "id": 0,
+          "name": "A",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        },
+        {
+          "id": 1,
+          "name": "B",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        },
+        {
+          "id": 2,
+          "name": "C",
+          "victory_points": 0,
+          "total_cards": 0,
+          "cards_list": [],
+          "dev_cards_list": [],
+          "settlements": 0,
+          "cities": 0,
+          "roads": 0,
+          "longest_road": 0,
+          "has_longest_road": false,
+          "knights": 0,
+          "knights_played": 0,
+          "has_largest_army": false
+        }
+      ],
+      "current_player": 0,
+      "current_phase": "SETUP_FIRST_ROUND",
+      "robber_position": [
+        2,
+        2
+      ],
+      "dice_result": null,
+      "points": [
+        {
+          "point_id": 1,
+          "game_coords": [
+            0,
+            0
+          ],
+          "adjacent_points": [
+            2,
+            9
+          ],
+          "adjacent_hexes": [
+            1
+          ],
+          "pixel_coords": [
+            377.5,
+            105.14428414850131
+          ]
+        },
+        {
+          "point_id": 2,
+          "game_coords": [
+            0,
+            1
+          ],
+          "adjacent_points": [
+            1,
+            3
+          ],
+          "adjacent_hexes": [
+            1
+          ],
+          "pixel_coords": [
+            422.5,
+            105.14428414850128
+          ]
+        },
+        {
+          "point_id": 3,
+          "game_coords": [
+            0,
+            2
+          ],
+          "adjacent_points": [
+            2,
+            4,
+            11
+          ],
+          "adjacent_hexes": [
+            2,
+            1
+          ],
+          "pixel_coords": [
+            445,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 4,
+          "game_coords": [
+            0,
+            3
+          ],
+          "adjacent_points": [
+            3,
+            5
+          ],
+          "adjacent_hexes": [
+            2
+          ],
+          "pixel_coords": [
+            490,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 5,
+          "game_coords": [
+            0,
+            4
+          ],
+          "adjacent_points": [
+            4,
+            6,
+            13
+          ],
+          "adjacent_hexes": [
+            3,
+            2
+          ],
+          "pixel_coords": [
+            512.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 6,
+          "game_coords": [
+            0,
+            5
+          ],
+          "adjacent_points": [
+            5,
+            7
+          ],
+          "adjacent_hexes": [
+            3
+          ],
+          "pixel_coords": [
+            557.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 7,
+          "game_coords": [
+            0,
+            6
+          ],
+          "adjacent_points": [
+            6,
+            15
+          ],
+          "adjacent_hexes": [
+            3
+          ],
+          "pixel_coords": [
+            580,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 8,
+          "game_coords": [
+            1,
+            0
+          ],
+          "adjacent_points": [
+            9,
+            18
+          ],
+          "adjacent_hexes": [
+            4
+          ],
+          "pixel_coords": [
+            310,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 9,
+          "game_coords": [
+            1,
+            1
+          ],
+          "adjacent_points": [
+            8,
+            10,
+            1
+          ],
+          "adjacent_hexes": [
+            4,
+            1
+          ],
+          "pixel_coords": [
+            355,
+            144.11542731880104
+          ]
+        },
+        {
+          "point_id": 10,
+          "game_coords": [
+            1,
+            2
+          ],
+          "adjacent_points": [
+            9,
+            11,
+            20
+          ],
+          "adjacent_hexes": [
+            5,
+            4,
+            1
+          ],
+          "pixel_coords": [
+            377.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 11,
+          "game_coords": [
+            1,
+            3
+          ],
+          "adjacent_points": [
+            10,
+            12,
+            3
+          ],
+          "adjacent_hexes": [
+            5,
+            2,
+            1
+          ],
+          "pixel_coords": [
+            422.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 12,
+          "game_coords": [
+            1,
+            4
+          ],
+          "adjacent_points": [
+            11,
+            13,
+            22
+          ],
+          "adjacent_hexes": [
+            6,
+            5,
+            2
+          ],
+          "pixel_coords": [
+            445,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 13,
+          "game_coords": [
+            1,
+            5
+          ],
+          "adjacent_points": [
+            12,
+            14,
+            5
+          ],
+          "adjacent_hexes": [
+            6,
+            3,
+            2
+          ],
+          "pixel_coords": [
+            490,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 14,
+          "game_coords": [
+            1,
+            6
+          ],
+          "adjacent_points": [
+            13,
+            15,
+            24
+          ],
+          "adjacent_hexes": [
+            7,
+            6,
+            3
+          ],
+          "pixel_coords": [
+            512.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 15,
+          "game_coords": [
+            1,
+            7
+          ],
+          "adjacent_points": [
+            14,
+            16,
+            7
+          ],
+          "adjacent_hexes": [
+            7,
+            3
+          ],
+          "pixel_coords": [
+            557.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 16,
+          "game_coords": [
+            1,
+            8
+          ],
+          "adjacent_points": [
+            15,
+            26
+          ],
+          "adjacent_hexes": [
+            7
+          ],
+          "pixel_coords": [
+            580,
+            300
+          ]
+        },
+        {
+          "point_id": 17,
+          "game_coords": [
+            2,
+            0
+          ],
+          "adjacent_points": [
+            18,
+            28
+          ],
+          "adjacent_hexes": [
+            8
+          ],
+          "pixel_coords": [
+            242.49999999999997,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 18,
+          "game_coords": [
+            2,
+            1
+          ],
+          "adjacent_points": [
+            17,
+            19,
+            8
+          ],
+          "adjacent_hexes": [
+            8,
+            4
+          ],
+          "pixel_coords": [
+            287.5,
+            183.08657048910078
+          ]
+        },
+        {
+          "point_id": 19,
+          "game_coords": [
+            2,
+            2
+          ],
+          "adjacent_points": [
+            18,
+            20,
+            30
+          ],
+          "adjacent_hexes": [
+            9,
+            8,
+            4
+          ],
+          "pixel_coords": [
+            310,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 20,
+          "game_coords": [
+            2,
+            3
+          ],
+          "adjacent_points": [
+            19,
+            21,
+            10
+          ],
+          "adjacent_hexes": [
+            9,
+            5,
+            4
+          ],
+          "pixel_coords": [
+            355,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 21,
+          "game_coords": [
+            2,
+            4
+          ],
+          "adjacent_points": [
+            20,
+            22,
+            32
+          ],
+          "adjacent_hexes": [
+            10,
+            9,
+            5
+          ],
+          "pixel_coords": [
+            377.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 22,
+          "game_coords": [
+            2,
+            5
+          ],
+          "adjacent_points": [
+            21,
+            23,
+            12
+          ],
+          "adjacent_hexes": [
+            10,
+            6,
+            5
+          ],
+          "pixel_coords": [
+            422.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 23,
+          "game_coords": [
+            2,
+            6
+          ],
+          "adjacent_points": [
+            22,
+            24,
+            34
+          ],
+          "adjacent_hexes": [
+            11,
+            10,
+            6
+          ],
+          "pixel_coords": [
+            445,
+            300
+          ]
+        },
+        {
+          "point_id": 24,
+          "game_coords": [
+            2,
+            7
+          ],
+          "adjacent_points": [
+            23,
+            25,
+            14
+          ],
+          "adjacent_hexes": [
+            11,
+            7,
+            6
+          ],
+          "pixel_coords": [
+            490,
+            300
+          ]
+        },
+        {
+          "point_id": 25,
+          "game_coords": [
+            2,
+            8
+          ],
+          "adjacent_points": [
+            24,
+            26,
+            36
+          ],
+          "adjacent_hexes": [
+            12,
+            11,
+            7
+          ],
+          "pixel_coords": [
+            512.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 26,
+          "game_coords": [
+            2,
+            9
+          ],
+          "adjacent_points": [
+            25,
+            27,
+            16
+          ],
+          "adjacent_hexes": [
+            12,
+            7
+          ],
+          "pixel_coords": [
+            557.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 27,
+          "game_coords": [
+            2,
+            10
+          ],
+          "adjacent_points": [
+            26,
+            38
+          ],
+          "adjacent_hexes": [
+            12
+          ],
+          "pixel_coords": [
+            580,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 28,
+          "game_coords": [
+            3,
+            0
+          ],
+          "adjacent_points": [
+            29,
+            17
+          ],
+          "adjacent_hexes": [
+            8
+          ],
+          "pixel_coords": [
+            220,
+            222.05771365940052
+          ]
+        },
+        {
+          "point_id": 29,
+          "game_coords": [
+            3,
+            1
+          ],
+          "adjacent_points": [
+            28,
+            30,
+            39
+          ],
+          "adjacent_hexes": [
+            13,
+            8
+          ],
+          "pixel_coords": [
+            242.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 30,
+          "game_coords": [
+            3,
+            2
+          ],
+          "adjacent_points": [
+            29,
+            31,
+            19
+          ],
+          "adjacent_hexes": [
+            13,
+            9,
+            8
+          ],
+          "pixel_coords": [
+            287.5,
+            261.02885682970026
+          ]
+        },
+        {
+          "point_id": 31,
+          "game_coords": [
+            3,
+            3
+          ],
+          "adjacent_points": [
+            30,
+            32,
+            41
+          ],
+          "adjacent_hexes": [
+            14,
+            13,
+            9
+          ],
+          "pixel_coords": [
+            310,
+            300
+          ]
+        },
+        {
+          "point_id": 32,
+          "game_coords": [
+            3,
+            4
+          ],
+          "adjacent_points": [
+            31,
+            33,
+            21
+          ],
+          "adjacent_hexes": [
+            14,
+            10,
+            9
+          ],
+          "pixel_coords": [
+            355,
+            300
+          ]
+        },
+        {
+          "point_id": 33,
+          "game_coords": [
+            3,
+            5
+          ],
+          "adjacent_points": [
+            32,
+            34,
+            43
+          ],
+          "adjacent_hexes": [
+            15,
+            14,
+            10
+          ],
+          "pixel_coords": [
+            377.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 34,
+          "game_coords": [
+            3,
+            6
+          ],
+          "adjacent_points": [
+            33,
+            35,
+            23
+          ],
+          "adjacent_hexes": [
+            15,
+            11,
+            10
+          ],
+          "pixel_coords": [
+            422.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 35,
+          "game_coords": [
+            3,
+            7
+          ],
+          "adjacent_points": [
+            34,
+            36,
+            45
+          ],
+          "adjacent_hexes": [
+            16,
+            15,
+            11
+          ],
+          "pixel_coords": [
+            445,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 36,
+          "game_coords": [
+            3,
+            8
+          ],
+          "adjacent_points": [
+            35,
+            37,
+            25
+          ],
+          "adjacent_hexes": [
+            16,
+            12,
+            11
+          ],
+          "pixel_coords": [
+            490,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 37,
+          "game_coords": [
+            3,
+            9
+          ],
+          "adjacent_points": [
+            36,
+            38,
+            47
+          ],
+          "adjacent_hexes": [
+            16,
+            12
+          ],
+          "pixel_coords": [
+            512.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 38,
+          "game_coords": [
+            3,
+            10
+          ],
+          "adjacent_points": [
+            37,
+            27
+          ],
+          "adjacent_hexes": [
+            12
+          ],
+          "pixel_coords": [
+            557.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 39,
+          "game_coords": [
+            4,
+            0
+          ],
+          "adjacent_points": [
+            40,
+            29
+          ],
+          "adjacent_hexes": [
+            13
+          ],
+          "pixel_coords": [
+            220,
+            300
+          ]
+        },
+        {
+          "point_id": 40,
+          "game_coords": [
+            4,
+            1
+          ],
+          "adjacent_points": [
+            39,
+            41,
+            48
+          ],
+          "adjacent_hexes": [
+            17,
+            13
+          ],
+          "pixel_coords": [
+            242.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 41,
+          "game_coords": [
+            4,
+            2
+          ],
+          "adjacent_points": [
+            40,
+            42,
+            31
+          ],
+          "adjacent_hexes": [
+            17,
+            14,
+            13
+          ],
+          "pixel_coords": [
+            287.5,
+            338.97114317029974
+          ]
+        },
+        {
+          "point_id": 42,
+          "game_coords": [
+            4,
+            3
+          ],
+          "adjacent_points": [
+            41,
+            43,
+            50
+          ],
+          "adjacent_hexes": [
+            18,
+            17,
+            14
+          ],
+          "pixel_coords": [
+            310,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 43,
+          "game_coords": [
+            4,
+            4
+          ],
+          "adjacent_points": [
+            42,
+            44,
+            33
+          ],
+          "adjacent_hexes": [
+            18,
+            15,
+            14
+          ],
+          "pixel_coords": [
+            355,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 44,
+          "game_coords": [
+            4,
+            5
+          ],
+          "adjacent_points": [
+            43,
+            45,
+            52
+          ],
+          "adjacent_hexes": [
+            19,
+            18,
+            15
+          ],
+          "pixel_coords": [
+            377.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 45,
+          "game_coords": [
+            4,
+            6
+          ],
+          "adjacent_points": [
+            44,
+            46,
+            35
+          ],
+          "adjacent_hexes": [
+            19,
+            16,
+            15
+          ],
+          "pixel_coords": [
+            422.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 46,
+          "game_coords": [
+            4,
+            7
+          ],
+          "adjacent_points": [
+            45,
+            47,
+            54
+          ],
+          "adjacent_hexes": [
+            19,
+            16
+          ],
+          "pixel_coords": [
+            445,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 47,
+          "game_coords": [
+            4,
+            8
+          ],
+          "adjacent_points": [
+            46,
+            37
+          ],
+          "adjacent_hexes": [
+            16
+          ],
+          "pixel_coords": [
+            490,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 48,
+          "game_coords": [
+            5,
+            0
+          ],
+          "adjacent_points": [
+            49,
+            40
+          ],
+          "adjacent_hexes": [
+            17
+          ],
+          "pixel_coords": [
+            220,
+            377.9422863405995
+          ]
+        },
+        {
+          "point_id": 49,
+          "game_coords": [
+            5,
+            1
+          ],
+          "adjacent_points": [
+            48,
+            50
+          ],
+          "adjacent_hexes": [
+            17
+          ],
+          "pixel_coords": [
+            242.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 50,
+          "game_coords": [
+            5,
+            2
+          ],
+          "adjacent_points": [
+            49,
+            51,
+            42
+          ],
+          "adjacent_hexes": [
+            18,
+            17
+          ],
+          "pixel_coords": [
+            287.5,
+            416.9134295108992
+          ]
+        },
+        {
+          "point_id": 51,
+          "game_coords": [
+            5,
+            3
+          ],
+          "adjacent_points": [
+            50,
+            52
+          ],
+          "adjacent_hexes": [
+            18
+          ],
+          "pixel_coords": [
+            310,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 52,
+          "game_coords": [
+            5,
+            4
+          ],
+          "adjacent_points": [
+            51,
+            53,
+            44
+          ],
+          "adjacent_hexes": [
+            19,
+            18
+          ],
+          "pixel_coords": [
+            355,
+            455.88457268119896
+          ]
+        },
+        {
+          "point_id": 53,
+          "game_coords": [
+            5,
+            5
+          ],
+          "adjacent_points": [
+            52,
+            54
+          ],
+          "adjacent_hexes": [
+            19
+          ],
+          "pixel_coords": [
+            377.5,
+            494.8557158514987
+          ]
+        },
+        {
+          "point_id": 54,
+          "game_coords": [
+            5,
+            6
+          ],
+          "adjacent_points": [
+            53,
+            46
+          ],
+          "adjacent_hexes": [
+            19
+          ],
+          "pixel_coords": [
+            422.5,
+            494.8557158514987
+          ]
+        }
+      ],
+      "board_graph": {
+        "adjacency": {
+          "1": [
+            2,
+            9
+          ],
+          "2": [
+            1,
+            3
+          ],
+          "3": [
+            2,
+            4,
+            11
+          ],
+          "4": [
+            3,
+            5
+          ],
+          "5": [
+            4,
+            6,
+            13
+          ],
+          "6": [
+            5,
+            7
+          ],
+          "7": [
+            6,
+            15
+          ],
+          "8": [
+            9,
+            18
+          ],
+          "9": [
+            8,
+            10,
+            1
+          ],
+          "10": [
+            9,
+            11,
+            20
+          ],
+          "11": [
+            10,
+            12,
+            3
+          ],
+          "12": [
+            11,
+            13,
+            22
+          ],
+          "13": [
+            12,
+            14,
+            5
+          ],
+          "14": [
+            13,
+            15,
+            24
+          ],
+          "15": [
+            14,
+            16,
+            7
+          ],
+          "16": [
+            15,
+            26
+          ],
+          "17": [
+            18,
+            28
+          ],
+          "18": [
+            17,
+            19,
+            8
+          ],
+          "19": [
+            18,
+            20,
+            30
+          ],
+          "20": [
+            19,
+            21,
+            10
+          ],
+          "21": [
+            20,
+            22,
+            32
+          ],
+          "22": [
+            21,
+            23,
+            12
+          ],
+          "23": [
+            22,
+            24,
+            34
+          ],
+          "24": [
+            23,
+            25,
+            14
+          ],
+          "25": [
+            24,
+            26,
+            36
+          ],
+          "26": [
+            25,
+            27,
+            16
+          ],
+          "27": [
+            26,
+            38
+          ],
+          "28": [
+            29,
+            17
+          ],
+          "29": [
+            28,
+            30,
+            39
+          ],
+          "30": [
+            29,
+            31,
+            19
+          ],
+          "31": [
+            30,
+            32,
+            41
+          ],
+          "32": [
+            31,
+            33,
+            21
+          ],
+          "33": [
+            32,
+            34,
+            43
+          ],
+          "34": [
+            33,
+            35,
+            23
+          ],
+          "35": [
+            34,
+            36,
+            45
+          ],
+          "36": [
+            35,
+            37,
+            25
+          ],
+          "37": [
+            36,
+            38,
+            47
+          ],
+          "38": [
+            37,
+            27
+          ],
+          "39": [
+            40,
+            29
+          ],
+          "40": [
+            39,
+            41,
+            48
+          ],
+          "41": [
+            40,
+            42,
+            31
+          ],
+          "42": [
+            41,
+            43,
+            50
+          ],
+          "43": [
+            42,
+            44,
+            33
+          ],
+          "44": [
+            43,
+            45,
+            52
+          ],
+          "45": [
+            44,
+            46,
+            35
+          ],
+          "46": [
+            45,
+            47,
+            54
+          ],
+          "47": [
+            46,
+            37
+          ],
+          "48": [
+            49,
+            40
+          ],
+          "49": [
+            48,
+            50
+          ],
+          "50": [
+            49,
+            51,
+            42
+          ],
+          "51": [
+            50,
+            52
+          ],
+          "52": [
+            51,
+            53,
+            44
+          ],
+          "53": [
+            52,
+            54
+          ],
+          "54": [
+            53,
+            46
+          ]
+        },
+        "hex_to_points": {
+          "1": [
+            1,
+            2,
+            3,
+            9,
+            10,
+            11
+          ],
+          "2": [
+            3,
+            4,
+            5,
+            11,
+            12,
+            13
+          ],
+          "3": [
+            5,
+            6,
+            7,
+            13,
+            14,
+            15
+          ],
+          "4": [
+            8,
+            9,
+            10,
+            18,
+            19,
+            20
+          ],
+          "5": [
+            10,
+            11,
+            12,
+            20,
+            21,
+            22
+          ],
+          "6": [
+            12,
+            13,
+            14,
+            22,
+            23,
+            24
+          ],
+          "7": [
+            14,
+            15,
+            16,
+            24,
+            25,
+            26
+          ],
+          "8": [
+            17,
+            18,
+            19,
+            28,
+            29,
+            30
+          ],
+          "9": [
+            19,
+            20,
+            21,
+            30,
+            31,
+            32
+          ],
+          "10": [
+            21,
+            22,
+            23,
+            32,
+            33,
+            34
+          ],
+          "11": [
+            23,
+            24,
+            25,
+            34,
+            35,
+            36
+          ],
+          "12": [
+            25,
+            26,
+            27,
+            36,
+            37,
+            38
+          ],
+          "13": [
+            29,
+            30,
+            31,
+            39,
+            40,
+            41
+          ],
+          "14": [
+            31,
+            32,
+            33,
+            41,
+            42,
+            43
+          ],
+          "15": [
+            33,
+            34,
+            35,
+            43,
+            44,
+            45
+          ],
+          "16": [
+            35,
+            36,
+            37,
+            45,
+            46,
+            47
+          ],
+          "17": [
+            40,
+            41,
+            42,
+            48,
+            49,
+            50
+          ],
+          "18": [
+            42,
+            43,
+            44,
+            50,
+            51,
+            52
+          ],
+          "19": [
+            44,
+            45,
+            46,
+            52,
+            53,
+            54
+          ]
+        },
+        "total_points": 54,
+        "total_hexes": 19
+      }
+    }
+  ]
+}

examples/ai_testing/play_and_capture.py

@@ -0,0 +1,148 @@
+"""
+Play Interactive Game with Guaranteed State Capture
+----------------------------------------------------
+This version captures EVERY game state update reliably.
+"""
+
+import sys
+from pathlib import Path
+import json
+import signal
+import atexit
+from datetime import datetime
+
+# Add parent directory to path
+sys.path.insert(0, str(Path(__file__).parent.parent.parent))
+
+from pycatan import RealGame
+from pycatan.management import game_manager as gm_module
+
+# Global list to capture states
+captured_states = []
+original_update_state = None
+
+
+def capturing_wrapper(original_method):
+    """Wrap the update_full_state method to capture all calls."""
+    def wrapper(self, game_state=None):
+        # Call original
+        result = original_method(self, game_state)
+        
+        # Capture from web visualization
+        for viz in self.visualizations:
+            if hasattr(viz, 'current_game_state') and viz.current_game_state:
+                state_copy = json.loads(json.dumps(viz.current_game_state))
+                captured_states.append(state_copy)
+                print(f"[Captured state #{len(captured_states)}]", flush=True)
+                break  # Only capture once per update
+        
+        return result
+    return wrapper
+
+
+def save_all_states():
+    """Save all captured states to files."""
+    if not captured_states:
+        print("\n⚠️  No states were captured during this game.")
+        return
+    
+    # Create output directory
+    output_dir = Path('examples/ai_testing/my_games')
+    output_dir.mkdir(exist_ok=True)
+    
+    # Generate timestamp
+    timestamp = datetime.now().strftime('%Y%m%d_%H%M%S')
+    
+    # Save full history
+    history_file = output_dir / f'game_{timestamp}_full.json'
+    with open(history_file, 'w', encoding='utf-8') as f:
+        json.dump({
+            'total_states': len(captured_states),
+            'timestamp': timestamp,
+            'states': captured_states
+        }, f, indent=2, ensure_ascii=False)
+    
+    # Save final state
+    final_file = output_dir / f'game_{timestamp}_final.json'
+    with open(final_file, 'w', encoding='utf-8') as f:
+        json.dump(captured_states[-1], f, indent=2, ensure_ascii=False)
+    
+    # Also save to standard location
+    sample_file = Path('examples/ai_testing/sample_states/captured_game.json')
+    sample_file.parent.mkdir(exist_ok=True)
+    with open(sample_file, 'w', encoding='utf-8') as f:
+        json.dump(captured_states[-1], f, indent=2, ensure_ascii=False)
+    
+    print("\n" + "="*80)
+    print("✅ GAME SAVED SUCCESSFULLY!")
+    print("="*80)
+    print(f"\nTotal states captured: {len(captured_states)}")
+    print(f"\nSaved to:")
+    print(f"  📁 Full history: {history_file}")
+    print(f"  📄 Final state:  {final_file}")
+    print(f"  📌 Quick access: {sample_file}")
+    print("\n" + "="*80)
+    
+    # Print summary
+    if captured_states:
+        final = captured_states[-1]
+        print("\n📊 FINAL GAME STATE:")
+        print(f"  Phase: {final.get('current_phase', 'UNKNOWN')}")
+        print(f"  Settlements: {len(final.get('settlements', []))}")
+        print(f"  Cities: {len(final.get('cities', []))}")
+        print(f"  Roads: {len(final.get('roads', []))}")
+        
+        for player in final.get('players', []):
+            print(f"\n  Player {player['id']} ({player['name']}):")
+            print(f"    Victory Points: {player['victory_points']}")
+            print(f"    Resources: {len(player.get('cards_list', []))}")
+            print(f"    Settlements: {player['settlements']}")
+            print(f"    Roads: {player['roads']}")
+        
+        print("="*80)
+
+
+# Register save function
+atexit.register(save_all_states)
+
+
+def signal_handler(sig, frame):
+    """Handle Ctrl+C gracefully."""
+    print("\n\n🛑 Game interrupted...")
+    sys.exit(0)
+
+
+signal.signal(signal.SIGINT, signal_handler)
+
+
+def main():
+    print("="*80)
+    print("🎮 CATAN WITH GUARANTEED STATE CAPTURE")
+    print("="*80)
+    print("\nEvery game action will be automatically saved!")
+    print("Press Ctrl+C anytime to stop and save.")
+    print("="*80 + "\n")
+    
+    # Patch the VisualizationManager's update_full_state
+    from pycatan.visualizations.visualization import VisualizationManager
+    VisualizationManager.update_full_state = capturing_wrapper(
+        VisualizationManager.update_full_state
+    )
+    
+    try:
+        # Start game
+        game = RealGame()
+        game.run()
+        
+    except KeyboardInterrupt:
+        print("\n\n✅ Game stopped")
+    except EOFError:
+        print("\n\n✅ Game completed")
+    except Exception as e:
+        print(f"\n\n❌ Error: {e}")
+        import traceback
+        traceback.print_exc()
+
+
+if __name__ == '__main__':
+    main()

examples/ai_testing/play_and_save.py

@@ -0,0 +1,179 @@
+"""
+Play Interactive Game and Auto-Save States
+-------------------------------------------
+Play Catan interactively in your browser, and all states
+are automatically captured and saved to JSON files.
+
+Usage:
+    python examples/ai_testing/play_and_save.py
+"""
+
+import sys
+from pathlib import Path
+import json
+import signal
+import atexit
+
+# Add parent directory to path
+sys.path.insert(0, str(Path(__file__).parent.parent.parent))
+
+from pycatan import RealGame
+from pycatan.visualizations.web_visualization import WebVisualization
+
+# Global list to capture states
+captured_states = []
+game_active = False
+
+# Store original functions
+original_web_update = WebVisualization.update_full_state
+original_display_action = None
+
+try:
+    from pycatan.management.game_manager import GameManager
+    original_display_action = GameManager.display_action
+except:
+    pass
+
+
+def capturing_update(self, game_state):
+    """Capture all state updates automatically."""
+    global captured_states
+    
+    # Call original function
+    original_web_update(self, game_state)
+    
+    # Capture the state
+    if hasattr(self, 'current_game_state') and self.current_game_state:
+        state_copy = json.loads(json.dumps(self.current_game_state))
+        captured_states.append(state_copy)
+        
+        # Print notification (less verbose)
+        if len(captured_states) % 5 == 0 or len(captured_states) == 1:
+            print(f"[Captured {len(captured_states)} states so far...]", flush=True)
+
+
+def capturing_display_action(self, action, result=None):
+    """Hook into display_action to capture after each action."""
+    # Call original
+    if original_display_action:
+        original_display_action(self, action, result)
+    
+    # Force a state capture by updating all visualizations
+    if hasattr(self, 'visualization_manager'):
+        try:
+            self.visualization_manager.update_full_state(self.game.get_state())
+        except:
+            pass
+
+
+def save_all_states():
+    """Save all captured states to files."""
+    if not captured_states:
+        print("\n⚠️  No states were captured during this game.")
+        return
+    
+    # Create output directory
+    output_dir = Path('examples/ai_testing/my_games')
+    output_dir.mkdir(exist_ok=True)
+    
+    # Generate timestamp for unique filename
+    from datetime import datetime
+    timestamp = datetime.now().strftime('%Y%m%d_%H%M%S')
+    
+    # Save full game history
+    history_file = output_dir / f'game_{timestamp}_full.json'
+    with open(history_file, 'w', encoding='utf-8') as f:
+        json.dump({
+            'total_states': len(captured_states),
+            'timestamp': timestamp,
+            'states': captured_states
+        }, f, indent=2, ensure_ascii=False)
+    
+    # Save just the final state
+    final_file = output_dir / f'game_{timestamp}_final.json'
+    with open(final_file, 'w', encoding='utf-8') as f:
+        json.dump(captured_states[-1], f, indent=2, ensure_ascii=False)
+    
+    # Also save to standard location
+    sample_file = Path('examples/ai_testing/sample_states/captured_game.json')
+    sample_file.parent.mkdir(exist_ok=True)
+    with open(sample_file, 'w', encoding='utf-8') as f:
+        json.dump(captured_states[-1], f, indent=2, ensure_ascii=False)
+    
+    print("\n" + "="*80)
+    print("✅ GAME SAVED SUCCESSFULLY!")
+    print("="*80)
+    print(f"\nTotal states captured: {len(captured_states)}")
+    print(f"\nSaved to:")
+    print(f"  📁 Full game history: {history_file}")
+    print(f"  📄 Final state:       {final_file}")
+    print(f"  📌 Standard location: {sample_file}")
+    print("\n" + "="*80)
+    
+    # Print summary
+    if captured_states:
+        final_state = captured_states[-1]
+        print("\n📊 FINAL GAME STATE:")
+        print(f"  Current Phase: {final_state.get('current_phase', 'UNKNOWN')}")
+        print(f"  Settlements: {len(final_state.get('settlements', []))}")
+        print(f"  Cities: {len(final_state.get('cities', []))}")
+        print(f"  Roads: {len(final_state.get('roads', []))}")
+        print(f"  Players: {len(final_state.get('players', []))}")
+        print("="*80)
+
+
+# Register save function to run on exit
+atexit.register(save_all_states)
+
+
+def signal_handler(sig, frame):
+    """Handle Ctrl+C gracefully."""
+    print("\n\n🛑 Game interrupted by user...")
+    save_all_states()
+    sys.exit(0)
+
+
+# Register signal handler
+signal.signal(signal.SIGINT, signal_handler)
+
+
+def main():
+    global game_active
+    
+    print("="*80)
+    print("🎮 INTERACTIVE CATAN WITH AUTO-SAVE")
+    print("="*80)
+    print("\nPlay the game normally in your browser.")
+    print("All states will be automatically captured and saved!")
+    print("\nPress Ctrl+C at any time to stop and save.")
+    print("="*80 + "\n")
+    
+    # Apply the patches
+    WebVisualization.update_full_state = capturing_update
+    
+    # Also patch GameManager if available
+    if original_display_action:
+        from pycatan.management.game_manager import GameManager
+        GameManager.display_action = capturing_display_action
+    
+    try:
+        # Start the game
+        game_active = True
+        game = RealGame()
+        game.run()
+        
+    except KeyboardInterrupt:
+        print("\n\n🛑 Game stopped by user")
+    except EOFError:
+        print("\n\n✅ Game completed")
+    except Exception as e:
+        print(f"\n\n❌ Error: {e}")
+        import traceback
+        traceback.print_exc()
+    finally:
+        game_active = False
+        # save_all_states() will be called by atexit
+
+
+if __name__ == '__main__':
+    main()

examples/ai_testing/sample_states/captured_game.json

@@ -0,0 +1,1850 @@
+{
+  "hexes": [
+    {
+      "id": 1,
+      "q": 0,
+      "r": -2,
+      "type": "wood",
+      "number": 12,
+      "has_robber": false,
+      "position": [
+        0,
+        0
+      ],
+      "axial_coords": [
+        0,
+        -2
+      ]
+    },
+    {
+      "id": 2,
+      "q": 1,
+      "r": -2,
+      "type": "sheep",
+      "number": 5,
+      "has_robber": false,
+      "position": [
+        0,
+        1
+      ],
+      "axial_coords": [
+        1,
+        -2
+      ]
+    },
+    {
+      "id": 3,
+      "q": 2,
+      "r": -2,
+      "type": "wood",
+      "number": 4,
+      "has_robber": false,
+      "position": [
+        0,
+        2
+      ],
+      "axial_coords": [
+        2,
+        -2
+      ]
+    },
+    {
+      "id": 4,
+      "q": -1,
+      "r": -1,
+      "type": "sheep",
+      "number": 8,
+      "has_robber": false,
+      "position": [
+        1,
+        0
+      ],
+      "axial_coords": [
+        -1,
+        -1
+      ]
+    },
+    {
+      "id": 5,
+      "q": 0,
+      "r": -1,
+      "type": "brick",
+      "number": 6,
+      "has_robber": false,
+      "position": [
+        1,
+        1
+      ],
+      "axial_coords": [
+        0,
+        -1
+      ]
+    },
+    {
+      "id": 6,
+      "q": 1,
+      "r": -1,
+      "type": "wood",
+      "number": 3,
+      "has_robber": false,
+      "position": [
+        1,
+        2
+      ],
+      "axial_coords": [
+        1,
+        -1
+      ]
+    },
+    {
+      "id": 7,
+      "q": 2,
+      "r": -1,
+      "type": "wheat",
+      "number": 8,
+      "has_robber": false,
+      "position": [
+        1,
+        3
+      ],
+      "axial_coords": [
+        2,
+        -1
+      ]
+    },
+    {
+      "id": 8,
+      "q": -2,
+      "r": 0,
+      "type": "brick",
+      "number": 10,
+      "has_robber": false,
+      "position": [
+        2,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        0
+      ]
+    },
+    {
+      "id": 9,
+      "q": -1,
+      "r": 0,
+      "type": "wood",
+      "number": 11,
+      "has_robber": false,
+      "position": [
+        2,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        0
+      ]
+    },
+    {
+      "id": 10,
+      "q": 0,
+      "r": 0,
+      "type": "desert",
+      "number": null,
+      "has_robber": true,
+      "position": [
+        2,
+        2
+      ],
+      "axial_coords": [
+        0,
+        0
+      ]
+    },
+    {
+      "id": 11,
+      "q": 1,
+      "r": 0,
+      "type": "ore",
+      "number": 3,
+      "has_robber": false,
+      "position": [
+        2,
+        3
+      ],
+      "axial_coords": [
+        1,
+        0
+      ]
+    },
+    {
+      "id": 12,
+      "q": 2,
+      "r": 0,
+      "type": "sheep",
+      "number": 4,
+      "has_robber": false,
+      "position": [
+        2,
+        4
+      ],
+      "axial_coords": [
+        2,
+        0
+      ]
+    },
+    {
+      "id": 13,
+      "q": -2,
+      "r": 1,
+      "type": "brick",
+      "number": 10,
+      "has_robber": false,
+      "position": [
+        3,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        1
+      ]
+    },
+    {
+      "id": 14,
+      "q": -1,
+      "r": 1,
+      "type": "wheat",
+      "number": 9,
+      "has_robber": false,
+      "position": [
+        3,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        1
+      ]
+    },
+    {
+      "id": 15,
+      "q": 0,
+      "r": 1,
+      "type": "wheat",
+      "number": 6,
+      "has_robber": false,
+      "position": [
+        3,
+        2
+      ],
+      "axial_coords": [
+        0,
+        1
+      ]
+    },
+    {
+      "id": 16,
+      "q": 1,
+      "r": 1,
+      "type": "sheep",
+      "number": 11,
+      "has_robber": false,
+      "position": [
+        3,
+        3
+      ],
+      "axial_coords": [
+        1,
+        1
+      ]
+    },
+    {
+      "id": 17,
+      "q": -2,
+      "r": 2,
+      "type": "ore",
+      "number": 5,
+      "has_robber": false,
+      "position": [
+        4,
+        0
+      ],
+      "axial_coords": [
+        -2,
+        2
+      ]
+    },
+    {
+      "id": 18,
+      "q": -1,
+      "r": 2,
+      "type": "wheat",
+      "number": 9,
+      "has_robber": false,
+      "position": [
+        4,
+        1
+      ],
+      "axial_coords": [
+        -1,
+        2
+      ]
+    },
+    {
+      "id": 19,
+      "q": 0,
+      "r": 2,
+      "type": "ore",
+      "number": 2,
+      "has_robber": false,
+      "position": [
+        4,
+        2
+      ],
+      "axial_coords": [
+        0,
+        2
+      ]
+    }
+  ],
+  "settlements": [],
+  "cities": [],
+  "roads": [],
+  "players": [
+    {
+      "id": 0,
+      "name": "A",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    },
+    {
+      "id": 1,
+      "name": "B",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    },
+    {
+      "id": 2,
+      "name": "C",
+      "victory_points": 0,
+      "total_cards": 0,
+      "cards_list": [],
+      "dev_cards_list": [],
+      "settlements": 0,
+      "cities": 0,
+      "roads": 0,
+      "longest_road": 0,
+      "has_longest_road": false,
+      "knights": 0,
+      "knights_played": 0,
+      "has_largest_army": false
+    }
+  ],
+  "current_player": 0,
+  "current_phase": "SETUP_FIRST_ROUND",
+  "robber_position": [
+    2,
+    2
+  ],
+  "dice_result": null,
+  "points": [
+    {
+      "point_id": 1,
+      "game_coords": [
+        0,
+        0
+      ],
+      "adjacent_points": [
+        2,
+        9
+      ],
+      "adjacent_hexes": [
+        1
+      ],
+      "pixel_coords": [
+        377.5,
+        105.14428414850131
+      ]
+    },
+    {
+      "point_id": 2,
+      "game_coords": [
+        0,
+        1
+      ],
+      "adjacent_points": [
+        1,
+        3
+      ],
+      "adjacent_hexes": [
+        1
+      ],
+      "pixel_coords": [
+        422.5,
+        105.14428414850128
+      ]
+    },
+    {
+      "point_id": 3,
+      "game_coords": [
+        0,
+        2
+      ],
+      "adjacent_points": [
+        2,
+        4,
+        11
+      ],
+      "adjacent_hexes": [
+        2,
+        1
+      ],
+      "pixel_coords": [
+        445,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 4,
+      "game_coords": [
+        0,
+        3
+      ],
+      "adjacent_points": [
+        3,
+        5
+      ],
+      "adjacent_hexes": [
+        2
+      ],
+      "pixel_coords": [
+        490,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 5,
+      "game_coords": [
+        0,
+        4
+      ],
+      "adjacent_points": [
+        4,
+        6,
+        13
+      ],
+      "adjacent_hexes": [
+        3,
+        2
+      ],
+      "pixel_coords": [
+        512.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 6,
+      "game_coords": [
+        0,
+        5
+      ],
+      "adjacent_points": [
+        5,
+        7
+      ],
+      "adjacent_hexes": [
+        3
+      ],
+      "pixel_coords": [
+        557.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 7,
+      "game_coords": [
+        0,
+        6
+      ],
+      "adjacent_points": [
+        6,
+        15
+      ],
+      "adjacent_hexes": [
+        3
+      ],
+      "pixel_coords": [
+        580,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 8,
+      "game_coords": [
+        1,
+        0
+      ],
+      "adjacent_points": [
+        9,
+        18
+      ],
+      "adjacent_hexes": [
+        4
+      ],
+      "pixel_coords": [
+        310,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 9,
+      "game_coords": [
+        1,
+        1
+      ],
+      "adjacent_points": [
+        8,
+        10,
+        1
+      ],
+      "adjacent_hexes": [
+        4,
+        1
+      ],
+      "pixel_coords": [
+        355,
+        144.11542731880104
+      ]
+    },
+    {
+      "point_id": 10,
+      "game_coords": [
+        1,
+        2
+      ],
+      "adjacent_points": [
+        9,
+        11,
+        20
+      ],
+      "adjacent_hexes": [
+        5,
+        4,
+        1
+      ],
+      "pixel_coords": [
+        377.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 11,
+      "game_coords": [
+        1,
+        3
+      ],
+      "adjacent_points": [
+        10,
+        12,
+        3
+      ],
+      "adjacent_hexes": [
+        5,
+        2,
+        1
+      ],
+      "pixel_coords": [
+        422.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 12,
+      "game_coords": [
+        1,
+        4
+      ],
+      "adjacent_points": [
+        11,
+        13,
+        22
+      ],
+      "adjacent_hexes": [
+        6,
+        5,
+        2
+      ],
+      "pixel_coords": [
+        445,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 13,
+      "game_coords": [
+        1,
+        5
+      ],
+      "adjacent_points": [
+        12,
+        14,
+        5
+      ],
+      "adjacent_hexes": [
+        6,
+        3,
+        2
+      ],
+      "pixel_coords": [
+        490,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 14,
+      "game_coords": [
+        1,
+        6
+      ],
+      "adjacent_points": [
+        13,
+        15,
+        24
+      ],
+      "adjacent_hexes": [
+        7,
+        6,
+        3
+      ],
+      "pixel_coords": [
+        512.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 15,
+      "game_coords": [
+        1,
+        7
+      ],
+      "adjacent_points": [
+        14,
+        16,
+        7
+      ],
+      "adjacent_hexes": [
+        7,
+        3
+      ],
+      "pixel_coords": [
+        557.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 16,
+      "game_coords": [
+        1,
+        8
+      ],
+      "adjacent_points": [
+        15,
+        26
+      ],
+      "adjacent_hexes": [
+        7
+      ],
+      "pixel_coords": [
+        580,
+        300
+      ]
+    },
+    {
+      "point_id": 17,
+      "game_coords": [
+        2,
+        0
+      ],
+      "adjacent_points": [
+        18,
+        28
+      ],
+      "adjacent_hexes": [
+        8
+      ],
+      "pixel_coords": [
+        242.49999999999997,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 18,
+      "game_coords": [
+        2,
+        1
+      ],
+      "adjacent_points": [
+        17,
+        19,
+        8
+      ],
+      "adjacent_hexes": [
+        8,
+        4
+      ],
+      "pixel_coords": [
+        287.5,
+        183.08657048910078
+      ]
+    },
+    {
+      "point_id": 19,
+      "game_coords": [
+        2,
+        2
+      ],
+      "adjacent_points": [
+        18,
+        20,
+        30
+      ],
+      "adjacent_hexes": [
+        9,
+        8,
+        4
+      ],
+      "pixel_coords": [
+        310,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 20,
+      "game_coords": [
+        2,
+        3
+      ],
+      "adjacent_points": [
+        19,
+        21,
+        10
+      ],
+      "adjacent_hexes": [
+        9,
+        5,
+        4
+      ],
+      "pixel_coords": [
+        355,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 21,
+      "game_coords": [
+        2,
+        4
+      ],
+      "adjacent_points": [
+        20,
+        22,
+        32
+      ],
+      "adjacent_hexes": [
+        10,
+        9,
+        5
+      ],
+      "pixel_coords": [
+        377.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 22,
+      "game_coords": [
+        2,
+        5
+      ],
+      "adjacent_points": [
+        21,
+        23,
+        12
+      ],
+      "adjacent_hexes": [
+        10,
+        6,
+        5
+      ],
+      "pixel_coords": [
+        422.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 23,
+      "game_coords": [
+        2,
+        6
+      ],
+      "adjacent_points": [
+        22,
+        24,
+        34
+      ],
+      "adjacent_hexes": [
+        11,
+        10,
+        6
+      ],
+      "pixel_coords": [
+        445,
+        300
+      ]
+    },
+    {
+      "point_id": 24,
+      "game_coords": [
+        2,
+        7
+      ],
+      "adjacent_points": [
+        23,
+        25,
+        14
+      ],
+      "adjacent_hexes": [
+        11,
+        7,
+        6
+      ],
+      "pixel_coords": [
+        490,
+        300
+      ]
+    },
+    {
+      "point_id": 25,
+      "game_coords": [
+        2,
+        8
+      ],
+      "adjacent_points": [
+        24,
+        26,
+        36
+      ],
+      "adjacent_hexes": [
+        12,
+        11,
+        7
+      ],
+      "pixel_coords": [
+        512.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 26,
+      "game_coords": [
+        2,
+        9
+      ],
+      "adjacent_points": [
+        25,
+        27,
+        16
+      ],
+      "adjacent_hexes": [
+        12,
+        7
+      ],
+      "pixel_coords": [
+        557.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 27,
+      "game_coords": [
+        2,
+        10
+      ],
+      "adjacent_points": [
+        26,
+        38
+      ],
+      "adjacent_hexes": [
+        12
+      ],
+      "pixel_coords": [
+        580,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 28,
+      "game_coords": [
+        3,
+        0
+      ],
+      "adjacent_points": [
+        29,
+        17
+      ],
+      "adjacent_hexes": [
+        8
+      ],
+      "pixel_coords": [
+        220,
+        222.05771365940052
+      ]
+    },
+    {
+      "point_id": 29,
+      "game_coords": [
+        3,
+        1
+      ],
+      "adjacent_points": [
+        28,
+        30,
+        39
+      ],
+      "adjacent_hexes": [
+        13,
+        8
+      ],
+      "pixel_coords": [
+        242.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 30,
+      "game_coords": [
+        3,
+        2
+      ],
+      "adjacent_points": [
+        29,
+        31,
+        19
+      ],
+      "adjacent_hexes": [
+        13,
+        9,
+        8
+      ],
+      "pixel_coords": [
+        287.5,
+        261.02885682970026
+      ]
+    },
+    {
+      "point_id": 31,
+      "game_coords": [
+        3,
+        3
+      ],
+      "adjacent_points": [
+        30,
+        32,
+        41
+      ],
+      "adjacent_hexes": [
+        14,
+        13,
+        9
+      ],
+      "pixel_coords": [
+        310,
+        300
+      ]
+    },
+    {
+      "point_id": 32,
+      "game_coords": [
+        3,
+        4
+      ],
+      "adjacent_points": [
+        31,
+        33,
+        21
+      ],
+      "adjacent_hexes": [
+        14,
+        10,
+        9
+      ],
+      "pixel_coords": [
+        355,
+        300
+      ]
+    },
+    {
+      "point_id": 33,
+      "game_coords": [
+        3,
+        5
+      ],
+      "adjacent_points": [
+        32,
+        34,
+        43
+      ],
+      "adjacent_hexes": [
+        15,
+        14,
+        10
+      ],
+      "pixel_coords": [
+        377.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 34,
+      "game_coords": [
+        3,
+        6
+      ],
+      "adjacent_points": [
+        33,
+        35,
+        23
+      ],
+      "adjacent_hexes": [
+        15,
+        11,
+        10
+      ],
+      "pixel_coords": [
+        422.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 35,
+      "game_coords": [
+        3,
+        7
+      ],
+      "adjacent_points": [
+        34,
+        36,
+        45
+      ],
+      "adjacent_hexes": [
+        16,
+        15,
+        11
+      ],
+      "pixel_coords": [
+        445,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 36,
+      "game_coords": [
+        3,
+        8
+      ],
+      "adjacent_points": [
+        35,
+        37,
+        25
+      ],
+      "adjacent_hexes": [
+        16,
+        12,
+        11
+      ],
+      "pixel_coords": [
+        490,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 37,
+      "game_coords": [
+        3,
+        9
+      ],
+      "adjacent_points": [
+        36,
+        38,
+        47
+      ],
+      "adjacent_hexes": [
+        16,
+        12
+      ],
+      "pixel_coords": [
+        512.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 38,
+      "game_coords": [
+        3,
+        10
+      ],
+      "adjacent_points": [
+        37,
+        27
+      ],
+      "adjacent_hexes": [
+        12
+      ],
+      "pixel_coords": [
+        557.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 39,
+      "game_coords": [
+        4,
+        0
+      ],
+      "adjacent_points": [
+        40,
+        29
+      ],
+      "adjacent_hexes": [
+        13
+      ],
+      "pixel_coords": [
+        220,
+        300
+      ]
+    },
+    {
+      "point_id": 40,
+      "game_coords": [
+        4,
+        1
+      ],
+      "adjacent_points": [
+        39,
+        41,
+        48
+      ],
+      "adjacent_hexes": [
+        17,
+        13
+      ],
+      "pixel_coords": [
+        242.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 41,
+      "game_coords": [
+        4,
+        2
+      ],
+      "adjacent_points": [
+        40,
+        42,
+        31
+      ],
+      "adjacent_hexes": [
+        17,
+        14,
+        13
+      ],
+      "pixel_coords": [
+        287.5,
+        338.97114317029974
+      ]
+    },
+    {
+      "point_id": 42,
+      "game_coords": [
+        4,
+        3
+      ],
+      "adjacent_points": [
+        41,
+        43,
+        50
+      ],
+      "adjacent_hexes": [
+        18,
+        17,
+        14
+      ],
+      "pixel_coords": [
+        310,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 43,
+      "game_coords": [
+        4,
+        4
+      ],
+      "adjacent_points": [
+        42,
+        44,
+        33
+      ],
+      "adjacent_hexes": [
+        18,
+        15,
+        14
+      ],
+      "pixel_coords": [
+        355,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 44,
+      "game_coords": [
+        4,
+        5
+      ],
+      "adjacent_points": [
+        43,
+        45,
+        52
+      ],
+      "adjacent_hexes": [
+        19,
+        18,
+        15
+      ],
+      "pixel_coords": [
+        377.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 45,
+      "game_coords": [
+        4,
+        6
+      ],
+      "adjacent_points": [
+        44,
+        46,
+        35
+      ],
+      "adjacent_hexes": [
+        19,
+        16,
+        15
+      ],
+      "pixel_coords": [
+        422.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 46,
+      "game_coords": [
+        4,
+        7
+      ],
+      "adjacent_points": [
+        45,
+        47,
+        54
+      ],
+      "adjacent_hexes": [
+        19,
+        16
+      ],
+      "pixel_coords": [
+        445,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 47,
+      "game_coords": [
+        4,
+        8
+      ],
+      "adjacent_points": [
+        46,
+        37
+      ],
+      "adjacent_hexes": [
+        16
+      ],
+      "pixel_coords": [
+        490,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 48,
+      "game_coords": [
+        5,
+        0
+      ],
+      "adjacent_points": [
+        49,
+        40
+      ],
+      "adjacent_hexes": [
+        17
+      ],
+      "pixel_coords": [
+        220,
+        377.9422863405995
+      ]
+    },
+    {
+      "point_id": 49,
+      "game_coords": [
+        5,
+        1
+      ],
+      "adjacent_points": [
+        48,
+        50
+      ],
+      "adjacent_hexes": [
+        17
+      ],
+      "pixel_coords": [
+        242.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 50,
+      "game_coords": [
+        5,
+        2
+      ],
+      "adjacent_points": [
+        49,
+        51,
+        42
+      ],
+      "adjacent_hexes": [
+        18,
+        17
+      ],
+      "pixel_coords": [
+        287.5,
+        416.9134295108992
+      ]
+    },
+    {
+      "point_id": 51,
+      "game_coords": [
+        5,
+        3
+      ],
+      "adjacent_points": [
+        50,
+        52
+      ],
+      "adjacent_hexes": [
+        18
+      ],
+      "pixel_coords": [
+        310,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 52,
+      "game_coords": [
+        5,
+        4
+      ],
+      "adjacent_points": [
+        51,
+        53,
+        44
+      ],
+      "adjacent_hexes": [
+        19,
+        18
+      ],
+      "pixel_coords": [
+        355,
+        455.88457268119896
+      ]
+    },
+    {
+      "point_id": 53,
+      "game_coords": [
+        5,
+        5
+      ],
+      "adjacent_points": [
+        52,
+        54
+      ],
+      "adjacent_hexes": [
+        19
+      ],
+      "pixel_coords": [
+        377.5,
+        494.8557158514987
+      ]
+    },
+    {
+      "point_id": 54,
+      "game_coords": [
+        5,
+        6
+      ],
+      "adjacent_points": [
+        53,
+        46
+      ],
+      "adjacent_hexes": [
+        19
+      ],
+      "pixel_coords": [
+        422.5,
+        494.8557158514987
+      ]
+    }
+  ],
+  "board_graph": {
+    "adjacency": {
+      "1": [
+        2,
+        9
+      ],
+      "2": [
+        1,
+        3
+      ],
+      "3": [
+        2,
+        4,
+        11
+      ],
+      "4": [
+        3,
+        5
+      ],
+      "5": [
+        4,
+        6,
+        13
+      ],
+      "6": [
+        5,
+        7
+      ],
+      "7": [
+        6,
+        15
+      ],
+      "8": [
+        9,
+        18
+      ],
+      "9": [
+        8,
+        10,
+        1
+      ],
+      "10": [
+        9,
+        11,
+        20
+      ],
+      "11": [
+        10,
+        12,
+        3
+      ],
+      "12": [
+        11,
+        13,
+        22
+      ],
+      "13": [
+        12,
+        14,
+        5
+      ],
+      "14": [
+        13,
+        15,
+        24
+      ],
+      "15": [
+        14,
+        16,
+        7
+      ],
+      "16": [
+        15,
+        26
+      ],
+      "17": [
+        18,
+        28
+      ],
+      "18": [
+        17,
+        19,
+        8
+      ],
+      "19": [
+        18,
+        20,
+        30
+      ],
+      "20": [
+        19,
+        21,
+        10
+      ],
+      "21": [
+        20,
+        22,
+        32
+      ],
+      "22": [
+        21,
+        23,
+        12
+      ],
+      "23": [
+        22,
+        24,
+        34
+      ],
+      "24": [
+        23,
+        25,
+        14
+      ],
+      "25": [
+        24,
+        26,
+        36
+      ],
+      "26": [
+        25,
+        27,
+        16
+      ],
+      "27": [
+        26,
+        38
+      ],
+      "28": [
+        29,
+        17
+      ],
+      "29": [
+        28,
+        30,
+        39
+      ],
+      "30": [
+        29,
+        31,
+        19
+      ],
+      "31": [
+        30,
+        32,
+        41
+      ],
+      "32": [
+        31,
+        33,
+        21
+      ],
+      "33": [
+        32,
+        34,
+        43
+      ],
+      "34": [
+        33,
+        35,
+        23
+      ],
+      "35": [
+        34,
+        36,
+        45
+      ],
+      "36": [
+        35,
+        37,
+        25
+      ],
+      "37": [
+        36,
+        38,
+        47
+      ],
+      "38": [
+        37,
+        27
+      ],
+      "39": [
+        40,
+        29
+      ],
+      "40": [
+        39,
+        41,
+        48
+      ],
+      "41": [
+        40,
+        42,
+        31
+      ],
+      "42": [
+        41,
+        43,
+        50
+      ],
+      "43": [
+        42,
+        44,
+        33
+      ],
+      "44": [
+        43,
+        45,
+        52
+      ],
+      "45": [
+        44,
+        46,
+        35
+      ],
+      "46": [
+        45,
+        47,
+        54
+      ],
+      "47": [
+        46,
+        37
+      ],
+      "48": [
+        49,
+        40
+      ],
+      "49": [
+        48,
+        50
+      ],
+      "50": [
+        49,
+        51,
+        42
+      ],
+      "51": [
+        50,
+        52
+      ],
+      "52": [
+        51,
+        53,
+        44
+      ],
+      "53": [
+        52,
+        54
+      ],
+      "54": [
+        53,
+        46
+      ]
+    },
+    "hex_to_points": {
+      "1": [
+        1,
+        2,
+        3,
+        9,
+        10,
+        11
+      ],
+      "2": [
+        3,
+        4,
+        5,
+        11,
+        12,
+        13
+      ],
+      "3": [
+        5,
+        6,
+        7,
+        13,
+        14,
+        15
+      ],
+      "4": [
+        8,
+        9,
+        10,
+        18,
+        19,
+        20
+      ],
+      "5": [
+        10,
+        11,
+        12,
+        20,
+        21,
+        22
+      ],
+      "6": [
+        12,
+        13,
+        14,
+        22,
+        23,
+        24
+      ],
+      "7": [
+        14,
+        15,
+        16,
+        24,
+        25,
+        26
+      ],
+      "8": [
+        17,
+        18,
+        19,
+        28,
+        29,
+        30
+      ],
+      "9": [
+        19,
+        20,
+        21,
+        30,
+        31,
+        32
+      ],
+      "10": [
+        21,
+        22,
+        23,
+        32,
+        33,
+        34
+      ],
+      "11": [
+        23,
+        24,
+        25,
+        34,
+        35,
+        36
+      ],
+      "12": [
+        25,
+        26,
+        27,
+        36,
+        37,
+        38
+      ],
+      "13": [
+        29,
+        30,
+        31,
+        39,
+        40,
+        41
+      ],
+      "14": [
+        31,
+        32,
+        33,
+        41,
+        42,
+        43
+      ],
+      "15": [
+        33,
+        34,
+        35,
+        43,
+        44,
+        45
+      ],
+      "16": [
+        35,
+        36,
+        37,
+        45,
+        46,
+        47
+      ],
+      "17": [
+        40,
+        41,
+        42,
+        48,
+        49,
+        50
+      ],
+      "18": [
+        42,
+        43,
+        44,
+        50,
+        51,
+        52
+      ],
+      "19": [
+        44,
+        45,
+        46,
+        52,
+        53,
+        54
+      ]
+    },
+    "total_points": 54,
+    "total_hexes": 19
+  }
+}

examples/ai_testing/sample_states/early_game.json

@@ -0,0 +1,91 @@
+{
+  "game_id": "early_game",
+  "turn_number": 1,
+  "current_player": 0,
+  "game_phase": "NORMAL_PLAY",
+  "turn_phase": "PLAYER_ACTIONS",
+  "dice_rolled": [3, 4],
+  "board_state": {
+    "tiles": [
+      {"coords": [0, 0], "type": "HILLS", "number": 3, "has_robber": false},
+      {"coords": [0, 1], "type": "PASTURE", "number": 6, "has_robber": false},
+      {"coords": [0, 2], "type": "MOUNTAINS", "number": 5, "has_robber": false},
+      {"coords": [1, 0], "type": "FIELDS", "number": 4, "has_robber": false},
+      {"coords": [1, 1], "type": "FOREST", "number": 11, "has_robber": false},
+      {"coords": [1, 2], "type": "PASTURE", "number": 12, "has_robber": false},
+      {"coords": [1, 3], "type": "FIELDS", "number": 9, "has_robber": false},
+      {"coords": [2, 0], "type": "FOREST", "number": 8, "has_robber": false},
+      {"coords": [2, 1], "type": "DESERT", "number": null, "has_robber": true},
+      {"coords": [2, 2], "type": "FOREST", "number": 10, "has_robber": false},
+      {"coords": [2, 3], "type": "MOUNTAINS", "number": 9, "has_robber": false},
+      {"coords": [3, 0], "type": "HILLS", "number": 11, "has_robber": false},
+      {"coords": [3, 1], "type": "FIELDS", "number": 2, "has_robber": false},
+      {"coords": [3, 2], "type": "PASTURE", "number": 6, "has_robber": false},
+      {"coords": [4, 0], "type": "PASTURE", "number": 4, "has_robber": false},
+      {"coords": [4, 1], "type": "FIELDS", "number": 5, "has_robber": false},
+      {"coords": [4, 2], "type": "MOUNTAINS", "number": 10, "has_robber": false}
+    ],
+    "robber_position": [2, 1],
+    "harbors": [],
+    "buildings": {
+      "[0, 0]": {"type": "SETTLEMENT", "owner": 0},
+      "[1, 5]": {"type": "SETTLEMENT", "owner": 1},
+      "[3, 2]": {"type": "SETTLEMENT", "owner": 2},
+      "[4, 1]": {"type": "SETTLEMENT", "owner": 0},
+      "[2, 4]": {"type": "SETTLEMENT", "owner": 1},
+      "[5, 3]": {"type": "SETTLEMENT", "owner": 2}
+    },
+    "roads": [
+      {"start": [0, 0], "end": [1, 0], "owner": 0},
+      {"start": [1, 5], "end": [2, 5], "owner": 1},
+      {"start": [3, 2], "end": [4, 2], "owner": 2},
+      {"start": [4, 1], "end": [5, 1], "owner": 0},
+      {"start": [2, 4], "end": [3, 4], "owner": 1},
+      {"start": [5, 3], "end": [6, 3], "owner": 2}
+    ]
+  },
+  "players_state": [
+    {
+      "player_id": 0,
+      "name": "Player 0 (Red)",
+      "cards": ["WOOD", "WOOD", "BRICK", "WHEAT"],
+      "dev_cards": [],
+      "settlements": [[0, 0], [4, 1]],
+      "cities": [],
+      "roads": [[[0, 0], [1, 0]], [[4, 1], [5, 1]]],
+      "victory_points": 2,
+      "longest_road_length": 1,
+      "has_longest_road": false,
+      "has_largest_army": false,
+      "knights_played": 0
+    },
+    {
+      "player_id": 1,
+      "name": "Player 1 (Blue)",
+      "cards": ["SHEEP", "WHEAT", "ORE"],
+      "dev_cards": [],
+      "settlements": [[1, 5], [2, 4]],
+      "cities": [],
+      "roads": [[[1, 5], [2, 5]], [[2, 4], [3, 4]]],
+      "victory_points": 2,
+      "longest_road_length": 1,
+      "has_longest_road": false,
+      "has_largest_army": false,
+      "knights_played": 0
+    },
+    {
+      "player_id": 2,
+      "name": "Player 2 (Green)",
+      "cards": ["WOOD", "BRICK", "SHEEP"],
+      "dev_cards": [],
+      "settlements": [[3, 2], [5, 3]],
+      "cities": [],
+      "roads": [[[3, 2], [4, 2]], [[5, 3], [6, 3]]],
+      "victory_points": 2,
+      "longest_road_length": 1,
+      "has_longest_road": false,
+      "has_largest_army": false,
+      "knights_played": 0
+    }
+  ]
+}

examples/ai_testing/sample_states/mid_game_competitive.json

@@ -0,0 +1,115 @@
+{
+  "game_id": "mid_game_competitive",
+  "turn_number": 15,
+  "current_player": 1,
+  "game_phase": "NORMAL_PLAY",
+  "turn_phase": "PLAYER_ACTIONS",
+  "dice_rolled": [5, 6],
+  "board_state": {
+    "tiles": [
+      {"coords": [0, 0], "type": "HILLS", "number": 3, "has_robber": false},
+      {"coords": [0, 1], "type": "PASTURE", "number": 6, "has_robber": false},
+      {"coords": [0, 2], "type": "MOUNTAINS", "number": 5, "has_robber": false},
+      {"coords": [1, 0], "type": "FIELDS", "number": 4, "has_robber": false},
+      {"coords": [1, 1], "type": "FOREST", "number": 11, "has_robber": false},
+      {"coords": [1, 2], "type": "PASTURE", "number": 12, "has_robber": false},
+      {"coords": [1, 3], "type": "FIELDS", "number": 9, "has_robber": false},
+      {"coords": [2, 0], "type": "FOREST", "number": 8, "has_robber": false},
+      {"coords": [2, 1], "type": "DESERT", "number": null, "has_robber": false},
+      {"coords": [2, 2], "type": "FOREST", "number": 10, "has_robber": true},
+      {"coords": [2, 3], "type": "MOUNTAINS", "number": 9, "has_robber": false},
+      {"coords": [3, 0], "type": "HILLS", "number": 11, "has_robber": false},
+      {"coords": [3, 1], "type": "FIELDS", "number": 2, "has_robber": false},
+      {"coords": [3, 2], "type": "PASTURE", "number": 6, "has_robber": false},
+      {"coords": [4, 0], "type": "PASTURE", "number": 4, "has_robber": false},
+      {"coords": [4, 1], "type": "FIELDS", "number": 5, "has_robber": false},
+      {"coords": [4, 2], "type": "MOUNTAINS", "number": 10, "has_robber": false}
+    ],
+    "robber_position": [2, 2],
+    "harbors": [],
+    "buildings": {
+      "[0, 0]": {"type": "CITY", "owner": 0},
+      "[1, 5]": {"type": "SETTLEMENT", "owner": 1},
+      "[3, 2]": {"type": "SETTLEMENT", "owner": 2},
+      "[4, 1]": {"type": "SETTLEMENT", "owner": 0},
+      "[2, 4]": {"type": "CITY", "owner": 1},
+      "[5, 3]": {"type": "SETTLEMENT", "owner": 2},
+      "[1, 1]": {"type": "SETTLEMENT", "owner": 0},
+      "[3, 5]": {"type": "SETTLEMENT", "owner": 1},
+      "[6, 2]": {"type": "SETTLEMENT", "owner": 2}
+    },
+    "roads": [
+      {"start": [0, 0], "end": [1, 0], "owner": 0},
+      {"start": [1, 0], "end": [2, 0], "owner": 0},
+      {"start": [1, 5], "end": [2, 5], "owner": 1},
+      {"start": [2, 5], "end": [3, 5], "owner": 1},
+      {"start": [3, 2], "end": [4, 2], "owner": 2},
+      {"start": [4, 2], "end": [5, 2], "owner": 2},
+      {"start": [4, 1], "end": [5, 1], "owner": 0},
+      {"start": [2, 4], "end": [3, 4], "owner": 1},
+      {"start": [5, 3], "end": [6, 3], "owner": 2},
+      {"start": [0, 0], "end": [0, 1], "owner": 0},
+      {"start": [0, 1], "end": [1, 1], "owner": 0},
+      {"start": [5, 2], "end": [6, 2], "owner": 2}
+    ]
+  },
+  "players_state": [
+    {
+      "player_id": 0,
+      "name": "Player 0 (Red)",
+      "cards": ["WOOD", "WOOD", "BRICK", "WHEAT", "ORE", "ORE", "SHEEP"],
+      "dev_cards": ["KNIGHT", "VICTORY_POINT"],
+      "settlements": [[4, 1], [1, 1]],
+      "cities": [[0, 0]],
+      "roads": [
+        [[0, 0], [1, 0]], 
+        [[1, 0], [2, 0]], 
+        [[4, 1], [5, 1]], 
+        [[0, 0], [0, 1]], 
+        [[0, 1], [1, 1]]
+      ],
+      "victory_points": 6,
+      "longest_road_length": 5,
+      "has_longest_road": true,
+      "has_largest_army": false,
+      "knights_played": 1
+    },
+    {
+      "player_id": 1,
+      "name": "Player 1 (Blue)",
+      "cards": ["SHEEP", "SHEEP", "WHEAT", "WHEAT", "ORE", "BRICK"],
+      "dev_cards": ["KNIGHT", "KNIGHT", "ROAD_BUILDING"],
+      "settlements": [[1, 5], [3, 5]],
+      "cities": [[2, 4]],
+      "roads": [
+        [[1, 5], [2, 5]], 
+        [[2, 5], [3, 5]], 
+        [[2, 4], [3, 4]]
+      ],
+      "victory_points": 5,
+      "longest_road_length": 2,
+      "has_longest_road": false,
+      "has_largest_army": false,
+      "knights_played": 2
+    },
+    {
+      "player_id": 2,
+      "name": "Player 2 (Green)",
+      "cards": ["WOOD", "WOOD", "BRICK", "BRICK", "SHEEP", "WHEAT"],
+      "dev_cards": ["YEAR_OF_PLENTY"],
+      "settlements": [[3, 2], [5, 3], [6, 2]],
+      "cities": [],
+      "roads": [
+        [[3, 2], [4, 2]], 
+        [[4, 2], [5, 2]], 
+        [[5, 3], [6, 3]], 
+        [[5, 2], [6, 2]]
+      ],
+      "victory_points": 4,
+      "longest_road_length": 4,
+      "has_longest_road": false,
+      "has_largest_army": false,
+      "knights_played": 0
+    }
+  ]
+}

examples/ai_testing/show_complete_state.py

@@ -0,0 +1,194 @@
+"""
+Show Complete Game State
+-------------------------
+Runs a game to a specific point and shows the COMPLETE JSON.
+"""
+
+import sys
+from pathlib import Path
+import os
+import json
+
+# Add parent directory to path
+sys.path.insert(0, str(Path(__file__).parent.parent.parent))
+
+from pycatan.visualizations.web_visualization import WebVisualization
+
+# Capture states
+captured_states = []
+update_counter = 0
+
+original_update = WebVisualization.update_full_state
+original_start_server = WebVisualization.start_server
+
+def capturing_update(self, game_state):
+    """Capture and save all states."""
+    global update_counter
+    original_update(self, game_state)
+    
+    if hasattr(self, 'current_game_state') and self.current_game_state:
+        update_counter += 1
+        state_copy = json.loads(json.dumps(self.current_game_state))
+        captured_states.append(state_copy)
+        
+        # Print just a notification
+        print(f"\r[Captured state #{update_counter}]", end='', flush=True)
+
+def no_server(self):
+    """Disable web server."""
+    self.running = True
+
+# Apply patches
+WebVisualization.update_full_state = capturing_update
+WebVisualization.start_server = no_server
+
+
+def print_complete_state(state, title="COMPLETE GAME STATE"):
+    """Print the complete state in a readable format."""
+    print("\n" + "="*80)
+    print(f"🎮 {title}")
+    print("="*80)
+    
+    # Print complete JSON
+    print(json.dumps(state, indent=2, ensure_ascii=False))
+    
+    print("\n" + "="*80)
+    print("📊 SUMMARY")
+    print("="*80)
+    
+    # Summary
+    print(f"\n🎲 Game Info:")
+    print(f"   Current Player: {state.get('current_player', '?')}")
+    print(f"   Game Phase: {state.get('current_phase', '?')}")
+    
+    if state.get('dice_result'):
+        print(f"   Last Dice: {state['dice_result']}")
+    
+    print(f"\n🗺️  Board:")
+    print(f"   Hexes: {len(state.get('hexes', []))}")
+    hexes_by_type = {}
+    for hex in state.get('hexes', []):
+        htype = hex.get('type', 'unknown')
+        hexes_by_type[htype] = hexes_by_type.get(htype, 0) + 1
+    for htype, count in sorted(hexes_by_type.items()):
+        print(f"      - {htype}: {count}")
+    
+    robber = state.get('robber_position')
+    if robber:
+        print(f"   Robber: {robber}")
+    
+    print(f"\n🏘️  Buildings:")
+    settlements = state.get('settlements', [])
+    cities = state.get('cities', [])
+    roads = state.get('roads', [])
+    print(f"   Settlements: {len(settlements)}")
+    for s in settlements[:5]:  # Show first 5
+        print(f"      - Point {s.get('point_id')}: Player {s.get('owner')}")
+    if len(settlements) > 5:
+        print(f"      ... and {len(settlements)-5} more")
+    
+    print(f"   Cities: {len(cities)}")
+    for c in cities[:5]:
+        print(f"      - Point {c.get('point_id')}: Player {c.get('owner')}")
+    if len(cities) > 5:
+        print(f"      ... and {len(cities)-5} more")
+    
+    print(f"   Roads: {len(roads)}")
+    for r in roads[:5]:
+        print(f"      - {r.get('start_point')} -> {r.get('end_point')}: Player {r.get('owner')}")
+    if len(roads) > 5:
+        print(f"      ... and {len(roads)-5} more")
+    
+    print(f"\n👥 Players: {len(state.get('players', []))}")
+    for player in state.get('players', []):
+        print(f"\n   Player {player.get('id')}: {player.get('name', 'Unknown')}")
+        print(f"      Victory Points: {player.get('victory_points', 0)}")
+        print(f"      Resources: {len(player.get('cards', []))} cards")
+        if player.get('cards'):
+            card_counts = {}
+            for card in player['cards']:
+                card_counts[card] = card_counts.get(card, 0) + 1
+            print(f"         {dict(card_counts)}")
+        print(f"      Dev Cards: {len(player.get('dev_cards', []))}")
+        if player.get('dev_cards'):
+            print(f"         {player['dev_cards']}")
+        print(f"      Knights Played: {player.get('knights_played', 0)}")
+        if player.get('has_longest_road'):
+            print(f"      🛣️  Has LONGEST ROAD")
+        if player.get('has_largest_army'):
+            print(f"      ⚔️  Has LARGEST ARMY")
+    
+    print("\n" + "="*80)
+
+
+def main():
+    if len(sys.argv) > 1:
+        input_file = sys.argv[1]
+    else:
+        input_file = 'examples/data/game_moves_3Players.txt'
+    
+    print(f"\nRunning game with: {input_file}")
+    print("(Web server disabled, capturing states...)\n")
+    
+    # Read inputs
+    with open(input_file, 'r', encoding='utf-8') as f:
+        inputs = f.read()
+    
+    from io import StringIO
+    sys.stdin = StringIO(inputs)
+    
+    try:
+        from pycatan import RealGame
+        game = RealGame()
+        game.run()
+        
+    except (EOFError, KeyboardInterrupt):
+        print("\n\nGame stopped")
+    except Exception as e:
+        print(f"\n\nError: {e}")
+    
+    # Show results
+    print(f"\n\n{'='*80}")
+    print(f"✅ Captured {len(captured_states)} states total")
+    print("="*80)
+    
+    if captured_states:
+        # Save all states
+        output_dir = Path('examples/ai_testing/captured_states')
+        output_dir.mkdir(exist_ok=True)
+        
+        # Save first state
+        first_state = captured_states[0]
+        first_file = output_dir / 'state_001_initial.json'
+        with open(first_file, 'w', encoding='utf-8') as f:
+            json.dump(first_state, f, indent=2, ensure_ascii=False)
+        print(f"\n💾 Saved first state to: {first_file}")
+        
+        # Save last state
+        last_state = captured_states[-1]
+        last_file = output_dir / f'state_{len(captured_states):03d}_final.json'
+        with open(last_file, 'w', encoding='utf-8') as f:
+            json.dump(last_state, f, indent=2, ensure_ascii=False)
+        print(f"💾 Saved last state to: {last_file}")
+        
+        # Also save to sample_states for compatibility
+        sample_file = Path('examples/ai_testing/sample_states/captured_game.json')
+        sample_file.parent.mkdir(exist_ok=True)
+        with open(sample_file, 'w', encoding='utf-8') as f:
+            json.dump(last_state, f, indent=2, ensure_ascii=False)
+        print(f"💾 Saved to: {sample_file}")
+        
+        # Print complete final state
+        print_complete_state(last_state, "FINAL GAME STATE - THIS IS WHAT AI SEES")
+        
+        print("\n" + "="*80)
+        print("📝 To see full JSON of any state, check the files above")
+        print("🌐 To view in browser, run:")
+        print(f"   py examples/ai_testing/visualize_game_state.py --state-file {sample_file}")
+        print("="*80)
+    else:
+        print("❌ No states were captured!")
+
+
+if __name__ == '__main__':
+    main()

examples/ai_testing/simple_capture.py

@@ -0,0 +1,109 @@
+"""
+Simple Game State Capturer
+---------------------------
+Runs a game and prints the JSON at each major point.
+WITHOUT starting a web server (to avoid port conflicts).
+"""
+
+import sys
+from pathlib import Path
+import os
+
+# Add parent directory to path for imports
+sys.path.insert(0, str(Path(__file__).parent.parent.parent))
+
+import json
+from pycatan.visualizations.web_visualization import WebVisualization
+
+
+# Monkey-patch to capture states WITHOUT starting server
+original_update = WebVisualization.update_full_state
+original_start_server = WebVisualization.start_server
+captured_states = []
+
+def capturing_update(self, game_state):
+    """Capture state and print JSON."""
+    original_update(self, game_state)
+    
+    if hasattr(self, 'current_game_state') and self.current_game_state:
+        print("\n" + "="*80)
+        print("GAME STATE JSON (This is what AI receives)")
+        print("="*80)
+        print(json.dumps(self.current_game_state, indent=2, ensure_ascii=False))
+        print("="*80 + "\n")
+        
+        # Save to list
+        captured_states.append(self.current_game_state.copy())
+
+def no_start_server(self):
+    """Don't start the server - just capture data."""
+    print("[INFO] Web server disabled for capture mode")
+    self.running = True  # Pretend it's running
+    pass
+
+# Apply monkey patches
+WebVisualization.update_full_state = capturing_update
+WebVisualization.start_server = no_start_server
+
+
+def main():
+    """Run game with input file."""
+    import sys
+    import os
+    
+    # Fix encoding for Windows console
+    if sys.platform == 'win32':
+        os.environ['PYTHONIOENCODING'] = 'utf-8'
+    
+    # Check if input file provided
+    if len(sys.argv) > 1:
+        input_file = sys.argv[1]
+    else:
+        input_file = 'examples/data/game_moves_3Players.txt'
+    
+    print(f"\nRunning game with inputs from: {input_file}")
+    print("="*80)
+    
+    # Read inputs
+    with open(input_file, 'r', encoding='utf-8') as f:
+        inputs = f.read()
+    
+    # Feed to stdin
+    from io import StringIO
+    sys.stdin = StringIO(inputs)
+    
+    try:
+        print("[INFO] Starting game in capture mode (web server disabled)")
+        print("="*80)
+        
+        # Import after patching
+        from pycatan import RealGame
+        
+        # Run the game - this will print JSON at each update
+        game = RealGame()
+        game.run()
+        
+    except (EOFError, KeyboardInterrupt):
+        print("\n\nGame stopped")
+    except Exception as e:
+        print(f"\nError: {e}")
+        import traceback
+        traceback.print_exc()
+    
+    print("\n" + "="*80)
+    print(f"Captured {len(captured_states)} states total")
+    print("="*80)
+    
+    # Save last state
+    if captured_states:
+        output_file = 'examples/ai_testing/sample_states/captured_game.json'
+        os.makedirs(os.path.dirname(output_file), exist_ok=True)
+        with open(output_file, 'w', encoding='utf-8') as f:
+            json.dump(captured_states[-1], f, indent=2, ensure_ascii=False)
+        print(f"Last state saved to: {output_file}")
+    else:
+        print("WARNING: No states were captured!")
+
+
+if __name__ == '__main__':
+    main()

examples/ai_testing/visualize_game_state.py

@@ -0,0 +1,364 @@
+"""
+Visualize Game State for AI Testing
+------------------------------------
+This script creates a specific game state and displays it using Web Visualizer.
+It also prints all the JSON data that would be sent to an AI agent.
+
+Usage:
+    python visualize_game_state.py [--state-file STATE_FILE]
+    
+    If STATE_FILE is not provided, uses a default test state.
+"""
+
+import sys
+import json
+import time
+import threading
+from pathlib import Path
+
+# Add parent directory to path for imports
+sys.path.insert(0, str(Path(__file__).parent.parent.parent))
+
+from pycatan.core.game import Game
+from pycatan.management.actions import GameState, PlayerState, BoardState, GamePhase, TurnPhase
+from pycatan.visualizations.web_visualization import WebVisualization
+from pycatan.core.card import ResCard, DevCard
+from pycatan.core.building import Building
+
+
+class GameStateCapture:
+    """Captures and displays all JSON data sent to Web Visualizer."""
+    
+    def __init__(self, web_viz):
+        self.web_viz = web_viz
+        self.captured_states = []
+        self.captured_events = []
+        
+    def capture_state_update(self, game_state):
+        """Capture and print game state JSON."""
+        print("\n" + "="*80)
+        print("📊 GAME STATE JSON (This is what the AI would receive)")
+        print("="*80)
+        
+        # Convert to web format (same as what web visualizer does)
+        web_format = self.web_viz._convert_game_state(game_state)
+        
+        # Print formatted JSON
+        json_str = json.dumps(web_format, indent=2, ensure_ascii=False)
+        print(json_str)
+        
+        print("\n" + "="*80)
+        print("📈 SUMMARY")
+        print("="*80)
+        self._print_summary(web_format)
+        
+        self.captured_states.append(web_format)
+        return web_format
+        
+    def _print_summary(self, state_data):
+        """Print a human-readable summary of the game state."""
+        print(f"Current Player: {state_data.get('current_player', 0)}")
+        print(f"Game Phase: {state_data.get('current_phase', 'UNKNOWN')}")
+        print(f"Robber Position: {state_data.get('robber_position', 'Unknown')}")
+        
+        if state_data.get('dice_result'):
+            print(f"Last Dice Roll: {state_data['dice_result']}")
+        
+        print(f"\nBoard:")
+        print(f"  - Hexes: {len(state_data.get('hexes', []))}")
+        print(f"  - Settlements: {len(state_data.get('settlements', []))}")
+        print(f"  - Cities: {len(state_data.get('cities', []))}")
+        print(f"  - Roads: {len(state_data.get('roads', []))}")
+        
+        print(f"\nPlayers: {len(state_data.get('players', []))}")
+        for player in state_data.get('players', []):
+            print(f"  Player {player.get('id', '?')}: {player.get('name', 'Unknown')}")
+            print(f"    - Victory Points: {player.get('victory_points', 0)}")
+            print(f"    - Resources: {len(player.get('cards', []))}")
+            print(f"    - Dev Cards: {len(player.get('dev_cards', []))}")
+            if player.get('has_longest_road'):
+                print(f"    - Has Longest Road!")
+            if player.get('has_largest_army'):
+                print(f"    - Has Largest Army!")
+
+
+def create_test_game_state():
+    """
+    Create a test game state with some buildings and resources.
+    This simulates a game in progress.
+    """
+    print("\n🎮 Creating test game state...")
+    
+    # Create a real game to get proper board structure
+    game = Game(num_of_players=3)
+    
+    # Build some structures for testing
+    # Player 0 (Red) - settlements and roads
+    point1 = game.board.points[0][0]  # Top left
+    point2 = game.board.points[1][0]  # Below it
+    
+    # Starting phase - build without resources
+    game.add_settlement(0, point1, is_starting=True)
+    game.add_road(0, point1, point2, is_starting=True)
+    
+    # Player 1 (Blue)
+    point4 = game.board.points[2][2]
+    point5 = game.board.points[3][2]
+    game.add_settlement(1, point4, is_starting=True)
+    game.add_road(1, point4, point5, is_starting=True)
+    
+    # Player 2 (Green)  
+    point6 = game.board.points[4][3]
+    point7 = game.board.points[5][3]
+    game.add_settlement(2, point6, is_starting=True)
+    game.add_road(2, point6, point7, is_starting=True)
+    
+    # Second round of starting placements
+    game.add_settlement(2, game.board.points[1][3], is_starting=True)
+    game.add_road(2, game.board.points[1][3], game.board.points[2][3], is_starting=True)
+    
+    game.add_settlement(1, game.board.points[2][1], is_starting=True)
+    game.add_road(1, game.board.points[2][1], game.board.points[3][1], is_starting=True)
+    
+    game.add_settlement(0, game.board.points[4][1], is_starting=True)
+    game.add_road(0, game.board.points[4][1], game.board.points[5][1], is_starting=True)
+    
+    # Give players some resources
+    game.players[0].cards[ResCard.Wood] = 3
+    game.players[0].cards[ResCard.Brick] = 2
+    game.players[0].cards[ResCard.Wheat] = 2
+    game.players[0].cards[ResCard.Ore] = 1
+    
+    game.players[1].cards[ResCard.Sheep] = 4
+    game.players[1].cards[ResCard.Wheat] = 1
+    game.players[1].cards[ResCard.Ore] = 2
+    
+    game.players[2].cards[ResCard.Wood] = 2
+    game.players[2].cards[ResCard.Brick] = 3
+    game.players[2].cards[ResCard.Sheep] = 1
+    
+    # Give player 0 some development cards
+    game.players[0].dev_cards[DevCard.Knight] = 2
+    game.players[0].dev_cards[DevCard.VictoryPoint] = 1
+    game.players[0].knights_played = 1
+    
+    # Position robber on a tile
+    game.board.robber = game.board.tiles[2][1]  # Move to a different tile
+    
+    print("✅ Test game state created!")
+    print(f"   - 3 Players")
+    print(f"   - 6 Settlements placed")
+    print(f"   - 6 Roads built")
+    print(f"   - Resources distributed")
+    print(f"   - Robber positioned")
+    
+    return game
+
+
+def game_to_game_state(game: Game) -> GameState:
+    """
+    Convert a Game object to a GameState object for visualization.
+    """
+    # Create board state
+    tiles = []
+    for row_idx, row in enumerate(game.board.tiles):
+        for col_idx, tile in enumerate(row):
+            if tile:  # Skip None tiles
+                tiles.append({
+                    'coords': [row_idx, col_idx],
+                    'type': tile.tile_type.name if tile.tile_type else 'DESERT',
+                    'number': tile.number if hasattr(tile, 'number') else None,
+                    'has_robber': tile == game.board.robber
+                })
+    
+    # Create buildings dictionary
+    buildings = {}
+    for row in game.board.points:
+        for point in row:
+            if point.building:
+                coords = tuple([point.row, point.index])
+                building_type_name = "SETTLEMENT" if point.building.type == Building.BUILDING_SETTLEMENT else \
+                                    "CITY" if point.building.type == Building.BUILDING_CITY else "UNKNOWN"
+                buildings[coords] = {
+                    'type': building_type_name,
+                    'owner': point.building.owner
+                }
+    
+    # Create roads list
+    roads = []
+    for player in game.players:
+        for road in player.roads:
+            roads.append({
+                'start': [road.start.row, road.start.index],
+                'end': [road.end.row, road.end.index],
+                'owner': road.owner
+            })
+    
+    # Find robber position
+    robber_pos = (0, 0)
+    if game.board.robber:
+        robber_pos = (game.board.robber.row, game.board.robber.index)
+    
+    board_state = BoardState(
+        tiles=tiles,
+        robber_position=robber_pos,
+        harbors=[],  # Can be added if needed
+        buildings=buildings,
+        roads=roads
+    )
+    
+    # Create player states
+    players_state = []
+    for player in game.players:
+        # Convert cards to list of strings
+        cards = []
+        for card_type, count in player.cards.items():
+            cards.extend([card_type.name] * count)
+        
+        dev_cards = []
+        for card_type, count in player.dev_cards.items():
+            dev_cards.extend([card_type.name] * count)
+        
+        # Get settlements and cities
+        settlements = []
+        cities = []
+        for row in game.board.points:
+            for point in row:
+                if point.building and point.building.owner == player.player_num:
+                    coords = (point.row, point.index)
+                    if point.building.type == Building.BUILDING_SETTLEMENT:
+                        settlements.append(coords)
+                    elif point.building.type == Building.BUILDING_CITY:
+                        cities.append(coords)
+        
+        # Get roads (as tuples of start, end)
+        roads_list = []
+        for road in player.roads:
+            roads_list.append(((road.start.row, road.start.index),
+                              (road.end.row, road.end.index)))
+        
+        player_state = PlayerState(
+            player_id=player.player_num,
+            name=f"Player {player.player_num}",
+            cards=cards,
+            dev_cards=dev_cards,
+            settlements=settlements,
+            cities=cities,
+            roads=roads_list,
+            victory_points=player.victory_points,
+            longest_road_length=player.longest_road_length,
+            has_longest_road=player.has_longest_road,
+            has_largest_army=player.has_largest_army,
+            knights_played=player.knights_played
+        )
+        players_state.append(player_state)
+    
+    # Create full game state
+    game_state = GameState(
+        game_id="test_game",
+        turn_number=5,
+        current_player=0,
+        game_phase=GamePhase.NORMAL_PLAY,
+        turn_phase=TurnPhase.PLAYER_ACTIONS,
+        board_state=board_state,
+        players_state=players_state,
+        dice_rolled=(4, 3)  # Example dice roll
+    )
+    
+    return game_state
+
+
+def load_game_state_from_file(filepath: str) -> GameState:
+    """
+    Load a game state from a JSON file.
+    
+    Args:
+        filepath: Path to JSON file containing game state
+        
+    Returns:
+        GameState object
+    """
+    with open(filepath, 'r', encoding='utf-8') as f:
+        data = json.load(f)
+    
+    # Reconstruct GameState from JSON
+    # This is a simplified version - may need expansion
+    board_state = BoardState(**data['board_state'])
+    players_state = [PlayerState(**p) for p in data['players_state']]
+    
+    game_state = GameState(
+        game_id=data.get('game_id', 'loaded_game'),
+        turn_number=data.get('turn_number', 0),
+        current_player=data.get('current_player', 0),
+        game_phase=GamePhase[data.get('game_phase', 'NORMAL_PLAY')],
+        turn_phase=TurnPhase[data.get('turn_phase', 'PLAYER_ACTIONS')],
+        board_state=board_state,
+        players_state=players_state,
+        dice_rolled=tuple(data['dice_rolled']) if data.get('dice_rolled') else None
+    )
+    
+    return game_state
+
+
+def main():
+    """Main function to visualize game state."""
+    import argparse
+    
+    parser = argparse.ArgumentParser(description='Visualize game state for AI testing')
+    parser.add_argument('--state-file', type=str, help='Path to game state JSON file')
+    parser.add_argument('--port', type=int, default=5000, help='Port for web server')
+    parser.add_argument('--no-browser', action='store_true', help='Don\'t open browser automatically')
+    
+    args = parser.parse_args()
+    
+    # Create or load game state
+    if args.state_file:
+        print(f"\n📂 Loading game state from: {args.state_file}")
+        game_state = load_game_state_from_file(args.state_file)
+    else:
+        print("\n🎲 Using default test game state...")
+        game = create_test_game_state()
+        game_state = game_to_game_state(game)
+    
+    # Create web visualization
+    print(f"\n🌐 Starting Web Visualizer on port {args.port}...")
+    web_viz = WebVisualization(port=args.port, auto_open=not args.no_browser)
+    
+    # Create capture wrapper
+    capture = GameStateCapture(web_viz)
+    
+    # Capture and print the JSON
+    web_format = capture.capture_state_update(game_state)
+    
+    # Update the visualization
+    web_viz.update_full_state(game_state)
+    
+    # Start the web server in a separate thread
+    def run_server():
+        web_viz.start()
+    
+    server_thread = threading.Thread(target=run_server, daemon=True)
+    server_thread.start()
+    
+    # Wait a moment for server to start
+    time.sleep(1)
+    
+    print("\n" + "="*80)
+    print("🎮 WEB VISUALIZER RUNNING")
+    print("="*80)
+    print(f"URL: http://localhost:{args.port}")
+    print("\nThe game state is now visible in your browser.")
+    print("The JSON data above is what an AI agent would receive.")
+    print("\nPress Ctrl+C to stop the server.")
+    print("="*80)
+    
+    try:
+        # Keep the main thread alive
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        print("\n\n👋 Shutting down...")
+
+
+if __name__ == '__main__':
+    main()

pycatan/core/game.py

@@ -79,12 +79,10 @@ class Game:
             return Statuses.ERR_CARDS
         # removes the cards
         self.players[player].remove_cards(needed_cards)
-        # gives the player a dev card
-        # DEBUG: Force Year of Plenty for testing
-        self.players[player].add_dev_card(DevCard.YearOfPlenty)
-        # self.players[player].add_dev_card(self.dev_deck[0])  # Original: random card
+
+        self.players[player].add_dev_card(self.dev_deck[0]) 
         # removes that dev card from the deck
-        # del self.dev_deck[0]  # Commented out: not removing from deck in debug mode
+        del self.dev_deck[0]  # Commented out: not removing from deck in debug mode
         return Statuses.ALL_GOOD
 
     # gives players the proper cards for a given roll

pycatan/visualizations/web_visualization.py

@@ -282,7 +282,10 @@ class WebVisualization(Visualization):
             'current_player': getattr(game_state, 'current_player', 0),
             'current_phase': getattr(game_state, 'game_phase', 'ACTION').name if hasattr(getattr(game_state, 'game_phase', None), 'name') else str(getattr(game_state, 'game_phase', 'ACTION')),
             'robber_position': None,
-            'dice_result': getattr(game_state, 'dice_rolled', None)
+            'dice_result': getattr(game_state, 'dice_rolled', None),
+            # Add board structure information - CRITICAL FOR AI!
+            'points': self._get_points_info(),
+            'board_graph': self._get_board_graph()
         }
         
         # Convert board data
@@ -393,6 +396,57 @@ class WebVisualization(Visualization):
         
         return hexes
     
+    def _get_points_info(self) -> List[Dict[str, Any]]:
+        """
+        Get complete information about all points on the board.
+        CRITICAL FOR AI - provides board structure and connectivity.
+        
+        Returns:
+            List of point definitions with adjacency information
+        """
+        points_info = []
+        
+        for point_id in board_definition.get_all_point_ids():
+            point_def = board_definition.points.get(point_id)
+            if point_def:
+                points_info.append({
+                    'point_id': point_id,
+                    'game_coords': list(point_def.game_coords),
+                    'adjacent_points': point_def.adjacent_points,  # Which points connect via roads
+                    'adjacent_hexes': point_def.adjacent_hexes,    # Which hexes touch this point
+                    'pixel_coords': list(point_def.pixel_coords)   # For visualization
+                })
+        
+        return points_info
+    
+    def _get_board_graph(self) -> Dict[str, Any]:
+        """
+        Get the board as a graph structure for AI pathfinding and strategy.
+        
+        Returns:
+            Graph representation with nodes (points) and edges (possible roads)
+        """
+        # Create adjacency list for quick lookup
+        adjacency = {}
+        for point_id in board_definition.get_all_point_ids():
+            point_def = board_definition.points.get(point_id)
+            if point_def:
+                adjacency[point_id] = point_def.adjacent_points
+        
+        # Get hex-to-points mapping for resource strategy
+        hex_to_points = {}
+        for hex_id in board_definition.get_all_hex_ids():
+            hex_def = board_definition.hexes.get(hex_id)
+            if hex_def:
+                hex_to_points[hex_id] = hex_def.adjacent_points
+        
+        return {
+            'adjacency': adjacency,  # point_id -> [connected_point_ids]
+            'hex_to_points': hex_to_points,  # hex_id -> [point_ids_on_hex]
+            'total_points': len(board_definition.points),
+            'total_hexes': len(board_definition.hexes)
+        }
+    
     def _find_robber_position(self, board_state) -> Optional[int]:
         """Find which hex has the robber."""
         if hasattr(board_state, 'robber_position'):

run.bat

@@ -0,0 +1,5 @@
+@echo off
+REM Activate virtual environment and run the Catan game
+call .venv\Scripts\activate.bat
+python play_catan.py
+pause