]> git.lizzy.rs Git - dragonfireclient.git/blob - builtin/settingtypes.txt
Merge branch 'master' of https://github.com/minetest/minetest
[dragonfireclient.git] / builtin / settingtypes.txt
1 # This file contains all settings displayed in the settings menu.
2 #
3 # General format:
4 #    name (Readable name) type type_args
5 #
6 # Note that the parts are separated by exactly one space
7 #
8 # `type` can be:
9 #    - int
10 #    - string
11 #    - bool
12 #    - float
13 #    - enum
14 #    - path
15 #    - filepath
16 #    - key (will be ignored in GUI, since a special key change dialog exists)
17 #    - flags
18 #    - noise_params_2d
19 #    - noise_params_3d
20 #    - v3f
21 #
22 # `type_args` can be:
23 #   * int:
24 #            - default
25 #            - default min max
26 #   * string:
27 #            - default (if default is not specified then "" is set)
28 #   * bool:
29 #            - default
30 #   * float:
31 #            - default
32 #            - default min max
33 #   * enum:
34 #            - default value1,value2,...
35 #   * path:
36 #            - default (if default is not specified then "" is set)
37 #   * filepath:
38 #            - default (if default is not specified then "" is set)
39 #   * key:
40 #            - default
41 #   * flags:
42 #            Flags are always separated by comma without spaces.
43 #            - default possible_flags
44 #   * noise_params_2d:
45 #            Format is <offset>, <scale>, (<spreadX>, <spreadY>, <spreadZ>), <seed>, <octaves>, <persistence>, <lacunarity>[, <default flags>]
46 #            - default
47 #   * noise_params_3d:
48 #            Format is <offset>, <scale>, (<spreadX>, <spreadY>, <spreadZ>), <seed>, <octaves>, <persistence>, <lacunarity>[, <default flags>]
49 #            - default
50 #   * v3f:
51 #            Format is (<X>, <Y>, <Z>)
52 #            - default
53 #
54 # Comments directly above a setting are bound to this setting.
55 # All other comments are ignored.
56 #
57 # Comments and (Readable name) are handled by gettext.
58 # Comments should be complete sentences that describe the setting and possibly
59 #  give the user additional useful insight.
60 # Sections are marked by a single line in the format: [Section Name]
61 # Sub-section are marked by adding * in front of the section name: [*Sub-section]
62 # Sub-sub-sections have two * etc.
63 # There shouldn't be too much settings per category; settings that shouldn't be
64 #  modified by the "average user" should be in (sub-)categories called "Advanced".
65
66 [Controls]
67 #    If enabled, you can place blocks at the position (feet + eye level) where you stand.
68 #    This is helpful when working with nodeboxes in small areas.
69 enable_build_where_you_stand (Build inside player) bool false
70
71 #    Player is able to fly without being affected by gravity.
72 #    This requires the "fly" privilege on the server.
73 free_move (Flying) bool false
74
75 #    If enabled, makes move directions relative to the player's pitch when flying or swimming.
76 pitch_move (Pitch move mode) bool false
77
78 #    Fast movement (via the "Aux1" key).
79 #    This requires the "fast" privilege on the server.
80 fast_move (Fast movement) bool false
81
82 #    If enabled together with fly mode, player is able to fly through solid nodes.
83 #    This requires the "noclip" privilege on the server.
84 noclip (Noclip) bool false
85
86 #    Smooths camera when looking around. Also called look or mouse smoothing.
87 #    Useful for recording videos.
88 cinematic (Cinematic mode) bool false
89
90 #    Smooths rotation of camera. 0 to disable.
91 camera_smoothing (Camera smoothing) float 0.0 0.0 0.99
92
93 #    Smooths rotation of camera in cinematic mode. 0 to disable.
94 cinematic_camera_smoothing (Camera smoothing in cinematic mode) float 0.7 0.0 0.99
95
96 #    Invert vertical mouse movement.
97 invert_mouse (Invert mouse) bool false
98
99 #    Mouse sensitivity multiplier.
100 mouse_sensitivity (Mouse sensitivity) float 0.2
101
102 #    If enabled, "Aux1" key instead of "Sneak" key is used for climbing down and
103 #    descending.
104 aux1_descends (Aux1 key for climbing/descending) bool false
105
106 #    Double-tapping the jump key toggles fly mode.
107 doubletap_jump (Double tap jump for fly) bool false
108
109 #    If disabled, "Aux1" key is used to fly fast if both fly and fast mode are
110 #    enabled.
111 always_fly_fast (Always fly and fast) bool true
112
113 #    The time in seconds it takes between repeated node placements when holding
114 #    the place button.
115 repeat_place_time (Place repetition interval) float 0.25 0.001
116
117 #    Automatically jump up single-node obstacles.
118 autojump (Automatic jumping) bool false
119
120 #    Prevent digging and placing from repeating when holding the mouse buttons.
121 #    Enable this when you dig or place too often by accident.
122 safe_dig_and_place (Safe digging and placing) bool false
123
124 #    Enable random user input (only used for testing).
125 random_input (Random input) bool false
126
127 #    Continuous forward movement, toggled by autoforward key.
128 #    Press the autoforward key again or the backwards movement to disable.
129 continuous_forward (Continuous forward) bool false
130
131 #    The length in pixels it takes for touch screen interaction to start.
132 touchscreen_threshold (Touch screen threshold) int 20 0 100
133
134 #    (Android) Fixes the position of virtual joystick.
135 #    If disabled, virtual joystick will center to first-touch's position.
136 fixed_virtual_joystick (Fixed virtual joystick) bool false
137
138 #    (Android) Use virtual joystick to trigger "Aux1" button.
139 #    If enabled, virtual joystick will also tap "Aux1" button when out of main circle.
140 virtual_joystick_triggers_aux1 (Virtual joystick triggers Aux1 button) bool false
141
142 #    Enable joysticks
143 enable_joysticks (Enable joysticks) bool false
144
145 #    The identifier of the joystick to use
146 joystick_id (Joystick ID) int 0
147
148 #    The type of joystick
149 joystick_type (Joystick type) enum auto auto,generic,xbox,dragonrise_gamecube
150
151 #    The time in seconds it takes between repeated events
152 #    when holding down a joystick button combination.
153 repeat_joystick_button_time (Joystick button repetition interval) float 0.17 0.001
154
155 #    The dead zone of the joystick
156 joystick_deadzone (Joystick dead zone) int 2048
157
158 #    The sensitivity of the joystick axes for moving the
159 #    in-game view frustum around.
160 joystick_frustum_sensitivity (Joystick frustum sensitivity) float 170
161
162 #    Key for moving the player forward.
163 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
164 keymap_forward (Forward key) key KEY_KEY_W
165
166 #    Key for moving the player backward.
167 #    Will also disable autoforward, when active.
168 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
169 keymap_backward (Backward key) key KEY_KEY_S
170
171 #    Key for moving the player left.
172 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
173 keymap_left (Left key) key KEY_KEY_A
174
175 #    Key for moving the player right.
176 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
177 keymap_right (Right key) key KEY_KEY_D
178
179 #    Key for jumping.
180 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
181 keymap_jump (Jump key) key KEY_SPACE
182
183 #    Key for sneaking.
184 #    Also used for climbing down and descending in water if aux1_descends is disabled.
185 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
186 keymap_sneak (Sneak key) key KEY_LSHIFT
187
188 #    Key for digging.
189 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
190 keymap_dig (Dig key) key KEY_LBUTTON
191
192 #    Key for placing.
193 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
194 keymap_place (Place key) key KEY_RBUTTON
195
196 #    Key for opening the inventory.
197 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
198 keymap_inventory (Inventory key) key KEY_KEY_I
199
200 #    Key for opening the special inventory.
201 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
202 keymap_special_inventory (Special inventory key) key KEY_KEY_O
203
204 #    Key for moving fast in fast mode.
205 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
206 keymap_aux1 (Aux1 key) key KEY_KEY_E
207
208 #    Key for opening the chat window.
209 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
210 keymap_chat (Chat key) key KEY_KEY_T
211
212 #    Key for opening the chat window to type commands.
213 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
214 keymap_cmd (Command key) key /
215
216 #    Key for opening the chat window to type local commands.
217 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
218 keymap_cmd_local (Command key) key .
219
220 #    Key for toggling unlimited view range.
221 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
222 keymap_rangeselect (Range select key) key KEY_KEY_R
223
224 #    Key for toggling flying.
225 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
226 keymap_freemove (Fly key) key KEY_KEY_K
227
228 #    Key for toggling pitch move mode.
229 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
230 keymap_pitchmove (Pitch move key) key KEY_KEY_P
231
232 #    Key for toggling fast mode.
233 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
234 keymap_fastmove (Fast key) key KEY_KEY_J
235
236 #    Key for toggling noclip mode.
237 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
238 keymap_noclip (Noclip key) key KEY_KEY_H
239
240 #    Key for selecting the next item in the hotbar.
241 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
242 keymap_hotbar_next (Hotbar next key) key KEY_KEY_N
243
244 #    Key for selecting the previous item in the hotbar.
245 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
246 keymap_hotbar_previous (Hotbar previous key) key KEY_KEY_B
247
248 #    Key for muting the game.
249 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
250 keymap_mute (Mute key) key KEY_KEY_M
251
252 #    Key for increasing the volume.
253 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
254 keymap_increase_volume (Inc. volume key) key
255
256 #    Key for decreasing the volume.
257 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
258 keymap_decrease_volume (Dec. volume key) key
259
260 #    Key for toggling autoforward.
261 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
262 keymap_autoforward (Automatic forward key) key
263
264 #    Key for toggling cinematic mode.
265 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
266 keymap_cinematic (Cinematic mode key) key
267
268 #    Key for toggling display of minimap.
269 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
270 keymap_minimap (Minimap key) key KEY_KEY_V
271
272 #    Key for taking screenshots.
273 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
274 keymap_screenshot (Screenshot) key KEY_F12
275
276 #    Key for dropping the currently selected item.
277 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
278 keymap_drop (Drop item key) key KEY_KEY_Q
279
280 #    Key to use view zoom when possible.
281 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
282 keymap_zoom (View zoom key) key KEY_KEY_Z
283
284 #    Key for toggling Killaura.
285 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
286 keymap_toggle_killaura (Killaura key) key KEY_KEY_X
287
288 #    Key for toggling Freecam.
289 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
290 keymap_toggle_freecam (Freecam key) key KEY_KEY_G
291
292 #    Key for selecting the first hotbar slot.
293 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
294 keymap_slot1 (Hotbar slot 1 key) key KEY_KEY_1
295
296 #    Key for selecting the second hotbar slot.
297 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
298 keymap_slot2 (Hotbar slot 2 key) key KEY_KEY_2
299
300 #    Key for selecting the third hotbar slot.
301 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
302 keymap_slot3 (Hotbar slot 3 key) key KEY_KEY_3
303
304 #    Key for selecting the fourth hotbar slot.
305 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
306 keymap_slot4 (Hotbar slot 4 key) key KEY_KEY_4
307
308 #    Key for selecting the fifth hotbar slot.
309 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
310 keymap_slot5 (Hotbar slot 5 key) key KEY_KEY_5
311
312 #    Key for selecting the sixth hotbar slot.
313 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
314 keymap_slot6 (Hotbar slot 6 key) key KEY_KEY_6
315
316 #    Key for selecting the seventh hotbar slot.
317 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
318 keymap_slot7 (Hotbar slot 7 key) key KEY_KEY_7
319
320 #    Key for selecting the eighth hotbar slot.
321 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
322 keymap_slot8 (Hotbar slot 8 key) key KEY_KEY_8
323
324 #    Key for selecting the ninth hotbar slot.
325 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
326 keymap_slot9 (Hotbar slot 9 key) key KEY_KEY_9
327
328 #    Key for selecting the tenth hotbar slot.
329 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
330 keymap_slot10 (Hotbar slot 10 key) key KEY_KEY_0
331
332 #    Key for selecting the 11th hotbar slot.
333 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
334 keymap_slot11 (Hotbar slot 11 key) key
335
336 #    Key for selecting the 12th hotbar slot.
337 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
338 keymap_slot12 (Hotbar slot 12 key) key
339
340 #    Key for selecting the 13th hotbar slot.
341 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
342 keymap_slot13 (Hotbar slot 13 key) key
343
344 #    Key for selecting the 14th hotbar slot.
345 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
346 keymap_slot14 (Hotbar slot 14 key) key
347
348 #    Key for selecting the 15th hotbar slot.
349 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
350 keymap_slot15 (Hotbar slot 15 key) key
351
352 #    Key for selecting the 16th hotbar slot.
353 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
354 keymap_slot16 (Hotbar slot 16 key) key
355
356 #    Key for selecting the 17th hotbar slot.
357 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
358 keymap_slot17 (Hotbar slot 17 key) key
359
360 #    Key for selecting the 18th hotbar slot.
361 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
362 keymap_slot18 (Hotbar slot 18 key) key
363
364 #    Key for selecting the 19th hotbar slot.
365 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
366 keymap_slot19 (Hotbar slot 19 key) key
367
368 #    Key for selecting the 20th hotbar slot.
369 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
370 keymap_slot20 (Hotbar slot 20 key) key
371
372 #    Key for selecting the 21st hotbar slot.
373 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
374 keymap_slot21 (Hotbar slot 21 key) key
375
376 #    Key for selecting the 22nd hotbar slot.
377 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
378 keymap_slot22 (Hotbar slot 22 key) key
379
380 #    Key for selecting the 23rd hotbar slot.
381 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
382 keymap_slot23 (Hotbar slot 23 key) key
383
384 #    Key for selecting the 24th hotbar slot.
385 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
386 keymap_slot24 (Hotbar slot 24 key) key
387
388 #    Key for selecting the 25th hotbar slot.
389 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
390 keymap_slot25 (Hotbar slot 25 key) key
391
392 #    Key for selecting the 26th hotbar slot.
393 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
394 keymap_slot26 (Hotbar slot 26 key) key
395
396 #    Key for selecting the 27th hotbar slot.
397 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
398 keymap_slot27 (Hotbar slot 27 key) key
399
400 #    Key for selecting the 28th hotbar slot.
401 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
402 keymap_slot28 (Hotbar slot 28 key) key
403
404 #    Key for selecting the 29th hotbar slot.
405 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
406 keymap_slot29 (Hotbar slot 29 key) key
407
408 #    Key for selecting the 30th hotbar slot.
409 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
410 keymap_slot30 (Hotbar slot 30 key) key
411
412 #    Key for selecting the 31st hotbar slot.
413 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
414 keymap_slot31 (Hotbar slot 31 key) key
415
416 #    Key for selecting the 32nd hotbar slot.
417 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
418 keymap_slot32 (Hotbar slot 32 key) key
419
420 #    Key for toggling the display of the HUD.
421 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
422 keymap_toggle_hud (HUD toggle key) key KEY_F1
423
424 #    Key for toggling the display of chat.
425 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
426 keymap_toggle_chat (Chat toggle key) key KEY_F2
427
428 #    Key for toggling the display of the large chat console.
429 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
430 keymap_console (Large chat console key) key KEY_F10
431
432 #    Key for toggling the display of fog.
433 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
434 keymap_toggle_force_fog_off (Fog toggle key) key KEY_F3
435
436 #    Key for toggling the camera update. Only used for development
437 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
438 keymap_toggle_update_camera (Camera update toggle key) key
439
440 #    Key for toggling the display of debug info.
441 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
442 keymap_toggle_debug (Debug info toggle key) key KEY_F5
443
444 #    Key for toggling the display of the profiler. Used for development.
445 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
446 keymap_toggle_profiler (Profiler toggle key) key KEY_F6
447
448 #    Key for switching between first- and third-person camera.
449 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
450 keymap_camera_mode (Toggle camera mode key) key KEY_KEY_C
451
452 #    Key for increasing the viewing range.
453 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
454 keymap_increase_viewing_range_min (View range increase key) key +
455
456 #    Key for decreasing the viewing range.
457 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
458 keymap_decrease_viewing_range_min (View range decrease key) key -
459
460 [Graphics]
461
462 [*In-Game]
463
464 [**Basic]
465
466 #    Whether name tag backgrounds should be shown by default.
467 #    Mods may still set a background.
468 show_nametag_backgrounds (Show name tag backgrounds by default) bool true
469
470 #    Enable vertex buffer objects.
471 #    This should greatly improve graphics performance.
472 enable_vbo (VBO) bool true
473
474 #    Whether to fog out the end of the visible area.
475 enable_fog (Fog) bool true
476
477 #    Leaves style:
478 #    -   Fancy:  all faces visible
479 #    -   Simple: only outer faces, if defined special_tiles are used
480 #    -   Opaque: disable transparency
481 leaves_style (Leaves style) enum fancy fancy,simple,opaque
482
483 #    Connects glass if supported by node.
484 connected_glass (Connect glass) bool false
485
486 #    Enable smooth lighting with simple ambient occlusion.
487 #    Disable for speed or for different looks.
488 smooth_lighting (Smooth lighting) bool true
489
490 #    Enables tradeoffs that reduce CPU load or increase rendering performance
491 #    at the expense of minor visual glitches that do not impact game playability.
492 performance_tradeoffs (Tradeoffs for performance) bool false
493
494 #    Clouds are a client side effect.
495 enable_clouds (Clouds) bool true
496
497 #    Use 3D cloud look instead of flat.
498 enable_3d_clouds (3D clouds) bool true
499
500 #    Method used to highlight selected object.
501 node_highlighting (Node highlighting) enum box box,halo,none
502
503 #    Adds particles when digging a node.
504 enable_particles (Digging particles) bool true
505
506 [**Filtering]
507
508 #    Use mipmapping to scale textures. May slightly increase performance,
509 #    especially when using a high resolution texture pack.
510 #    Gamma correct downscaling is not supported.
511 mip_map (Mipmapping) bool false
512
513 #    Use anisotropic filtering when viewing at textures from an angle.
514 anisotropic_filter (Anisotropic filtering) bool false
515
516 #    Use bilinear filtering when scaling textures.
517 bilinear_filter (Bilinear filtering) bool false
518
519 #    Use trilinear filtering when scaling textures.
520 trilinear_filter (Trilinear filtering) bool false
521
522 #    Filtered textures can blend RGB values with fully-transparent neighbors,
523 #    which PNG optimizers usually discard, often resulting in dark or
524 #    light edges to transparent textures. Apply a filter to clean that up
525 #    at texture load time. This is automatically enabled if mipmapping is enabled.
526 texture_clean_transparent (Clean transparent textures) bool false
527
528 #    When using bilinear/trilinear/anisotropic filters, low-resolution textures
529 #    can be blurred, so automatically upscale them with nearest-neighbor
530 #    interpolation to preserve crisp pixels. This sets the minimum texture size
531 #    for the upscaled textures; higher values look sharper, but require more
532 #    memory. Powers of 2 are recommended. This setting is ONLY applied if
533 #    bilinear/trilinear/anisotropic filtering is enabled.
534 #    This is also used as the base node texture size for world-aligned
535 #    texture autoscaling.
536 texture_min_size (Minimum texture size) int 64
537
538 #    Use multi-sample antialiasing (MSAA) to smooth out block edges.
539 #    This algorithm smooths out the 3D viewport while keeping the image sharp,
540 #    but it doesn't affect the insides of textures
541 #    (which is especially noticeable with transparent textures).
542 #    Visible spaces appear between nodes when shaders are disabled.
543 #    If set to 0, MSAA is disabled.
544 #    A restart is required after changing this option.
545 fsaa (FSAA) enum 0 0,1,2,4,8,16
546
547 #    Undersampling is similar to using a lower screen resolution, but it applies
548 #    to the game world only, keeping the GUI intact.
549 #    It should give a significant performance boost at the cost of less detailed image.
550 #    Higher values result in a less detailed image.
551 undersampling (Undersampling) int 1 1 8
552
553 [**Shaders]
554
555 #    Shaders allow advanced visual effects and may increase performance on some video
556 #    cards.
557 #    This only works with the OpenGL video backend.
558 enable_shaders (Shaders) bool true
559
560 #    Path to shader directory. If no path is defined, default location will be used.
561 shader_path (Shader path) path
562
563 [***Tone Mapping]
564
565 #    Enables Hable's 'Uncharted 2' filmic tone mapping.
566 #    Simulates the tone curve of photographic film and how this approximates the
567 #    appearance of high dynamic range images. Mid-range contrast is slightly
568 #    enhanced, highlights and shadows are gradually compressed.
569 tone_mapping (Filmic tone mapping) bool false
570
571 [***Waving Nodes]
572
573 #    Set to true to enable waving liquids (like water).
574 #    Requires shaders to be enabled.
575 enable_waving_water (Waving liquids) bool false
576
577 #    The maximum height of the surface of waving liquids.
578 #    4.0 = Wave height is two nodes.
579 #    0.0 = Wave doesn't move at all.
580 #    Default is 1.0 (1/2 node).
581 #    Requires waving liquids to be enabled.
582 water_wave_height (Waving liquids wave height) float 1.0 0.0 4.0
583
584 #    Length of liquid waves.
585 #    Requires waving liquids to be enabled.
586 water_wave_length (Waving liquids wavelength) float 20.0 0.1
587
588 #    How fast liquid waves will move. Higher = faster.
589 #    If negative, liquid waves will move backwards.
590 #    Requires waving liquids to be enabled.
591 water_wave_speed (Waving liquids wave speed) float 5.0
592
593 #    Set to true to enable waving leaves.
594 #    Requires shaders to be enabled.
595 enable_waving_leaves (Waving leaves) bool false
596
597 #    Set to true to enable waving plants.
598 #    Requires shaders to be enabled.
599 enable_waving_plants (Waving plants) bool false
600
601 [***Dynamic shadows]
602
603 #    Set to true to enable Shadow Mapping.
604 #    Requires shaders to be enabled.
605 enable_dynamic_shadows (Dynamic shadows) bool false
606
607 #    Set the shadow strength gamma.
608 #    Adjusts the intensity of in-game dynamic shadows.
609 #    Lower value means lighter shadows, higher value means darker shadows.
610 shadow_strength_gamma (Shadow strength gamma) float 1.0 0.1 10.0
611
612 #    Maximum distance to render shadows.
613 shadow_map_max_distance (Shadow map max distance in nodes to render shadows) float 120.0 10.0 1000.0
614
615 #    Texture size to render the shadow map on.
616 #    This must be a power of two.
617 #    Bigger numbers create better shadows but it is also more expensive.
618 shadow_map_texture_size (Shadow map texture size) int 1024 128 8192
619
620 #    Sets shadow texture quality to 32 bits.
621 #    On false, 16 bits texture will be used.
622 #    This can cause much more artifacts in the shadow.
623 shadow_map_texture_32bit (Shadow map texture in 32 bits) bool true
624
625 #    Enable Poisson disk filtering.
626 #    On true uses Poisson disk to make "soft shadows". Otherwise uses PCF filtering.
627 shadow_poisson_filter (Poisson filtering) bool true
628
629 #   Define shadow filtering quality.
630 #   This simulates the soft shadows effect by applying a PCF or Poisson disk
631 #   but also uses more resources.
632 shadow_filters (Shadow filter quality) enum 1 0,1,2
633
634 #    Enable colored shadows.
635 #    On true translucent nodes cast colored shadows. This is expensive.
636 shadow_map_color (Colored shadows) bool false
637
638 #    Spread a complete update of shadow map over given amount of frames.
639 #    Higher values might make shadows laggy, lower values
640 #    will consume more resources.
641 #    Minimum value: 1; maximum value: 16
642 shadow_update_frames (Map shadows update frames) int 8 1 16
643
644 #    Set the soft shadow radius size.
645 #    Lower values mean sharper shadows, bigger values mean softer shadows.
646 #    Minimum value: 1.0; maximum value: 15.0
647 shadow_soft_radius (Soft shadow radius) float 5.0 1.0 15.0
648
649 #    Set the tilt of Sun/Moon orbit in degrees.
650 #    Value of 0 means no tilt / vertical orbit.
651 #    Minimum value: 0.0; maximum value: 60.0
652 shadow_sky_body_orbit_tilt (Sky Body Orbit Tilt) float 0.0 0.0 60.0
653
654 [**Advanced]
655
656 #    Arm inertia, gives a more realistic movement of
657 #    the arm when the camera moves.
658 arm_inertia (Arm inertia) bool true
659
660 #    If FPS would go higher than this, limit it by sleeping
661 #    to not waste CPU power for no benefit.
662 fps_max (Maximum FPS) int 60 1
663
664 #    Maximum FPS when the window is not focused, or when the game is paused.
665 fps_max_unfocused (FPS when unfocused or paused) int 20 1
666
667 #    Open the pause menu when the window's focus is lost. Does not pause if a formspec is
668 #    open.
669 pause_on_lost_focus (Pause on lost window focus) bool false
670
671 #    View distance in nodes.
672 viewing_range (Viewing range) int 190 20 4000
673
674 #   Camera 'near clipping plane' distance in nodes, between 0 and 0.25
675 #   Only works on GLES platforms. Most users will not need to change this.
676 #   Increasing can reduce artifacting on weaker GPUs.
677 #   0.1 = Default, 0.25 = Good value for weaker tablets.
678 near_plane (Near plane) float 0.1 0 0.25
679
680 #    Width component of the initial window size. Ignored in fullscreen mode.
681 screen_w (Screen width) int 1024 1
682
683 #    Height component of the initial window size. Ignored in fullscreen mode.
684 screen_h (Screen height) int 600 1
685
686 #    Save window size automatically when modified.
687 autosave_screensize (Autosave screen size) bool true
688
689 #    Fullscreen mode.
690 fullscreen (Full screen) bool false
691
692 #    Vertical screen synchronization.
693 vsync (VSync) bool false
694
695 #    Field of view in degrees.
696 fov (Field of view) int 72 45 160
697
698 #    Alters the light curve by applying 'gamma correction' to it.
699 #    Higher values make middle and lower light levels brighter.
700 #    Value '1.0' leaves the light curve unaltered.
701 #    This only has significant effect on daylight and artificial
702 #    light, it has very little effect on natural night light.
703 display_gamma (Light curve gamma) float 1.0 0.33 3.0
704
705 #    Gradient of light curve at minimum light level.
706 #    Controls the contrast of the lowest light levels.
707 lighting_alpha (Light curve low gradient) float 0.0 0.0 3.0
708
709 #    Gradient of light curve at maximum light level.
710 #    Controls the contrast of the highest light levels.
711 lighting_beta (Light curve high gradient) float 1.5 0.0 3.0
712
713 #    Strength of light curve boost.
714 #    The 3 'boost' parameters define a range of the light
715 #    curve that is boosted in brightness.
716 lighting_boost (Light curve boost) float 0.2 0.0 0.4
717
718 #    Center of light curve boost range.
719 #    Where 0.0 is minimum light level, 1.0 is maximum light level.
720 lighting_boost_center (Light curve boost center) float 0.5 0.0 1.0
721
722 #    Spread of light curve boost range.
723 #    Controls the width of the range to be boosted.
724 #    Standard deviation of the light curve boost Gaussian.
725 lighting_boost_spread (Light curve boost spread) float 0.2 0.0 0.4
726
727 #    Path to texture directory. All textures are first searched from here.
728 texture_path (Texture path) path
729
730 #    The rendering back-end.
731 #    A restart is required after changing this.
732 #    Note: On Android, stick with OGLES1 if unsure! App may fail to start otherwise.
733 #    On other platforms, OpenGL is recommended.
734 #    Shaders are supported by OpenGL (desktop only) and OGLES2 (experimental)
735 video_driver (Video driver) enum opengl opengl,ogles1,ogles2
736
737 #    Radius of cloud area stated in number of 64 node cloud squares.
738 #    Values larger than 26 will start to produce sharp cutoffs at cloud area corners.
739 cloud_radius (Cloud radius) int 12
740
741 #    Enable view bobbing and amount of view bobbing.
742 #    For example: 0 for no view bobbing; 1.0 for normal; 2.0 for double.
743 view_bobbing_amount (View bobbing factor) float 1.0
744
745 #    Multiplier for fall bobbing.
746 #    For example: 0 for no view bobbing; 1.0 for normal; 2.0 for double.
747 fall_bobbing_amount (Fall bobbing factor) float 0.03
748
749 #    3D support.
750 #    Currently supported:
751 #    -    none: no 3d output.
752 #    -    anaglyph: cyan/magenta color 3d.
753 #    -    interlaced: odd/even line based polarisation screen support.
754 #    -    topbottom: split screen top/bottom.
755 #    -    sidebyside: split screen side by side.
756 #    -    crossview: Cross-eyed 3d
757 #    -    pageflip: quadbuffer based 3d.
758 #    Note that the interlaced mode requires shaders to be enabled.
759 3d_mode (3D mode) enum none none,anaglyph,interlaced,topbottom,sidebyside,crossview,pageflip
760
761 #    Strength of 3D mode parallax.
762 3d_paralax_strength (3D mode parallax strength) float 0.025
763
764 #    In-game chat console height, between 0.1 (10%) and 1.0 (100%).
765 console_height (Console height) float 0.6 0.1 1.0
766
767 #    In-game chat console background color (R,G,B).
768 console_color (Console color) string (0,0,0)
769
770 #    In-game chat console background alpha (opaqueness, between 0 and 255).
771 console_alpha (Console alpha) int 200 0 255
772
773 #    Formspec full-screen background opacity (between 0 and 255).
774 formspec_fullscreen_bg_opacity (Formspec Full-Screen Background Opacity) int 140 0 255
775
776 #    Formspec full-screen background color (R,G,B).
777 formspec_fullscreen_bg_color (Formspec Full-Screen Background Color) string (0,0,0)
778
779 #    Formspec default background opacity (between 0 and 255).
780 formspec_default_bg_opacity (Formspec Default Background Opacity) int 140 0 255
781
782 #    Formspec default background color (R,G,B).
783 formspec_default_bg_color (Formspec Default Background Color) string (0,0,0)
784
785 #    Selection box border color (R,G,B).
786 selectionbox_color (Selection box color) string (0,0,0)
787
788 #    Width of the selection box lines around nodes.
789 selectionbox_width (Selection box width) int 2 1 5
790
791 #    Crosshair color (R,G,B).
792 #    Also controls the object crosshair color
793 crosshair_color (Crosshair color) string (255,255,255)
794
795 #    Crosshair alpha (opaqueness, between 0 and 255).
796 #    This also applies to the object crosshair.
797 crosshair_alpha (Crosshair alpha) int 255 0 255
798
799 #    Maximum number of recent chat messages to show
800 recent_chat_messages (Recent Chat Messages) int 6 2 20
801
802 #    Whether node texture animations should be desynchronized per mapblock.
803 desynchronize_mapblock_texture_animation (Desynchronize block animation) bool true
804
805 #    Maximum proportion of current window to be used for hotbar.
806 #    Useful if there's something to be displayed right or left of hotbar.
807 hud_hotbar_max_width (Maximum hotbar width) float 1.0
808
809 #    Modifies the size of the HUD elements.
810 hud_scaling (HUD scale factor) float 1.0
811
812 #    Enables caching of facedir rotated meshes.
813 enable_mesh_cache (Mesh cache) bool false
814
815 #    Delay between mesh updates on the client in ms. Increasing this will slow
816 #    down the rate of mesh updates, thus reducing jitter on slower clients.
817 mesh_generation_interval (Mapblock mesh generation delay) int 0 0 50
818
819 #    Size of the MapBlock cache of the mesh generator. Increasing this will
820 #    increase the cache hit %, reducing the data being copied from the main
821 #    thread, thus reducing jitter.
822 meshgen_block_cache_size (Mapblock mesh generator's MapBlock cache size in MB) int 20 0 1000
823
824 #    Enables minimap.
825 enable_minimap (Minimap) bool true
826
827 #    Shape of the minimap. Enabled = round, disabled = square.
828 minimap_shape_round (Round minimap) bool true
829
830 #    True = 256
831 #    False = 128
832 #    Usable to make minimap smoother on slower machines.
833 minimap_double_scan_height (Minimap scan height) bool true
834
835 #    Make fog and sky colors depend on daytime (dawn/sunset) and view direction.
836 directional_colored_fog (Colored fog) bool true
837
838 #    The strength (darkness) of node ambient-occlusion shading.
839 #    Lower is darker, Higher is lighter. The valid range of values for this
840 #    setting is 0.25 to 4.0 inclusive. If the value is out of range it will be
841 #    set to the nearest valid value.
842 ambient_occlusion_gamma (Ambient occlusion gamma) float 2.2 0.25 4.0
843
844 #    Enables animation of inventory items.
845 inventory_items_animations (Inventory items animations) bool false
846
847 #    Fraction of the visible distance at which fog starts to be rendered
848 fog_start (Fog start) float 0.4 0.0 0.99
849
850 #    Makes all liquids opaque
851 opaque_water (Opaque liquids) bool false
852
853 #    Textures on a node may be aligned either to the node or to the world.
854 #    The former mode suits better things like machines, furniture, etc., while
855 #    the latter makes stairs and microblocks fit surroundings better.
856 #    However, as this possibility is new, thus may not be used by older servers,
857 #    this option allows enforcing it for certain node types. Note though that
858 #    that is considered EXPERIMENTAL and may not work properly.
859 world_aligned_mode (World-aligned textures mode) enum enable disable,enable,force_solid,force_nodebox
860
861 #    World-aligned textures may be scaled to span several nodes. However,
862 #    the server may not send the scale you want, especially if you use
863 #    a specially-designed texture pack; with this option, the client tries
864 #    to determine the scale automatically basing on the texture size.
865 #    See also texture_min_size.
866 #    Warning: This option is EXPERIMENTAL!
867 autoscale_mode (Autoscaling mode) enum disable disable,enable,force
868
869 #    Show entity selection boxes
870 #    A restart is required after changing this.
871 show_entity_selectionbox (Show entity selection boxes) bool false
872
873 #    Distance in nodes at which transparency depth sorting is enabled
874 #    Use this to limit the performance impact of transparency depth sorting
875 transparency_sorting_distance (Transparency Sorting Distance) int 16 0 128
876
877 [*Menus]
878
879 #    Use a cloud animation for the main menu background.
880 menu_clouds (Clouds in menu) bool true
881
882 #    Scale GUI by a user specified value.
883 #    Use a nearest-neighbor-anti-alias filter to scale the GUI.
884 #    This will smooth over some of the rough edges, and blend
885 #    pixels when scaling down, at the cost of blurring some
886 #    edge pixels when images are scaled by non-integer sizes.
887 gui_scaling (GUI scaling) float 1.0 0.001
888
889 #    When gui_scaling_filter is true, all GUI images need to be
890 #    filtered in software, but some images are generated directly
891 #    to hardware (e.g. render-to-texture for nodes in inventory).
892 gui_scaling_filter (GUI scaling filter) bool false
893
894 #    When gui_scaling_filter_txr2img is true, copy those images
895 #    from hardware to software for scaling.  When false, fall back
896 #    to the old scaling method, for video drivers that don't
897 #    properly support downloading textures back from hardware.
898 gui_scaling_filter_txr2img (GUI scaling filter txr2img) bool true
899
900 #    Delay showing tooltips, stated in milliseconds.
901 tooltip_show_delay (Tooltip delay) int 400
902
903 #    Append item name to tooltip.
904 tooltip_append_itemname (Append item name) bool false
905
906 font_bold (Font bold by default) bool false
907
908 font_italic (Font italic by default) bool false
909
910 #    Shadow offset (in pixels) of the default font. If 0, then shadow will not be drawn.
911 font_shadow (Font shadow) int 1
912
913 #    Opaqueness (alpha) of the shadow behind the default font, between 0 and 255.
914 font_shadow_alpha (Font shadow alpha) int 127 0 255
915
916 #    Font size of the default font where 1 unit = 1 pixel at 96 DPI
917 font_size (Font size) int 16 1
918
919 #    For pixel-style fonts that do not scale well, this ensures that font sizes used
920 #    with this font will always be divisible by this value, in pixels. For instance,
921 #    a pixel font 16 pixels tall should have this set to 16, so it will only ever be
922 #    sized 16, 32, 48, etc., so a mod requesting a size of 25 will get 32.
923 font_size_divisible_by (Font size divisible by) int 1 1
924
925 #    Path to the default font. Must be a TrueType font.
926 #    The fallback font will be used if the font cannot be loaded.
927 font_path (Regular font path) filepath fonts/Arimo-Regular.ttf
928
929 font_path_bold (Bold font path) filepath fonts/Arimo-Bold.ttf
930 font_path_italic (Italic font path) filepath fonts/Arimo-Italic.ttf
931 font_path_bold_italic (Bold and italic font path) filepath fonts/Arimo-BoldItalic.ttf
932
933 #    Font size of the monospace font where 1 unit = 1 pixel at 96 DPI
934 mono_font_size (Monospace font size) int 16 1
935
936 #    For pixel-style fonts that do not scale well, this ensures that font sizes used
937 #    with this font will always be divisible by this value, in pixels. For instance,
938 #    a pixel font 16 pixels tall should have this set to 16, so it will only ever be
939 #    sized 16, 32, 48, etc., so a mod requesting a size of 25 will get 32.
940 mono_font_size_divisible_by (Monospace font size divisible by) int 1 1
941
942 #    Path to the monospace font. Must be a TrueType font.
943 #    This font is used for e.g. the console and profiler screen.
944 mono_font_path (Monospace font path) filepath fonts/Cousine-Regular.ttf
945
946 mono_font_path_bold (Bold monospace font path) filepath fonts/Cousine-Bold.ttf
947 mono_font_path_italic (Italic monospace font path) filepath fonts/Cousine-Italic.ttf
948 mono_font_path_bold_italic (Bold and italic monospace font path) filepath fonts/Cousine-BoldItalic.ttf
949
950 #    Path of the fallback font. Must be a TrueType font.
951 #    This font will be used for certain languages or if the default font is unavailable.
952 fallback_font_path (Fallback font path) filepath fonts/DroidSansFallbackFull.ttf
953
954 #    Font size of the recent chat text and chat prompt in point (pt).
955 #    Value 0 will use the default font size.
956 chat_font_size (Chat font size) int 0
957
958 #    Path to save screenshots at. Can be an absolute or relative path.
959 #    The folder will be created if it doesn't already exist.
960 screenshot_path (Screenshot folder) path screenshots
961
962 #    Format of screenshots.
963 screenshot_format (Screenshot format) enum png png,jpg
964
965 #    Screenshot quality. Only used for JPEG format.
966 #    1 means worst quality; 100 means best quality.
967 #    Use 0 for default quality.
968 screenshot_quality (Screenshot quality) int 0 0 100
969
970 [*Advanced]
971
972 #    Adjust dpi configuration to your screen (non X11/Android only) e.g. for 4k screens.
973 screen_dpi (DPI) int 72 1
974
975 #    Adjust the detected display density, used for scaling UI elements.
976 display_density_factor (Display Density Scaling Factor) float 1
977
978 #    Windows systems only: Start Minetest with the command line window in the background.
979 #    Contains the same information as the file debug.txt (default name).
980 enable_console (Enable console window) bool false
981
982 [Sound]
983
984 #    Enables the sound system.
985 #    If disabled, this completely disables all sounds everywhere and the in-game
986 #    sound controls will be non-functional.
987 #    Changing this setting requires a restart.
988 enable_sound (Sound) bool true
989
990 #    Volume of all sounds.
991 #    Requires the sound system to be enabled.
992 sound_volume (Volume) float 0.7 0.0 1.0
993
994 #    Whether to mute sounds. You can unmute sounds at any time, unless the
995 #    sound system is disabled (enable_sound=false).
996 #    In-game, you can toggle the mute state with the mute key or by using the
997 #    pause menu.
998 mute_sound (Mute sound) bool false
999
1000 [Client]
1001
1002 #    Clickable weblinks (middle-click or Ctrl+left-click) enabled in chat console output.
1003 clickable_chat_weblinks (Chat weblinks) bool true
1004
1005 #    Optional override for chat weblink color.
1006 chat_weblink_color (Weblink color) string
1007
1008 [*Network]
1009
1010 #    Address to connect to.
1011 #    Leave this blank to start a local server.
1012 #    Note that the address field in the main menu overrides this setting.
1013 address (Server address) string
1014
1015 #    Port to connect to (UDP).
1016 #    Note that the port field in the main menu overrides this setting.
1017 remote_port (Remote port) int 30000 1 65535
1018
1019 #    Prometheus listener address.
1020 #    If Minetest is compiled with ENABLE_PROMETHEUS option enabled,
1021 #    enable metrics listener for Prometheus on that address.
1022 #    Metrics can be fetched on http://127.0.0.1:30000/metrics
1023 prometheus_listener_address (Prometheus listener address) string 127.0.0.1:30000
1024
1025 #    Save the map received by the client on disk.
1026 enable_local_map_saving (Saving map received from server) bool false
1027
1028 #    Enable usage of remote media server (if provided by server).
1029 #    Remote servers offer a significantly faster way to download media (e.g. textures)
1030 #    when connecting to the server.
1031 enable_remote_media_server (Connect to external media server) bool true
1032
1033 #    Enable Lua modding support on client.
1034 #    This support is experimental and API can change.
1035 enable_client_modding (Client modding) bool false
1036
1037 #    URL to the server list displayed in the Multiplayer Tab.
1038 serverlist_url (Serverlist URL) string servers.minetest.net
1039
1040 #    File in client/serverlist/ that contains your favorite servers displayed in the
1041 #    Multiplayer Tab.
1042 serverlist_file (Serverlist file) string favoriteservers.json
1043
1044 #    Maximum size of the out chat queue.
1045 #    0 to disable queueing and -1 to make the queue size unlimited.
1046 max_out_chat_queue_size (Maximum size of the out chat queue) int 20
1047
1048 #    Enable register confirmation when connecting to server.
1049 #    If disabled, new account will be registered automatically.
1050 enable_register_confirmation (Enable register confirmation) bool true
1051
1052 [*Advanced]
1053
1054 #    Timeout for client to remove unused map data from memory.
1055 client_unload_unused_data_timeout (Mapblock unload timeout) int 600
1056
1057 #    Maximum number of mapblocks for client to be kept in memory.
1058 #    Set to -1 for unlimited amount.
1059 client_mapblock_limit (Mapblock limit) int 7500
1060
1061 #    Whether to show technical names.
1062 #    Affects mods and texture packs in the Content and Select Mods menus, as well as
1063 #    setting names in All Settings.
1064 #    Controlled by the checkbox in the "All settings" menu.
1065 show_technical_names (Show technical names) bool false
1066
1067 #    Whether to show the client debug info (has the same effect as hitting F5).
1068 show_debug (Show debug info) bool false
1069
1070 [Server / Singleplayer]
1071
1072 #    Name of the server, to be displayed when players join and in the serverlist.
1073 server_name (Server name) string Minetest server
1074
1075 #    Description of server, to be displayed when players join and in the serverlist.
1076 server_description (Server description) string mine here
1077
1078 #    Domain name of server, to be displayed in the serverlist.
1079 server_address (Server address) string game.minetest.net
1080
1081 #    Homepage of server, to be displayed in the serverlist.
1082 server_url (Server URL) string https://minetest.net
1083
1084 #    Automatically report to the serverlist.
1085 server_announce (Announce server) bool false
1086
1087 #    Announce to this serverlist.
1088 serverlist_url (Serverlist URL) string servers.minetest.net
1089
1090 #    Remove color codes from incoming chat messages
1091 #    Use this to stop players from being able to use color in their messages
1092 strip_color_codes (Strip color codes) bool false
1093
1094 [*Network]
1095
1096 #    Network port to listen (UDP).
1097 #    This value will be overridden when starting from the main menu.
1098 port (Server port) int 30000
1099
1100 #    The network interface that the server listens on.
1101 bind_address (Bind address) string
1102
1103 #    Enable to disallow old clients from connecting.
1104 #    Older clients are compatible in the sense that they will not crash when connecting
1105 #    to new servers, but they may not support all new features that you are expecting.
1106 strict_protocol_version_checking (Strict protocol checking) bool false
1107
1108 #    Specifies URL from which client fetches media instead of using UDP.
1109 #    $filename should be accessible from $remote_media$filename via cURL
1110 #    (obviously, remote_media should end with a slash).
1111 #    Files that are not present will be fetched the usual way.
1112 remote_media (Remote media) string
1113
1114 #    Enable/disable running an IPv6 server.
1115 #    Ignored if bind_address is set.
1116 #    Needs enable_ipv6 to be enabled.
1117 ipv6_server (IPv6 server) bool false
1118
1119 [**Advanced]
1120
1121 #    Maximum number of blocks that are simultaneously sent per client.
1122 #    The maximum total count is calculated dynamically:
1123 #    max_total = ceil((#clients + max_users) * per_client / 4)
1124 max_simultaneous_block_sends_per_client (Maximum simultaneous block sends per client) int 40
1125
1126 #    To reduce lag, block transfers are slowed down when a player is building something.
1127 #    This determines how long they are slowed down after placing or removing a node.
1128 full_block_send_enable_min_time_from_building (Delay in sending blocks after building) float 2.0
1129
1130 #    Maximum number of packets sent per send step, if you have a slow connection
1131 #    try reducing it, but don't reduce it to a number below double of targeted
1132 #    client number.
1133 max_packets_per_iteration (Max. packets per iteration) int 1024
1134
1135 #    Compression level to use when sending mapblocks to the client.
1136 #    -1 - use default compression level
1137 #     0 - least compression, fastest
1138 #     9 - best compression, slowest
1139 map_compression_level_net (Map Compression Level for Network Transfer) int -1 -1 9
1140
1141 [*Game]
1142
1143 #    Default game when creating a new world.
1144 #    This will be overridden when creating a world from the main menu.
1145 default_game (Default game) string minetest
1146
1147 #    Message of the day displayed to players connecting.
1148 motd (Message of the day) string
1149
1150 #    Maximum number of players that can be connected simultaneously.
1151 max_users (Maximum users) int 15
1152
1153 #    World directory (everything in the world is stored here).
1154 #    Not needed if starting from the main menu.
1155 map-dir (Map directory) path
1156
1157 #    Time in seconds for item entity (dropped items) to live.
1158 #    Setting it to -1 disables the feature.
1159 item_entity_ttl (Item entity TTL) int 900
1160
1161 #    Specifies the default stack size of nodes, items and tools.
1162 #    Note that mods or games may explicitly set a stack for certain (or all) items.
1163 default_stack_max (Default stack size) int 99
1164
1165 #    Enable players getting damage and dying.
1166 enable_damage (Damage) bool false
1167
1168 #    Enable creative mode for all players
1169 creative_mode (Creative) bool false
1170
1171 #    A chosen map seed for a new map, leave empty for random.
1172 #    Will be overridden when creating a new world in the main menu.
1173 fixed_map_seed (Fixed map seed) string
1174
1175 #    New users need to input this password.
1176 default_password (Default password) string
1177
1178 #    The privileges that new users automatically get.
1179 #    See /privs in game for a full list on your server and mod configuration.
1180 default_privs (Default privileges) string interact, shout
1181
1182 #    Privileges that players with basic_privs can grant
1183 basic_privs (Basic privileges) string interact, shout
1184
1185 #    Whether players are shown to clients without any range limit.
1186 #    Deprecated, use the setting player_transfer_distance instead.
1187 unlimited_player_transfer_distance (Unlimited player transfer distance) bool true
1188
1189 #    Defines the maximal player transfer distance in blocks (0 = unlimited).
1190 player_transfer_distance (Player transfer distance) int 0
1191
1192 #    Whether to allow players to damage and kill each other.
1193 enable_pvp (Player versus player) bool true
1194
1195 #    Enable mod channels support.
1196 enable_mod_channels (Mod channels) bool false
1197
1198 #    If this is set, players will always (re)spawn at the given position.
1199 static_spawnpoint (Static spawnpoint) string
1200
1201 #    If enabled, players cannot join without a password or change theirs to an empty password.
1202 disallow_empty_password (Disallow empty passwords) bool false
1203
1204 #    If enabled, disable cheat prevention in multiplayer.
1205 disable_anticheat (Disable anticheat) bool false
1206
1207 #    If enabled, actions are recorded for rollback.
1208 #    This option is only read when server starts.
1209 enable_rollback_recording (Rollback recording) bool false
1210
1211 #    Format of player chat messages. The following strings are valid placeholders:
1212 #    @name, @message, @timestamp (optional)
1213 chat_message_format (Chat message format) string <@name> @message
1214
1215 #    If the execution of a chat command takes longer than this specified time in
1216 #    seconds, add the time information to the chat command message
1217 chatcommand_msg_time_threshold (Chat command time message threshold) float 0.1
1218
1219 #    A message to be displayed to all clients when the server shuts down.
1220 kick_msg_shutdown (Shutdown message) string Server shutting down.
1221
1222 #    A message to be displayed to all clients when the server crashes.
1223 kick_msg_crash (Crash message) string This server has experienced an internal error. You will now be disconnected.
1224
1225 #    Whether to ask clients to reconnect after a (Lua) crash.
1226 #    Set this to true if your server is set up to restart automatically.
1227 ask_reconnect_on_crash (Ask to reconnect after crash) bool false
1228
1229 #    From how far clients know about objects, stated in mapblocks (16 nodes).
1230 #
1231 #    Setting this larger than active_block_range will also cause the server
1232 #    to maintain active objects up to this distance in the direction the
1233 #    player is looking. (This can avoid mobs suddenly disappearing from view)
1234 active_object_send_range_blocks (Active object send range) int 8
1235
1236 #    The radius of the volume of blocks around every player that is subject to the
1237 #    active block stuff, stated in mapblocks (16 nodes).
1238 #    In active blocks objects are loaded and ABMs run.
1239 #    This is also the minimum range in which active objects (mobs) are maintained.
1240 #    This should be configured together with active_object_send_range_blocks.
1241 active_block_range (Active block range) int 4
1242
1243 #    From how far blocks are sent to clients, stated in mapblocks (16 nodes).
1244 max_block_send_distance (Max block send distance) int 12
1245
1246 #    Maximum number of forceloaded mapblocks.
1247 max_forceloaded_blocks (Maximum forceloaded blocks) int 16
1248
1249 #    Interval of sending time of day to clients.
1250 time_send_interval (Time send interval) int 5
1251
1252 #    Controls length of day/night cycle.
1253 #    Examples:
1254 #    72 = 20min, 360 = 4min, 1 = 24hour, 0 = day/night/whatever stays unchanged.
1255 time_speed (Time speed) int 72
1256
1257 #    Time of day when a new world is started, in millihours (0-23999).
1258 world_start_time (World start time) int 6125 0 23999
1259
1260 #    Interval of saving important changes in the world, stated in seconds.
1261 server_map_save_interval (Map save interval) float 5.3
1262
1263 #    Set the maximum character length of a chat message sent by clients.
1264 chat_message_max_size (Chat message max length) int 500
1265
1266 #    Amount of messages a player may send per 10 seconds.
1267 chat_message_limit_per_10sec (Chat message count limit) float 10.0
1268
1269 #    Kick players who sent more than X messages per 10 seconds.
1270 chat_message_limit_trigger_kick (Chat message kick threshold) int 50
1271
1272 [**Physics]
1273
1274 #    Horizontal and vertical acceleration on ground or when climbing,
1275 #    in nodes per second per second.
1276 movement_acceleration_default (Default acceleration) float 3
1277
1278 #    Horizontal acceleration in air when jumping or falling,
1279 #    in nodes per second per second.
1280 movement_acceleration_air (Acceleration in air) float 2
1281
1282 #    Horizontal and vertical acceleration in fast mode,
1283 #    in nodes per second per second.
1284 movement_acceleration_fast (Fast mode acceleration) float 10
1285
1286 #    Walking and flying speed, in nodes per second.
1287 movement_speed_walk (Walking speed) float 4
1288
1289 #    Sneaking speed, in nodes per second.
1290 movement_speed_crouch (Sneaking speed) float 1.35
1291
1292 #    Walking, flying and climbing speed in fast mode, in nodes per second.
1293 movement_speed_fast (Fast mode speed) float 20
1294
1295 #    Vertical climbing speed, in nodes per second.
1296 movement_speed_climb (Climbing speed) float 3
1297
1298 #    Initial vertical speed when jumping, in nodes per second.
1299 movement_speed_jump (Jumping speed) float 6.5
1300
1301 #    Decrease this to increase liquid resistance to movement.
1302 movement_liquid_fluidity (Liquid fluidity) float 1
1303
1304 #    Maximum liquid resistance. Controls deceleration when entering liquid at
1305 #    high speed.
1306 movement_liquid_fluidity_smooth (Liquid fluidity smoothing) float 0.5
1307
1308 #    Controls sinking speed in liquid.
1309 movement_liquid_sink (Liquid sinking) float 10
1310
1311 #    Acceleration of gravity, in nodes per second per second.
1312 movement_gravity (Gravity) float 9.81
1313
1314 [**Advanced]
1315
1316 #    Handling for deprecated Lua API calls:
1317 #    -    none: Do not log deprecated calls
1318 #    -    log: mimic and log backtrace of deprecated call (default).
1319 #    -    error: abort on usage of deprecated call (suggested for mod developers).
1320 deprecated_lua_api_handling (Deprecated Lua API handling) enum log none,log,error
1321
1322 #    Number of extra blocks that can be loaded by /clearobjects at once.
1323 #    This is a trade-off between SQLite transaction overhead and
1324 #    memory consumption (4096=100MB, as a rule of thumb).
1325 max_clearobjects_extra_loaded_blocks (Max. clearobjects extra blocks) int 4096
1326
1327 #    How much the server will wait before unloading unused mapblocks.
1328 #    Higher value is smoother, but will use more RAM.
1329 server_unload_unused_data_timeout (Unload unused server data) int 29
1330
1331 #    Maximum number of statically stored objects in a block.
1332 max_objects_per_block (Maximum objects per block) int 256
1333
1334 #    See https://www.sqlite.org/pragma.html#pragma_synchronous
1335 sqlite_synchronous (Synchronous SQLite) enum 2 0,1,2
1336
1337 #    Compression level to use when saving mapblocks to disk.
1338 #    -1 - use default compression level
1339 #     0 - least compression, fastest
1340 #     9 - best compression, slowest
1341 map_compression_level_disk (Map Compression Level for Disk Storage) int -1 -1 9
1342
1343 #    Length of a server tick and the interval at which objects are generally updated over
1344 #    network.
1345 dedicated_server_step (Dedicated server step) float 0.09
1346
1347 #    Length of time between active block management cycles
1348 active_block_mgmt_interval (Active block management interval) float 2.0
1349
1350 #    Length of time between Active Block Modifier (ABM) execution cycles
1351 abm_interval (ABM interval) float 1.0
1352
1353 #    The time budget allowed for ABMs to execute on each step
1354 #    (as a fraction of the ABM Interval)
1355 abm_time_budget (ABM time budget) float 0.2 0.1 0.9
1356
1357 #    Length of time between NodeTimer execution cycles
1358 nodetimer_interval (NodeTimer interval) float 0.2
1359
1360 #    If enabled, invalid world data won't cause the server to shut down.
1361 #    Only enable this if you know what you are doing.
1362 ignore_world_load_errors (Ignore world errors) bool false
1363
1364 #    Max liquids processed per step.
1365 liquid_loop_max (Liquid loop max) int 100000
1366
1367 #    The time (in seconds) that the liquids queue may grow beyond processing
1368 #    capacity until an attempt is made to decrease its size by dumping old queue
1369 #    items.  A value of 0 disables the functionality.
1370 liquid_queue_purge_time (Liquid queue purge time) int 0
1371
1372 #    Liquid update interval in seconds.
1373 liquid_update (Liquid update tick) float 1.0
1374
1375 #    At this distance the server will aggressively optimize which blocks are sent to
1376 #    clients.
1377 #    Small values potentially improve performance a lot, at the expense of visible
1378 #    rendering glitches (some blocks will not be rendered under water and in caves,
1379 #    as well as sometimes on land).
1380 #    Setting this to a value greater than max_block_send_distance disables this
1381 #    optimization.
1382 #    Stated in mapblocks (16 nodes).
1383 block_send_optimize_distance (Block send optimize distance) int 4 2
1384
1385 #    If enabled the server will perform map block occlusion culling based on
1386 #    on the eye position of the player. This can reduce the number of blocks
1387 #    sent to the client 50-80%. The client will not longer receive most invisible
1388 #    so that the utility of noclip mode is reduced.
1389 server_side_occlusion_culling (Server side occlusion culling) bool true
1390
1391 #    Restricts the access of certain client-side functions on servers.
1392 #    Combine the byteflags below to restrict client-side features, or set to 0
1393 #    for no restrictions:
1394 #    LOAD_CLIENT_MODS: 1 (disable loading client-provided mods)
1395 #    CHAT_MESSAGES: 2 (disable send_chat_message call client-side)
1396 #    READ_ITEMDEFS: 4 (disable get_item_def call client-side)
1397 #    READ_NODEDEFS: 8 (disable get_node_def call client-side)
1398 #    LOOKUP_NODES_LIMIT: 16 (limits get_node call client-side to
1399 #    csm_restriction_noderange)
1400 #    READ_PLAYERINFO: 32 (disable get_player_names call client-side)
1401 csm_restriction_flags (Client side modding restrictions) int 62
1402
1403 #   If the CSM restriction for node range is enabled, get_node calls are limited
1404 #   to this distance from the player to the node.
1405 csm_restriction_noderange (Client side node lookup range restriction) int 0
1406
1407 [*Security]
1408
1409 #    Prevent mods from doing insecure things like running shell commands.
1410 secure.enable_security (Enable mod security) bool true
1411
1412 #    Comma-separated list of trusted mods that are allowed to access insecure
1413 #    functions even when mod security is on (via request_insecure_environment()).
1414 secure.trusted_mods (Trusted mods) string
1415
1416 #    Comma-separated list of mods that are allowed to access HTTP APIs, which
1417 #    allow them to upload and download data to/from the internet.
1418 secure.http_mods (HTTP mods) string
1419
1420 [*Advanced]
1421
1422 [**Profiling]
1423 #    Load the game profiler to collect game profiling data.
1424 #    Provides a /profiler command to access the compiled profile.
1425 #    Useful for mod developers and server operators.
1426 profiler.load (Load the game profiler) bool false
1427
1428 #    The default format in which profiles are being saved,
1429 #    when calling `/profiler save [format]` without format.
1430 profiler.default_report_format (Default report format) enum txt txt,csv,lua,json,json_pretty
1431
1432 #    The file path relative to your worldpath in which profiles will be saved to.
1433 profiler.report_path (Report path) string ""
1434
1435 [***Instrumentation]
1436
1437 #    Instrument the methods of entities on registration.
1438 instrument.entity (Entity methods) bool true
1439
1440 #    Instrument the action function of Active Block Modifiers on registration.
1441 instrument.abm (Active Block Modifiers) bool true
1442
1443 #    Instrument the action function of Loading Block Modifiers on registration.
1444 instrument.lbm (Loading Block Modifiers) bool true
1445
1446 #    Instrument chat commands on registration.
1447 instrument.chatcommand (Chat commands) bool true
1448
1449 #    Instrument global callback functions on registration.
1450 #    (anything you pass to a minetest.register_*() function)
1451 instrument.global_callback (Global callbacks) bool true
1452
1453 [****Advanced]
1454 #    Instrument builtin.
1455 #    This is usually only needed by core/builtin contributors
1456 instrument.builtin (Builtin) bool false
1457
1458 #    Have the profiler instrument itself:
1459 #     * Instrument an empty function.
1460 #       This estimates the overhead, that instrumentation is adding (+1 function call).
1461 #     * Instrument the sampler being used to update the statistics.
1462 instrument.profiler (Profiler) bool false
1463
1464 [Client and Server]
1465
1466 #    Name of the player.
1467 #    When running a server, clients connecting with this name are admins.
1468 #    When starting from the main menu, this is overridden.
1469 name (Player name) string
1470
1471 #    Set the language. Leave empty to use the system language.
1472 #    A restart is required after changing this.
1473 language (Language) enum   ,be,bg,ca,cs,da,de,el,en,eo,es,et,eu,fi,fr,gd,gl,hu,id,it,ja,jbo,kk,ko,lt,lv,ms,nb,nl,nn,pl,pt,pt_BR,ro,ru,sk,sl,sr_Cyrl,sr_Latn,sv,sw,tr,uk,vi,zh_CN,zh_TW
1474
1475 #    Level of logging to be written to debug.txt:
1476 #    -    <nothing> (no logging)
1477 #    -    none (messages with no level)
1478 #    -    error
1479 #    -    warning
1480 #    -    action
1481 #    -    info
1482 #    -    verbose
1483 #    -    trace
1484 debug_log_level (Debug log level) enum action ,none,error,warning,action,info,verbose,trace
1485
1486 #    If the file size of debug.txt exceeds the number of megabytes specified in
1487 #    this setting when it is opened, the file is moved to debug.txt.1,
1488 #    deleting an older debug.txt.1 if it exists.
1489 #    debug.txt is only moved if this setting is positive.
1490 debug_log_size_max (Debug log file size threshold) int 50
1491
1492 #    Minimal level of logging to be written to chat.
1493 chat_log_level (Chat log level) enum error ,none,error,warning,action,info,verbose,trace
1494
1495 #    Enable IPv6 support (for both client and server).
1496 #    Required for IPv6 connections to work at all.
1497 enable_ipv6 (IPv6) bool true
1498
1499 [*Advanced]
1500
1501 #    Maximum time an interactive request (e.g. server list fetch) may take, stated in milliseconds.
1502 curl_timeout (cURL interactive timeout) int 20000
1503
1504 #    Limits number of parallel HTTP requests. Affects:
1505 #    -    Media fetch if server uses remote_media setting.
1506 #    -    Serverlist download and server announcement.
1507 #    -    Downloads performed by main menu (e.g. mod manager).
1508 #    Only has an effect if compiled with cURL.
1509 curl_parallel_limit (cURL parallel limit) int 8
1510
1511 #    Maximum time a file download (e.g. a mod download) may take, stated in milliseconds.
1512 curl_file_download_timeout (cURL file download timeout) int 300000
1513
1514 #    Replaces the default main menu with a custom one.
1515 main_menu_script (Main menu script) string
1516
1517 #    Print the engine's profiling data in regular intervals (in seconds).
1518 #    0 = disable. Useful for developers.
1519 profiler_print_interval (Engine profiling data print interval) int 0
1520
1521 [Mapgen]
1522
1523 #    Name of map generator to be used when creating a new world.
1524 #    Creating a world in the main menu will override this.
1525 #    Current mapgens in a highly unstable state:
1526 #    -    The optional floatlands of v7 (disabled by default).
1527 mg_name (Mapgen name) enum v7 v7,valleys,carpathian,v5,flat,fractal,singlenode,v6
1528
1529 #    Water surface level of the world.
1530 water_level (Water level) int 1
1531
1532 #    From how far blocks are generated for clients, stated in mapblocks (16 nodes).
1533 max_block_generate_distance (Max block generate distance) int 10
1534
1535 #    Limit of map generation, in nodes, in all 6 directions from (0, 0, 0).
1536 #    Only mapchunks completely within the mapgen limit are generated.
1537 #    Value is stored per-world.
1538 mapgen_limit (Map generation limit) int 31007 0 31007
1539
1540 #    Global map generation attributes.
1541 #    In Mapgen v6 the 'decorations' flag controls all decorations except trees
1542 #    and jungle grass, in all other mapgens this flag controls all decorations.
1543 mg_flags (Mapgen flags) flags caves,dungeons,light,decorations,biomes,ores caves,dungeons,light,decorations,biomes,ores,nocaves,nodungeons,nolight,nodecorations,nobiomes,noores
1544
1545 [*Biome API temperature and humidity noise parameters]
1546
1547 #    Temperature variation for biomes.
1548 mg_biome_np_heat (Heat noise) noise_params_2d 50, 50, (1000, 1000, 1000), 5349, 3, 0.5, 2.0, eased
1549
1550 #    Small-scale temperature variation for blending biomes on borders.
1551 mg_biome_np_heat_blend (Heat blend noise) noise_params_2d 0, 1.5, (8, 8, 8), 13, 2, 1.0, 2.0, eased
1552
1553 #    Humidity variation for biomes.
1554 mg_biome_np_humidity (Humidity noise) noise_params_2d 50, 50, (1000, 1000, 1000), 842, 3, 0.5, 2.0, eased
1555
1556 #    Small-scale humidity variation for blending biomes on borders.
1557 mg_biome_np_humidity_blend (Humidity blend noise) noise_params_2d 0, 1.5, (8, 8, 8), 90003, 2, 1.0, 2.0, eased
1558
1559 [*Mapgen V5]
1560
1561 #    Map generation attributes specific to Mapgen v5.
1562 mgv5_spflags (Mapgen V5 specific flags) flags caverns caverns,nocaverns
1563
1564 #    Controls width of tunnels, a smaller value creates wider tunnels.
1565 #    Value >= 10.0 completely disables generation of tunnels and avoids the
1566 #    intensive noise calculations.
1567 mgv5_cave_width (Cave width) float 0.09
1568
1569 #    Y of upper limit of large caves.
1570 mgv5_large_cave_depth (Large cave depth) int -256
1571
1572 #    Minimum limit of random number of small caves per mapchunk.
1573 mgv5_small_cave_num_min (Small cave minimum number) int 0 0 256
1574
1575 #    Maximum limit of random number of small caves per mapchunk.
1576 mgv5_small_cave_num_max (Small cave maximum number) int 0 0 256
1577
1578 #    Minimum limit of random number of large caves per mapchunk.
1579 mgv5_large_cave_num_min (Large cave minimum number) int 0 0 64
1580
1581 #    Maximum limit of random number of large caves per mapchunk.
1582 mgv5_large_cave_num_max (Large cave maximum number) int 2 0 64
1583
1584 #    Proportion of large caves that contain liquid.
1585 mgv5_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
1586
1587 #    Y-level of cavern upper limit.
1588 mgv5_cavern_limit (Cavern limit) int -256
1589
1590 #    Y-distance over which caverns expand to full size.
1591 mgv5_cavern_taper (Cavern taper) int 256
1592
1593 #    Defines full size of caverns, smaller values create larger caverns.
1594 mgv5_cavern_threshold (Cavern threshold) float 0.7
1595
1596 #    Lower Y limit of dungeons.
1597 mgv5_dungeon_ymin (Dungeon minimum Y) int -31000
1598
1599 #    Upper Y limit of dungeons.
1600 mgv5_dungeon_ymax (Dungeon maximum Y) int 31000
1601
1602 [**Noises]
1603
1604 #    Variation of biome filler depth.
1605 mgv5_np_filler_depth (Filler depth noise) noise_params_2d 0, 1, (150, 150, 150), 261, 4, 0.7, 2.0, eased
1606
1607 #    Variation of terrain vertical scale.
1608 #    When noise is < -0.55 terrain is near-flat.
1609 mgv5_np_factor (Factor noise) noise_params_2d 0, 1, (250, 250, 250), 920381, 3, 0.45, 2.0, eased
1610
1611 #    Y-level of average terrain surface.
1612 mgv5_np_height (Height noise) noise_params_2d 0, 10, (250, 250, 250), 84174, 4, 0.5, 2.0, eased
1613
1614 #    First of two 3D noises that together define tunnels.
1615 mgv5_np_cave1 (Cave1 noise) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
1616
1617 #    Second of two 3D noises that together define tunnels.
1618 mgv5_np_cave2 (Cave2 noise) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
1619
1620 #    3D noise defining giant caverns.
1621 mgv5_np_cavern (Cavern noise) noise_params_3d 0, 1, (384, 128, 384), 723, 5, 0.63, 2.0
1622
1623 #    3D noise defining terrain.
1624 mgv5_np_ground (Ground noise) noise_params_3d 0, 40, (80, 80, 80), 983240, 4, 0.55, 2.0, eased
1625
1626 #    3D noise that determines number of dungeons per mapchunk.
1627 mgv5_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
1628
1629 [*Mapgen V6]
1630
1631 #    Map generation attributes specific to Mapgen v6.
1632 #    The 'snowbiomes' flag enables the new 5 biome system.
1633 #    When the 'snowbiomes' flag is enabled jungles are automatically enabled and
1634 #    the 'jungles' flag is ignored.
1635 mgv6_spflags (Mapgen V6 specific flags) flags jungles,biomeblend,mudflow,snowbiomes,noflat,trees jungles,biomeblend,mudflow,snowbiomes,flat,trees,nojungles,nobiomeblend,nomudflow,nosnowbiomes,noflat,notrees
1636
1637 #    Deserts occur when np_biome exceeds this value.
1638 #    When the 'snowbiomes' flag is enabled, this is ignored.
1639 mgv6_freq_desert (Desert noise threshold) float 0.45
1640
1641 #    Sandy beaches occur when np_beach exceeds this value.
1642 mgv6_freq_beach (Beach noise threshold) float 0.15
1643
1644 #    Lower Y limit of dungeons.
1645 mgv6_dungeon_ymin (Dungeon minimum Y) int -31000
1646
1647 #    Upper Y limit of dungeons.
1648 mgv6_dungeon_ymax (Dungeon maximum Y) int 31000
1649
1650 [**Noises]
1651
1652 #    Y-level of lower terrain and seabed.
1653 mgv6_np_terrain_base (Terrain base noise) noise_params_2d -4, 20, (250, 250, 250), 82341, 5, 0.6, 2.0, eased
1654
1655 #    Y-level of higher terrain that creates cliffs.
1656 mgv6_np_terrain_higher (Terrain higher noise) noise_params_2d 20, 16, (500, 500, 500), 85039, 5, 0.6, 2.0, eased
1657
1658 #    Varies steepness of cliffs.
1659 mgv6_np_steepness (Steepness noise) noise_params_2d 0.85, 0.5, (125, 125, 125), -932, 5, 0.7, 2.0, eased
1660
1661 #    Defines distribution of higher terrain.
1662 mgv6_np_height_select (Height select noise) noise_params_2d 0.5, 1, (250, 250, 250), 4213, 5, 0.69, 2.0, eased
1663
1664 #    Varies depth of biome surface nodes.
1665 mgv6_np_mud (Mud noise) noise_params_2d 4, 2, (200, 200, 200), 91013, 3, 0.55, 2.0, eased
1666
1667 #    Defines areas with sandy beaches.
1668 mgv6_np_beach (Beach noise) noise_params_2d 0, 1, (250, 250, 250), 59420, 3, 0.50, 2.0, eased
1669
1670 #    Temperature variation for biomes.
1671 mgv6_np_biome (Biome noise) noise_params_2d 0, 1, (500, 500, 500), 9130, 3, 0.50, 2.0, eased
1672
1673 #    Variation of number of caves.
1674 mgv6_np_cave (Cave noise) noise_params_2d 6, 6, (250, 250, 250), 34329, 3, 0.50, 2.0, eased
1675
1676 #    Humidity variation for biomes.
1677 mgv6_np_humidity (Humidity noise) noise_params_2d 0.5, 0.5, (500, 500, 500), 72384, 3, 0.50, 2.0, eased
1678
1679 #    Defines tree areas and tree density.
1680 mgv6_np_trees (Trees noise) noise_params_2d 0, 1, (125, 125, 125), 2, 4, 0.66, 2.0, eased
1681
1682 #    Defines areas where trees have apples.
1683 mgv6_np_apple_trees (Apple trees noise) noise_params_2d 0, 1, (100, 100, 100), 342902, 3, 0.45, 2.0, eased
1684
1685 [*Mapgen V7]
1686
1687 #    Map generation attributes specific to Mapgen v7.
1688 #    'ridges': Rivers.
1689 #    'floatlands': Floating land masses in the atmosphere.
1690 #    'caverns': Giant caves deep underground.
1691 mgv7_spflags (Mapgen V7 specific flags) flags mountains,ridges,nofloatlands,caverns mountains,ridges,floatlands,caverns,nomountains,noridges,nofloatlands,nocaverns
1692
1693 #    Y of mountain density gradient zero level. Used to shift mountains vertically.
1694 mgv7_mount_zero_level (Mountain zero level) int 0
1695
1696 #    Lower Y limit of floatlands.
1697 mgv7_floatland_ymin (Floatland minimum Y) int 1024
1698
1699 #    Upper Y limit of floatlands.
1700 mgv7_floatland_ymax (Floatland maximum Y) int 4096
1701
1702 #    Y-distance over which floatlands taper from full density to nothing.
1703 #    Tapering starts at this distance from the Y limit.
1704 #    For a solid floatland layer, this controls the height of hills/mountains.
1705 #    Must be less than or equal to half the distance between the Y limits.
1706 mgv7_floatland_taper (Floatland tapering distance) int 256
1707
1708 #    Exponent of the floatland tapering. Alters the tapering behaviour.
1709 #    Value = 1.0 creates a uniform, linear tapering.
1710 #    Values > 1.0 create a smooth tapering suitable for the default separated
1711 #    floatlands.
1712 #    Values < 1.0 (for example 0.25) create a more defined surface level with
1713 #    flatter lowlands, suitable for a solid floatland layer.
1714 mgv7_float_taper_exp (Floatland taper exponent) float 2.0
1715
1716 #    Adjusts the density of the floatland layer.
1717 #    Increase value to increase density. Can be positive or negative.
1718 #    Value = 0.0: 50% of volume is floatland.
1719 #    Value = 2.0 (can be higher depending on 'mgv7_np_floatland', always test
1720 #    to be sure) creates a solid floatland layer.
1721 mgv7_floatland_density (Floatland density) float -0.6
1722
1723 #    Surface level of optional water placed on a solid floatland layer.
1724 #    Water is disabled by default and will only be placed if this value is set
1725 #    to above 'mgv7_floatland_ymax' - 'mgv7_floatland_taper' (the start of the
1726 #    upper tapering).
1727 #    ***WARNING, POTENTIAL DANGER TO WORLDS AND SERVER PERFORMANCE***:
1728 #    When enabling water placement the floatlands must be configured and tested
1729 #    to be a solid layer by setting 'mgv7_floatland_density' to 2.0 (or other
1730 #    required value depending on 'mgv7_np_floatland'), to avoid
1731 #    server-intensive extreme water flow and to avoid vast flooding of the
1732 #    world surface below.
1733 mgv7_floatland_ywater (Floatland water level) int -31000
1734
1735 #    Controls width of tunnels, a smaller value creates wider tunnels.
1736 #    Value >= 10.0 completely disables generation of tunnels and avoids the
1737 #    intensive noise calculations.
1738 mgv7_cave_width (Cave width) float 0.09
1739
1740 #    Y of upper limit of large caves.
1741 mgv7_large_cave_depth (Large cave depth) int -33
1742
1743 #    Minimum limit of random number of small caves per mapchunk.
1744 mgv7_small_cave_num_min (Small cave minimum number) int 0 0 256
1745
1746 #    Maximum limit of random number of small caves per mapchunk.
1747 mgv7_small_cave_num_max (Small cave maximum number) int 0 0 256
1748
1749 #    Minimum limit of random number of large caves per mapchunk.
1750 mgv7_large_cave_num_min (Large cave minimum number) int 0 0 64
1751
1752 #    Maximum limit of random number of large caves per mapchunk.
1753 mgv7_large_cave_num_max (Large cave maximum number) int 2 0 64
1754
1755 #    Proportion of large caves that contain liquid.
1756 mgv7_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
1757
1758 #    Y-level of cavern upper limit.
1759 mgv7_cavern_limit (Cavern limit) int -256
1760
1761 #    Y-distance over which caverns expand to full size.
1762 mgv7_cavern_taper (Cavern taper) int 256
1763
1764 #    Defines full size of caverns, smaller values create larger caverns.
1765 mgv7_cavern_threshold (Cavern threshold) float 0.7
1766
1767 #    Lower Y limit of dungeons.
1768 mgv7_dungeon_ymin (Dungeon minimum Y) int -31000
1769
1770 #    Upper Y limit of dungeons.
1771 mgv7_dungeon_ymax (Dungeon maximum Y) int 31000
1772
1773 [**Noises]
1774
1775 #    Y-level of higher terrain that creates cliffs.
1776 mgv7_np_terrain_base (Terrain base noise) noise_params_2d 4, 70, (600, 600, 600), 82341, 5, 0.6, 2.0, eased
1777
1778 #    Y-level of lower terrain and seabed.
1779 mgv7_np_terrain_alt (Terrain alternative noise) noise_params_2d 4, 25, (600, 600, 600), 5934, 5, 0.6, 2.0, eased
1780
1781 #    Varies roughness of terrain.
1782 #    Defines the 'persistence' value for terrain_base and terrain_alt noises.
1783 mgv7_np_terrain_persist (Terrain persistence noise) noise_params_2d 0.6, 0.1, (2000, 2000, 2000), 539, 3, 0.6, 2.0, eased
1784
1785 #    Defines distribution of higher terrain and steepness of cliffs.
1786 mgv7_np_height_select (Height select noise) noise_params_2d -8, 16, (500, 500, 500), 4213, 6, 0.7, 2.0, eased
1787
1788 #    Variation of biome filler depth.
1789 mgv7_np_filler_depth (Filler depth noise) noise_params_2d 0, 1.2, (150, 150, 150), 261, 3, 0.7, 2.0, eased
1790
1791 #    Variation of maximum mountain height (in nodes).
1792 mgv7_np_mount_height (Mountain height noise) noise_params_2d 256, 112, (1000, 1000, 1000), 72449, 3, 0.6, 2.0, eased
1793
1794 #    Defines large-scale river channel structure.
1795 mgv7_np_ridge_uwater (Ridge underwater noise) noise_params_2d 0, 1, (1000, 1000, 1000), 85039, 5, 0.6, 2.0, eased
1796
1797 #    3D noise defining mountain structure and height.
1798 #    Also defines structure of floatland mountain terrain.
1799 mgv7_np_mountain (Mountain noise) noise_params_3d -0.6, 1, (250, 350, 250), 5333, 5, 0.63, 2.0
1800
1801 #    3D noise defining structure of river canyon walls.
1802 mgv7_np_ridge (Ridge noise) noise_params_3d 0, 1, (100, 100, 100), 6467, 4, 0.75, 2.0
1803
1804 #    3D noise defining structure of floatlands.
1805 #    If altered from the default, the noise 'scale' (0.7 by default) may need
1806 #    to be adjusted, as floatland tapering functions best when this noise has
1807 #    a value range of approximately -2.0 to 2.0.
1808 mgv7_np_floatland (Floatland noise) noise_params_3d 0, 0.7, (384, 96, 384), 1009, 4, 0.75, 1.618
1809
1810 #    3D noise defining giant caverns.
1811 mgv7_np_cavern (Cavern noise) noise_params_3d 0, 1, (384, 128, 384), 723, 5, 0.63, 2.0
1812
1813 #    First of two 3D noises that together define tunnels.
1814 mgv7_np_cave1 (Cave1 noise) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
1815
1816 #    Second of two 3D noises that together define tunnels.
1817 mgv7_np_cave2 (Cave2 noise) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
1818
1819 #    3D noise that determines number of dungeons per mapchunk.
1820 mgv7_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
1821
1822 [*Mapgen Carpathian]
1823
1824 #    Map generation attributes specific to Mapgen Carpathian.
1825 mgcarpathian_spflags (Mapgen Carpathian specific flags) flags caverns,norivers caverns,rivers,nocaverns,norivers
1826
1827 #    Defines the base ground level.
1828 mgcarpathian_base_level (Base ground level) float 12.0
1829
1830 #    Defines the width of the river channel.
1831 mgcarpathian_river_width (River channel width) float 0.05
1832
1833 #    Defines the depth of the river channel.
1834 mgcarpathian_river_depth (River channel depth) float 24.0
1835
1836 #    Defines the width of the river valley.
1837 mgcarpathian_valley_width (River valley width) float 0.25
1838
1839 #    Controls width of tunnels, a smaller value creates wider tunnels.
1840 #    Value >= 10.0 completely disables generation of tunnels and avoids the
1841 #    intensive noise calculations.
1842 mgcarpathian_cave_width (Cave width) float 0.09
1843
1844 #    Y of upper limit of large caves.
1845 mgcarpathian_large_cave_depth (Large cave depth) int -33
1846
1847 #    Minimum limit of random number of small caves per mapchunk.
1848 mgcarpathian_small_cave_num_min (Small cave minimum number) int 0 0 256
1849
1850 #    Maximum limit of random number of small caves per mapchunk.
1851 mgcarpathian_small_cave_num_max (Small cave maximum number) int 0 0 256
1852
1853 #    Minimum limit of random number of large caves per mapchunk.
1854 mgcarpathian_large_cave_num_min (Large cave minimum number) int 0 0 64
1855
1856 #    Maximum limit of random number of large caves per mapchunk.
1857 mgcarpathian_large_cave_num_max (Large cave maximum number) int 2 0 64
1858
1859 #    Proportion of large caves that contain liquid.
1860 mgcarpathian_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
1861
1862 #    Y-level of cavern upper limit.
1863 mgcarpathian_cavern_limit (Cavern limit) int -256
1864
1865 #    Y-distance over which caverns expand to full size.
1866 mgcarpathian_cavern_taper (Cavern taper) int 256
1867
1868 #    Defines full size of caverns, smaller values create larger caverns.
1869 mgcarpathian_cavern_threshold (Cavern threshold) float 0.7
1870
1871 #    Lower Y limit of dungeons.
1872 mgcarpathian_dungeon_ymin (Dungeon minimum Y) int -31000
1873
1874 #    Upper Y limit of dungeons.
1875 mgcarpathian_dungeon_ymax (Dungeon maximum Y) int 31000
1876
1877 [**Noises]
1878
1879 #    Variation of biome filler depth.
1880 mgcarpathian_np_filler_depth (Filler depth noise) noise_params_2d 0, 1, (128, 128, 128), 261, 3, 0.7, 2.0, eased
1881
1882 #    First of 4 2D noises that together define hill/mountain range height.
1883 mgcarpathian_np_height1 (Hilliness1 noise) noise_params_2d 0, 5, (251, 251, 251), 9613, 5, 0.5, 2.0, eased
1884
1885 #    Second of 4 2D noises that together define hill/mountain range height.
1886 mgcarpathian_np_height2 (Hilliness2 noise) noise_params_2d 0, 5, (383, 383, 383), 1949, 5, 0.5, 2.0, eased
1887
1888 #    Third of 4 2D noises that together define hill/mountain range height.
1889 mgcarpathian_np_height3 (Hilliness3 noise) noise_params_2d 0, 5, (509, 509, 509), 3211, 5, 0.5, 2.0, eased
1890
1891 #    Fourth of 4 2D noises that together define hill/mountain range height.
1892 mgcarpathian_np_height4 (Hilliness4 noise) noise_params_2d 0, 5, (631, 631, 631), 1583, 5, 0.5, 2.0, eased
1893
1894 #    2D noise that controls the size/occurrence of rolling hills.
1895 mgcarpathian_np_hills_terrain (Rolling hills spread noise) noise_params_2d 1, 1, (1301, 1301, 1301), 1692, 3, 0.5, 2.0, eased
1896
1897 #    2D noise that controls the size/occurrence of ridged mountain ranges.
1898 mgcarpathian_np_ridge_terrain (Ridge mountain spread noise) noise_params_2d 1, 1, (1889, 1889, 1889), 3568, 3, 0.5, 2.0, eased
1899
1900 #    2D noise that controls the size/occurrence of step mountain ranges.
1901 mgcarpathian_np_step_terrain (Step mountain spread noise) noise_params_2d 1, 1, (1889, 1889, 1889), 4157, 3, 0.5, 2.0, eased
1902
1903 #    2D noise that controls the shape/size of rolling hills.
1904 mgcarpathian_np_hills (Rolling hill size noise) noise_params_2d 0, 3, (257, 257, 257), 6604, 6, 0.5, 2.0, eased
1905
1906 #    2D noise that controls the shape/size of ridged mountains.
1907 mgcarpathian_np_ridge_mnt (Ridged mountain size noise) noise_params_2d 0, 12, (743, 743, 743), 5520, 6, 0.7, 2.0, eased
1908
1909 #    2D noise that controls the shape/size of step mountains.
1910 mgcarpathian_np_step_mnt (Step mountain size noise) noise_params_2d 0, 8, (509, 509, 509), 2590, 6, 0.6, 2.0, eased
1911
1912 #    2D noise that locates the river valleys and channels.
1913 mgcarpathian_np_rivers (River noise) noise_params_2d 0, 1, (1000, 1000, 1000), 85039, 5, 0.6, 2.0, eased
1914
1915 #    3D noise for mountain overhangs, cliffs, etc. Usually small variations.
1916 mgcarpathian_np_mnt_var (Mountain variation noise) noise_params_3d 0, 1, (499, 499, 499), 2490, 5, 0.55, 2.0
1917
1918 #    First of two 3D noises that together define tunnels.
1919 mgcarpathian_np_cave1 (Cave1 noise) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
1920
1921 #    Second of two 3D noises that together define tunnels.
1922 mgcarpathian_np_cave2 (Cave2 noise) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
1923
1924 #    3D noise defining giant caverns.
1925 mgcarpathian_np_cavern (Cavern noise) noise_params_3d 0, 1, (384, 128, 384), 723, 5, 0.63, 2.0
1926
1927 #    3D noise that determines number of dungeons per mapchunk.
1928 mgcarpathian_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
1929
1930 [*Mapgen Flat]
1931
1932 #    Map generation attributes specific to Mapgen Flat.
1933 #    Occasional lakes and hills can be added to the flat world.
1934 mgflat_spflags (Mapgen Flat specific flags) flags nolakes,nohills,nocaverns lakes,hills,caverns,nolakes,nohills,nocaverns
1935
1936 #    Y of flat ground.
1937 mgflat_ground_level (Ground level) int 8
1938
1939 #    Y of upper limit of large caves.
1940 mgflat_large_cave_depth (Large cave depth) int -33
1941
1942 #    Minimum limit of random number of small caves per mapchunk.
1943 mgflat_small_cave_num_min (Small cave minimum number) int 0 0 256
1944
1945 #    Maximum limit of random number of small caves per mapchunk.
1946 mgflat_small_cave_num_max (Small cave maximum number) int 0 0 256
1947
1948 #    Minimum limit of random number of large caves per mapchunk.
1949 mgflat_large_cave_num_min (Large cave minimum number) int 0 0 64
1950
1951 #    Maximum limit of random number of large caves per mapchunk.
1952 mgflat_large_cave_num_max (Large cave maximum number) int 2 0 64
1953
1954 #    Proportion of large caves that contain liquid.
1955 mgflat_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
1956
1957 #    Controls width of tunnels, a smaller value creates wider tunnels.
1958 #    Value >= 10.0 completely disables generation of tunnels and avoids the
1959 #    intensive noise calculations.
1960 mgflat_cave_width (Cave width) float 0.09
1961
1962 #    Terrain noise threshold for lakes.
1963 #    Controls proportion of world area covered by lakes.
1964 #    Adjust towards 0.0 for a larger proportion.
1965 mgflat_lake_threshold (Lake threshold) float -0.45
1966
1967 #    Controls steepness/depth of lake depressions.
1968 mgflat_lake_steepness (Lake steepness) float 48.0
1969
1970 #    Terrain noise threshold for hills.
1971 #    Controls proportion of world area covered by hills.
1972 #    Adjust towards 0.0 for a larger proportion.
1973 mgflat_hill_threshold (Hill threshold) float 0.45
1974
1975 #    Controls steepness/height of hills.
1976 mgflat_hill_steepness (Hill steepness) float 64.0
1977
1978 #    Y-level of cavern upper limit.
1979 mgflat_cavern_limit (Cavern limit) int -256
1980
1981 #    Y-distance over which caverns expand to full size.
1982 mgflat_cavern_taper (Cavern taper) int 256
1983
1984 #    Defines full size of caverns, smaller values create larger caverns.
1985 mgflat_cavern_threshold (Cavern threshold) float 0.7
1986
1987 #    Lower Y limit of dungeons.
1988 mgflat_dungeon_ymin (Dungeon minimum Y) int -31000
1989
1990 #    Upper Y limit of dungeons.
1991 mgflat_dungeon_ymax (Dungeon maximum Y) int 31000
1992
1993 [**Noises]
1994
1995 #    Defines location and terrain of optional hills and lakes.
1996 mgflat_np_terrain (Terrain noise) noise_params_2d 0, 1, (600, 600, 600), 7244, 5, 0.6, 2.0, eased
1997
1998 #    Variation of biome filler depth.
1999 mgflat_np_filler_depth (Filler depth noise) noise_params_2d 0, 1.2, (150, 150, 150), 261, 3, 0.7, 2.0, eased
2000
2001 #    First of two 3D noises that together define tunnels.
2002 mgflat_np_cave1 (Cave1 noise) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
2003
2004 #    Second of two 3D noises that together define tunnels.
2005 mgflat_np_cave2 (Cave2 noise) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
2006
2007 #    3D noise defining giant caverns.
2008 mgflat_np_cavern (Cavern noise) noise_params_3d 0, 1, (384, 128, 384), 723, 5, 0.63, 2.0
2009
2010 #    3D noise that determines number of dungeons per mapchunk.
2011 mgflat_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
2012
2013 [*Mapgen Fractal]
2014
2015 #    Map generation attributes specific to Mapgen Fractal.
2016 #    'terrain' enables the generation of non-fractal terrain:
2017 #    ocean, islands and underground.
2018 mgfractal_spflags (Mapgen Fractal specific flags) flags terrain terrain,noterrain
2019
2020 #    Controls width of tunnels, a smaller value creates wider tunnels.
2021 #    Value >= 10.0 completely disables generation of tunnels and avoids the
2022 #    intensive noise calculations.
2023 mgfractal_cave_width (Cave width) float 0.09
2024
2025 #    Y of upper limit of large caves.
2026 mgfractal_large_cave_depth (Large cave depth) int -33
2027
2028 #    Minimum limit of random number of small caves per mapchunk.
2029 mgfractal_small_cave_num_min (Small cave minimum number) int 0 0 256
2030
2031 #    Maximum limit of random number of small caves per mapchunk.
2032 mgfractal_small_cave_num_max (Small cave maximum number) int 0 0 256
2033
2034 #    Minimum limit of random number of large caves per mapchunk.
2035 mgfractal_large_cave_num_min (Large cave minimum number) int 0 0 64
2036
2037 #    Maximum limit of random number of large caves per mapchunk.
2038 mgfractal_large_cave_num_max (Large cave maximum number) int 2 0 64
2039
2040 #    Proportion of large caves that contain liquid.
2041 mgfractal_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
2042
2043 #    Lower Y limit of dungeons.
2044 mgfractal_dungeon_ymin (Dungeon minimum Y) int -31000
2045
2046 #    Upper Y limit of dungeons.
2047 mgfractal_dungeon_ymax (Dungeon maximum Y) int 31000
2048
2049 #    Selects one of 18 fractal types.
2050 #    1 = 4D "Roundy" Mandelbrot set.
2051 #    2 = 4D "Roundy" Julia set.
2052 #    3 = 4D "Squarry" Mandelbrot set.
2053 #    4 = 4D "Squarry" Julia set.
2054 #    5 = 4D "Mandy Cousin" Mandelbrot set.
2055 #    6 = 4D "Mandy Cousin" Julia set.
2056 #    7 = 4D "Variation" Mandelbrot set.
2057 #    8 = 4D "Variation" Julia set.
2058 #    9 = 3D "Mandelbrot/Mandelbar" Mandelbrot set.
2059 #    10 = 3D "Mandelbrot/Mandelbar" Julia set.
2060 #    11 = 3D "Christmas Tree" Mandelbrot set.
2061 #    12 = 3D "Christmas Tree" Julia set.
2062 #    13 = 3D "Mandelbulb" Mandelbrot set.
2063 #    14 = 3D "Mandelbulb" Julia set.
2064 #    15 = 3D "Cosine Mandelbulb" Mandelbrot set.
2065 #    16 = 3D "Cosine Mandelbulb" Julia set.
2066 #    17 = 4D "Mandelbulb" Mandelbrot set.
2067 #    18 = 4D "Mandelbulb" Julia set.
2068 mgfractal_fractal (Fractal type) int 1 1 18
2069
2070 #    Iterations of the recursive function.
2071 #    Increasing this increases the amount of fine detail, but also
2072 #    increases processing load.
2073 #    At iterations = 20 this mapgen has a similar load to mapgen V7.
2074 mgfractal_iterations (Iterations) int 11
2075
2076 #    (X,Y,Z) scale of fractal in nodes.
2077 #    Actual fractal size will be 2 to 3 times larger.
2078 #    These numbers can be made very large, the fractal does
2079 #    not have to fit inside the world.
2080 #    Increase these to 'zoom' into the detail of the fractal.
2081 #    Default is for a vertically-squashed shape suitable for
2082 #    an island, set all 3 numbers equal for the raw shape.
2083 mgfractal_scale (Scale) v3f (4096.0, 1024.0, 4096.0)
2084
2085 #    (X,Y,Z) offset of fractal from world center in units of 'scale'.
2086 #    Can be used to move a desired point to (0, 0) to create a
2087 #    suitable spawn point, or to allow 'zooming in' on a desired
2088 #    point by increasing 'scale'.
2089 #    The default is tuned for a suitable spawn point for Mandelbrot
2090 #    sets with default parameters, it may need altering in other
2091 #    situations.
2092 #    Range roughly -2 to 2. Multiply by 'scale' for offset in nodes.
2093 mgfractal_offset (Offset) v3f (1.79, 0.0, 0.0)
2094
2095 #    W coordinate of the generated 3D slice of a 4D fractal.
2096 #    Determines which 3D slice of the 4D shape is generated.
2097 #    Alters the shape of the fractal.
2098 #    Has no effect on 3D fractals.
2099 #    Range roughly -2 to 2.
2100 mgfractal_slice_w (Slice w) float 0.0
2101
2102 #    Julia set only.
2103 #    X component of hypercomplex constant.
2104 #    Alters the shape of the fractal.
2105 #    Range roughly -2 to 2.
2106 mgfractal_julia_x (Julia x) float 0.33
2107
2108 #    Julia set only.
2109 #    Y component of hypercomplex constant.
2110 #    Alters the shape of the fractal.
2111 #    Range roughly -2 to 2.
2112 mgfractal_julia_y (Julia y) float 0.33
2113
2114 #    Julia set only.
2115 #    Z component of hypercomplex constant.
2116 #    Alters the shape of the fractal.
2117 #    Range roughly -2 to 2.
2118 mgfractal_julia_z (Julia z) float 0.33
2119
2120 #    Julia set only.
2121 #    W component of hypercomplex constant.
2122 #    Alters the shape of the fractal.
2123 #    Has no effect on 3D fractals.
2124 #    Range roughly -2 to 2.
2125 mgfractal_julia_w (Julia w) float 0.33
2126
2127 [**Noises]
2128
2129 #    Y-level of seabed.
2130 mgfractal_np_seabed (Seabed noise) noise_params_2d -14, 9, (600, 600, 600), 41900, 5, 0.6, 2.0, eased
2131
2132 #    Variation of biome filler depth.
2133 mgfractal_np_filler_depth (Filler depth noise) noise_params_2d 0, 1.2, (150, 150, 150), 261, 3, 0.7, 2.0, eased
2134
2135 #    First of two 3D noises that together define tunnels.
2136 mgfractal_np_cave1 (Cave1 noise) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
2137
2138 #    Second of two 3D noises that together define tunnels.
2139 mgfractal_np_cave2 (Cave2 noise) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
2140
2141 #    3D noise that determines number of dungeons per mapchunk.
2142 mgfractal_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
2143
2144 [*Mapgen Valleys]
2145
2146 #    Map generation attributes specific to Mapgen Valleys.
2147 #    'altitude_chill': Reduces heat with altitude.
2148 #    'humid_rivers': Increases humidity around rivers.
2149 #    'vary_river_depth': If enabled, low humidity and high heat causes rivers
2150 #    to become shallower and occasionally dry.
2151 #    'altitude_dry': Reduces humidity with altitude.
2152 mgvalleys_spflags (Mapgen Valleys specific flags) flags altitude_chill,humid_rivers,vary_river_depth,altitude_dry altitude_chill,humid_rivers,vary_river_depth,altitude_dry,noaltitude_chill,nohumid_rivers,novary_river_depth,noaltitude_dry
2153
2154 #    The vertical distance over which heat drops by 20 if 'altitude_chill' is
2155 #    enabled. Also the vertical distance over which humidity drops by 10 if
2156 #    'altitude_dry' is enabled.
2157 mgvalleys_altitude_chill (Altitude chill) int 90
2158
2159 #    Depth below which you'll find large caves.
2160 mgvalleys_large_cave_depth (Large cave depth) int -33
2161
2162 #    Minimum limit of random number of small caves per mapchunk.
2163 mgvalleys_small_cave_num_min (Small cave minimum number) int 0 0 256
2164
2165 #    Maximum limit of random number of small caves per mapchunk.
2166 mgvalleys_small_cave_num_max (Small cave maximum number) int 0 0 256
2167
2168 #    Minimum limit of random number of large caves per mapchunk.
2169 mgvalleys_large_cave_num_min (Large cave minimum number) int 0 0 64
2170
2171 #    Maximum limit of random number of large caves per mapchunk.
2172 mgvalleys_large_cave_num_max (Large cave maximum number) int 2 0 64
2173
2174 #    Proportion of large caves that contain liquid.
2175 mgvalleys_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
2176
2177 #    Depth below which you'll find giant caverns.
2178 mgvalleys_cavern_limit (Cavern upper limit) int -256
2179
2180 #    Y-distance over which caverns expand to full size.
2181 mgvalleys_cavern_taper (Cavern taper) int 192
2182
2183 #    Defines full size of caverns, smaller values create larger caverns.
2184 mgvalleys_cavern_threshold (Cavern threshold) float 0.6
2185
2186 #    How deep to make rivers.
2187 mgvalleys_river_depth (River depth) int 4
2188
2189 #    How wide to make rivers.
2190 mgvalleys_river_size (River size) int 5
2191
2192 #    Controls width of tunnels, a smaller value creates wider tunnels.
2193 #    Value >= 10.0 completely disables generation of tunnels and avoids the
2194 #    intensive noise calculations.
2195 mgvalleys_cave_width (Cave width) float 0.09
2196
2197 #    Lower Y limit of dungeons.
2198 mgvalleys_dungeon_ymin (Dungeon minimum Y) int -31000
2199
2200 #    Upper Y limit of dungeons.
2201 mgvalleys_dungeon_ymax (Dungeon maximum Y) int 63
2202
2203 [**Noises]
2204
2205 #    First of two 3D noises that together define tunnels.
2206 mgvalleys_np_cave1 (Cave noise #1) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
2207
2208 #    Second of two 3D noises that together define tunnels.
2209 mgvalleys_np_cave2 (Cave noise #2) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
2210
2211 #    The depth of dirt or other biome filler node.
2212 mgvalleys_np_filler_depth (Filler depth) noise_params_2d 0, 1.2, (256, 256, 256), 1605, 3, 0.5, 2.0, eased
2213
2214 #    3D noise defining giant caverns.
2215 mgvalleys_np_cavern (Cavern noise) noise_params_3d 0, 1, (768, 256, 768), 59033, 6, 0.63, 2.0
2216
2217 #    Defines large-scale river channel structure.
2218 mgvalleys_np_rivers (River noise) noise_params_2d 0, 1, (256, 256, 256), -6050, 5, 0.6, 2.0, eased
2219
2220 #    Base terrain height.
2221 mgvalleys_np_terrain_height (Terrain height) noise_params_2d -10, 50, (1024, 1024, 1024), 5202, 6, 0.4, 2.0, eased
2222
2223 #    Raises terrain to make valleys around the rivers.
2224 mgvalleys_np_valley_depth (Valley depth) noise_params_2d 5, 4, (512, 512, 512), -1914, 1, 1.0, 2.0, eased
2225
2226 #    Slope and fill work together to modify the heights.
2227 mgvalleys_np_inter_valley_fill (Valley fill) noise_params_3d 0, 1, (256, 512, 256), 1993, 6, 0.8, 2.0
2228
2229 #    Amplifies the valleys.
2230 mgvalleys_np_valley_profile (Valley profile) noise_params_2d 0.6, 0.5, (512, 512, 512), 777, 1, 1.0, 2.0, eased
2231
2232 #    Slope and fill work together to modify the heights.
2233 mgvalleys_np_inter_valley_slope (Valley slope) noise_params_2d 0.5, 0.5, (128, 128, 128), 746, 1, 1.0, 2.0, eased
2234
2235 #    3D noise that determines number of dungeons per mapchunk.
2236 mgvalleys_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
2237
2238 [*Advanced]
2239
2240 #    Size of mapchunks generated by mapgen, stated in mapblocks (16 nodes).
2241 #    WARNING!: There is no benefit, and there are several dangers, in
2242 #    increasing this value above 5.
2243 #    Reducing this value increases cave and dungeon density.
2244 #    Altering this value is for special usage, leaving it unchanged is
2245 #    recommended.
2246 chunksize (Chunk size) int 5
2247
2248 #    Dump the mapgen debug information.
2249 enable_mapgen_debug_info (Mapgen debug) bool false
2250
2251 #    Maximum number of blocks that can be queued for loading.
2252 emergequeue_limit_total (Absolute limit of queued blocks to emerge) int 1024 1 1000000
2253
2254 #    Maximum number of blocks to be queued that are to be loaded from file.
2255 #    This limit is enforced per player.
2256 emergequeue_limit_diskonly (Per-player limit of queued blocks load from disk) int 128 1 1000000
2257
2258 #    Maximum number of blocks to be queued that are to be generated.
2259 #    This limit is enforced per player.
2260 emergequeue_limit_generate (Per-player limit of queued blocks to generate) int 128 1 1000000
2261
2262 #    Number of emerge threads to use.
2263 #    Value 0:
2264 #    -    Automatic selection. The number of emerge threads will be
2265 #    -    'number of processors - 2', with a lower limit of 1.
2266 #    Any other value:
2267 #    -    Specifies the number of emerge threads, with a lower limit of 1.
2268 #    WARNING: Increasing the number of emerge threads increases engine mapgen
2269 #    speed, but this may harm game performance by interfering with other
2270 #    processes, especially in singleplayer and/or when running Lua code in
2271 #    'on_generated'. For many users the optimum setting may be '1'.
2272 num_emerge_threads (Number of emerge threads) int 1
2273
2274 [Online Content Repository]
2275
2276 #    The URL for the content repository
2277 contentdb_url (ContentDB URL) string https://content.minetest.net
2278
2279 #    Comma-separated list of flags to hide in the content repository.
2280 #    "nonfree" can be used to hide packages which do not qualify as 'free software',
2281 #    as defined by the Free Software Foundation.
2282 #    You can also specify content ratings.
2283 #    These flags are independent from Minetest versions,
2284 #    so see a full list at https://content.minetest.net/help/content_flags/
2285 contentdb_flag_blacklist (ContentDB Flag Blacklist) string nonfree, desktop_default
2286
2287 #    Maximum number of concurrent downloads. Downloads exceeding this limit will be queued.
2288 #    This should be lower than curl_parallel_limit.
2289 contentdb_max_concurrent_downloads (ContentDB Max Concurrent Downloads) int 3
2290
2291 [Cheat Menu]
2292
2293 #   Font to use for cheat menu
2294 cheat_menu_font (MenuFont) enum FM_Mono FM_Standard,FM_Mono,FM_Fallback,FM_MaxMode,FM_Unspecified
2295
2296 #   (RGB value)
2297 cheat_menu_bg_color (Cell background color) v3f 255, 145, 88
2298
2299 cheat_menu_bg_color_alpha (Cell background color alpha) int 192
2300
2301 #   (RGB value)
2302 cheat_menu_active_bg_color (Active cell background color) v3f 255, 87, 53
2303
2304 cheat_menu_active_bg_color_alpha (Active cell background color alpha) int 192
2305
2306 #   (RGB value)
2307 cheat_menu_font_color (Font color) v3f 0, 0, 0
2308
2309 cheat_menu_font_color_alpha (Font color alpha) int 255 
2310
2311 #   (RGB value)
2312 cheat_menu_selected_font_color (Selected font color) v3f 255, 252, 88
2313
2314 cheat_menu_selected_font_color_alpha (Selected font color alpha) int 255
2315
2316 cheat_menu_head_height (Head height) int 50
2317
2318 cheat_menu_entry_height (Entry height) int 40
2319
2320 cheat_menu_entry_width (Entry width) int 200
2321
2322 [Cheats]
2323
2324 fullbright (Fullbright) bool false
2325
2326 xray (XRay) bool false
2327
2328 xray_nodes (XRay Nodes) string default:stone,mcl_core:stone
2329
2330 priv_bypass (PrivBypass) bool true
2331
2332 fastdig (FastDig) bool false
2333
2334 fastplace (FastPlace) bool false
2335
2336 autodig (AutoDig) bool false
2337
2338 autoplace (AutoPlace) bool false
2339
2340 prevent_natural_damage (NoFallDamage) bool true
2341
2342 freecam (Freecam) bool false
2343
2344 no_hurt_cam (NoHurtCam) bool false
2345
2346 hud_flags_bypass (HUDBypass) bool true
2347
2348 antiknockback (AntiKnockback) bool false
2349
2350 entity_speed (EntitySpeed) bool false
2351
2352 jesus (Jesus) bool false
2353
2354 instant_break (InstantBreak) bool false
2355
2356 no_night (BrightNight) bool false
2357
2358 coords (Coords) bool false
2359
2360 point_liquids (PointLiquids) bool false
2361
2362 spamclick (FastHit) bool false
2363
2364 no_force_rotate (NoForceRotate) bool false
2365
2366 no_slow (NoSlow) bool false
2367
2368 cheat_hud (CheatHUD) bool true
2369
2370 node_esp_nodes (NodeESP Nodes) string
2371
2372 jetpack (JetPack) bool false
2373
2374 autohit (AutoHit) bool false
2375
2376 antislip (AntiSlip) bool false
2377
2378 enable_entity_tracers (EntityTracers) bool false
2379
2380 enable_entity_esp (EntityESP) bool false
2381
2382 enable_player_tracers (PlayerTracers) bool false
2383
2384 enable_player_esp (PlayerESP) bool false
2385
2386 enable_node_esp (NodeESP) bool false
2387
2388 enable_node_tracers (NodeTracers) bool false
2389
2390 entity_esp_color (EntityESP Color) v3f 255, 255, 255
2391
2392 player_esp_color (PlayerESP Color) v3f 0, 255, 0
2393
2394 tool_range (Additional Tool Range) int 2
2395
2396 reach (Reach) bool false
2397
2398 airjump (AirJump) bool false
2399
2400 spider (Spider) bool false