Shadows Settings

Shadows Settings ################

.. omw-setting:: :title: enable shadows :type: boolean :range: true, false :default: false :location: :bdg-success:Launcher > Settings > Visuals > Shadows

Enable or disable shadow rendering using shadow mapping. More realistic but may reduce performance.

.. omw-setting:: :title: number of shadow maps :type: int :range: 1 to 8 :default: 3 :location: :bdg-success:Launcher > Settings > Visuals > Shadows

Number of shadow maps used. More maps improve shadow quality but may reduce performance or cause texture conflicts.

.. omw-setting:: :title: maximum shadow map distance :type: float32 :range: full 32-bit float range :default: 8192 :location: :bdg-success:Launcher > Settings > Visuals > Shadows

Maximum distance shadows cover from the camera. Set ≤ 0 to disable distance limit.

.. omw-setting:: :title: shadow fade start :type: float32 :range: [0, 1] :default: 0.9 :location: :bdg-success:Launcher > Settings > Visuals > Shadows

Fraction of maximum shadow distance at which shadows start fading. No effect if distance limit disabled.

.. omw-setting:: :title: enable debug hud :type: boolean :range: true, false :default: false

Show debug HUD visualizing shadow map contents. Recommended for developers or advanced users.

.. omw-setting:: :title: enable debug overlay :type: boolean :range: true, false :default: false

Show debug overlay showing shadow map coverage areas. Recommended for advanced debugging.

.. omw-setting:: :title: compute scene bounds :type: string :range: primitives | bounds | none :default: bounds :location: :bdg-success:Launcher > Settings > Visuals > Shadows

Method to compute shadow map coverage:

• primitives: better shadows, higher CPU cost
• bounds: better performance, lower quality
• none: disables computation

.. omw-setting:: :title: shadow map resolution :type: int :range: dependent on GPU/driver :default: 1024 :location: :bdg-success:Launcher > Settings > Visuals > Shadows

Size of shadow maps. Higher values improve quality but increase GPU load. Powers of two may perform better on some hardware.

.. omw-setting:: :title: actor shadows :type: boolean :range: true, false :default: false

Enable shadows cast by NPCs and creatures. May reduce performance.

.. omw-setting:: :title: player shadows :type: boolean :range: true, false :default: false :location: :bdg-success:Launcher > Settings > Visuals > Shadows

Enable shadows cast by the player character. May reduce performance.

.. omw-setting:: :title: terrain shadows :type: boolean :range: true, false :default: false :location: :bdg-success:Launcher > Settings > Visuals > Shadows

Enable shadows cast by terrain. May reduce performance.

.. omw-setting:: :title: object shadows :type: boolean :range: true, false :default: false :location: :bdg-success:Launcher > Settings > Visuals > Shadows

Enable shadows cast by static objects. May reduce performance.

.. omw-setting:: :title: enable indoor shadows :type: boolean :range: true, false :default: false :location: :bdg-success:Launcher > Settings > Visuals > Shadows

Enable shadows indoors. Only actors cast shadows indoors without full ceiling shadows. Can cause shadows appearing through objects.

.. omw-setting:: :title: polygon offset factor :type: float32 :range: full 32-bit float range, sensibly >1.0 :default: 1.1

Polygon offset factor for shadow map rendering. Reduces shadow flicker but may increase Peter Panning.

.. omw-setting:: :title: polygon offset units :type: float32 :range: full 32-bit float range, sensibly 1 to 10 :default: 4.0

Polygon offset units for shadow map rendering. Works with offset factor to reduce artifacts.

.. omw-setting:: :title: normal offset distance :type: float32 :range: full 32-bit float range, sensibly 0 to 2 :default: 1.0

Distance along surface normal to project shadow coordinates. Reduces flicker with less Peter Panning than polygon offset.

.. omw-setting:: :title: use front face culling :type: boolean :range: true, false :default: false

Exclude front faces from shadow maps for performance. May increase Peter Panning artifacts.

.. omw-setting:: :title: split point uniform logarithmic ratio :type: float32 :range: [0, 1] :default: 0.5

Controls balance between logarithmic and uniform split points for shadow splits. Adjust when using large view distances or distant terrain.

.. omw-setting:: :title: split point bias :type: float32 :range: full C++ float range :default: 0.0

Bias parameter used in shadow split computation. Non-zero values can cause unusual behavior.

.. omw-setting:: :title: minimum lispsm near far ratio :type: float32 :range: > 0 :default: 0.25

Minimum near/far ratio for Light Space Perspective Shadow Map. Controls distribution of shadow detail near and far from the camera.