1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
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.
Forces shaders usage like :ref:`force shaders`.
.. 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.
|
