- Agents will receive a 1-N frames of JSON objects with the game state and metadata.
- Agents will respond with an action 1-5 or a 6th action which includes x, y coordinates.
Available Games
To see which games are available, either go to three.arcprize.org or make an API call to list games. Example games includeGame ID
Game IDs are formatted as<game_name>
-<version>
.
game_names
are stable, but version
may change as games update.
Grid Structure
- Dimensions: Maximum 64x64 grid size
- Cell Values: Integer values 0-15 representing different states/colors
- Coordinate System: (0,0) at top-left, (x,y) format
Game Available Actions
Each game provides an explicit set of actions that an agent can take. Actions available vary per game. Typically, the available actions include:- Actions 1–4: ex: move up, down, left, or right
- Action 6: A complex action (if supported by the game)
Running a Full Playtest
To run a complete playtest, you’ll need to integrate your agent with scorecard management and the game loop. This is what happens “under the hood” when you run commands likeuv run main.py --agent=random --game=ls20
(from the Quick Start). Below is pseudocode for the key steps. For a ready-to-use implementation, see the Swarms guide—which can automate this for you across multiple games.
Game State Enumeration
State | Description |
---|---|
NOT_FINISHED | Game is active and awaiting next action |
WIN | Objective completed successfully |
GAME_OVER | Game terminated due to the max actions reached or other conditions |