f728d6c88168b0b81666c82c34e3d89e8edf0e00
[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 # Constant volume liquids
97 #liquid_finite = false
98 # Max liquids processed per step
99 #liquid_loop_max = 10000
100 # Update liquids every .. recommend for finite: 0.2
101 #liquid_update = 1.0
102 # Relax flowing blocks to source if level near max and N nearby
103 #  source blocks, more realistic, but not true constant.
104 #  values: 0,1,2,3,4 : 0 - disable, 1 - most aggresive
105 #  (for finite liquids)
106 #liquid_relax = 2
107 # Optimization: faster cave flood (and not true constant)
108 #  (for finite liquids)
109 #liquid_fast_flood = 1
110 # Underground water and lava springs, its infnity sources if liquid_finite enabled
111 #underground_springs = 1
112 # Enable weather (cold-hot, water freeze-melt). use only with liquid_finite=1
113 #weather = false
114 # Enable nice leaves; disable for speed
115 #new_style_leaves = true
116 # Enable smooth lighting with simple ambient occlusion;
117 # disable for speed or for different looks.
118 #smooth_lighting = true
119 # Path to texture directory. All textures are first searched from here.
120 #texture_path =
121 # Video back-end.
122 # Possible values: null, software, burningsvideo, direct3d8, direct3d9, opengl
123 #video_driver = opengl
124 # Unobstructed movement without physics, downwards key is keymap_special1
125 #free_move = false
126 # Continuous forward movement (for testing)
127 #continuous_forward = false
128 # Fast movement (keymap_special1)
129 #fast_move = false
130 # Invert mouse
131 #invert_mouse = false
132 # Enable/disable clouds
133 #enable_clouds = true
134 #cloud_height = 120
135 #enable_3d_clouds = true
136 # Use a cloud animation for the main menu background
137 #menu_clouds = true
138 # Path for screenshots
139 #screenshot_path = .
140 # Amount of view bobbing (0 = no view bobbing, 1.0 = normal, 2.0 = double)
141 #view_bobbing_amount = 1.0
142 # Amount of fall bobbing (0 = no fall bobbing, 1.0 = normal, 2.0 = double)
143 #fall_bobbing_amount = 0.0
144 # Anaglyph stereo
145 #anaglyph = false
146 #anaglyph_strength = 0.1
147 # In-game chat console background color (R,G,B)
148 #console_color = (0,0,0)
149 # In-game chat console background alpha (opaqueness, between 0 and 255)
150 #console_alpha = 200
151 # Selection box border color (R,G,B)
152 #selectionbox_color = (0,0,0)
153 # Crosshair color (R,G,B)
154 #crosshair_color = (255,255,255)
155 # Cross alpha (opaqueness, between 0 and 255)
156 #crosshair_alpha = 255
157 # Sensitivity multiplier
158 #mouse_sensitivity = 0.2
159 # Sound settings
160 #enable_sound = true
161 #sound_volume = 0.7
162 # Whether node texture animations should be desynchronized per MapBlock
163 #desynchronize_mapblock_texture_animation = true
164 # Texture filtering settings
165 #mip_map = false
166 #anisotropic_filter = false
167 #bilinear_filter = false
168 #trilinear_filter = false
169 # Set to true to pre-generate all item visuals
170 #preload_item_visuals = true
171 # Set to true to enable shaders. Disable them if video_driver = direct3d9/8.
172 #enable_shaders = true
173 # Set to true to enable textures bumpmapping. Requires shaders enabled.
174 #enable_bumpmapping = false
175 # Set to true enables parallax occlusion mapping. Requires shaders enabled.
176 #generate_normalmaps = false
177 # Set to true enables on the fly normalmap generation (Emboss effect).
178 # Requires bumpmapping enabled.
179 #normalmaps_strength = 0.6
180 # Strength of generated normalmaps
181 #normalmaps_smooth = 1
182 # Defines sampling step of texture (0 - 2) 
183 # Higher the value normal maps will be smoother
184 #enable_parallax_occlusion = false
185 # Scale of parallax occlusion effect
186 #parallax_occlusion_scale = 0.08
187 # Bias of parallax occlusion effect, usually scale/2
188 #parallax_occlusion_bias = 0.04
189 # Set to true enables waving water. Requires shaders enabled.
190 #enable_waving_water = false
191 # Parameters for waving water:
192 #water_wave_height = 1.0
193 #water_wave_length = 20.0
194 #water_wave_speed = 5.0
195 # Set to true enables waving leaves. Requires shaders enabled.
196 #enable_waving_leaves = false
197 # Set to true enables waving plants. Requires shaders enabled.
198 #enable_waving_plants = false
199 # The time in seconds it takes between repeated
200 # right clicks when holding the right mouse button
201 #repeat_rightclick_time = 0.25
202 # Make fog and sky colors depend on daytime (dawn/sunset) and view direction
203 #directional_colored_fog = true
204
205 # Default timeout for cURL, in milliseconds
206 # Only has an effect if compiled with cURL
207 #curl_timeout = 5000
208 # Limits number of parallel HTTP requests. Affects:
209 # - Media fetch if server uses remote_media setting
210 # - Serverlist download and server announcement
211 # - Downloads performed by main menu (e.g. mod manager)
212 # Only has an effect if compiled with cURL
213 #curl_parallel_limit = 8
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 # Set to true to enable creative mode (unlimited inventory)
268 #creative_mode = false
269 # Enable players getting damage and dying
270 #enable_damage = false
271 # Despawn all non-peaceful mobs
272 #only_peaceful_mobs = false
273 # A chosen map seed for a new map, leave empty for random
274 #fixed_map_seed =
275 # Gives some stuff to players at the beginning
276 #give_initial_stuff = false
277 # New users need to input this password
278 #default_password =
279 # Available privileges: interact, shout, teleport, settime, privs, ...
280 # See /privs in game for a full list on your server and mod configuration.
281 #default_privs = interact, shout
282 # Whether players are shown to clients without any range limit
283 #unlimited_player_transfer_distance = true
284 # Whether to enable players killing each other
285 #enable_pvp = true
286 # If this is set, players will always (re)spawn at the given position
287 #static_spawnpoint = 0, 10, 0
288 # If true, new players cannot join with an empty password
289 #disallow_empty_password = false
290 # If true, disable cheat prevention in multiplayer
291 #disable_anticheat = false
292 # If true, actions are recorded for rollback
293 #enable_rollback_recording = false
294
295 # Profiler data print interval. #0 = disable.
296 #profiler_print_interval = 0
297 #enable_mapgen_debug_info = false
298 # from how far client knows about objects
299 #active_object_send_range_blocks = 3
300 # how large area of blocks are subject to the active block stuff (active = objects are loaded and ABMs run)
301 #active_block_range = 2
302 # how many blocks are flying in the wire simultaneously per client
303 #max_simultaneous_block_sends_per_client = 10
304 # how many blocks are flying in the wire simultaneously per server
305 #max_simultaneous_block_sends_server_total = 40
306 # From how far blocks are sent to clients (value * 16 nodes)
307 #max_block_send_distance = 10
308 # From how far blocks are generated for clients (value * 16 nodes)
309 #max_block_generate_distance = 6
310 # Number of extra blocks that can be loaded by /clearobjects at once
311 # This is a trade-off between sqlite transaction overhead and
312 # memory consumption (4096=100MB, as a rule of thumb)
313 #max_clearobjects_extra_loaded_blocks = 4096
314 # Maximum number of forceloaded blocks
315 #max_forceloaded_blocks = 16
316 # Interval of sending time of day to clients
317 #time_send_interval = 5
318 # Length of day/night cycle. 72=20min, 360=4min, 1=24hour, 0=day/night/whatever stays unchanged
319 #time_speed = 72
320 # Length of year in days for seasons change. With default time_speed 365 days = 5 real days for year. 30 days = 10 real hours
321 #year_days = 30
322 #server_unload_unused_data_timeout = 29
323 # Maximum number of statically stored objects in a block
324 #max_objects_per_block = 49
325 # Interval of saving important changes in the world
326 #server_map_save_interval = 5.3
327 # http://www.sqlite.org/pragma.html#pragma_synchronous only numeric values: 0 1 2
328 #sqlite_synchronous = 2
329 # To reduce lag, block transfers are slowed down when a player is building something.
330 # This determines how long they are slowed down after placing or removing a node.
331 #full_block_send_enable_min_time_from_building = 2.0
332 # Length of a server tick and the interval at which objects are generally updated over network
333 #dedicated_server_step = 0.1
334 # Can be set to true to disable shutting down on invalid world data
335 #ignore_world_load_errors = false
336 # Congestion control parameters
337 # time in seconds, rate in ~500B packets
338 #congestion_control_aim_rtt = 0.2
339 #congestion_control_max_rate = 400
340 #congestion_control_min_rate = 10
341 # Specifies URL from which client fetches media instead of using UDP
342 # $filename should be accessible from $remote_media$filename via cURL
343 # (obviously, remote_media should end with a slash)
344 # Files that are not present would be fetched the usual way
345 #remote_media =
346 # Level of logging to be written to debug.txt.
347 # 0 = none, 1 = errors and debug, 2 = action, 3 = info, 4 = verbose
348 #debug_log_level = 2
349 # Maximum number of blocks that can be queued for loading.
350 #emergequeue_limit_total = 256
351 # Maximum number of blocks to be queued that are to be loaded from file.
352 # Set to blank for an appropriate amount to be chosen automatically.
353 #emergequeue_limit_diskonly = 32
354 # Maximum number of blocks to be queued that are to be generated.
355 # Set to blank for an appropriate amount to be chosen automatically.
356 #emergequeue_limit_generate = 32
357 # Number of emerge threads to use.  Make this field blank, or increase this number, to use multiple threads.
358 # On multiprocessor systems, this will improve mapgen speed greatly, at the cost of slightly buggy caves.
359 #num_emerge_threads = 1
360 # maximum number of packets sent per send step, if you have a slow connection
361 # try reducing it, but don't reduce it to a number below double of targeted
362 # client number
363 #max_packets_per_iteration = 1024
364 #
365 # Physics stuff
366 #
367
368 #movement_acceleration_default = 3
369 #movement_acceleration_air = 2
370 #movement_acceleration_fast = 10
371 #movement_speed_walk = 4
372 #movement_speed_crouch = 1.35
373 #movement_speed_fast = 20
374 #movement_speed_climb = 2
375 #movement_speed_jump = 6.5
376 #movement_speed_descend = 6
377 #movement_liquid_fluidity = 1
378 #movement_liquid_fluidity_smooth = 0.5
379 #movement_liquid_sink = 10
380 #movement_gravity = 9.81
381
382 #
383 # Mapgen stuff
384 #
385
386 # Name of map generator to be used.  Currently supported: v6, v7, indev, singlenode, math
387 #mg_name = v6
388 # Water level of map.
389 #water_level = 1
390 # Size of chunks to be generated.
391 #chunksize = 5
392 # Map generation attributes.  Currently supported: trees, caves, flat, dungeons, light
393 # Flags that are not specified in the flag string are not modified from the default.
394 # To explicitly turn off a flag, prepend "no" to the beginning, e.g. nolight.
395 #mg_flags = trees, caves
396 # Map generation attributes specific to Mapgen V6.  Currently supported: biomeblend, jungles, mudflow
397 #mgv6_spflags = biomeblend
398 # How large deserts and beaches are
399 #mgv6_freq_desert = 0.45
400 #mgv6_freq_beach = 0.15
401 # Perlin noise attributes for different map generation parameters
402 # Offset, scale, spread factor, seed offset, number of octaves, persistence
403 #mgv6_np_terrain_base = -4, 20, (250, 250, 250), 82341, 5, 0.6
404 #mgv6_np_terrain_higher = 20, 16, (500, 500, 500), 85039, 5, 0.6
405 #mgv6_np_steepness = 0.85, 0.5, (125, 125, 125), -932, 5, 0.7
406 #mgv6_np_height_select = 0.5, 1, (250, 250, 250), 4213, 5, 0.69
407 #mgv6_np_mud = 4, 2, (200, 200, 200), 91013, 3, 0.55
408 #mgv6_np_beach = 0, 1, (250, 250, 250), 59420, 3, 0.50
409 #mgv6_np_biome = 0, 1, (250, 250, 250), 9130, 3, 0.50
410 #mgv6_np_cave = 6, 6, (250, 250, 250), 34329, 3, 0.50
411 #mgv6_np_humidity = 0.5, 0.5, (500, 500, 500), 72384, 4, 0.66
412 #mgv6_np_trees = 0, 1, (125, 125, 125), 2, 4, 0.66
413 #mgv6_np_apple_trees = 0, 1, (100, 100, 100), 342902, 3, 0.45
414
415 #mgv7_spflags = mountains, ridges
416 #mgv7_np_terrain = 10, 12, (350, 350, 350), 82341, 5, 0.6
417 #mgv7_np_bgroup = 0.5, 0.3125, (350, 350, 350), 5923, 2, 0.6
418 #mgv7_np_heat = 25, 50, (500, 500, 500), 35293, 1, 0
419 #mgv7_np_humidity = 50, 31.25, (750, 750, 750), 12094, 2, 0.6
420
421 # Offset, scale, spread factor, seed offset, number of octaves, persistence, farscale, farspread
422 #mgindev_np_terrain_base   = -4,   20,  (250, 250, 250), 82341, 5, 0.6,  10,  10
423 #mgindev_np_terrain_higher = 20,   16,  (500, 500, 500), 85039, 5, 0.6,  10,  10
424 #mgindev_np_steepness      = 0.85, 0.5, (125, 125, 125), -932,  5, 0.7,  2,   10
425 #mgindev_np_mud            = 4,    2,   (200, 200, 200), 91013, 3, 0.55, 1,   1
426 #mgindev_np_float_islands1 = 0,    1,   (64,  64,  64 ), 3683,  5, 0.5,  1,   1.5
427 #mgindev_np_float_islands2 = 0,    1,   (8,   8,   8  ), 9292,  2, 0.5,  1,   1.5
428 #mgindev_np_float_islands3 = 0,    1,   (256, 256, 256), 6412,  2, 0.5,  1,   0.5
429 #mgindev_np_biome          = 0,    1,   (250, 250, 250), 9130,  3, 0.50, 1,   10
430
431 # Float islands starts from height, 0 to disable
432 #mgindev_float_islands = 500
433
434 # Math mapgen generator: sphere, mandelbox, mengersponge      dont forget to lower water_level = -30000
435 #mgmath_generator = mandelbox
436
437 # Enable/disable IPv6
438 #enable_ipv6 = true
439 # Enable/disable running an IPv6 server.  An IPv6 server may be restricted
440 # to IPv6 clients, depending on system configuration.
441 #ipv6_server = false
442
443 #main_menu_script =
444 #main_menu_game_mgr = 0
445 #main_menu_mod_mgr = 1
446 #modstore_download_url = https://forum.minetest.net/media/
447 #modstore_listmods_url = https://forum.minetest.net/mmdb/mods/
448 #modstore_details_url  = https://forum.minetest.net/mmdb/mod/*/
449
450 # Makes DirectX work with LuaJIT. Disable if it causes troubles.
451 #high_precision_fpu = true
452
453 # Override language. When no value is provided (default) system language is used.
454 # Check "locale" directory for the list of available translations.
455 #language =