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