Lights

"You cannot add darkness. You can only stop adding light, which is not the same and never looks it." — Gaffer Sekk Orlan
Verified

/add light places a coloured point light in the world so you can relight a corner the map builder left dim.

You need permission bit 25 for every command on this page, and bit 26 for /trace lights. Servers give it to community admins by default. See permission bits.

Lights are additive only. They brighten an area and can never darken one.

What it does

A placed light is a coloured glow at a point in space, with a brightness you set. Everyone on the server sees it, and it stays until you remove it or the map changes.

Use it to pick a face out of a shadow, to give a console a colour, or to sell a fire that is only a particle effect. Use /fade or the dark overlay when you need less light rather than more.

Using it

Placing a light

Aim at the surface you want lit and run the command with 4 numbers: red, green, blue and intensity. The light appears at your crosshair point.

Each colour channel runs 0 to 255. Intensity runs 1 to 1020, and anything outside those ranges is pulled back to the nearest end without a warning.

Add coordinates on the end when you need the light somewhere your crosshair cannot reach. Unlike models, a light placed by coordinates sits exactly where you put it with no offset.

Choosing a brightness

Intensity sets reach as well as strength. The number is the light's radius in map units, so a light at 400 brightens everything within 400 units, and a brighter light is always a bigger one.

Commands

Adding a light

Recolouring

colour is an accepted alias for color.

Changing brightness

intensity is an accepted alias for light.

Moving a light

A hyphen keeps an axis where it is, so this raises the light without touching X or Y.

Finding your lights

Run /trace lights to see markers on lights in the world rather than a list.

Removing lights

Remove a single light with /remove <id>.

Settings

Server-side. Spawns lights automatically from any `light____` tag built into a placed model. On by default.

Things to note

  • Only 32 lights render in one view. The map holds 64, but the renderer draws 32 per frame. Cram more than 32 into one sightline and the extras go dark with no message.
  • 64 lights is the map-wide cap. The 65th prints "Maximum placed lights reached (64)." and is not placed.
  • Lights cannot darken. There is no negative intensity. To lose light, remove lights, use the dark overlay, or use /fade.
  • Values are clamped in silence. An intensity of 2000 becomes 1020 and the game does not tell you.
  • A model can bring its own lights. An MD3 with light_<r>_<g>_<b>_<i> tags spawns one placed light per tag, and each one counts against the cap of 64. Removing the model removes its tag lights with it.
  • Lights have no collision and no model. You can see the glow, but nothing marks the point it comes from. Use /trace lights.

Next

© 2026 StoryForce