Bevy 3D lighting

When to use

Load this when a 3D scene needs lights. Materials stay on bevy-3d-materials. Spawn light entities; clustering and shadow extraction stay engine-owned.

ECS shape

• Module: bevy::light says it provides directional, point, and spot lights, plus light probes, atmosphere, volumetrics, and shadow configuration.
• Feature: bevy_light is described the same way on the crate feature list.
• PBR page names: DirectionalLightViewEntities, ExtractedDirectionalLight, ExtractedPointLight, ExtractedRectLight, GpuClusteredLight (point, spot, or rectangle), DistanceFog, LightProbePlugin, ContactShadows.
• Systems: light clustering and extraction are engine-owned. Gameplay only spawns light entities.

Light choice

Need	Spawn
Sun	DirectionalLight plus CascadeShadowConfig on one entity.
Local omni	PointLight (intensity in lumens, range in meters).
Cone	SpotLight with inner_angle and outer_angle in radians.
Distance haze	DistanceFog on the camera entity.
Local image-based lighting	LightProbe with EnvironmentMapLight cubemap handles.

bevy_solari is the experimental raytraced-lighting Cargo feature. These examples use the raster lights in bevy::light.

[dependencies]
bevy = "0.20"

use bevy::light::{
    CascadeShadowConfig, CascadeShadowConfigBuilder, DirectionalLightShadowMap, SunDisk,
};