From fa30a14c5ce4cac402a6cecaee2e450969625f68 Mon Sep 17 00:00:00 2001 From: Marcin Date: Sun, 30 Aug 2015 20:28:48 +0200 Subject: [PATCH] Make example config more readable --- minetest.conf.example | 171 +++++++++++++++++++++++++++++++++++++++++- 1 file changed, 170 insertions(+), 1 deletion(-) diff --git a/minetest.conf.example b/minetest.conf.example index 656abd13b..54fd66bcb 100644 --- a/minetest.conf.example +++ b/minetest.conf.example @@ -31,6 +31,7 @@ # Port to connect to (UDP) #remote_port = + # Key mappings. # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 #keymap_forward = KEY_KEY_W @@ -40,6 +41,7 @@ #keymap_jump = KEY_SPACE #keymap_sneak = KEY_LSHIFT #keymap_inventory = KEY_KEY_I + # Go down ladder / go down in fly mode / go fast in fast mode #keymap_special1 = KEY_KEY_E #keymap_chat = KEY_KEY_T @@ -50,12 +52,16 @@ #keymap_fastmove = KEY_KEY_J #keymap_cinematic = KEY_F8 #keymap_screenshot = KEY_F12 + # If true, keymap_special1 instead of keymap_sneak is used for climbing down and descending #aux1_descends = false + # Double-tapping the jump key toggles fly mode #doubletap_jump = false + # If false aux1 is used to fly fast #always_fly_fast = true + # Some (temporary) keys for debugging #keymap_print_debug_stacks = KEY_KEY_P #keymap_quicktune_prev = KEY_HOME @@ -66,100 +72,143 @@ # If set to true, you can place blocks at the position (feet + eye level) where you stand. # This is helpful when working with nodeboxes. #enable_build_where_you_stand = false + # Minimum FPS. # The amount of rendered stuff is dynamically set according to this. #wanted_fps = 30 + # If FPS would go higher than this, limit it by sleeping # to not waste CPU power for no benefit. #fps_max = 60 + # Maximum FPS when game is paused #pause_fps_max = 20 + # The allowed adjustment range for the automatic rendering range adjustment #viewing_range_nodes_max = 160 #viewing_range_nodes_min = 35 + # Initial window size #screenW = 800 #screenH = 600 #fullscreen = false #fullscreen_bpp = 24 + # Experimental option, might cause visible spaces between blocks # when set to higher number than 0. #fsaa = 0 + +# Vertical synchronization #vsync = false + # Field of view in degrees #fov = 72 + # Address to connect to (#blank = start local server) #address = + # Enable random user input, for testing #random_input = false + # Timeout for client to remove unused map data from memory #client_unload_unused_data_timeout = 600 + # Maximum number of mapblocks for client to be kept in memory # Set to -1 for unlimited amount #client_mapblock_limit = 5000 + # Whether to fog out the end of the visible area #enable_fog = true + # Whether to show the client debug info (has the same effect as hitting F5) #show_debug = false + # Enable a bit lower water surface; disable for speed (not quite optimized) #new_style_water = false + # Max liquids processed per step #liquid_loop_max = 100000 + # The time (in seconds) that the liquids queue may grow beyond processing # capacity until an attempt is made to decrease its size by dumping old queue # items. A value of 0 disables the functionality. #liquid_queue_purge_time = 0 + # Liquid update interval in seconds #liquid_update = 1.0 + # Leaves style: # fancy - all faces visible # simple - only outer faces, if defined special_tiles are used # opaque - disable transparency #leaves_style = fancy + # Connects glass if supported by node #connected_glass = false + # Enable smooth lighting with simple ambient occlusion. # Disable for speed or for different looks. #smooth_lighting = true + # Adjust the gamma encoding for the light tables. Valid values are in the range # 1.0 to 3.0 (inclusive); lower numbers are brighter. This setting is for the # client only and is ignored by the server #display_gamma = 1.8 + # Path to texture directory. All textures are first searched from here. #texture_path = + # Video back-end. # Possible values: null, software, burningsvideo, direct3d8, direct3d9, opengl. #video_driver = opengl + # Unobstructed movement without physics, downwards key is keymap_special1 #free_move = false + # Continuous forward movement (for testing) #continuous_forward = false + # Enable cinematic mode #cinematic = false + # Camera smoothing - smooths rotation of camera. 0 is no smoothing. # Must be equal to or greater than 0, and less than 1. #camera_smoothing = 0.0 + # Camera smoothing when in cinematic mode #cinematic_camera_smoothing = 0.7 + # Fast movement (keymap_special1) #fast_move = false + # Invert mouse #invert_mouse = false + # Enable/disable clouds #enable_clouds = true + +# Height on which clouds are appearing #cloud_height = 120 + # Radius of cloud area stated in number of 64 node cloud squares. # Values larger than 26 will start to produce sharp cutoffs at cloud area corners. #cloud_radius = 12 + +# Use 3D cloud look instead of flat #enable_3d_clouds = true + # Use a cloud animation for the main menu background #menu_clouds = true + # Path for screenshots #screenshot_path = + # Amount of view bobbing (0 = no view bobbing, 1.0 = normal, 2.0 = double) #view_bobbing_amount = 1.0 + # Amount of fall bobbing (0 = no fall bobbing, 1.0 = normal, 2.0 = double) #fall_bobbing_amount = 0.0 + # 3d support. # Currently: # "none" = no 3d output. @@ -168,58 +217,78 @@ # "topbottom" = split screen top/bottom. # "sidebyside" = split screen side by side. #3d_mode = none + +# Strength of parallax #3d_parallax_strength = 0.025 + # In-game chat console background color (R,G,B) #console_color = (0,0,0) + # In-game chat console background alpha (opaqueness, between 0 and 255) #console_alpha = 200 + # Selection box border color (R,G,B) #selectionbox_color = (0,0,0) + # Crosshair color (R,G,B) #crosshair_color = (255,255,255) + # Cross alpha (opaqueness, between 0 and 255) #crosshair_alpha = 255 + # Scale gui by a user specified value # Use a nearest-neighbor-anti-alias filter to scale the GUI. # This will smooth over some of the rough edges, and blend # pixels when scaling down, at the cost of blurring some # edge pixels when images are scaled by non-integer sizes. #gui_scaling = 1.0 + # When gui_scaling_filter is true, all GUI images need to be # filtered in software, but some images are generated directly # to hardware (e.g. render-to-texture for nodes in inventory). +#gui_scaling_filter = false + # When gui_scaling_filter_txr2img is true, copy those images # from hardware to software for scaling. When false, fall back # to the old scaling method, for video drivers that don't # propery support downloading textures back from hardware. -#gui_scaling_filter = false #gui_scaling_filter_txr2img = true + # Sensitivity multiplier #mouse_sensitivity = 0.2 + # Sound settings #enable_sound = true #sound_volume = 0.7 + # Whether node texture animations should be desynchronized per mapblock #desynchronize_mapblock_texture_animation = true + # Width of the selectionbox's lines (Between 1 and 5) #selectionbox_width = 2 + # Maximum proportion of current window to be used for hotbar. # Useful if there's something to be displayed right or left of hotbar. #hud_hotbar_max_width = 1.0 + # Save the map received by the client on disk #enable_local_map_saving = false + # Enable selection highlighting for nodes (disables selectionbox) #enable_node_highlighting = false + # Texture filtering settings #mip_map = false #anisotropic_filter = false #bilinear_filter = false #trilinear_filter = false + # Filtered textures can blend RGB values with fully-transparent neighbors, # which PNG optimizers usually discard, sometimes resulting in a dark or # light edge to transparent textures. Apply this filter to clean that up # at texture load time. #texture_clean_transparent = false + # When using bilinear/trilinear/anisotropic filters, low-resolution textures # can be blurred, so automatically upscale them with nearest-neighbor # interpolation to preserve crisp pixels. This sets the minimum texture size @@ -228,53 +297,72 @@ # have a visible effect unless bilinear/trilinear/anisotropic filtering is # enabled. #texture_min_size = 64 + # Set to true to pre-generate all item visuals #preload_item_visuals = false + # Set to true to enable shaders. Disable them if video_driver = direct3d9/8. #enable_shaders = true + # Set to true to enable textures bumpmapping. Requires shaders enabled. #enable_bumpmapping = false + # Set to true enables on the fly normalmap generation (Emboss effect). # Requires bumpmapping enabled. #generate_normalmaps = false + # Strength of generated normalmaps #normalmaps_strength = 0.6 + # Defines sampling step of texture (0 - 2). # A higher value results in smoother normal maps. #normalmaps_smooth = 0 + # 0 = parallax occlusion with slope information (faster) # 1 = relief mapping (slower, more accurate) #parallax_occlusion_mode = 1 + # Set to true enables parallax occlusion mapping. Requires shaders enabled. #enable_parallax_occlusion = false + # Number of parallax occlusion iterations #parallax_occlusion_iterations = 4 + # Overall scale of parallax occlusion effect #parallax_occlusion_scale = 0.08 + # Overall bias of parallax occlusion effect, usually scale/2 #parallax_occlusion_bias = 0.04 + # Set to true enables waving water. Requires shaders enabled. #enable_waving_water = false + # Parameters for waving water: #water_wave_height = 1.0 #water_wave_length = 20.0 #water_wave_speed = 5.0 + # Set to true enables waving leaves. Requires shaders enabled. #enable_waving_leaves = false + # Set to true enables waving plants. Requires shaders enabled. #enable_waving_plants = false + # The strength (darkness) of node ambient-occlusion shading. # Lower is darker, Higher is lighter. The valid range of values for this # setting is 0.25 to 4.0 inclusive. If the value is out of range it will be # set to the nearest valid value. #ambient_occlusion_gamma = 2.2 + # Enables caching of facedir rotated meshes #enable_mesh_cache = false # Enables minimap #enable_minimap = true + # true - round shape, false - square #minimap_shape_round = true + # true = 256, false = 128 # useable to make minimap smoother on slower machines #minimap_double_scan_height = true @@ -282,40 +370,54 @@ # The time in seconds it takes between repeated # right clicks when holding the right mouse button. #repeat_rightclick_time = 0.25 + # Make fog and sky colors depend on daytime (dawn/sunset) and view direction #directional_colored_fog = true + # Delay showing tooltips, stated in milliseconds #tooltip_show_delay = 400 + # Adjust dpi configuration to your screen (non X11/Android only) e.g. for 4k screens #screen_dpi = 72 + # Default timeout for cURL, stated in milliseconds. # Only has an effect if compiled with cURL. #curl_timeout = 5000 + # Limits number of parallel HTTP requests. Affects: # Media fetch if server uses remote_media setting. # Serverlist download and server announcement. # Downloads performed by main menu (e.g. mod manager). # Only has an effect if compiled with cURL. #curl_parallel_limit = 8 + # Maximum time in ms a file download (e.g. a mod download) may take #curl_file_download_timeout = 300000 + # Enable usage of remote media server (if provided by server) #enable_remote_media_server = true + # Url to the server list displayed in the Multiplayer Tab #serverlist_url = servers.minetest.net + # File in client/serverlist/ that contains your favorite servers displayed in the Multiplayer Tab #serverlist_file = favoriteservers.txt + # Whether freetype fonts are used, requires freetype support to be compiled in #freetype = true + # Path to TrueTypeFont or bitmap #font_path = fonts/liberationsans.ttf #font_size = 15 + # Font shadow offset, if 0 then shadow will not be drawn #font_shadow = 1 + # Font shadow alpha (opaqueness, between 0 and 255) #font_shadow_alpha = 128 #mono_font_path = fonts/liberationmono.ttf #mono_font_size = 15 + # This font will be used for certain languages #fallback_font_path = fonts/DroidSansFallbackFull.ttf #fallback_font_size = 15 @@ -328,63 +430,90 @@ # Network port to listen (UDP) #port = 30000 + # Bind address #bind_address = + # Name of server #server_name = Minetest server + # Description of server #server_description = mine here + # Domain name of server #server_address = game.minetest.net + # Homepage of server #server_url = http://minetest.net + # Automaticaly report to masterserver #server_announce = 0 + # Announce to this masterserver. # If you want to announce your ipv6 address - use serverlist_url = v6.servers.minetest.net. #serverlist_url = servers.minetest.net + # Default game (default when creating a new world) #default_game = minetest + # World directory (everything in the world is stored here) #map-dir = /custom/world + # Message of the Day #motd = Welcome to this awesome Minetest server! + # Maximum number of players connected simultaneously #max_users = 15 + # Set to true to disallow old clients from connecting #strict_protocol_version_checking = false + # Time in seconds for item entity to live. Default value: 900s. # Setting it to -1 disables the feature. #item_entity_ttl = 900 + # Set to true to enable creative mode (unlimited inventory) #creative_mode = false + # Enable players getting damage and dying #enable_damage = false + # A chosen map seed for a new map, leave empty for random #fixed_map_seed = + # Gives some stuff to players at the beginning #give_initial_stuff = false + # New users need to input this password #default_password = + # Available privileges: interact, shout, teleport, settime, privs, ... # See /privs in game for a full list on your server and mod configuration. #default_privs = interact, shout + # Whether players are shown to clients without any range limit. # Deprecated, use the setting player_transfer_distance instead. #unlimited_player_transfer_distance = true + # Defines the maximal player transfer distance in blocks (0 = unlimited) #player_transfer_distance = 0 + # Whether to enable players killing each other #enable_pvp = true + # If this is set, players will always (re)spawn at the given position #static_spawnpoint = 0, 10, 0 + # If true, new players cannot join with an empty password #disallow_empty_password = false + # If true, disable cheat prevention in multiplayer #disable_anticheat = false + # If true, actions are recorded for rollback # This option is only read when server starts #enable_rollback_recording = false + # Handling for deprecated lua api calls: # "legacy" = (try to) mimic old behaviour (default for release). # "log" = mimic and log backtrace of deprecated call (default for debug). @@ -393,32 +522,43 @@ # A message to be displayed to all clients when the server shuts down #kick_msg_shutdown = Server shutting down. + # A message to be displayed to all clients when the server crashes #kick_msg_crash = This server has experienced an internal error. You will now be disconnected. + # Whether to ask clients to reconnect after a (lua) crash. # Set this to true if your server is set up to restart automatically. #ask_reconnect_on_crash = false # Mod profiler #mod_profiling = false + # Detailed mod profile data #detailed_profiling = false + # Profiler data print interval. #0 = disable. #profiler_print_interval = 0 #enable_mapgen_debug_info = false + # From how far client knows about objects #active_object_send_range_blocks = 3 + # How large area of blocks are subject to the active block stuff. # Active = objects are loaded and ABMs run. #active_block_range = 2 + # How many blocks are flying in the wire simultaneously per client #max_simultaneous_block_sends_per_client = 10 + # How many blocks are flying in the wire simultaneously per server #max_simultaneous_block_sends_server_total = 40 + # From how far blocks are sent to clients, stated in mapblocks (16 nodes) #max_block_send_distance = 10 + # From how far blocks are generated for clients, stated in mapblocks (16 nodes) #max_block_generate_distance = 6 + # Where the map generator stops. # Please note: # * Limited to 31000 (setting above has no effect) @@ -426,51 +566,71 @@ # * Those groups have an offset of -32, -32 nodes from the origin. # * Only groups which are within the map_generation_limit are generated #map_generation_limit = 31000 + # Number of extra blocks that can be loaded by /clearobjects at once. # This is a trade-off between sqlite transaction overhead and # memory consumption (4096=100MB, as a rule of thumb). #max_clearobjects_extra_loaded_blocks = 4096 + # Maximum number of forceloaded blocks #max_forceloaded_blocks = 16 + # Interval of sending time of day to clients #time_send_interval = 5 + # Controls length of day/night cycle. # 72=20min, 360=4min, 1=24hour, 0=day/night/whatever stays unchanged. #time_speed = 72 + +# How much the server will wait before unloading unused MapBlocks. +# Higher value is smoother, but will use more RAM. #server_unload_unused_data_timeout = 29 + # Maximum number of statically stored objects in a block #max_objects_per_block = 49 + # Interval of saving important changes in the world, stated in seconds #server_map_save_interval = 5.3 + # http://www.sqlite.org/pragma.html#pragma_synchronous only numeric values: 0 1 2 #sqlite_synchronous = 2 + # To reduce lag, block transfers are slowed down when a player is building something. # This determines how long they are slowed down after placing or removing a node. #full_block_send_enable_min_time_from_building = 2.0 + # Length of a server tick and the interval at which objects are generally updated over network #dedicated_server_step = 0.1 + # Can be set to true to disable shutting down on invalid world data #ignore_world_load_errors = false + # Specifies URL from which client fetches media instead of using UDP. # $filename should be accessible from $remote_media$filename via cURL # (obviously, remote_media should end with a slash). # Files that are not present would be fetched the usual way. #remote_media = + # Level of logging to be written to debug.txt: # 0 = none, 1 = errors and debug, 2 = action, 3 = info, 4 = verbose. #debug_log_level = 2 + # Maximum number of blocks that can be queued for loading #emergequeue_limit_total = 256 + # Maximum number of blocks to be queued that are to be loaded from file. # Set to blank for an appropriate amount to be chosen automatically. #emergequeue_limit_diskonly = 32 + # Maximum number of blocks to be queued that are to be generated. # Set to blank for an appropriate amount to be chosen automatically. #emergequeue_limit_generate = 32 + # Number of emerge threads to use. Make this field blank, or increase this number # to use multiple threads. On multiprocessor systems, this will improve mapgen speed greatly # at the cost of slightly buggy caves. #num_emerge_threads = 1 + # Maximum number of packets sent per send step, if you have a slow connection # try reducing it, but don't reduce it to a number below double of targeted # client number. @@ -478,18 +638,22 @@ # Enable/disable IPv6 #enable_ipv6 = true + # Enable/disable running an IPv6 server. An IPv6 server may be restricted # to IPv6 clients, depending on system configuration. # Ignored if bind_address is set. #ipv6_server = false + #main_menu_script = #main_menu_game_mgr = 0 #main_menu_mod_mgr = 1 #modstore_download_url = https://forum.minetest.net/media/ #modstore_listmods_url = https://forum.minetest.net/mmdb/mods/ #modstore_details_url = https://forum.minetest.net/mmdb/mod/*/ + # Makes DirectX work with LuaJIT. Disable if it causes troubles. #high_precision_fpu = true + # Override language. When no value is provided (default) system language is used. # Check "locale" directory for the list of available translations. #language = @@ -519,10 +683,13 @@ # Name of map generator to be used. # Currently supported: v5, v6, v7, singlenode. #mg_name = v6 + # Water surface level of map #water_level = 1 + # Size of chunks to be generated, stated in mapblocks (16 nodes) #chunksize = 5 + # Global map generation attributes. # Currently supported: trees, caves, flat, dungeons, light. # Flags that are not specified in the flag string are not modified from the default. @@ -534,6 +701,7 @@ # Currently supported: jungles, biomeblend, mudflow, snowbiomes. # When snowbiomes are enabled jungles are enabled and the jungles flag is ignored. #mgv6_spflags = jungles, biomeblend, mudflow, snowbiomes + # Controls size of deserts and beaches in Mapgen V6 # When snowbiomes are enabled 'mgv6_freq_desert' is ignored. #mgv6_freq_desert = 0.45 @@ -612,6 +780,7 @@ # Prevent mods from doing insecure things like running shell commands. #secure.enable_security = false + # Comma-separated list of trusted mods that are allowed to access insecure # functions even when mod security is on (via request_insecure_environment()). #secure.trusted_mods =