Ambient Light

Ambient light is the base light that fills the entirety of a world, regardless of caves or other occluding elements. If you're using ambient light with the Sun Light (Directional light), you can think of ambient light as the minimum lighting in your world.

Color & Intensity

The ambient light allows you to control its color using an RGB value, and its intensity as a number.

The ambient light color and intensity can be changed anytime during gameplay to update the world's overall lighting.

Here's how we can change a world's ambient light color.

// ... other code
world.setAmbientLightColor({ r: 255, g: 0, b: 0 }); // very red ambient lighting

Here's how we can change a world's ambient light intensity. Ambient lighting intensity can be a value from 0 to 1+, with 1 being the default brightness, and anything above that being additional brightness.

// ... other code
world.setAmbientLightIntensity(20); // Very over-exposed, ultra bright lighting

You can use both the light color and intensity in combination to get your ambient lighting for a world.

Diving Deeper

The latest ambient lighting API Reference can be found as part of the World API Reference here.

If there are features that we don't currently support for ambient lighting that you'd like to see added to the HYTOPIA SDK, you can submit a feature request here.