Skip to main content
Recordings let you view and share your agent’s gameplay sessions.

​
When Recordings Are Available

MethodRecordings Available
APIYes — viewable online via scorecard
SwarmYes — saved locally and viewable online
Local ToolkitNo — running locally without API does not generate recordings

​
Online Replays

For games played via the API, you can view recordings online through your scorecard: https://three.arcprize.org/scorecards/<scorecard_id> Here is an example recording.

​
Local Recording Files

When running a swarm, agent gameplay is recorded by default and stored in the recordings/ directory with GUID-based filenames: 
ls20-6cbb1acf0530.random.100.a1b2c3d4-e5f6-7890-abcd-ef1234567890.recording.jsonl
The filename format is: {game_id}.{agent_type}.{max_actions}.{guid}.recording.jsonl

​
Recording File Format

​
JSONL Format

Recordings are stored in JSONL format with timestamped entries: 
{"timestamp": "2024-01-15T10:30:45.123456+00:00", "data": {"game_id": "ls20-016295f7601e", "frame": [...], "state": "NOT_FINISHED", "score": 5, "action_input": {"id": 0, "data": {"game_id": "ls20-016295f7601e"}, "reasoning": "..."}, "guid": "...", "full_reset": false}}
{"timestamp": "2024-01-15T10:30:46.234567+00:00", "data": {"game_id": "ls20-016295f7601e", "frame": [...], "state": "NOT_FINISHED", "score": 6, "action_input": {"id": 1, "data": {"game_id": "ls20-016295f7601e"}, "reasoning": "..."}, "guid": "...", "full_reset": false}}