Update wiki url
[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 # Network port (UDP)
26 #port = 
27 # Name of player; on a server this is the main admin
28 #name = 
29
30 #
31 # Client stuff
32 #
33
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 # The allowed adjustment range for the automatic rendering range adjustment
72 #viewing_range_nodes_max = 160
73 #viewing_range_nodes_min = 35
74 # Initial window size
75 #screenW = 800
76 #screenH = 600
77 #fullscreen = false
78 #fullscreen_bpp = 24
79 # Experimental option, might cause visible spaces between blocks
80 # when set to higher number than 0
81 #fsaa = 0
82 #vsync = false
83 #fov = 72
84 # Address to connect to (#blank = start local server)
85 #address = 
86 # Enable random user input, for testing
87 #random_input = false
88 # Timeout for client to remove unused map data from memory
89 #client_unload_unused_data_timeout = 600
90 # Whether to fog out the end of the visible area
91 #enable_fog = true
92 # Enable a bit lower water surface; disable for speed (not quite optimized)
93 #new_style_water = false
94 # Constant volume liquids
95 #liquid_finite = false
96 # Max liquids processed per step
97 #liquid_loop_max = 1000
98 # Update liquids every .. recommend for finite: 0.2
99 #liquid_update = 1.0
100 # Relax flowing blocks to source if level near max and N nearby
101 #  source blocks, more realistic, but not true constant.
102 #  values: 0,1,2,3,4 : 0 - disable, 1 - most aggresive
103 #  (for finite liquids)
104 #liquid_relax = 2
105 # Optimization: faster cave flood (and not true constant)
106 #  (for finite liquids)
107 #liquid_fast_flood = 1
108 # Underground water and lava springs, its infnity sources if liquid_finite enabled
109 #underground_springs = 1
110 # Enable nice leaves; disable for speed
111 #new_style_leaves = true
112 # Enable smooth lighting with simple ambient occlusion;
113 # disable for speed or for different looks.
114 #smooth_lighting = true
115 # Path to texture directory. All textures are first searched from here.
116 #texture_path = 
117 # Video back-end.
118 # Possible values: null, software, burningsvideo, direct3d8, direct3d9, opengl
119 #video_driver = opengl
120 # Unobstructed movement without physics, downwards key is keymap_special1
121 #free_move = false
122 # Continuous forward movement (for testing)
123 #continuous_forward = false
124 # Fast movement (keymap_special1)
125 #fast_move = false
126 # Invert mouse
127 #invert_mouse = false
128 # FarMesh thingy
129 #enable_farmesh = false
130 #farmesh_trees = true
131 #farmesh_distance = 40
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 # 0: disable shaders
172 # (1: low level shaders; not implemented)
173 # 2: enable high level shaders
174 #enable_shaders = 2
175 # The time in seconds it takes between repeated
176 # right clicks when holding the right mouse button
177 #repeat_rightclick_time = 0.25
178
179 # will only work for servers which use remote_media setting
180 # and only for clients compiled with cURL
181 #media_fetch_threads = 8
182
183 # Url to the server list displayed in the Multiplayer Tab
184 #serverlist_url = servers.minetest.net
185 # File in client/serverlist/ that contains your favorite servers displayed in the Multiplayer Tab
186 #serverlist_file = favoriteservers.txt
187
188 #font_path = fonts/liberationsans.ttf
189 #font_size = 13
190 #mono_font_path = fonts/liberationmono.ttf
191 #mono_font_size = 13
192
193 #
194 # Server stuff
195 #
196
197 # Name of server
198 #server_name = Minetest server
199 # Description of server
200 #server_description = mine here
201 # Domain name of server
202 #server_address = game.minetest.net
203 # Homepage of server
204 #server_url = http://minetest.net
205 # Automaticaly report to masterserver
206 #server_announce = 0
207 # Default game (default when creating a new world)
208 #default_game = minetest
209 # World directory (everything in the world is stored here)
210 #map-dir = /custom/world
211 # Message of the Day
212 #motd = Welcome to this awesome Minetest server!
213 # Maximum number of players connected simultaneously
214 #max_users = 100
215 # Set to true to disallow old clients from connecting
216 #strict_protocol_version_checking = false
217 # Set to true to enable creative mode (unlimited inventory)
218 #creative_mode = false
219 # Enable players getting damage and dying
220 #enable_damage = false
221 # Despawn all non-peaceful mobs
222 #only_peaceful_mobs = false
223 # A chosen map seed for a new map, leave empty for random
224 #fixed_map_seed =
225 # Gives some stuff to players at the beginning
226 #give_initial_stuff = false
227 # New users need to input this password
228 #default_password = 
229 # Available privileges: interact, shout, teleport, settime, privs, ...
230 # See /privs in game for a full list on your server and mod configuration.
231 #default_privs = interact, shout
232 # Whether players are shown to clients without any range limit
233 #unlimited_player_transfer_distance = true
234 # Whether to enable players killing each other
235 #enable_pvp = true
236 # If this is set, players will always (re)spawn at the given position
237 #static_spawnpoint = 0, 10, 0
238 # If true, new players cannot join with an empty password
239 #disallow_empty_password = false
240 # If true, disable cheat prevention in multiplayer
241 #disable_anticheat = false
242 # If true, actions are recorded for rollback
243 #enable_rollback_recording = false
244
245 # Profiler data print interval. #0 = disable.
246 #profiler_print_interval = 0
247 #enable_mapgen_debug_info = false
248 # from how far client knows about objects
249 #active_object_send_range_blocks = 3
250 # how large area of blocks are subject to the active block stuff (active = objects are loaded and ABMs run)
251 #active_block_range = 2
252 # how many blocks are flying in the wire simultaneously per client
253 #max_simultaneous_block_sends_per_client = 2
254 # how many blocks are flying in the wire simultaneously per server
255 #max_simultaneous_block_sends_server_total = 8
256 # From how far blocks are sent to clients (value * 16 nodes)
257 #max_block_send_distance = 10
258 # From how far blocks are generated for clients (value * 16 nodes)
259 #max_block_generate_distance = 6
260 # Number of extra blocks that can be loaded by /clearobjects at once
261 # This is a trade-off between sqlite transaction overhead and
262 # memory consumption (4096=100MB, as a rule of thumb)
263 #max_clearobjects_extra_loaded_blocks = 4096
264 # Interval of sending time of day to clients
265 #time_send_interval = 5
266 # Length of day/night cycle. 72=20min, 360=4min, 1=24hour, 0=day/night/whatever stays unchanged
267 #time_speed = 96
268 #server_unload_unused_data_timeout = 29
269 # Interval of saving important changes in the world
270 #server_map_save_interval = 5.3
271 # To reduce lag, block transfers are slowed down when a player is building something.
272 # This determines how long they are slowed down after placing or removing a node.
273 #full_block_send_enable_min_time_from_building = 2.0
274 # Length of a server tick and the interval at which objects are generally updated over network
275 #dedicated_server_step = 0.1
276 # Can be set to true to disable shutting down on invalid world data
277 #ignore_world_load_errors = false
278 # Congestion control parameters
279 # time in seconds, rate in ~500B packets
280 #congestion_control_aim_rtt = 0.2
281 #congestion_control_max_rate = 400
282 #congestion_control_min_rate = 10
283 # Specifies URL from which client fetches media instead of using UDP
284 # $filename should be accessible from $remote_media$filename via cURL
285 # (obviously, remote_media should end with a slash)
286 # Files that are not present would be fetched the usual way
287 #remote_media =
288 # Level of logging to be written to debug.txt.
289 # 0 = none, 1 = errors and debug, 2 = action, 3 = info, 4 = verbose
290 #debug_log_level = 2
291 # Maximum number of blocks that can be queued for loading.
292 #emergequeue_limit_total = 256
293 # Maximum number of blocks to be queued that are to be loaded from file.
294 # Leave blank for an appropriate amount to be chosen automatically.
295 #emergequeue_limit_diskonly =
296 # Maximum number of blocks to be queued that are to be generated.
297 # Leave blank for an appropriate amount to be chosen automatically.
298 #emergequeue_limit_generate = 
299 # Number of emerge threads to use.  Make this field blank, or increase this number, to use multiple threads.
300 # On multiprocessor systems, this will improve mapgen speed greatly, at the cost of slightly buggy caves.
301 #num_emerge_threads = 1
302
303 #
304 # Physics stuff
305 #
306
307 #movement_acceleration_default = 3
308 #movement_acceleration_air = 2
309 #movement_acceleration_fast = 10
310 #movement_speed_walk = 4
311 #movement_speed_crouch = 1.35
312 #movement_speed_fast = 20
313 #movement_speed_climb = 2
314 #movement_speed_jump = 6.5
315 #movement_speed_descend = 6
316 #movement_liquid_fluidity = 1
317 #movement_liquid_fluidity_smooth = 0.5
318 #movement_liquid_sink = 10
319 #movement_gravity = 9.81
320
321 #
322 # Mapgen stuff
323 #
324
325 # Name of map generator to be used.  Currently supported: v6, indev, singlenode, math
326 #mg_name = v6
327 # Water level of map.
328 #water_level = 1
329 # Size of chunks to be generated.
330 #chunksize = 5
331 # Map generation attributes.  Currently supported: trees, caves, flat, v6_biome_blend, v6_jungles, dungeons, nolight
332 #mg_flags = trees, caves, v6_biome_blend
333 # How large deserts and beaches are
334 #mgv6_freq_desert = 0.45
335 #mgv6_freq_beach = 0.15
336 # Perlin noise attributes for different map generation parameters
337 # Offset, scale, spread factor, seed offset, number of octaves, persistence
338 #mgv6_np_terrain_base = -4, 20, (250, 250, 250), 82341, 5, 0.6
339 #mgv6_np_terrain_higher = 20, 16, (500, 500, 500), 85039, 5, 0.6
340 #mgv6_np_steepness = 0.85, 0.5, (125, 125, 125), -932, 5, 0.7
341 #mgv6_np_height_select = 0.5, 1, (250, 250, 250), 4213, 5, 0.69
342 #mgv6_np_mud = 4, 2, (200, 200, 200), 91013, 3, 0.55
343 #mgv6_np_beach = 0, 1, (250, 250, 250), 59420, 3, 0.50
344 #mgv6_np_biome = 0, 1, (250, 250, 250), 9130, 3, 0.50
345 #mgv6_np_cave = 6, 6, (250, 250, 250), 34329, 3, 0.50
346 #mgv6_np_humidity = 0.5, 0.5, (500, 500, 500), 72384, 4, 0.66
347 #mgv6_np_trees = 0, 1, (125, 125, 125), 2, 4, 0.66
348 #mgv6_np_apple_trees = 0, 1, (100, 100, 100), 342902, 3, 0.45
349
350 #mgv7_np_terrain = 10, 12, (350, 350, 350), 82341, 5, 0.6
351 #mgv7_np_bgroup = 0.5, 0.3125, (350, 350, 350), 5923, 2, 0.6
352 #mgv7_np_heat = 25, 50, (500, 500, 500), 35293, 1, 0
353 #mgv7_np_humidity = 50, 31.25, (750, 750, 750), 12094, 2, 0.6
354
355 # Offset, scale, spread factor, seed offset, number of octaves, persistence, farscale, farspread
356 #mgindev_np_terrain_base   = -4,   20,  (250, 250, 250), 82341, 5, 0.6,  10,  10
357 #mgindev_np_terrain_higher = 20,   16,  (500, 500, 500), 85039, 5, 0.6,  10,  10
358 #mgindev_np_steepness      = 0.85, 0.5, (125, 125, 125), -932,  5, 0.7,  2,   10
359 #mgindev_np_mud            = 4,    2,   (200, 200, 200), 91013, 3, 0.55, 1,   1
360 #mgindev_np_float_islands1 = 0,    1,   (64,  64,  64 ), 3683,  5, 0.5,  1,   1.5
361 #mgindev_np_float_islands2 = 0,    1,   (8,   8,   8  ), 9292,  2, 0.5,  1,   1.5
362 #mgindev_np_float_islands3 = 0,    1,   (256, 256, 256), 6412,  2, 0.5,  1,   0.5
363 #mgindev_np_biome          = 0,    1,   (250, 250, 250), 9130,  3, 0.50, 1,   10
364
365 # Float islands starts from height, 0 to disable
366 #mgindev_float_islands = 500
367
368 # Math mapgen generator: sphere, mandelbox, mengersponge      dont forget to lower water_level = -30000
369 #mgmath_generator = mandelbox
370
371 # Enable/disable IPv6
372 #enable_ipv6 = true
373 # Enable/disable running an IPv6 server.  An IPv6 server may be restricted
374 # to IPv6 clients, depending on system configuration.
375 #ipv6_server = false
376
377 #main_menu_game_mgr = 0
378 #main_menu_mod_mgr = 0
379 #modstore_download_url = http://forum.minetest.net/media/
380 #modstore_listmods_url = http://forum.minetest.net/mmdb/mods/
381 #modstore_details_url  = http://forum.minetest.net/mmdb/mod/*/