record-simulation

Records a running CARLA simulation to a verified .log file for later replay.

3|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/carla-simulator/carla-agentic-tools --skill record-simulation-carla-simulator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: record-simulation
Source: https://github.com/carla-simulator/carla-agentic-tools/tree/main/skills/python-api/record-simulation
Command: npx skills add https://github.com/carla-simulator/carla-agentic-tools --skill record-simulation-carla-simulator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires carla, and includes scripts (resource) and references (resource) components.

What problem does it solve? Capturing a CARLA simulation run for later replay or analysis requires correctly bracketing start_recorder/stop_recorder calls, and the API alone gives no confirmation that anything was actually captured. This Skill records world state to a .log file and verifies the result by parsing the file back from the server. ## Core Features & Use Cases - Manual recording bracketing: Start and stop the recorder around traffic runs, scenarios, or manual driving sessions. - Fixed-length clips: Record a set number of simulated seconds with automatic verification of frame count and duration. - Optional extended capture: Record velocities, accelerations, and control inputs via the additional_data flag. - Use Case: A user asks to "record 30 seconds of traffic" — the Skill starts the recorder, waits 30 simulated seconds, stops, and confirms the log contains frames before handing it to the replay or query skills. ## Quick Start Ask the agent to record the currently running CARLA simulation to an absolute .log path for a fixed number of seconds and verify the captured frames.

Frequently Asked Questions about record-simulation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record a CARLA simulation to a log file?▼

Use the CARLA Python API client.start_recorder(file, additional_data) to begin recording and client.stop_recorder() to end it. The Skill's record.py script wraps this with start, stop, and clip commands, and verifies the log by parsing it back from the server.

What data does the CARLA recorder capture?▼

The recorder captures world state per frame: actor spawns and destroys, transforms, traffic-light states, vehicle wheel and animation data, and walker bone poses. With additional_data enabled it also records velocities, accelerations, and control inputs.

Does the CARLA recorder capture camera or lidar sensor data?▼

No, the recorder does not store sensor output such as camera images or lidar point clouds. On replay you re-attach sensors and enable replay_sensors to regenerate that data from the replayed world state.

Where is the CARLA recording log file saved?▼

The .log file is written on the server's filesystem, not the client. A relative filename lands under the server's CarlaUE4/Saved/ directory, so pass an absolute path to control exactly where it goes.

Why does my CARLA recording have zero frames?▼

A zero-frame log means nothing simulated between start and stop, or the server-side path was wrong. Ensure actors are actually moving during the recording window and use an absolute writable path on the server machine.