# bake-lighting

Explains how to bake static PlayCanvas lighting and shadows into lightmaps to cut per-frame rendering cost.

Skill by PlayCanvas. Category: Design and frontend.

## Install

Project (for this project only):

```sh
npx skills add playcanvas/skills --skill bake-lighting
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add playcanvas/skills --skill bake-lighting -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 201. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/playcanvas/skills/bake-lighting)

## Source

[Open the source](https://github.com/playcanvas/skills/tree/HEAD/skills/bake-lighting). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: bake-lighting
description: Use when static PlayCanvas lighting, shadows, or ambient occlusion cost too much per frame and should be baked into lightmaps.
---

# Bake static lighting

Lightmaps remove per-frame shadow and lighting cost for static lights on static geometry.

- `Application` registers `Lightmapper`; manual `AppOptions` bootstraps set
  `lightmapper = Lightmapper`.
- On the light, set `bake = true`; once every mesh it lights is lightmapped, set
  `affectDynamic = false`.
- On each mesh, set `render.lightmapped = true`, or it goes unlit once `affectDynamic` is off. Size
  it with `lightmapSizeMultiplier`; `castShadowsLightmap` lets meshes shadow each other.
- Set the mode on `scene.lightmapMode`: `BAKE_COLOR` for flat diffuse, or the default
  `BAKE_COLORDIR`, which adds direction for normal- or specular-mapped materials.
- Bake AO without lights with `scene.ambientBake`, `ambientBakeNumSamples`, and
  `ambientBakeOcclusionBrightness` and `ambientBakeOcclusionContrast`.
- The Engine bakes once on the first rendered frame. Call `app.lightmapper.bake(null, mode)` only
  for nodes added later or to re-bake.

## A second UV set is required

A node bakes only when every mesh instance has `SEMANTIC_TEXCOORD1`. Otherwise it is skipped, with
only a debug-build log, and stays dynamically lit. Primitives have the set; imported GLBs often do
not. Check, then unwrap or re-export.

## On-device or offline

Time `bake()` on the target device. Move to an offline bake shipped as textures only when it misses
the startup budget or needs detail the runtime lightmapper cannot produce, and state the added
download size.

Dynamic objects moving through baked light need approximated occlusion and a contact shadow, or
they look pasted on. Compare `verify-pixels` captures in and out of baked shadow.
````

- Previous: [verify-pixels](https://syn4pse.dev/terminal/playcanvas-verify-pixels.md)
- Next: [override-shader-chunks](https://syn4pse.dev/terminal/playcanvas-override-shader-chunks.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
