A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
2D Lighting
A hands-on tour of the engine's dynamic 2D lighting: a Light2D torch that
follows your mouse through a near-dark room, Light2D lamps you drop with a
click, and ShadowCaster2D boxes that block light and cast real-time soft
shadows.
Controls
| Input | Action |
|---|---|
| Move mouse | The torch follows the cursor, revealing walls and casting shadows |
| Left-click | Drop a fixed colored light (cycles red → green → blue → warm white) |
| Right-click | Drop a box obstacle that blocks light and casts a shadow |
C |
Clear everything you placed |
Placed lights are capped at 10 and obstacles at 40; when you exceed a cap the oldest one fades out and is removed. The light cap is the frame's (16 fit in the lighting block); the obstacle one is only to keep the demo tidy — occluders are drawn as geometry, so a scene may hold as many as it has walls. What IS capped is how many lights that meet cast at once: the 2D shadow mask has eight channels (four where a light has a shape) and lights whose reach and shadows cannot touch share one, so only a ninth light among eight that overlap it lights the room without shadowing it.
How it works
Lighting is multiplicative: a lit surface renders as
albedo × (ambient + Σ lights). With the ambient term set very low (~0.06), an
unlit wall is nearly black — so a light does not just brighten the room, it
reveals it.
- The room — the tile grid, the props, the pillars, and every placed
obstacle — has
lit: trueon itsSprite, the one-flag way to receive 2D lights (in the editor it is the Lit checkbox). A sprite without the flag stays unlit (full-bright) — the light markers are left unlit on purpose so they read as emissive dots. Kill every light and the whole room goes black; only the markers keep glowing. When a surface needs more than the flag (a tint, a normal map), give it aLit2Dmaterial instead — see the lighting guide. - Shadow casters are lit like anything else: an occluder box never shadows its own interior, so the pillars and obstacles take light on the side facing it while still throwing a shadow cone behind them.
- The torch (
src/systems/torch.ts) is aLight2Dof typePoint. Each frame it is moved toUICameraInfo.worldMouseX/Y, the cursor already projected into world space by the active camera. - Placing & clearing (
src/systems/place.ts) reads mouse buttons and theCkey from theInputresource and usesCommandsto spawn/despawn entities. Left-click spawns aLight2D, right-click spawns aShadowCaster2D. - Fading (
src/systems/fade.ts) dims an evicted or cleared entity's light and sprite to zero over a short window, then despawns it.
Shadow softness comes from the light's shadowSoftness field: the torch uses a
larger value for a wide penumbra, placed lights a smaller one for crisper edges.
Files
assets/
scenes/
main.esscene # camera, ambient, torch, the lit tile/prop room, two pillars
src/
main.ts # registers the three systems
config.ts # shared tuning (colors, radii, caps, fade)
components.ts # Torch tag, Fading component
systems/
torch.ts # torch follows the mouse
place.ts # click to place lights/obstacles, C to clear
fade.ts # fade-out + despawn of removed entities