carla-simulator/carla-agentic-tools/control-lights

Control light sources

Paths. scripts/… and references/… below are relative to the

directory holding this SKILL.md. Your working directory is the user's

project, not that directory, so prefix them with its absolute path or the

command is not found.

Switch and tune the world's illumination — street lamps, building lights, vehicle lights — via the LightManager. These are actual light sources (they cast light): different from toggle-env-objects (which hides the lamp geometry) and set-weather (the sun). Effects show on a rendered server.

Instructions

Progress:
- [ ] Step 1: Check prerequisites (bash scripts/check_env.sh), clear FAILs
- [ ] Step 2: list a group to see counts/states
- [ ] Step 3: on / off / set a group, or toggle the day-night cycle

Commands need CARLA_HOST/CARLA_PORT from scripts/env.sh.

Step 1: Check prerequisites

bash scripts/check_env.sh

Step 3: Control

source scripts/env.sh
 
python3 scripts/lights.py list --group street              # counts + a sample
 
# light up the streets, warm colour
python3 scripts/lights.py on --group street --color 255,220,150 --intensity 2000
# turn building lights on for a night-city look
python3 scripts/lights.py on --group building
# turn everything off
python3 scripts/lights.py off --group all
 
# recolour without toggling
python3 scripts/lights.py set --group street --color 150,200,255
 
# let lights switch on/off automatically with the sun
python3 scripts/lights.py day-night on

Groups: street, building, vehicle, other, all.

Examples

Example 1: night city

User says: "make it a lit-up city at night"

Set night with set-weather (sun_altitude_angle negative), then on --group street and on --group building.

Example 2: blackout

User says: "kill all the lights"

off --group all.

Example 3: automatic dusk lighting

User says: "have the street lights come on by themselves at dusk"

day-night on.

Troubleshooting

Problem: no visible change Cause: headless -nullrhi server (no rendering), or it's daytime so lights wash out. Solution: use a rendered server; set night (set-weather) to see them clearly.

Problem: `list` shows 0 lights Cause: this map has few/no light sources of that group, or wrong group. Solution: try --group all; some maps have sparse building lights.

Problem: lights won't stay on Cause: the day-night cycle is auto-switching them. Solution: day-night off, then set them manually.

Outputs

Illumination state on the server (on/off, colour, intensity, auto-cycle). No file. list reports per-group counts and a sample.

Detail (LightManager API, groups, colour/intensity units, day-night) in references/lights.md.