debug-draw

Draws debug overlay primitives in a running CARLA world via the world.debug Python API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Visual debugging in CARLA requires knowing the exact world.debug API calls, coordinate formats, and rendering constraints; this Skill encodes that procedure so an agent can mark points, paths, boxes, and labels in a running simulator without improvising against the Python API. ## Core Features & Use Cases - Overlay primitives: Draw points, lines, arrows, bounding boxes, and text strings with configurable colour and lifetime through carla.DebugHelper. - Prerequisite checking: A check_env.sh script verifies the carla module is importable and the server is reachable before any drawing is attempted. - Version and rendering guidance: Documents the differences between CARLA 0.9.x and 0.10.0 (removed draw_hud_* variants) and the sync-mode and headless -nullrhi pitfalls. - Use Case: A user asks to "mark world position (10, 20) and label it"; the agent runs the point and text subcommands with a colour and lifetime, then confirms the overlay in a rendered view. ## Quick Start Ask the agent to draw a green point at world coordinates 10,20,1 with a 60-second lifetime in the running CARLA server.

Frequently Asked Questions about debug-draw

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

FAQPage Schema
How do I draw debug shapes in CARLA with Python?▼

Use the world.debug (carla.DebugHelper) methods draw_point, draw_line, draw_arrow, draw_box, and draw_string, each taking a location, colour, and life_time in seconds. The debug_draw.py script wraps these as point, line, arrow, box, and text subcommands with X,Y,Z coordinates.

How do I mark or label a location in the CARLA simulator?▼

Draw a point at the world coordinates with draw_point and add a floating label with draw_string at a slightly higher Z. Both accept an r,g,b colour and a lifetime in seconds, and they expire automatically.

Why are CARLA debug shapes not showing up?▼

Debug shapes are invisible on headless servers started with -nullrhi because there is no render thread, and in synchronous mode nothing renders until the client calls world.tick(). Use a windowed or packaged server and tick the world in sync mode.

Does CARLA 0.10.0 support draw_hud debug functions?▼

No. On CARLA 0.10.0 (UE5 line) carla.DebugHelper exposes only seven methods: draw_point, draw_line, draw_arrow, draw_box, draw_string, clear_debug_shape, and clear_debug_string. The 0.9.x draw_hud_point/line/box variants have no equivalent, so use the world-space calls.

Can I delete a CARLA debug shape before its lifetime expires?▼

Debug shapes are render overlays, not actors, so they cannot be selected or individually deleted through get_actors(). They expire after their life_time; clear_debug_shape and clear_debug_string are the only early-removal calls, and a world reload clears everything.

How do I keep a debug box attached to a moving CARLA actor?▼

Shapes are stamped at a fixed world pose and do not follow moving actors. Redraw the shape every frame with a short life_time (around 0.15 seconds), re-reading the actor's transform each iteration, so the re-stamped box appears to ride the actor.