6a227487a94b3356fb505955c88011dcf8dc4036
[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://c55.me/minetest/wiki/doku.php
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://bitbucket.org/celeron55/minetest/src/tip/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 # Address to connect to (#blank = start local server)
84 #address = 
85 # Enable random user input, for testing
86 #random_input = false
87 # Timeout for client to remove unused map data from memory
88 #client_unload_unused_data_timeout = 600
89 # Whether to fog out the end of the visible area
90 #enable_fog = true
91 # Enable a bit lower water surface; disable for speed (not quite optimized)
92 #new_style_water = false
93 # Constant volume liquids
94 #liquid_finite = false
95 # Update liquids every .. recommend for finite: 0.2
96 #liquid_update = 1.0
97 # When finite liquid: relax flowing blocks to source if level near max and N nearby source blocks, more realistic, but not true constant. values: 0,1,2,3,4 : 0 - disable, 1 - most aggresive
98 #liquid_relax = 2
99 # Optimization: faster cave flood (and not true constant)
100 #liquid_fast_flood = 1
101 # Underground water and lava springs, its infnity sources if liquid_finite enabled
102 #underground_springs = 1
103 # Enable nice leaves; disable for speed
104 #new_style_leaves = true
105 # Enable smooth lighting with simple ambient occlusion;
106 # disable for speed or for different looks.
107 #smooth_lighting = true
108 # Enable combining mainly used textures to a bigger one for improved speed
109 # disable if it causes graphics glitches.
110 #enable_texture_atlas = false
111 # Path to texture directory. All textures are first searched from here.
112 #texture_path = 
113 # Video back-end.
114 # Possible values: null, software, burningsvideo, direct3d8, direct3d9, opengl
115 #video_driver = opengl
116 # Unobstructed movement without physics, downwards key is keymap_special1
117 #free_move = false
118 # Continuous forward movement (for testing)
119 #continuous_forward = false
120 # Fast movement (keymap_special1)
121 #fast_move = false
122 # Invert mouse
123 #invert_mouse = false
124 # FarMesh thingy
125 #enable_farmesh = false
126 #farmesh_trees = true
127 #farmesh_distance = 40
128 # Enable/disable clouds
129 #enable_clouds = true
130 # Use a cloud animation for the main menu background
131 #menu_clouds = true
132 # Path for screenshots
133 #screenshot_path = .
134 # Amount of view bobbing (0 = no view bobbing, 1.0 = normal, 2.0 = double)
135 #view_bobbing_amount = 1.0
136 # Anaglyph stereo
137 #anaglyph = false
138 #anaglyph_strength = 0.1
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 # Sound settings
150 #enable_sound = true
151 #sound_volume = 0.7
152 # Whether node texture animations should be desynchronized per MapBlock
153 #desynchronize_mapblock_texture_animation = true
154 # Texture filtering settings
155 #mip_map = false
156 #anisotropic_filter = false
157 #bilinear_filter = false
158 #trilinear_filter = false
159 # Set to true to pre-generate all item visuals
160 #preload_item_visuals = true
161 # 0: disable shaders
162 # (1: low level shaders; not implemented)
163 # 2: enable high level shaders
164 #enable_shaders = 2
165 # The time in seconds it takes between repeated
166 # right clicks when holding the right mouse button
167 #repeat_rightclick_time = 0.25
168
169 # will only work for servers which use remote_media setting
170 # and only for clients compiled with cURL
171 #media_fetch_threads = 8
172
173 # Url to the server list displayed in the Multiplayer Tab
174 #serverlist_url = servers.minetest.net
175 # File in client/serverlist/ that contains your favorite servers displayed in the Multiplayer Tab
176 #serverlist_file = favoriteservers.txt
177
178 #font_path = fonts/liberationsans.ttf
179 #font_size = 13
180 #mono_font_path = fonts/liberationmono.ttf
181 #mono_font_size = 13
182
183 #
184 # Server stuff
185 #
186
187 # Name of server
188 #server_name = Minetest server
189 # Description of server
190 #server_description = mine here
191 # Domain name of server
192 #server_address = game.minetest.net
193 # Homepage of server
194 #server_url = http://minetest.net
195 # Automaticaly report to masterserver
196 #server_announce = 0
197 # Default game (default when creating a new world)
198 #default_game = minetest
199 # World directory (everything in the world is stored here)
200 #map-dir = /custom/world
201 # Message of the Day
202 #motd = Welcome to this awesome Minetest server!
203 # Maximum number of players connected simultaneously
204 #max_users = 100
205 # Set to true to disallow old clients from connecting
206 #strict_protocol_version_checking = false
207 # Set to true to enable creative mode (unlimited inventory)
208 #creative_mode = false
209 # Enable players getting damage and dying
210 #enable_damage = false
211 # Despawn all non-peaceful mobs
212 #only_peaceful_mobs = false
213 # A chosen map seed for a new map, leave empty for random
214 #fixed_map_seed =
215 # Gives some stuff to players at the beginning
216 #give_initial_stuff = false
217 # New users need to input this password
218 #default_password = 
219 # Available privileges: interact, shout, teleport, settime, privs, ...
220 # See /privs in game for a full list on your server and mod configuration.
221 #default_privs = interact, shout
222 # Whether players are shown to clients without any range limit
223 #unlimited_player_transfer_distance = true
224 # Whether to enable players killing each other
225 #enable_pvp = true
226 # If this is set, players will always (re)spawn at the given position
227 #static_spawnpoint = 0, 10, 0
228 # If true, new players cannot join with an empty password
229 #disallow_empty_password = false
230 # If true, disable cheat prevention in multiplayer
231 #disable_anticheat = false
232 # If true, actions are recorded for rollback
233 #enable_rollback_recording = false
234
235 # Profiler data print interval. #0 = disable.
236 #profiler_print_interval = 0
237 #enable_mapgen_debug_info = false
238 # from how far client knows about objects
239 #active_object_send_range_blocks = 3
240 # how large area of blocks are subject to the active block stuff (active = objects are loaded and ABMs run)
241 #active_block_range = 2
242 # how many blocks are flying in the wire simultaneously per client
243 #max_simultaneous_block_sends_per_client = 2
244 # how many blocks are flying in the wire simultaneously per server
245 #max_simultaneous_block_sends_server_total = 8
246 # From how far blocks are sent to clients (value * 16 nodes)
247 #max_block_send_distance = 10
248 # From how far blocks are generated for clients (value * 16 nodes)
249 #max_block_generate_distance = 6
250 # Interval of sending time of day to clients
251 #time_send_interval = 5
252 # Length of day/night cycle. 72=20min, 360=4min, 1=24hour, 0=day/night/whatever stays unchanged
253 #time_speed = 96
254 #server_unload_unused_data_timeout = 29
255 # Interval of saving important changes in the world
256 #server_map_save_interval = 5.3
257 # To reduce lag, block transfers are slowed down when a player is building something.
258 # This determines how long they are slowed down after placing or removing a node.
259 #full_block_send_enable_min_time_from_building = 2.0
260 # Length of a server tick and the interval at which objects are generally updated over network
261 #dedicated_server_step = 0.1
262 # Can be set to true to disable shutting down on invalid world data
263 #ignore_world_load_errors = false
264 # Congestion control parameters
265 # time in seconds, rate in ~500B packets
266 #congestion_control_aim_rtt = 0.2
267 #congestion_control_max_rate = 400
268 #congestion_control_min_rate = 10
269 # Specifies URL from which client fetches media instead of using UDP
270 # $filename should be accessible from $remote_media$filename via cURL
271 # (obviously, remote_media should end with a slash)
272 # Files that are not present would be fetched the usual way
273 #remote_media =
274 # Level of logging to be written to debug.txt.
275 # 0 = none, 1 = errors and debug, 2 = action, 3 = info, 4 = verbose
276 #debug_log_level = 2
277 # Maximum number of blocks that can be queued for loading.
278 #emergequeue_limit_total = 256
279 # Maximum number of blocks to be queued that are to be loaded from file.
280 # Leave blank for an appropriate amount to be chosen automatically.
281 #emergequeue_limit_diskonly =
282 # Maximum number of blocks to be queued that are to be generated.
283 # Leave blank for an appropriate amount to be chosen automatically.
284 #emergequeue_limit_generate = 
285 # Number of emerge threads to use.  Make this field blank, or increase this number, to use multiple threads.
286 # On multiprocessor systems, this will improve mapgen speed greatly, at the cost of slightly buggy caves.
287 #num_emerge_threads = 1
288
289 #
290 # Physics stuff
291 #
292
293 #movement_acceleration_default = 3
294 #movement_acceleration_air = 2
295 #movement_acceleration_fast = 10
296 #movement_speed_walk = 4
297 #movement_speed_crouch = 1.35
298 #movement_speed_fast = 20
299 #movement_speed_climb = 2
300 #movement_speed_jump = 6.5
301 #movement_speed_descend = 6
302 #movement_liquid_fluidity = 1
303 #movement_liquid_fluidity_smooth = 0.5
304 #movement_liquid_sink = 10
305 #movement_gravity = 9.81
306
307 #
308 # Mapgen stuff
309 #
310
311 # Name of map generator to be used.  Currently v6 and indev are supported.
312 #mg_name = v6
313 # Water level of map.
314 #water_level = 1
315 # Size of chunks to be generated.
316 #chunksize = 5
317 # Map generation attributes.  Currently supported: trees, caves, flat, v6_biome_blend, v6_jungles
318 #mg_flags = trees, caves, v6_biome_blend
319 # How large deserts and beaches are
320 #mgv6_freq_desert = 0.45
321 #mgv6_freq_beach = 0.15
322 # Perlin noise attributes for different map generation parameters
323 # Offset, scale, spread factor, seed offset, number of octaves, persistence
324 #mgv6_np_terrain_base = -4, 20, (250, 250, 250), 82341, 5, 0.6
325 #mgv6_np_terrain_higher = 20, 16, (500, 500, 500), 85039, 5, 0.6
326 #mgv6_np_steepness = 0.85, 0.5, (125, 125, 125), -932, 5, 0.7
327 #mgv6_np_height_select = 0.5, 1, (250, 250, 250), 4213, 5, 0.69
328 #mgv6_np_mud = 4, 2, (200, 200, 200), 91013, 3, 0.55
329 #mgv6_np_beach = 0, 1, (250, 250, 250), 59420, 3, 0.50
330 #mgv6_np_biome = 0, 1, (250, 250, 250), 9130, 3, 0.50
331 #mgv6_np_cave = 6, 6, (250, 250, 250), 34329, 3, 0.50
332 #mgv6_np_humidity = 0.5, 0.5, (500, 500, 500), 72384, 4, 0.66
333 #mgv6_np_trees = 0, 1, (125, 125, 125), 2, 4, 0.66
334 #mgv6_np_apple_trees = 0, 1, (100, 100, 100), 342902, 3, 0.45
335
336 #mgv7_np_terrain = 10, 12, (350, 350, 350), 82341, 5, 0.6
337 #mgv7_np_bgroup = 0.5, 0.3125, (350, 350, 350), 5923, 2, 0.6
338 #mgv7_np_heat = 25, 50, (500, 500, 500), 35293, 1, 0
339 #mgv7_np_humidity = 50, 31.25, (750, 750, 750), 12094, 2, 0.6
340
341 # Offset, scale, spread factor, seed offset, number of octaves, persistence, farscale
342 #mgindev_np_terrain_base = -4, 20, (250.0, 250, 250), 82341, 5, 0.6, 10
343 #mgindev_np_terrain_higher = 20, 16, (500, 500, 500), 85039, 5, 0.6, 10
344 #mgindev_np_steepness = 0.85, 0.5, (125, 125, 125), -932, 5, 0.7, 10
345 #mgindev_np_mud = 4, 2, (200, 200, 200), 91013, 3, 0.55, 1