Display sane output for empty descriptions
[oweals/minetest.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 # `type` can be:
7 #    - int
8 #    - string
9 #    - bool
10 #    - float
11 #    - enum
12 #    - path
13 #    - key (will be ignored in GUI, since a special key change dialog exists)
14 #
15 # `type_args` can be:
16 #   * int:
17 #            - default
18 #            - default min max
19 #   * string:
20 #            - default (if default is not specified then "" is set)
21 #   * bool:
22 #            - default
23 #   * float:
24 #            - default
25 #            - default min max
26 #   * enum:
27 #            - default value1,value2,...
28 #   * path:
29 #            - default (if default is not specified then "" is set)
30 #   * key:
31 #            - default
32 #
33 # Comments directly above a setting are bound to this setting.
34 # All other comments are ignored.
35 #
36 # Comments and (Readable name) are handled by gettext.
37 # Comments should be complete sentences that describe the setting and possibly
38 #  give the user additional useful insight.
39 # Sections are marked by a single line in the format: [Section Name]
40 # Sub-section are marked by adding * in front of the section name: [*Sub-section]
41 # Sub-sub-sections have two * etc.
42 # There shouldn't be too much settings per category; settings that shouldn't be
43 #  modified by the "average user" should be in (sub-)categories called "Advanced".
44
45 [Client]
46
47 [*Controls]
48 #    If enabled, you can place blocks at the position (feet + eye level) where you stand.
49 #    This is helpful when working with nodeboxes in small areas.
50 enable_build_where_you_stand (Build inside player) bool false
51
52 #    Unobstructed movement without physics, downwards key is keymap_special1.
53 free_move (Free movement) bool false
54
55 #    Fast movement (keymap_special1).
56 fast_move (Fast movement) bool false
57
58 #    Smooths camera when moving and looking arround.
59 #    Useful for recording videos.
60 cinematic (Cinematic mode) bool false
61
62 #    Smooths rotation of camera. 0 to disable.
63 camera_smoothing (Camera smoothing) float 0.0 0.0 0.99
64
65 #    Smooths rotation of camera in cinematic mode. 0 to disable.
66 cinematic_camera_smoothing (Camera smoothing in cinematic mode) float 0.7 0.0 0.99
67
68 #    Invert vertical mouse movement.
69 invert_mouse (Invert mouse) bool false
70
71 #    Mouse sensitivity multiplier.
72 mouse_sensitivity (Mouse sensitivity) float 0.2
73
74 #    If enabled, keymap_special1 instead of keymap_sneak is used for climbing down and descending.
75 aux1_descends (Key use for climbing/descending) bool false
76
77 #    Double-tapping the jump key toggles fly mode.
78 doubletap_jump (Double tap jump for fly) bool false
79
80 #    If false aux1 is used to fly fast.
81 always_fly_fast (Always fly and fast) bool true
82
83 #    The time in seconds it takes between repeated right clicks when holding the right mouse button.
84 repeat_rightclick_time (Rightclick repetition interval) float 0.25
85
86 #    Enable random user input, for testing.
87 random_input (Random input) bool false
88
89 #    Continuous forward movement (for testing).
90 continuous_forward (Continuous forward) bool false
91
92 #    Key mappings.
93 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
94 keymap_forward (Forward) key KEY_KEY_W
95 keymap_backward (Backward) key KEY_KEY_S
96 keymap_left (Left) key KEY_KEY_A
97 keymap_right (Right) key KEY_KEY_D
98 keymap_jump (Jump) key KEY_SPACE
99 keymap_sneak (Sneak) key KEY_LSHIFT
100 keymap_inventory (Inventory) key KEY_KEY_I
101 keymap_special1 (Use) key KEY_KEY_E
102 keymap_chat (Chat) key KEY_KEY_T
103 keymap_cmd (Command) key /
104 keyman_console (Console) key KEY_F10
105 keymap_rangeselect (Range select) key KEY_KEY_R
106 keymap_freemove (Fly) key KEY_KEY_K
107 keymap_fastmove (Fast) key KEY_KEY_J
108 keymap_cinematic (Cinematic mode) key KEY_F8
109 keymap_minimap (Minimap) key KEY_F9
110 keymap_screenshot (Screenshot) key KEY_F12
111 keymap_print_debug_stacks (Print stacks) key KEY_KEY_P
112
113 [*Network]
114
115 #    Address to connect to (blank = start local server).
116 address (Server address) string
117
118 #    Port to connect to (UDP).
119 remote_port (Remote port) int 30000
120
121 #    Save the map received by the client on disk.
122 enable_local_map_saving (Saving map received by server) bool false
123
124 #    Enable usage of remote media server (if provided by server).
125 enable_remote_media_server (Connect to external media server) bool true
126
127 #    URL to the server list displayed in the Multiplayer Tab.
128 serverlist_url (Serverlist URL) string servers.minetest.net
129
130 #    File in client/serverlist/ that contains your favorite servers displayed in the Multiplayer Tab.
131 serverlist_file (Serverlist file) string favoriteservers.txt
132
133 [*Graphics]
134
135 [**In-Game]
136
137 #    Minimum wanted FPS.
138 #    The amount of rendered stuff is dynamically set according to this.
139 wanted_fps (Wanted FPS) int 30
140
141 #    If FPS would go higher than this, limit it by sleeping.
142 #    to not waste CPU power for no benefit.
143 fps_max (Maximum FPS) int 60
144
145 #    Maximum FPS when game is paused.
146 pause_fps_max (FPS in pause menu) int 20
147
148 #    The allowed adjustment range for the automatic rendering range adjustment.
149 viewing_range_nodes_max (Viewing range maximum) int 160
150
151 #    The allowed adjustment range for the automatic rendering range adjustment.
152 viewing_range_nodes_min (View range minimum) int 35
153
154 #    Vertical initial window size.
155 screenW (Screen width) int 800
156
157 #    Horizontal initial window size.
158 screenH (Screen height) int 600
159
160 #    Fullscreen mode.
161 fullscreen (Full screen) bool false
162
163 fullscreen_bpp (Full screen BPP) int 24
164
165 #    Experimental option, might cause visible spaces between blocks
166 #    when set to higher number than 0.
167 fsaa (FSAA) enum 0 0,1,2,4,8,16
168
169 #    Vertical screen synchronization.
170 vsync (V-Sync) bool false
171
172 #    Field of view in degrees.
173 fov (Field of view) int 72 30 160
174
175 #    Whether to fog out the end of the visible area.
176 enable_fog (Fog) bool true
177
178 #    Enable a bit lower water surface; disable for speed (not quite optimized).
179 new_style_water (New style water) bool false
180
181 #    Leaves style:
182 #         - Fancy  -> all faces visible
183 #         - Simple -> only outer faces, if defined special_tiles are used
184 #         - Opaque -> disable transparency
185 leaves_style (Leaves style) enum fancy fancy,simple,opaque
186
187 #    Connects glass if supported by node.
188 connected_glass (Connect glass) bool false
189
190 #    Enable smooth lighting with simple ambient occlusion.
191 #    Disable for speed or for different looks.
192 smooth_lighting (Smooth lighting) bool true
193
194 #    Adjust the gamma encoding for the light tables. Lower numbers are brighter.
195 #    This setting is for the client only and is ignored by the server.
196 display_gamma (Gamma) float 1.8 1.0 3.0
197
198 #    Path to texture directory. All textures are first searched from here.
199 texture_path (Texture path) path
200
201 #    Video back-end.
202 #    Possible values: null, software, burningsvideo, direct3d8, direct3d9, opengl.
203 video_driver (Video driver) enum opengl null,software,burningsvideo,direct3d8,direct3d9,opengl
204
205 #    Enable/disable clouds.
206 enable_clouds (Clouds) bool true
207
208 #    Height on which clouds are appearing.
209 cloud_height (Cloud height) int 120
210
211 #    Radius of cloud area stated in number of 64 node cloud squares.
212 #    Values larger than 26 will start to produce sharp cutoffs at cloud area corners.
213 cloud_radius (Cloud radius) int 12
214
215 #    Use 3D cloud look instead of flat.
216 enable_3d_clouds (3D clouds) bool true
217
218 #    Amount of view bobbing (0 = no view bobbing, 1.0 = normal, 2.0 = double).
219 view_bobbing_amount (View bobbing) float 1.0
220
221 #    Amount of fall bobbing (0 = no fall bobbing, 1.0 = normal, 2.0 = double).
222 fall_bobbing_amount (Fall bobbing) float 0.0
223
224 #    3D support.
225 #    Currently:
226 #         - "none"       = no 3d output.
227 #         - "anaglyph"   = cyan/magenta color 3d.
228 #         - "interlaced" = odd/even line based polarisation screen support.
229 #         - "topbottom"  = split screen top/bottom.
230 #         - "sidebyside" = split screen side by side.
231 3d_mode (3D mode) enum none none,anaglyph,interlaced,topbottom,sidebyside
232
233 #    In-game chat console background color (R,G,B).
234 console_color (Console color) string (0,0,0)
235
236 #    In-game chat console background alpha (opaqueness, between 0 and 255).
237 console_alpha (Console alpha) int 200 0 255
238
239 #    Selection box border color (R,G,B).
240 selectionbox_color (Selection box color) string (0,0,0)
241
242 #    Width of the selectionbox's lines.
243 selectionbox_width (Selection box width) int 2 1 5
244
245 #    Crosshair color (R,G,B).
246 crosshair_color (Crosshair color) string (255,255,255)
247
248 #    Cross alpha (opaqueness, between 0 and 255).
249 crosshair_alpha (Crosshair alpha) int 255 0 255
250
251 #    Path for screenshots.
252 screenshot_path (Screenshot folder) path
253
254 #    Whether node texture animations should be desynchronized per mapblock.
255 desynchronize_mapblock_texture_animation (Desynchronize block animation) bool true
256
257 #    Maximum proportion of current window to be used for hotbar.
258 #    Useful if there's something to be displayed right or left of hotbar.
259 hud_hotbar_max_width (Maximum hotbar width) float 1.0
260
261 #    Enable selection highlighting for nodes (disables selectionbox).
262 enable_node_highlighting (Node highlighting) bool false
263
264 mip_map (Mipmapping) bool false
265 anisotropic_filter (Anisotropic filtering) bool false
266 bilinear_filter (Bilinear filtering) bool false
267 trilinear_filter (Trilinear filtering) bool false
268
269 #    Filtered textures can blend RGB values with fully-transparent neighbors,
270 #    which PNG optimizers usually discard, sometimes resulting in a dark or
271 #    light edge to transparent textures.  Apply this filter to clean that up
272 #    at texture load time.
273 texture_clean_transparent (Clean transparent textures) bool false
274
275 #    When using bilinear/trilinear/anisotropic filters, low-resolution textures
276 #    can be blurred, so automatically upscale them with nearest-neighbor
277 #    interpolation to preserve crisp pixels.  This sets the minimum texture size
278 #    for the upscaled textures; higher values look sharper, but require more
279 #    memory.  Powers of 2 are recommended.  Setting this higher than 1 may not
280 #    have a visible effect unless bilinear/trilinear/anisotropic filtering is
281 #    enabled.
282 texture_min_size (Minimum texture size for filters) int 64
283
284 #    Set to true to pre-generate all item visuals.
285 preload_item_visuals (Preload inventory textures) bool false
286
287 #    Set to true to enable shaders. Disable them if video_driver = direct3d9/8.
288 enable_shaders (Shaders) bool true
289
290 #    Set to true to enable textures bumpmapping. Requires shaders enabled.
291 enable_bumpmapping (Bumpmapping) bool false
292
293 #    Set to true enables on the fly normalmap generation (Emboss effect).
294 #    Requires bumpmapping enabled.
295 generate_normalmaps (Generate normalmaps) bool false
296
297 #    Strength of generated normalmaps.
298 normalmaps_strength (Normalmaps strength) float 0.6
299
300 #    Defines sampling step of texture (0 - 2).
301 #    A higher value results in smoother normal maps.
302 normalmaps_smooth (Normalmaps sampling) int 0 0 2
303
304 #    Set to true enables parallax occlusion mapping. Requires shaders enabled.
305 enable_parallax_occlusion (Parralax occlusion) bool false
306
307 #    0 = parallax occlusion with slope information (faster).
308 #    1 = relief mapping (slower, more accurate).
309 parallax_occlusion_mode (Parralax occlusion mode) int 1 0 1
310
311 #    Strength of parallax.
312 3d_parallax_strength (Parralax occlusion strength) float 0.025
313
314 #    Number of parallax occlusion iterations.
315 parallax_occlusion_iterations (Parralax occlusion iterations) int 4
316
317 #    Overall scale of parallax occlusion effect.
318 parallax_occlusion_scale (Parralax occlusion Scale) float 0.08
319
320 #    Overall bias of parallax occlusion effect, usually scale/2.
321 parallax_occlusion_bias (Parralax occlusion bias) float 0.04
322
323 #    Set to true enables waving water. Requires shaders enabled.
324 enable_waving_water (Waving water) bool false
325
326 water_wave_height (Waving water height) float 1.0
327 water_wave_length (Waving water length) float 20.0
328 water_wave_speed (Waving water speed) float 5.0
329
330 #    Set to true enables waving leaves. Requires shaders enabled.
331 enable_waving_leaves (Waving leaves) bool false
332
333 #    Set to true enables waving plants. Requires shaders enabled.
334 enable_waving_plants (Waving plants) bool false
335
336 #    The strength (darkness) of node ambient-occlusion shading.
337 #    Lower is darker, Higher is lighter. The valid range of values for this
338 #    setting is 0.25 to 4.0 inclusive. If the value is out of range it will be
339 #    set to the nearest valid value.
340 ambient_occlusion_gamma (Ambient occlusion gamma) float 2.2 0.25 4.0
341
342 #    Enables caching of facedir rotated meshes.
343 enable_mesh_cache (Mesh cache) bool false
344
345 #    Enables minimap.
346 enable_minimap (Minimap) bool true
347
348 #    Shape of the minimap. Enabled = round, disabled = square.
349 minimap_shape_round (Round minimap) bool true
350
351 #    True = 256
352 #    False = 128
353 #    Useable to make minimap smoother on slower machines.
354 minimap_double_scan_height (Minimap scan height) bool true
355
356 #    Make fog and sky colors depend on daytime (dawn/sunset) and view direction.
357 directional_colored_fog (Colored fog) bool true
358
359 [**Menus]
360
361 #    Use a cloud animation for the main menu background.
362 menu_clouds (Clouds in menu) bool true
363
364 #    Scale gui by a user specified value.
365 #    Use a nearest-neighbor-anti-alias filter to scale the GUI.
366 #    This will smooth over some of the rough edges, and blend
367 #    pixels when scaling down, at the cost of blurring some
368 #    edge pixels when images are scaled by non-integer sizes.
369 gui_scaling (GUI scaling) float 1.0
370
371 #    When gui_scaling_filter is true, all GUI images need to be
372 #    filtered in software, but some images are generated directly
373 #    to hardware (e.g. render-to-texture for nodes in inventory).
374 gui_scaling_filter (GUI scaling filter) bool false
375
376 #    When gui_scaling_filter_txr2img is true, copy those images
377 #    from hardware to software for scaling.  When false, fall back
378 #    to the old scaling method, for video drivers that don't
379 #    propery support downloading textures back from hardware.
380 gui_scaling_filter_txr2img (GUI scaling filter txr2img) bool true
381
382 #    Delay showing tooltips, stated in milliseconds.
383 tooltip_show_delay (Tooltip delay) int 400
384
385 #    Whether freetype fonts are used, requires freetype support to be compiled in.
386 freetype (Freetype fonts) bool true
387
388 #    Path to TrueTypeFont or bitmap.
389 font_path (Font path) path fonts/liberationsans.ttf
390
391 #    Font size.
392 font_size (Font size) int 15
393
394 #    Font shadow offset, if 0 then shadow will not be drawn.
395 font_shadow (Font shadow) int 1
396
397 #    Font shadow alpha (opaqueness, between 0 and 255).
398 font_shadow_alpha (Font shadow alpha) int 128 0 255
399
400 mono_font_path (Monospace font path) path fonts/liberationmono.ttf
401
402 mono_font_size (Monospace font size) int 15
403
404 #    This font will be used for certain languages.
405 fallback_font_path (Fallback font) path fonts/DroidSansFallbackFull.ttf
406 fallback_font_size (Fallback font size) int 15
407 fallback_font_shadow (Fallback font shadow) int 1
408 fallback_font_shadow_alpha (Fallback font shadow alpha) int 128 0 255
409
410 [**Advanced]
411
412 #    Adjust dpi configuration to your screen (non X11/Android only) e.g. for 4k screens.
413 screen_dpi (DPI) int 72
414
415 [*Sound]
416 enable_sound (Sound) bool true
417 sound_volume (Volume) float 0.7 0.0 1.0
418
419 [*Advanced]
420
421 #    Timeout for client to remove unused map data from memory.
422 client_unload_unused_data_timeout (Mapblock unload timeout) int 600
423
424 #    Maximum number of mapblocks for client to be kept in memory.
425 #    Set to -1 for unlimited amount.
426 client_mapblock_limit (Mapblock limit) int 5000
427
428 #    Whether to show the client debug info (has the same effect as hitting F5).
429 show_debug (Show debug info) bool false
430
431 [Server / Singleplayer]
432
433 #    Name of the server.
434 server_name (Server name) string Minetest server
435
436 #    Description of server.
437 server_description (Server description) string mine here
438
439 #    Domain name of server.
440 server_address (Server address) string game.minetest.net
441
442 #    Homepage of server.
443 server_url (Server URL) string http://minetest.net
444
445 #    Automaticaly report to masterserver.
446 server_announce (Announce server) bool false
447
448 #    Announce to this masterserver.
449 #    If you want to announce your ipv6 address - use  serverlist_url = v6.servers.minetest.net.
450 serverlist_url (Serverlist URL) string servers.minetest.net
451
452 [*Network]
453
454 #    Network port to listen (UDP).
455 port (Server port) int 30000
456
457 #    The network interface that the server listens on.
458 bind_address (Bind address) string
459
460 #    Set to true to disallow old clients from connecting.
461 strict_protocol_version_checking (Strict protocol checking) bool false
462
463 #    Specifies URL from which client fetches media instead of using UDP.
464 #    $filename should be accessible from $remote_media$filename via cURL
465 #    (obviously, remote_media should end with a slash).
466 #    Files that are not present would be fetched the usual way.
467 remote_media (Remote media) string
468
469 #    Enable/disable running an IPv6 server.  An IPv6 server may be restricted
470 #    to IPv6 clients, depending on system configuration.
471 #    Ignored if bind_address is set.
472 ipv6_server (IPv6 server) bool false
473
474 [**Advanced]
475
476 #    How many blocks are flying in the wire simultaneously per client.
477 max_simultaneous_block_sends_per_client (Maximum simultaneously blocks send per client) int 10
478
479 #    How many blocks are flying in the wire simultaneously per server.
480 max_simultaneous_block_sends_server_total (Maximum simultaneously bocks send total) int 40
481
482 #    To reduce lag, block transfers are slowed down when a player is building something.
483 #    This determines how long they are slowed down after placing or removing a node.
484 full_block_send_enable_min_time_from_building () float 2.0
485
486 #    Maximum number of packets sent per send step, if you have a slow connection
487 #    try reducing it, but don't reduce it to a number below double of targeted
488 #    client number.
489 max_packets_per_iteration (Max. packets per iteration) int 1024
490
491 [*Game]
492
493 #    Default game (default when creating a new world).
494 default_game (Default game) string minetest
495
496 #    Message of the Day.
497 motd (Message of the day) string Welcome to this awesome Minetest server!
498
499 #    Maximum number of players connected simultaneously.
500 max_users (Maximum users) int 15
501
502 #    World directory (everything in the world is stored here).
503 map-dir (Map directory) path
504
505 #    Time in seconds for item entity to live.
506 #    Setting it to -1 disables the feature.
507 item_entity_ttl (Item entity TTL) int 900
508
509 #    Set to true to enable creative mode (unlimited inventory).
510 creative_mode (Creative mode) bool false
511
512 #    Enable players getting damage and dying.
513 enable_damage (Damage) bool false
514
515 #    A chosen map seed for a new map, leave empty for random.
516 fixed_map_seed (Fixed map seed) string
517
518 #    Gives some stuff to players at the beginning.
519 give_initial_stuff (Give initial stuff) bool false
520
521 #    New users need to input this password.
522 default_password (Default password) string
523
524 #    Available privileges: interact, shout, teleport, settime, privs, ...
525 #    See /privs in game for a full list on your server and mod configuration.
526 default_privs (Default privileges) string interact, shout
527
528 #    Whether players are shown to clients without any range limit.
529 #    Deprecated, use the setting player_transfer_distance instead.
530 unlimited_player_transfer_distance (Unlimited player transfer distance) bool true
531
532 #    Defines the maximal player transfer distance in blocks (0 = unlimited).
533 player_transfer_distance (Player transfer distance) int 0
534
535 #    Whether to enable players killing each other.
536 enable_pvp (Player versus Player) bool true
537
538 #    If this is set, players will always (re)spawn at the given position.
539 static_spawnpoint (Static spawnpoint) string 0, 10, 0
540
541 #    If true, new players cannot join with an empty password.
542 disallow_empty_password (Disallow empty passwords) bool false
543
544 #    If true, disable cheat prevention in multiplayer.
545 disable_anticheat (Disable anticheat) bool false
546
547 #    If true, actions are recorded for rollback.
548 #    This option is only read when server starts.
549 enable_rollback_recording (Rollback recording) bool false
550
551 #    A message to be displayed to all clients when the server shuts down.
552 kick_msg_shutdown (Shutdown message) string Server shutting down.
553
554 #    A message to be displayed to all clients when the server crashes.
555 kick_msg_crash (Crash message) string This server has experienced an internal error. You will now be disconnected.
556
557 #    Whether to ask clients to reconnect after a (Lua) crash.
558 #    Set this to true if your server is set up to restart automatically.
559 ask_reconnect_on_crash (Ask to reconnect after crash) bool false
560
561 #    From how far client knows about objects.
562 active_object_send_range_blocks (Active object send range) int 3
563
564 #    How large area of blocks are subject to the active block stuff.
565 #    Active = objects are loaded and ABMs run.
566 active_block_range (Active block range) int 2
567
568 #    From how far blocks are sent to clients, stated in mapblocks (16 nodes).
569 max_block_send_distance (Max block send distance) int 10
570
571 #    Maximum number of forceloaded blocks.
572 max_forceloaded_blocks (Maximum forceloaded blocks) int 16
573
574 #    Interval of sending time of day to clients.
575 time_send_interval (Time send interval) int 5
576
577 #    Controls length of day/night cycle.
578 #    72=20min, 360=4min, 1=24hour, 0=day/night/whatever stays unchanged.
579 time_speed (Time speed) int 72
580
581 #    Interval of saving important changes in the world, stated in seconds.
582 server_map_save_interval (Map save interval) float 5.3
583
584 [**Physics]
585
586 movement_acceleration_default (Default acceleration) float 3
587 movement_acceleration_air (Acceleration in air) float 2
588 movement_acceleration_fast (Fast mode acceleration) float 10
589 movement_speed_walk (Walking speed) float 4
590 movement_speed_crouch (Crouch speed) float 1.35
591 movement_speed_fast (Fast mode speed) float 20
592 movement_speed_climb (Climbing speed) float 2
593 movement_speed_jump (Jumping speed) float 6.5
594 movement_speed_descend (Descending speed) float 6
595 movement_liquid_fluidity (Liquid fluidity) float 1
596 movement_liquid_fluidity_smooth (Liquid fluidity smoothing) float 0.5
597 movement_liquid_sink (Liquid sink) float 10
598 movement_gravity (Gravity) float 9.81
599
600 [**Advanced]
601
602 #    Handling for deprecated lua api calls:
603 #         - "legacy" = (try to) mimic old behaviour (default for release).
604 #         - "log"    = mimic and log backtrace of deprecated call (default for debug).
605 #         - "error"  = abort on usage of deprecated call (suggested for mod developers).
606 deprecated_lua_api_handling (Deprecated Lua API handling) enum legacy legacy,log,error
607
608 #    Mod profiler.
609 mod_profiling (Mod profiling) bool false
610
611 #    Detailed mod profile data.
612 detailed_profiling (Detailed mod profiling) bool false
613
614 #    Profiler data print interval. 0 = disable.
615 profiler_print_interval (Profiling print interval) int 0
616
617 #    Number of extra blocks that can be loaded by /clearobjects at once.
618 #    This is a trade-off between sqlite transaction overhead and
619 #    memory consumption (4096=100MB, as a rule of thumb).
620 max_clearobjects_extra_loaded_blocks (Max. clearobjects extra blocks) int 4096
621
622 #    How much the server will wait before unloading unused MapBlocks.
623 #    Higher value is smoother, but will use more RAM.
624 server_unload_unused_data_timeout (Unload unused server data) int 29
625
626 #    Maximum number of statically stored objects in a block.
627 max_objects_per_block (Maxmimum objects per block) int 49
628
629 #    http://www.sqlite.org/pragma.html#pragma_synchronous only numeric values: 0 1 2
630 sqlite_synchronous (Synchronous SQLite) int 2 0 2
631
632 #    Length of a server tick and the interval at which objects are generally updated over network.
633 dedicated_server_step (Dedicated server step) float 0.1
634
635 #    Can be set to true to disable shutting down on invalid world data.
636 ignore_world_load_errors (Ignore world errors) bool false
637
638 #    Max liquids processed per step.
639 liquid_loop_max (Liquid loop max) int 100000
640
641 #    The time (in seconds) that the liquids queue may grow beyond processing
642 #    capacity until an attempt is made to decrease its size by dumping old queue
643 #    items.  A value of 0 disables the functionality.
644 liquid_queue_purge_time (Liquid queue purge time) int 0
645
646 #    Liquid update interval in seconds.
647 liquid_update (Liquid update tick) float 1.0
648
649 [*Mapgen]
650
651 #    Name of map generator to be used when creating a new world.
652 #    Currently supported: v5, v6, v7, singlenode.
653 mg_name (Mapgen name) enum v6 v5,v6,v7,singlenode
654
655 #    Water surface level of map
656 water_level (Water level) int 1
657
658 #    From how far blocks are generated for clients, stated in mapblocks (16 nodes).
659 max_block_generate_distance (Max block generate distance) int 6
660
661 #    Where the map generator stops.
662 #    Please note:
663 #        * Limited to 31000 (setting above has no effect)
664 #        * The map generator works in groups of 80x80x80 nodes (5x5x5 MapBlocks).
665 #        * Those groups have an offset of -32, -32 nodes from the origin.
666 #        * Only groups which are within the map_generation_limit are generated
667 map_generation_limit (Map generation limit) int 31000 0 31000
668
669 #    Global map generation attributes.
670 #    Currently supported: trees, caves, flat, dungeons, light.
671 #    Flags that are not specified in the flag string are not modified from the default.
672 #    To explicitly turn off a flag, prepend "no" to the beginning, e.g. nolight.
673 #    'trees' and 'flat' flags only have effect in mgv6.
674 mg_flags (Mapgen flags) flags trees, caves, dungeons, light
675
676 [**Advanced]
677
678 #    Size of chunks to be generated, stated in mapblocks (16 nodes).
679 chunksize (Chunk size) int 5
680
681 #    Dump the mapgen debug infos.
682 enable_mapgen_debug_info (Mapgen debug) bool false
683
684 #    Maximum number of blocks that can be queued for loading.
685 emergequeue_limit_total (Absolute limit of emerge queues) int 256
686
687 #    Maximum number of blocks to be queued that are to be loaded from file.
688 #    Set to blank for an appropriate amount to be chosen automatically.
689 emergequeue_limit_diskonly (Limit of emerge queues on disk) int 32
690
691 #    Maximum number of blocks to be queued that are to be generated.
692 #    Set to blank for an appropriate amount to be chosen automatically.
693 emergequeue_limit_generate (Limit of emerge queues to generate) int 32
694
695 #    Number of emerge threads to use. Make this field blank, or increase this number
696 #    to use multiple threads. On multiprocessor systems, this will improve mapgen speed greatly
697 #    at the cost of slightly buggy caves.
698 num_emerge_threads (Number of emerge threads) int 1
699
700 #    Noise parameters for biome API temperature, humidity and biome blend.
701 mg_biome_np_heat (Mapgen biome heat) noise_params 50, 50, (750, 750, 750), 5349, 3, 0.5, 2.0
702 mg_biome_np_heat_blend (Mapgen heat blend) noise_params 0, 1.5, (8, 8, 8), 13, 2, 1.0, 2.0
703 mg_biome_np_humidity (Mapgen biome humidity) noise_params 50, 50, (750, 750, 750), 842, 3, 0.5, 2.0
704 mg_biome_np_humidity_blend (Mapgen biome humidity blend) noise_params 0, 1.5, (8, 8, 8), 90003, 2, 1.0, 2.0
705
706 [***Mapgen v5]
707
708 mgv5_np_filler_depth (Mapgen v5 filler depth) noise_params 0, 1, (150, 150, 150), 261, 4, 0.7, 2.0
709 mgv5_np_factor (Mapgen v5 factor) noise_params 0, 1, (250, 250, 250), 920381, 3, 0.45, 2.0
710 mgv5_np_height (Mapgen v5 height) noise_params 0, 10, (250, 250, 250), 84174, 4, 0.5, 2.0
711 mgv5_np_cave1 (Mapgen v5 cave1) noise_params 0, 12, (50, 50, 50), 52534, 4, 0.5, 2.0
712 mgv5_np_cave2 (Mapgen v5 cave2) noise_params 0, 12, (50, 50, 50), 10325, 4, 0.5, 2.0
713 #    TODO
714 #mgv5_np_ground = {
715 #    offset      = 0
716 #    scale       = 40
717 #    spread      = (80, 80, 80)
718 #    seed        = 983240
719 #    octaves     = 4
720 #    persistence = 0.55
721 #    lacunarity  = 2.0
722 #    flags       = "eased"
723 #}
724
725 [***Mapgen v6]
726
727 #    Map generation attributes specific to Mapgen V6.
728 #    Currently supported: jungles, biomeblend, mudflow, snowbiomes.
729 #    When snowbiomes are enabled jungles are enabled and the jungles flag is ignored.
730 mgv6_spflags (Mapgen v6 flags) flags jungles, biomeblend, mudflow, snowbiomes
731
732 #    Controls size of deserts and beaches in Mapgen V6.
733 #    When snowbiomes are enabled 'mgv6_freq_desert' is ignored.
734 mgv6_freq_desert (Mapgen v6 desert frequency) float 0.45
735 mgv6_freq_beach (Mapgen v6 beach frequency) float 0.15
736
737 #    Perlin noise attributes for different map generation parameters.
738 #    Noise parameters can be specified as a set of positional values:
739 #    Offset, scale, (spread factors), seed offset, number of octaves, persistence, lacunarity.
740 #    For example:
741 mgv6_np_terrain_base (Mapgen v6 terrain base) noise_params -4, 20, (250, 250, 250), 82341, 5, 0.6, 2.0
742
743 mgv6_np_terrain_base (Mapgen v6 terrain base) noise_params -4, 20, (250, 250, 250), 82341, 5, 0.6, 2.0
744 mgv6_np_terrain_higher (Mapgen v6 terrain altitude) noise_params 20, 16, (500, 500, 500), 85039, 5, 0.6, 2.0
745 mgv6_np_steepness (Mapgen v6 steepness) noise_params 0.85, 0.5, (125, 125, 125), -932, 5, 0.7, 2.0
746 mgv6_np_height_select (Mapgen v6 height select) noise_params 0.5, 1, (250, 250, 250), 4213, 5, 0.69, 2.0
747 mgv6_np_mud (Mapgen v6 mud) noise_params 4, 2, (200, 200, 200), 91013, 3, 0.55, 2.0
748 mgv6_np_beach (Mapgen v6 beach) noise_params 0, 1, (250, 250, 250), 59420, 3, 0.50, 2.0
749 mgv6_np_biome (Mapgen v6 biome) noise_params 0, 1, (500, 500, 500), 9130, 3, 0.50, 2.0
750 mgv6_np_cave (Mapgen v6 cave) noise_params 6, 6, (250, 250, 250), 34329, 3, 0.50, 2.0
751 mgv6_np_humidity (Mapgen v6 humidity) noise_params 0.5, 0.5, (500, 500, 500), 72384, 3, 0.50, 2.0
752 mgv6_np_trees (Mapgen v6 trees) noise_params 0, 1, (125, 125, 125), 2, 4, 0.66, 2.0
753 mgv6_np_apple_trees (Mapgen v6 apple trees) noise_params 0, 1, (100, 100, 100), 342902, 3, 0.45, 2.0
754
755 [***Mapgen v7]
756 #    Map generation attributes specific to Mapgen V7.
757 #    Currently supported: mountains, ridges.
758 #    'ridges' are the rivers.
759 mgv7_spflags (Mapgen v7 flags) flags mountains, ridges
760
761 mgv7_np_terrain_base (Mapgen v7 terrain base) noise_params 4, 70, (600, 600, 600), 82341, 5, 0.6, 2.0
762 mgv7_np_terrain_alt (Mapgen v7 terrain altitude) noise_params 4, 25, (600, 600, 600), 5934, 5, 0.6, 2.0
763 mgv7_np_terrain_persist (Mapgen v7 terrain persistation) noise_params 0.6, 0.1, (2000, 2000, 2000), 539, 3, 0.6, 2.0
764 mgv7_np_height_select (Mapgen v7 height select) noise_params -12, 24, (500, 500, 500), 4213, 6, 0.7, 2.0
765 mgv7_np_filler_depth (Mapgen v7 filler depth) noise_params 0, 1.2, (150, 150, 150), 261, 3, 0.7, 2.0
766 mgv7_np_mount_height (Mapgen v7 mount height) noise_params 256, 112, (1000, 1000, 1000), 72449, 3, 0.6, 2.0
767 mgv7_np_ridge_uwater (Mapgen v7 ridge water) noise_params 0, 1, (1000, 1000, 1000), 85039, 5, 0.6, 2.0
768 mgv7_np_mountain (Mapgen v7 mountain) noise_params -0.6, 1, (250, 350, 250), 5333, 5, 0.63, 2.0
769 mgv7_np_ridge (Mapgen v7 ridge) noise_params 0, 1, (100, 100, 100), 6467, 4, 0.75, 2.0
770 mgv7_np_cave1 (Mapgen v7 cave1) noise_params 0, 12, (100, 100, 100), 52534, 4, 0.5, 2.0
771 mgv7_np_cave2 (Mapgen v7 cave2) noise_params 0, 12, (100, 100, 100), 10325, 4, 0.5, 2.0
772
773 [*Security]
774
775 #    Prevent mods from doing insecure things like running shell commands.
776 secure.enable_security (Enable mod security) bool false
777
778 #    Comma-separated list of trusted mods that are allowed to access insecure
779 #    functions even when mod security is on (via request_insecure_environment()).
780 secure.trusted_mods (Trusted mods) string
781
782 [Client and Server]
783 #    Name of the player.
784 #    When running a server, clients connecting with this name are admins.
785 name (Player name) string
786
787 #    Override language. When no value is provided (default) system language is used.
788 #    Check "locale" directory for the list of available translations.
789 language (Language) string
790
791 #    Level of logging to be written to debug.txt:
792 #         - <nothing> (no logging)
793 #         - none (messages with no level)
794 #         - error
795 #         - warning
796 #         - action
797 #         - info
798 #         - verbose
799 debug_log_level (Debug log level) enum action warning,action,info,verbose
800
801 #    IPv6 support.
802 enable_ipv6 (IPv6) bool true
803
804 [*Advanced]
805 #    Default timeout for cURL, stated in milliseconds.
806 #    Only has an effect if compiled with cURL.
807 curl_timeout (cURL timeout) int 5000
808
809 #    Limits number of parallel HTTP requests. Affects:
810 #         - Media fetch if server uses remote_media setting.
811 #         - Serverlist download and server announcement.
812 #         - Downloads performed by main menu (e.g. mod manager).
813 #    Only has an effect if compiled with cURL.
814 curl_parallel_limit (cURL parallel limit) int 8
815
816 #    Maximum time in ms a file download (e.g. a mod download) may take
817 curl_file_download_timeout (cURL file download timeout) int 300000
818
819 #    Makes DirectX work with LuaJIT. Disable if it causes troubles.
820 high_precision_fpu (High-precision FPU) bool true
821
822 main_menu_script (Main menu script) string
823
824 main_menu_game_mgr (Main menu game manager) int 0
825
826 main_menu_mod_mgr (Main menu mod manager) int 1
827
828 modstore_download_url (Modstore download URL) string https://forum.minetest.net/media/
829
830 modstore_listmods_url (Modstore mods list URL) string https://forum.minetest.net/mmdb/mods/
831
832 modstore_details_url (Modstore details URL) string https://forum.minetest.net/mmdb/mod/*/