Fix misleading error when exiting the client from the main menu
[oweals/minetest.git] / minetest.conf.example
1 # This file is read by default from:
2 # ../minetest.conf
3 # ../../minetest.conf
4 # Any other path can be chosen by passing the path as a parameter
5 # to the program, eg. "minetest.exe --config ../minetest.conf.example"
6 #
7 # By default, all the settings are commented and not functional.
8 # Uncomment settings by removing the preceding #.
9 #
10 # Further documentation:
11 # http://wiki.minetest.net/
12 #
13 # NOTE: This file might not be up-to-date, refer to the
14 #       defaultsettings.cpp file for an up-to-date list:
15 # https://github.com/minetest/minetest/blob/master/src/defaultsettings.cpp
16 #
17 # A vim command to convert most of defaultsettings.cpp to conf file format:
18 # :'<,'>s/\tsettings->setDefault("\([^"]*\)", "\([^"]*\)");.*/#\1 = \2/g
19 # Note: Some of the settings are implemented in Lua
20
21 #
22 # Client and server
23 #
24
25 # Name of player; on a server this is the main admin
26 #name =
27
28 #
29 # Client stuff
30 #
31
32 # Port to connect to (UDP)
33 #remote_port =
34 # Key mappings
35 # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
36 #keymap_forward = KEY_KEY_W
37 #keymap_backward = KEY_KEY_S
38 #keymap_left = KEY_KEY_A
39 #keymap_right = KEY_KEY_D
40 #keymap_jump = KEY_SPACE
41 #keymap_sneak = KEY_LSHIFT
42 #keymap_inventory = KEY_KEY_I
43 # Go down ladder / go down in fly mode / go fast in fast mode
44 #keymap_special1 = KEY_KEY_E
45 #keymap_chat = KEY_KEY_T
46 #keymap_cmd = /
47 #keyman_console = KEY_F10
48 #keymap_rangeselect = KEY_KEY_R
49 #keymap_freemove = KEY_KEY_K
50 #keymap_fastmove = KEY_KEY_J
51 #keymap_screenshot = KEY_F12
52 # If true, keymap_special1 instead of keymap_sneak is used for climbing down and descending
53 #aux1_descends = false
54 # Double-tapping the jump key toggles fly mode
55 #doubletap_jump = false
56 # If false aux1 is used to fly fast
57 #always_fly_fast = true
58 # Some (temporary) keys for debugging
59 #keymap_print_debug_stacks = KEY_KEY_P
60 #keymap_quicktune_prev = KEY_HOME
61 #keymap_quicktune_next = KEY_END
62 #keymap_quicktune_dec = KEY_NEXT
63 #keymap_quicktune_inc = KEY_PRIOR
64
65 # If set to true, you can place blocks at the position (feet + eye level) where you stand; this is helpful when working with nodeboxes
66 #enable_build_where_you_stand = false
67
68 # Minimum FPS
69 # The amount of rendered stuff is dynamically set according to this
70 #wanted_fps = 30
71 # If FPS would go higher than this, limit it by sleeping
72 # (to not waste CPU power for no benefit)
73 #fps_max = 60
74 # Maximum FPS when game is paused
75 #pause_fps_max = 20
76 # The allowed adjustment range for the automatic rendering range adjustment
77 #viewing_range_nodes_max = 160
78 #viewing_range_nodes_min = 35
79 # Initial window size
80 #screenW = 800
81 #screenH = 600
82 #fullscreen = false
83 #fullscreen_bpp = 24
84 # Experimental option, might cause visible spaces between blocks
85 # when set to higher number than 0
86 #fsaa = 0
87 #vsync = false
88 #fov = 72
89 # Address to connect to (#blank = start local server)
90 #address =
91 # Enable random user input, for testing
92 #random_input = false
93 # Timeout for client to remove unused map data from memory
94 #client_unload_unused_data_timeout = 600
95 # Whether to fog out the end of the visible area
96 #enable_fog = true
97 # Whether to show the client debug info (has the same effect as hitting F5)
98 #show_debug = false
99 # Enable a bit lower water surface; disable for speed (not quite optimized)
100 #new_style_water = false
101 # Max liquids processed per step
102 #liquid_loop_max = 10000
103 # Update liquids every .. recommend for finite: 0.2
104 #liquid_update = 1.0
105 # Enable nice leaves; disable for speed
106 #new_style_leaves = true
107 # Connects glass if supported by node
108 #connected_glass = false
109 # Enable smooth lighting with simple ambient occlusion;
110 # disable for speed or for different looks.
111 #smooth_lighting = true
112 # Path to texture directory. All textures are first searched from here.
113 #texture_path =
114 # Video back-end.
115 # Possible values: null, software, burningsvideo, direct3d8, direct3d9, opengl
116 #video_driver = opengl
117 # Unobstructed movement without physics, downwards key is keymap_special1
118 #free_move = false
119 # Continuous forward movement (for testing)
120 #continuous_forward = false
121 # Fast movement (keymap_special1)
122 #fast_move = false
123 # Invert mouse
124 #invert_mouse = false
125 # Enable/disable clouds
126 #enable_clouds = true
127 #cloud_height = 120
128 #enable_3d_clouds = true
129 # Use a cloud animation for the main menu background
130 #menu_clouds = true
131 # Path for screenshots
132 #screenshot_path = .
133 # Amount of view bobbing (0 = no view bobbing, 1.0 = normal, 2.0 = double)
134 #view_bobbing_amount = 1.0
135 # Amount of fall bobbing (0 = no fall bobbing, 1.0 = normal, 2.0 = double)
136 #fall_bobbing_amount = 0.0
137 # 3d support,
138 # right now:
139 #     "none"       = no 3d output,
140 #     "anaglyph"   = cyan/magenta color 3d,
141 #     "interlaced" = odd/even line based polarisation screen support,
142 #     "topbottom"  = split screen top boton,
143 #     "sidebyside" = split screen side by side
144 #3d_mode = none
145 #3d_paralax_strength = 0.025
146 # In-game chat console background color (R,G,B)
147 #console_color = (0,0,0)
148 # In-game chat console background alpha (opaqueness, between 0 and 255)
149 #console_alpha = 200
150 # Selection box border color (R,G,B)
151 #selectionbox_color = (0,0,0)
152 # Crosshair color (R,G,B)
153 #crosshair_color = (255,255,255)
154 # Cross alpha (opaqueness, between 0 and 255)
155 #crosshair_alpha = 255
156 # scale gui by a user specified value
157 #gui_scaling = 1.0
158 # Sensitivity multiplier
159 #mouse_sensitivity = 0.2
160 # Sound settings
161 #enable_sound = true
162 #sound_volume = 0.7
163 # Whether node texture animations should be desynchronized per MapBlock
164 #desynchronize_mapblock_texture_animation = true
165 # (useful if you've there's something to be displayed right or left of hotbar)
166 # Width of the selectionbox's lines (Between 1 and 5)
167 #selectionbox_width = 2
168 # maximum percentage of current window to be used for hotbar
169 #hud_hotbar_max_width = 1.0
170 # Save the map received by the client on disk
171 #enable_local_map_saving = false
172 # Enable highlighting for nodes (disables selectionboxes)
173 #enable_node_highlighting = false
174 # Texture filtering settings
175 #mip_map = false
176 #anisotropic_filter = false
177 #bilinear_filter = false
178 #trilinear_filter = false
179 # Set to true to pre-generate all item visuals
180 #preload_item_visuals = false
181 # Set to true to enable shaders. Disable them if video_driver = direct3d9/8.
182 #enable_shaders = true
183 # Set to true to enable textures bumpmapping. Requires shaders enabled.
184 #enable_bumpmapping = false
185 # Set to true enables parallax occlusion mapping. Requires shaders enabled.
186 #generate_normalmaps = false
187 # Set to true enables on the fly normalmap generation (Emboss effect).
188 # Requires bumpmapping enabled.
189 #normalmaps_strength = 0.6
190 # Strength of generated normalmaps
191 #normalmaps_smooth = 1
192 # Defines sampling step of texture (0 - 2)
193 # Higher the value normal maps will be smoother
194 #enable_parallax_occlusion = false
195 # Scale of parallax occlusion effect
196 #parallax_occlusion_scale = 0.08
197 # Bias of parallax occlusion effect, usually scale/2
198 #parallax_occlusion_bias = 0.04
199 # Set to true enables waving water. Requires shaders enabled.
200 #enable_waving_water = false
201 # Parameters for waving water:
202 #water_wave_height = 1.0
203 #water_wave_length = 20.0
204 #water_wave_speed = 5.0
205 # Set to true enables waving leaves. Requires shaders enabled.
206 #enable_waving_leaves = false
207 # Set to true enables waving plants. Requires shaders enabled.
208 #enable_waving_plants = false
209 # Enables caching of facedir rotated meshes
210 #enable_mesh_cache = true
211 # The time in seconds it takes between repeated
212 # right clicks when holding the right mouse button
213 #repeat_rightclick_time = 0.25
214 # Make fog and sky colors depend on daytime (dawn/sunset) and view direction
215 #directional_colored_fog = true
216 #tooltip_show_delay = 400
217 # Delay showing tooltips, in miliseconds
218 #screen_dpi = 72
219 # adjust dpi configuration to your screen (Desktop only) e.g. for 4k screens
220
221 # Default timeout for cURL, in milliseconds
222 # Only has an effect if compiled with cURL
223 #curl_timeout = 5000
224 # Limits number of parallel HTTP requests. Affects:
225 # - Media fetch if server uses remote_media setting
226 # - Serverlist download and server announcement
227 # - Downloads performed by main menu (e.g. mod manager)
228 # Only has an effect if compiled with cURL
229 #curl_parallel_limit = 8
230 # maximum time in ms a file download (e.g. a mod download) may take
231 #curl_file_download_timeout = 300000
232
233 # enable usage of remote media server (if provided by server)
234 #enable_remote_media_server = true
235
236 # Url to the server list displayed in the Multiplayer Tab
237 #serverlist_url = servers.minetest.net
238 # File in client/serverlist/ that contains your favorite servers displayed in the Multiplayer Tab
239 #serverlist_file = favoriteservers.txt
240
241 # Whether freetype fonts are used, requires freetype support to be compiled in
242 #freetype = true
243 # Path to TrueTypeFont or bitmap
244 #font_path = fonts/liberationsans.ttf
245 #font_size = 13
246 # Font shadow offset, if 0 then shadow will not be drawn.
247 #font_shadow = 1
248 # Font shadow alpha (opaqueness, between 0 and 255)
249 #font_shadow_alpha = 128
250 #mono_font_path = fonts/liberationmono.ttf
251 #mono_font_size = 13
252
253 # This font will be used for certain languages
254 #fallback_font_path = fonts/DroidSansFallbackFull.ttf
255 #fallback_font_size = 13
256 #fallback_font_shadow = 1
257 #fallback_font_shadow_alpha = 128
258
259 #
260 # Server stuff
261 #
262 # Network port to listen (UDP)
263 #port = 30000
264 # Bind address
265 #bind_address =
266 # Name of server
267 #server_name = Minetest server
268 # Description of server
269 #server_description = mine here
270 # Domain name of server
271 #server_address = game.minetest.net
272 # Homepage of server
273 #server_url = http://minetest.net
274 # Automaticaly report to masterserver
275 #server_announce = 0
276 # Announce to this masterserver. if you want to announce your ipv6 address - use  serverlist_url = v6.servers.minetest.net
277 #serverlist_url = servers.minetest.net
278 # Default game (default when creating a new world)
279 #default_game = minetest
280 # World directory (everything in the world is stored here)
281 #map-dir = /custom/world
282 # Message of the Day
283 #motd = Welcome to this awesome Minetest server!
284 # Maximum number of players connected simultaneously
285 #max_users = 15
286 # Set to true to disallow old clients from connecting
287 #strict_protocol_version_checking = false
288 # Time in seconds for item entity to live. Default value: 900s
289 # Setting it to -1 disables the feature
290 #item_entity_ttl = 900
291 # Set to true to enable creative mode (unlimited inventory)
292 #creative_mode = false
293 # Enable players getting damage and dying
294 #enable_damage = false
295 # A chosen map seed for a new map, leave empty for random
296 #fixed_map_seed =
297 # Gives some stuff to players at the beginning
298 #give_initial_stuff = false
299 # New users need to input this password
300 #default_password =
301 # Available privileges: interact, shout, teleport, settime, privs, ...
302 # See /privs in game for a full list on your server and mod configuration.
303 #default_privs = interact, shout
304 # Whether players are shown to clients without any range limit
305 # deprecated, use the setting player_transfer_distance instead
306 #unlimited_player_transfer_distance = true
307 # Defines the maximal player transfer distance in blocks (0 = unlimited)
308 #player_transfer_distance = 0
309 # Whether to enable players killing each other
310 #enable_pvp = true
311 # If this is set, players will always (re)spawn at the given position
312 #static_spawnpoint = 0, 10, 0
313 # If true, new players cannot join with an empty password
314 #disallow_empty_password = false
315 # If true, disable cheat prevention in multiplayer
316 #disable_anticheat = false
317 # If true, actions are recorded for rollback
318 #enable_rollback_recording = false
319 # handling for deprecated lua api calls
320 #    "legacy" = (try to) mimic old behaviour (default for release)
321 #    "log"    = mimic and log backtrace of deprecated call (default for debug)
322 #    "error"  = abort on usage of deprecated call (suggested for mod developers)
323 #deprecated_lua_api_handling = legacy
324
325 # Mod profiler
326 #mod_profiling = false
327 # Detailed mod profile data
328 #detailed_profiling = false
329
330 # Profiler data print interval. #0 = disable.
331 #profiler_print_interval = 0
332 #enable_mapgen_debug_info = false
333 # from how far client knows about objects
334 #active_object_send_range_blocks = 3
335 # how large area of blocks are subject to the active block stuff (active = objects are loaded and ABMs run)
336 #active_block_range = 2
337 # how many blocks are flying in the wire simultaneously per client
338 #max_simultaneous_block_sends_per_client = 10
339 # how many blocks are flying in the wire simultaneously per server
340 #max_simultaneous_block_sends_server_total = 40
341 # From how far blocks are sent to clients (value * 16 nodes)
342 #max_block_send_distance = 10
343 # From how far blocks are generated for clients (value * 16 nodes)
344 #max_block_generate_distance = 6
345 # Number of extra blocks that can be loaded by /clearobjects at once
346 # This is a trade-off between sqlite transaction overhead and
347 # memory consumption (4096=100MB, as a rule of thumb)
348 #max_clearobjects_extra_loaded_blocks = 4096
349 # Maximum number of forceloaded blocks
350 #max_forceloaded_blocks = 16
351 # Interval of sending time of day to clients
352 #time_send_interval = 5
353 # Length of day/night cycle. 72=20min, 360=4min, 1=24hour, 0=day/night/whatever stays unchanged
354 #time_speed = 72
355 # Length of year in days for seasons change. With default time_speed 365 days = 5 real days for year. 30 days = 10 real hours
356 #year_days = 30
357 #server_unload_unused_data_timeout = 29
358 # Maximum number of statically stored objects in a block
359 #max_objects_per_block = 49
360 # Interval of saving important changes in the world
361 #server_map_save_interval = 5.3
362 # http://www.sqlite.org/pragma.html#pragma_synchronous only numeric values: 0 1 2
363 #sqlite_synchronous = 2
364 # To reduce lag, block transfers are slowed down when a player is building something.
365 # This determines how long they are slowed down after placing or removing a node.
366 #full_block_send_enable_min_time_from_building = 2.0
367 # Length of a server tick and the interval at which objects are generally updated over network
368 #dedicated_server_step = 0.1
369 # Can be set to true to disable shutting down on invalid world data
370 #ignore_world_load_errors = false
371 # Specifies URL from which client fetches media instead of using UDP
372 # $filename should be accessible from $remote_media$filename via cURL
373 # (obviously, remote_media should end with a slash)
374 # Files that are not present would be fetched the usual way
375 #remote_media =
376 # Level of logging to be written to debug.txt.
377 # 0 = none, 1 = errors and debug, 2 = action, 3 = info, 4 = verbose
378 #debug_log_level = 2
379 # Maximum number of blocks that can be queued for loading.
380 #emergequeue_limit_total = 256
381 # Maximum number of blocks to be queued that are to be loaded from file.
382 # Set to blank for an appropriate amount to be chosen automatically.
383 #emergequeue_limit_diskonly = 32
384 # Maximum number of blocks to be queued that are to be generated.
385 # Set to blank for an appropriate amount to be chosen automatically.
386 #emergequeue_limit_generate = 32
387 # Number of emerge threads to use.  Make this field blank, or increase this number, to use multiple threads.
388 # On multiprocessor systems, this will improve mapgen speed greatly, at the cost of slightly buggy caves.
389 #num_emerge_threads = 1
390 # maximum number of packets sent per send step, if you have a slow connection
391 # try reducing it, but don't reduce it to a number below double of targeted
392 # client number
393 #max_packets_per_iteration = 1024
394
395 #
396 # Physics stuff
397 #
398
399 #movement_acceleration_default = 3
400 #movement_acceleration_air = 2
401 #movement_acceleration_fast = 10
402 #movement_speed_walk = 4
403 #movement_speed_crouch = 1.35
404 #movement_speed_fast = 20
405 #movement_speed_climb = 2
406 #movement_speed_jump = 6.5
407 #movement_speed_descend = 6
408 #movement_liquid_fluidity = 1
409 #movement_liquid_fluidity_smooth = 0.5
410 #movement_liquid_sink = 10
411 #movement_gravity = 9.81
412
413 #
414 # Mapgen stuff
415 #
416
417 # Name of map generator to be used.  Currently supported: v5, v6, v7, singlenode
418 #mg_name = v6
419 # Water level of map.
420 #water_level = 1
421 # Size of chunks to be generated.
422 #chunksize = 5
423 # Map generation attributes.  Currently supported: trees, caves, flat, dungeons, light
424 # Flags that are not specified in the flag string are not modified from the default.
425 # To explicitly turn off a flag, prepend "no" to the beginning, e.g. nolight.
426 #mg_flags = trees, caves
427 # Map generation attributes specific to Mapgen V6.  Currently supported: biomeblend, jungles, mudflow
428 #mgv6_spflags = biomeblend
429 # How large deserts and beaches are
430 #mgv6_freq_desert = 0.45
431 #mgv6_freq_beach = 0.15
432 # Perlin noise attributes for different map generation parameters
433 # Offset, scale, spread factor, seed offset, number of octaves, persistence
434
435 #mgv5_spflags = blobs
436 #mgv5_np_filler_depth = 0, 1, (150, 150, 150), 261, 4, 0.7
437 #mgv5_np_factor = 0, 1, (250, 250, 250), 920381, 3, 0.45
438 #mgv5_np_height = 0, 10, (250, 250, 250), 84174, 4, 0.5
439 #mgv5_np_cave1 = 0, 6, (50, 50, 50), 52534, 4, 0.5
440 #mgv5_np_cave2 = 0, 6, (50, 50, 50), 10325, 4, 0.5
441 #mgv5_np_ground = 0, 40, (80, 80, 80), 983240, 4, 0.55
442 #mgv5_np_crumble = 0, 1, (20, 20, 20), 34413, 3, 1.3
443 #mgv5_np_wetness = 0, 1, (40, 40, 40), 32474, 4, 1.1
444
445 #mgv6_spflags = biomeblend, jungles, mudflow
446
447 #
448 # Noise parameters can be specified as a set of positional values:
449 #mgv6_np_terrain_base = -4, 20, (250, 250, 250), 82341, 5, 0.6
450 #
451 # Or the new group format can be used instead:
452 #mgv6_np_terrain_base = {
453 #   offset      = -4
454 #   scale       = 20
455 #   spread      = (250, 250, 250)
456 #   seed        = 82341
457 #   octaves     = 5
458 #   persistence = 0.6
459 #}
460
461 #mgv6_np_terrain_higher = 20, 16, (500, 500, 500), 85039, 5, 0.6
462 #mgv6_np_steepness = 0.85, 0.5, (125, 125, 125), -932, 5, 0.7
463 #mgv6_np_height_select = 0.5, 1, (250, 250, 250), 4213, 5, 0.69
464 #mgv6_np_mud = 4, 2, (200, 200, 200), 91013, 3, 0.55
465 #mgv6_np_beach = 0, 1, (250, 250, 250), 59420, 3, 0.50
466 #mgv6_np_biome = 0, 1, (250, 250, 250), 9130, 3, 0.50
467 #mgv6_np_cave = 6, 6, (250, 250, 250), 34329, 3, 0.50
468 #mgv6_np_humidity = 0.5, 0.5, (500, 500, 500), 72384, 4, 0.66
469 #mgv6_np_trees = 0, 1, (125, 125, 125), 2, 4, 0.66
470 #mgv6_np_apple_trees = 0, 1, (100, 100, 100), 342902, 3, 0.45
471
472 #mgv7_spflags = mountains, ridges
473 #mgv7_np_terrain = 10, 12, (350, 350, 350), 82341, 5, 0.6
474 #mgv7_np_bgroup = 0.5, 0.3125, (350, 350, 350), 5923, 2, 0.6
475 #mgv7_np_heat = 25, 50, (500, 500, 500), 35293, 1, 0
476 #mgv7_np_humidity = 50, 31.25, (750, 750, 750), 12094, 2, 0.6
477
478 # Enable/disable IPv6
479 #enable_ipv6 = true
480 # Enable/disable running an IPv6 server.  An IPv6 server may be restricted
481 # to IPv6 clients, depending on system configuration.
482 # Ignored if bind_address is set.
483 #ipv6_server = false
484
485 #main_menu_script =
486 #main_menu_game_mgr = 0
487 #main_menu_mod_mgr = 1
488 #modstore_download_url = https://forum.minetest.net/media/
489 #modstore_listmods_url = https://forum.minetest.net/mmdb/mods/
490 #modstore_details_url  = https://forum.minetest.net/mmdb/mod/*/
491
492 # Makes DirectX work with LuaJIT. Disable if it causes troubles.
493 #high_precision_fpu = true
494
495 # Override language. When no value is provided (default) system language is used.
496 # Check "locale" directory for the list of available translations.
497 #language =