Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.arcprize.org/llms.txt

Use this file to discover all available pages before exploring further.

All games implement a standardized action interface with seven core actions:
ActionDescription
RESETInitialize or restarts the game/level state
ACTION1Simple action - varies by game (semantically mapped to up)
ACTION2Simple action - varies by game (semantically mapped to down)
ACTION3Simple action - varies by game (semantically mapped to left)
ACTION4Simple action - varies by game (semantically mapped to right)
ACTION5Simple action - varies by game (e.g., interact, select, rotate, attach/detach, execute, etc.)
ACTION6Complex action requiring x,y coordinates (0-63 range)
ACTION7Simple action - Undo (e.g., interact, select)

Human Player Keybindings

When playing games manually in the ARC-AGI-3 UI, you can use these keyboard shortcuts instead of clicking action buttons:
Control SchemeACTION1ACTION2ACTION3ACTION4ACTION5ACTION6ACTION7
WASD + SpaceWSADSpaceMouse ClickCTRL/CMD+Z
Arrow Keys + FFMouse ClickCTRL/CMD+Z
All control schemes support mouse clicking for ACTION6 (coordinate-based actions). Choose whichever scheme feels most comfortable for your playstyle.

Game-over state

When a game reaches a game-over state, the only valid action is RESET. Sending any other action (e.g., ACTION1 through ACTION7) to a game in this state returns a 400 Bad Request error. If you encounter a 400 error during gameplay, check whether the game has ended and issue a RESET to start a new game.
A 400 error indicates the game is in a game-over state. A 500 error, by contrast, indicates a server-side issue.

Available actions

Each game explicitly defines the set of available actions that can be used within that game. This approach ensures clarity for both human and AI participants by making it clear which actions are permitted, thereby reducing confusion. In the human-facing UI, available actions are visually highlighted or dismissed to provide the same affordance. For each action taken, the metadata of the returned frame will indicate which actions are available. Agents may use this information to narrow the action space and develop effective strategies for completing the game. Note: Action 6 does not provide explicit X/Y coordinates for active areas. If Action 6 is available, only its availability will be indicated, without specifying which coordinates are active.