{"data":{"kind":"file","path":"README.md","version_id":"qo4t2rui4ivk540dwnrwi88u","entry":{"name":"README.md","path":"README.md","is_directory":false,"size":1954,"modified_at":"2026-08-16T14:03:32.126000","content_hash":"49647b4a7a71793ed1dc5c4b4f446e5eb73faffaed92b7e3887e160441801d43"},"entries":[],"content":"# Abalone Strategy Game\n\nA Prime Intellect environment for evaluating LLM strategic reasoning through the Abalone board game.\n\n## Overview\n\nAbalone is a two-player abstract strategy game played on a hexagonal board with 61 cells. Each player starts with 14 marbles and the goal is to push 6 of the opponent's marbles off the board.\n\n## Task Types\n\n### 1. Board Analysis (30 tasks)\nAnalyze mid-game positions: count marbles, evaluate material advantage, assess specific moves, rate board control.\n\n### 2. Push Mechanics (25 tasks)\nUnderstand Abalone's core push (Sumito) mechanics: 1v0, 1v1, 2v1, 3v2 scenarios, edge ejections, blocked pushes.\n\n### 3. Strategic Reasoning (20 tasks)\nHigher-level strategic questions: center control, formation types (Escargot), sacrifice tactics, Belgian Daisy opening theory.\n\n### 4. Endgame Puzzles (15 tasks)\nFind winning moves in endgame positions with few marbles. Identify moves that eject opponent marbles.\n\n## Reward Functions\n\n| Function | Weight | Description |\n|---|---|---|\n| `material_accuracy` | 0.20 | Correct marble count for each side |\n| `move_legality` | 0.20 | Correctly identifies if a move is legal |\n| `ejection_accuracy` | 0.15 | Correctly counts ejected marbles |\n| `json_format_score` | 0.15 | Valid JSON output with expected keys |\n| `strategic_depth` | 0.15 | Quality of strategic reasoning |\n| `move_finding` | 0.15 | Finds correct winning move in endgames |\n\n## Key Abalone Concepts\n\n- **Sumito**: Push advantage when you have more marbles in a line than the opponent\n- **Hexagonal grid**: Axial coordinates (q, r), 6 directions (E, NE, NW, W, SW, SE)\n- **Push rules**: 1-3 consecutive marbles can push if strictly outnumbering opponent\n- **Ejection**: Pushing a marble off the board edge = permanent removal\n- **Win condition**: First to eject 6 opponent marbles wins\n\n## Usage\n\n```python\nimport verifiers as vf\n\nenv = vf.load_environment(\"nelio/abalone-strategy-game\")\n```\n\n## License\n\nMIT\n","encoding":"utf-8","truncated":false,"total_bytes":1954},"status":null}