debug-navmesh

Validates and visualizes a CARLA map's pedestrian navigation mesh by sampling walkable locations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? After importing a map into CARLA, there is no direct API to inspect the pedestrian navigation mesh, so you cannot tell whether walkers will navigate or stand still. This Skill samples walkable locations via get_random_location_from_navigation() to confirm the navmesh loaded, measure its coverage, and draw it as debug points. ## Core Features & Use Cases - Headless validation: Samples hundreds of navigation points and reports a PASS/FAIL with unique-location counts, coverage bounds, and walkable span in metres. - Visual overlay: Draws sampled points through world.debug on a rendered server so you can see exactly which areas are walkable. - Prerequisite checks: Verifies the carla Python module imports and the server is reachable, warning on client/server version mismatches. - Use Case: After importing a custom town, run validation to confirm the pedestrian nav mesh was built; if it FAILs, rebuild the navmesh in the import pipeline before spawning walkers. ## Quick Start Ask the agent to validate the pedestrian navmesh on the running CARLA server and show the walkable area.

Frequently Asked Questions about debug-navmesh

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

FAQPage Schema
How do I check if a CARLA map has a pedestrian navmesh?▼

Sample locations with world.get_random_location_from_navigation() and count the valid, unique points returned. This Skill's validate command samples 500 points by default and reports PASS with coverage bounds, or FAIL if no navmesh exists.

How to visualize the walkable area in CARLA?▼

Sample many navigation points and draw them with world.debug.draw_point on a rendered server. The resulting point cloud outlines the walkable region; a headless -nullrhi server draws nothing, so validation should be used instead.

Why won't my CARLA walkers move after spawning?▼

Walkers stand still when the map has no usable navmesh, because WalkerAIController.go_to_location has nothing to route on. Run navmesh validation first; if it passes, the problem is in the WalkerAIController wiring rather than the map.

Does navmesh validation work on a headless CARLA server?▼

Yes, validation works headless because it only samples locations and computes coverage statistics. Only the visualization step requires a rendered, windowed server since debug drawing produces no output under -nullrhi.

What does a client/server version mismatch cause in CARLA?▼

A mismatched client can abort mid-call with errors like std::bad_array_new_length when deserializing snapshots or sensor data. The prerequisite check warns on mismatches and recommends installing a matching client wheel.