X-Git-Url: https://git.lizzy.rs/?a=blobdiff_plain;f=minetest.conf.example;h=c430764597673884fb1aec23c755b28be2848d56;hb=312ca0382b864e6cdc20e308c33558869527a8ff;hp=34d618fd55ee60673a3953930f29ab58bf2ec983;hpb=8e3602f6949026b740bd190c0d21a75cf5720eeb;p=minetest.git diff --git a/minetest.conf.example b/minetest.conf.example index 34d618fd5..c43076459 100644 --- a/minetest.conf.example +++ b/minetest.conf.example @@ -38,7 +38,7 @@ # type: bool # noclip = false -# Smooths camera when moving and looking around. +# Smooths camera when looking around. Also called look or mouse smoothing. # Useful for recording videos. # type: bool # cinematic = false @@ -79,10 +79,32 @@ # type: bool # random_input = false -# Continuous forward movement (only used for testing). +# Continuous forward movement, toggled by autoforward key. # type: bool # continuous_forward = false +# Enable Joysticks +# type: bool +# enable_joysticks = false + +# The identifier of the joystick to use +# type: int +# joystick_id = 0 + +# The type of joystick +# type: enum values: auto, generic, xbox +# joystick_type = auto + +# The time in seconds it takes between repeated events +# when holding down a joystick button combination. +# type: float +# repeat_joystick_button_time = 0.17 + +# The sensitivity of the joystick axes for moving the +# ingame view frustum around. +# type: float +# joystick_frustum_sensitivity = 170 + # Key for moving the player forward. # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 # type: key @@ -134,6 +156,11 @@ # type: key # keymap_cmd = / +# Key for opening the chat window to type local commands. +# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 +# type: key +# keymap_cmd_local = . + # Key for opening the chat console. # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 # type: key @@ -159,10 +186,40 @@ # type: key # keymap_noclip = KEY_KEY_H +# Key for selecting the next item in the hotbar. +# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 +# type: key +# keymap_hotbar_next = KEY_KEY_N + +# Key for selecting the previous item in the hotbar. +# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 +# type: key +# keymap_hotbar_previous = KEY_KEY_B + +# Key for muting the game. +# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 +# type: key +# keymap_mute = KEY_KEY_M + +# Key for increasing the volume. +# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 +# type: key +# keymap_increase_volume = + +# Key for decreasing the volume. +# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 +# type: key +# keymap_decrease_volume = + +# Key for toggling autoforward. +# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 +# type: key +# keymap_autoforward = + # Key for toggling cinematic mode. # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 # type: key -# keymap_cinematic = KEY_F8 +# keymap_cinematic = # Key for toggling display of minimap. # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 @@ -179,6 +236,11 @@ # type: key # keymap_drop = KEY_KEY_Q +# Key to use view zoom when possible. +# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 +# type: key +# keymap_zoom = KEY_KEY_Z + # Key for toggling the display of the HUD. # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 # type: key @@ -189,15 +251,20 @@ # type: key # keymap_toggle_chat = KEY_F2 +# Key for toggling the display of the large chat console. +# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 +# type: key +# keymap_console = KEY_F10 + # Key for toggling the display of the fog. # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 # type: key # keymap_toggle_force_fog_off = KEY_F3 -# Key for toggling the camrea update. Only used for development +# Key for toggling the camera update. Only used for development # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 # type: key -# keymap_toggle_update_camera = +# keymap_toggle_update_camera = # Key for toggling the display of debug info. # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 @@ -214,12 +281,12 @@ # type: key # keymap_camera_mode = KEY_F7 -# Key for increasing the viewing range. Modifies the minimum viewing range. +# Key for increasing the viewing range. # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 # type: key # keymap_increase_viewing_range_min = + -# Key for decreasing the viewing range. Modifies the minimum viewing range. +# Key for decreasing the viewing range. # See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3 # type: key # keymap_decrease_viewing_range_min = - @@ -235,23 +302,39 @@ # Leave this blank to start a local server. # Note that the address field in the main menu overrides this setting. # type: string -# address = +# address = # Port to connect to (UDP). # Note that the port field in the main menu overrides this setting. # type: int min: 1 max: 65535 # remote_port = 30000 +# Whether to support older servers before protocol version 25. +# Enable if you want to connect to 0.4.12 servers and before. +# Servers starting with 0.4.13 will work, 0.4.12-dev servers may work. +# Disabling this option will protect your password better. +# type: bool +# send_pre_v25_init = false + # Save the map received by the client on disk. # type: bool # enable_local_map_saving = false +# Show entity selection boxes +# type: bool +# show_entity_selectionbox = true + # Enable usage of remote media server (if provided by server). # Remote servers offer a significantly faster way to download media (e.g. textures) # when connecting to the server. # type: bool # enable_remote_media_server = true +# Enable Lua modding support on client. +# This support is experimental and API can change. +# type: bool +# enable_client_modding = false + # URL to the server list displayed in the Multiplayer Tab. # type: string # serverlist_url = servers.minetest.net @@ -260,21 +343,23 @@ # type: string # serverlist_file = favoriteservers.txt +# Maximum size of the out chat queue. 0 to disable queueing and -1 to make the queue size unlimited +# type: int min: -1 +max_out_chat_queue_size = 20 + ## Graphics ### In-Game #### Basic -# Whether to fog out the end of the visible area. +# Enable VBO # type: bool -# enable_fog = true +# enable_vbo = true -# Enable a bit lower water surface, so it doesn't "fill" the node completely. -# Note that this is not quite optimized and that smooth lighting on the -# water surface doesn't work with this. +# Whether to fog out the end of the visible area. # type: bool -# new_style_water = false +# enable_fog = true # Leaves style: # - Fancy: all faces visible @@ -300,6 +385,14 @@ # type: bool # enable_3d_clouds = true +# Method used to highlight selected object. +# type: enum values: box, halo, none +# node_highlighting = box + +# Adds particles when digging a node. +# type: bool +# enable_particles = true + #### Filtering # Use mip mapping to scale textures. May slightly increase performance. @@ -335,24 +428,34 @@ # type: int # texture_min_size = 64 -# Pre-generate all item visuals used in the inventory. -# This increases startup time, but runs smoother in-game. -# The generated textures can easily exceed your VRAM, causing artifacts in the inventory. -# type: bool -# preload_item_visuals = false - # Experimental option, might cause visible spaces between blocks # when set to higher number than 0. # type: enum values: 0, 1, 2, 4, 8, 16 # fsaa = 0 +# Undersampling is similar to using lower screen resolution, but it applies +# to the game world only, keeping the GUI intact. +# It should give significant performance boost at the cost of less detailed image. +# type: enum values: 0, 2, 3, 4 +# undersampling = 0 + #### Shaders -# Shaders allow advanced visul effects and may increase performance on some video cards. -# Thy only work with the OpenGL video backend. +# Shaders allow advanced visual effects and may increase performance on some video cards. +# This only works with the OpenGL video backend. # type: bool # enable_shaders = true +# Path to shader directory. If no path is defined, default location will be used. +# type: path +# shader_path = + +##### Tone Mapping + +# Enables filmic tone mapping +# type: bool +# tone_mapping = false + ##### Bumpmapping # Enables bumpmapping for textures. Normalmaps need to be supplied by the texture pack @@ -389,7 +492,7 @@ # Strength of parallax. # type: float -# 3d_parallax_strength = 0.025 +# 3d_paralax_strength = 0.025 # Number of parallax occlusion iterations. # type: int @@ -431,11 +534,6 @@ #### Advanced -# Minimum wanted FPS. -# The amount of rendered stuff is dynamically set according to this. and viewing range min and max. -# type: int -# wanted_fps = 30 - # If FPS would go higher than this, limit it by sleeping # to not waste CPU power for no benefit. # type: int @@ -445,23 +543,21 @@ # type: int # pause_fps_max = 20 -# The allowed adjustment range for the automatic rendering range adjustment. -# Set this to be equal to viewing range minimum to disable the auto-adjustment algorithm. -# type: int -# viewing_range_nodes_max = 160 - -# The allowed adjustment range for the automatic rendering range adjustment. -# Set this to be equal to viewing range maximum to disable the auto-adjustment algorithm. -# type: int -# viewing_range_nodes_min = 35 +# View distance in nodes. +# type: int min: 20 max: 4000 +# viewing_range = 100 # Width component of the initial window size. # type: int -# screenW = 800 +# screen_w = 800 # Height component of the initial window size. # type: int -# screenH = 600 +# screen_h = 600 + +# Save the window size automatically when modified. +# type: bool +# autosave_screensize = true # Fullscreen mode. # type: bool @@ -479,14 +575,19 @@ # type: int min: 30 max: 160 # fov = 72 -# Adjust the gamma encoding for the light tables. Lower numbers are brighter. +# Field of view while zooming in degrees. +# This requires the "zoom" privilege on the server. +# type: int min: 7 max: 160 +# zoom_fov = 15 + +# Adjust the gamma encoding for the light tables. Higher numbers are brighter. # This setting is for the client only and is ignored by the server. # type: float min: 1 max: 3 -# display_gamma = 1.8 +# display_gamma = 2.2 # Path to texture directory. All textures are first searched from here. # type: path -# texture_path = +# texture_path = # The rendering back-end for Irrlicht. # type: enum values: null, software, burningsvideo, direct3d8, direct3d9, opengl @@ -501,7 +602,7 @@ # type: int # cloud_radius = 12 -# Multiplier for view bobbing. +# Enable view bobbing and amount of view bobbing. # For example: 0 for no view bobbing; 1.0 for normal; 2.0 for double. # type: float # view_bobbing_amount = 1.0 @@ -518,9 +619,14 @@ # - interlaced: odd/even line based polarisation screen support. # - topbottom: split screen top/bottom. # - sidebyside: split screen side by side. -# type: enum values: none, anaglyph, interlaced, topbottom, sidebyside +# - pageflip: quadbuffer based 3d. +# type: enum values: none, anaglyph, interlaced, topbottom, sidebyside, pageflip # 3d_mode = none +# In-game chat console height, between 0.1 (10%) and 1.0 (100%). +# type: float min: 0.1 max: 1 +# console_height = 1.0 + # In-game chat console background color (R,G,B). # type: string # console_color = (0,0,0) @@ -554,14 +660,25 @@ # type: float # hud_hotbar_max_width = 1.0 -# Enable selection highlighting for nodes (disables selectionbox). -# type: bool -# enable_node_highlighting = false +# Modifies the size of the hudbar elements. +# type: float +# hud_scaling = 1.0 # Enables caching of facedir rotated meshes. # type: bool # enable_mesh_cache = false +# Delay between mesh updates on the client in ms. Increasing this will slow +# down the rate of mesh updates, thus reducing jitter on slower clients. +# type: int min: 0 max: 50 +# mesh_generation_interval = 0 + +# Size of the MapBlock cache of the mesh generator. Increasing this will +# increase the cache hit %, reducing the data being copied from the main +# thread, thus reducing jitter. +# type: int min: 0 max: 1000 +# meshgen_block_cache_size = 20 + # Enables minimap. # type: bool # enable_minimap = true @@ -587,6 +704,23 @@ # type: float min: 0.25 max: 4 # ambient_occlusion_gamma = 2.2 +# Enables animation of inventory items. +# type: bool +# inventory_items_animations = false + +# Android systems only: Tries to create inventory textures from meshes +# when no supported render was found. +# type: bool +# inventory_image_hack = false + +# Fraction of the visible distance at which fog starts to be rendered +# type: float min: 0 max: 0.99 +# fog_start = 0.4 + +# Makes all liquids opaque +# type: bool +# opaque_water = false + ### Menus # Use a cloud animation for the main menu background. @@ -610,7 +744,7 @@ # 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. +# properly support downloading textures back from hardware. # type: bool # gui_scaling_filter_txr2img = true @@ -627,7 +761,7 @@ # font_path = fonts/liberationsans.ttf # type: int -# font_size = 15 +# font_size = 16 # Font shadow offset, if 0 then shadow will not be drawn. # type: int @@ -635,7 +769,7 @@ # Font shadow alpha (opaqueness, between 0 and 255). # type: int min: 0 max: 255 -# font_shadow_alpha = 128 +# font_shadow_alpha = 127 # type: path # mono_font_path = fonts/liberationmono.ttf @@ -658,7 +792,17 @@ # Path to save screenshots at. # type: path -# screenshot_path = +# screenshot_path = + +# Format of screenshots. +# type: enum values: png, jpg, bmp, pcx, ppm, tga +# screenshot_format = png + +# Screenshot quality. Only used for JPEG format. +# 1 means worst quality; 100 means best quality. +# Use 0 for default quality. +# type: int min: 0 max: 100 +# screenshot_quality = 0 ### Advanced @@ -666,6 +810,11 @@ # type: int # screen_dpi = 72 +# Windows systems only: Start Minetest with the command line window in the background. +# Contains the same information as the file debug.txt (default name). +# type: bool +# enable_console = false + ## Sound # type: bool @@ -718,6 +867,12 @@ # type: string # serverlist_url = servers.minetest.net +# Disable escape sequences, e.g. chat coloring. +# Use this if you want to run a server with pre-0.4.14 clients and you want to disable +# the escape sequences generated by mods. +# type: bool +# disable_escape_sequences = false + ## Network # Network port to listen (UDP). @@ -727,7 +882,7 @@ # The network interface that the server listens on. # type: string -# bind_address = +# bind_address = # Enable to disallow old clients from connecting. # Older clients are compatible in the sense that they will not crash when connecting @@ -740,7 +895,7 @@ # (obviously, remote_media should end with a slash). # Files that are not present will be fetched the usual way. # type: string -# remote_media = +# remote_media = # Enable/disable running an IPv6 server. An IPv6 server may be restricted # to IPv6 clients, depending on system configuration. @@ -750,11 +905,11 @@ ### Advanced -# How many blocks are flying in the wire simultaneously per client. +# Maximum number of blocks that are simultaneously sent per client. # type: int # max_simultaneous_block_sends_per_client = 10 -# How many blocks are flying in the wire simultaneously for the whole server. +# Maximum number of blocks that are simultaneously sent in total. # type: int # max_simultaneous_block_sends_server_total = 40 @@ -778,7 +933,7 @@ # Message of the day displayed to players connecting. # type: string -# motd = +# motd = # Maximum number of players that can connect simultaneously. # type: int @@ -787,31 +942,43 @@ # World directory (everything in the world is stored here). # Not needed if starting from the main menu. # type: path -# map-dir = +# map-dir = # Time in seconds for item entity (dropped items) to live. # Setting it to -1 disables the feature. # type: int # item_entity_ttl = 900 +# If enabled, show the server status message on player connection. +# type: bool +# show_statusline_on_connect = true + # Enable players getting damage and dying. # type: bool # enable_damage = false +# Enable creative mode for new created maps. +# type: bool +# creative_mode = false + # A chosen map seed for a new map, leave empty for random. # Will be overridden when creating a new world in the main menu. # type: string -# fixed_map_seed = +# fixed_map_seed = # New users need to input this password. # type: string -# default_password = +# default_password = # The privileges that new users automatically get. # See /privs in game for a full list on your server and mod configuration. # type: string # default_privs = interact, shout +# Privileges that players with basic_privs can grant +# type: string +# basic_privs = interact, shout + # Whether players are shown to clients without any range limit. # Deprecated, use the setting player_transfer_distance instead. # type: bool @@ -827,14 +994,7 @@ # If this is set, players will always (re)spawn at the given position. # type: string -# static_spawnpoint = - -# Maximum distance above water level for player spawn. -# Larger values result in spawn points closer to (x = 0, z = 0). -# Smaller values may result in a suitable spawn point not being found, -# resulting in a spawn at (0, 0, 0) possibly buried underground. -# type: int -# vertical_spawn_range = 16 +# static_spawnpoint = # If enabled, new players cannot join with an empty password. # type: bool @@ -869,7 +1029,7 @@ # How large area of blocks are subject to the active block stuff, stated in mapblocks (16 nodes). # In active blocks objects are loaded and ABMs run. # type: int -# active_block_range = 2 +# active_block_range = 3 # From how far blocks are sent to clients, stated in mapblocks (16 nodes). # type: int @@ -913,14 +1073,11 @@ # movement_speed_fast = 20 # type: float -# movement_speed_climb = 2 +# movement_speed_climb = 3 # type: float # movement_speed_jump = 6.5 -# type: float -# movement_speed_descend = 6 - # type: float # movement_liquid_fluidity = 1 @@ -942,18 +1099,6 @@ # type: enum values: legacy, log, error # deprecated_lua_api_handling = legacy -# Useful for mod developers. -# type: bool -# mod_profiling = false - -# Detailed mod profile data. Useful for mod developers. -# type: bool -# detailed_profiling = false - -# Profiler data print interval. 0 = disable. Useful for developers. -# type: int -# profiler_print_interval = 0 - # 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). @@ -967,7 +1112,7 @@ # Maximum number of statically stored objects in a block. # type: int -# max_objects_per_block = 49 +# max_objects_per_block = 64 # See http://www.sqlite.org/pragma.html#pragma_synchronous # type: enum values: 0, 1, 2 @@ -977,6 +1122,18 @@ # type: float # dedicated_server_step = 0.1 +# Time in between active block management cycles +# type: float +# active_block_mgmt_interval = 2.0 + +# Length of time between ABM execution cycles +# type: float +# abm_interval = 1.0 + +# Length of time between NodeTimer execution cycles +# type: float +# nodetimer_interval = 0.2 + # If enabled, invalid world data won't cause the server to shut down. # Only enable this if you know what you are doing. # type: bool @@ -996,12 +1153,27 @@ # type: float # liquid_update = 1.0 +# At this distance the server will aggressively optimize which blocks are sent to clients. +# Small values potentially improve performance a lot, at the expense of visible rendering glitches. +# (some blocks will not be rendered under water and in caves, as well as sometimes on land) +# Setting this to a value greater than max_block_send_distance disables this optimization. +# Stated in mapblocks (16 nodes) +# type: int min: 2 +# block_send_optimize_distance = 4 + +# If enabled the server will perform map block occlusion culling based on +# on the eye position of the player. This can reduce the number of blocks +# sent to the client 50-80%. The client will not longer receive most invisible +# so that the utility of noclip mode is reduced. +# type: bool +# server_side_occlusion_culling = true + ## Mapgen # Name of map generator to be used when creating a new world. # Creating a world in the main menu will override this. -# type: enum values: v5, v6, v7, flat, fractal, singlenode -# mg_name = v6 +# type: enum values: v5, v6, v7, flat, valleys, fractal, singlenode +# mg_name = v7 # Water surface level of the world. # type: int @@ -1011,20 +1183,17 @@ # type: int # max_block_generate_distance = 6 -# Where the map generator stops. -# Please note: -# - Limited to 31000 (setting above has no effect) -# - The map generator works in groups of 80x80x80 nodes (5x5x5 MapBlocks). -# - Those groups have an offset of -32, -32 nodes from the origin. -# - Only groups which are within the map_generation_limit are generated +# Limit of map generation, in nodes, in all 6 directions from (0, 0, 0). +# Only mapchunks completely within the mapgen limit are generated. +# Value is stored per-world. # type: int min: 0 max: 31000 -# map_generation_limit = 31000 +# mapgen_limit = 31000 # Global map generation attributes. # In Mapgen v6 the 'decorations' flag controls all decorations except trees # and junglegrass, in all other mapgens this flag controls all decorations. # Flags that are not specified in the flag string are not modified from the default. -# Flags starting with "no" are used to explicitly disable them. +# Flags starting with 'no' are used to explicitly disable them. # type: flags possible values: caves, dungeons, light, decorations, nocaves, nodungeons, nolight, nodecorations # mg_flags = caves,dungeons,light,decorations @@ -1058,134 +1227,245 @@ # type: int # num_emerge_threads = 1 -# Noise parameters for biome API temperature, humidity and biome blend. +#### Biome API temperature and humidity noise parameters + +# Temperature variation for biomes. # type: noise_params -# mg_biome_np_heat = 50, 50, (750, 750, 750), 5349, 3, 0.5, 2.0 +# mg_biome_np_heat = 50, 50, (1000, 1000, 1000), 5349, 3, 0.5, 2.0 +# Small-scale temperature variation for blending biomes on borders. # type: noise_params # mg_biome_np_heat_blend = 0, 1.5, (8, 8, 8), 13, 2, 1.0, 2.0 +# Humidity variation for biomes. # type: noise_params -# mg_biome_np_humidity = 50, 50, (750, 750, 750), 842, 3, 0.5, 2.0 +# mg_biome_np_humidity = 50, 50, (1000, 1000, 1000), 842, 3, 0.5, 2.0 +# Small-scale humidity variation for blending biomes on borders. # type: noise_params # mg_biome_np_humidity_blend = 0, 1.5, (8, 8, 8), 90003, 2, 1.0, 2.0 #### Mapgen v5 +# Map generation attributes specific to Mapgen v5. +# Flags that are not specified in the flag string are not modified from the default. +# Flags starting with 'no' are used to explicitly disable them. +# type: flags possible values: caverns, nocaverns +# mgv5_spflags = caverns + +# Controls width of tunnels, a smaller value creates wider tunnels. +# type: float +# mgv5_cave_width = 0.125 + +# Y-level of cavern upper limit. +# type: int +# mgv5_cavern_limit = -256 + +# Y-distance over which caverns expand to full size. +# type: int +# mgv5_cavern_taper = 256 + +# Defines full size of caverns, smaller values create larger caverns. +# type: float +# mgv5_cavern_threshold = 0.7 + +# Variation of biome filler depth. # type: noise_params # mgv5_np_filler_depth = 0, 1, (150, 150, 150), 261, 4, 0.7, 2.0 +# Variation of terrain vertical scale. +# When noise is < -0.55 terrain is near-flat. # type: noise_params # mgv5_np_factor = 0, 1, (250, 250, 250), 920381, 3, 0.45, 2.0 +# Y-level of average terrain surface. # type: noise_params # mgv5_np_height = 0, 10, (250, 250, 250), 84174, 4, 0.5, 2.0 +# First of 2 3D noises that together define tunnels. # type: noise_params # mgv5_np_cave1 = 0, 12, (50, 50, 50), 52534, 4, 0.5, 2.0 +# Second of 2 3D noises that together define tunnels. # type: noise_params # mgv5_np_cave2 = 0, 12, (50, 50, 50), 10325, 4, 0.5, 2.0 +# 3D noise defining giant caverns. +# type: noise_params +# mgv5_np_cavern = 0, 1, (384, 128, 384), 723, 5, 0.63, 2.0 + #### Mapgen v6 # Map generation attributes specific to Mapgen v6. -# When snowbiomes are enabled jungles are enabled and the jungles flag is ignored. +# The 'snowbiomes' flag enables the new 5 biome system. +# When the new biome system is enabled jungles are automatically enabled and +# the 'jungles' flag is ignored. # Flags that are not specified in the flag string are not modified from the default. -# Flags starting with "no" are used to explicitly disable them. +# Flags starting with 'no' are used to explicitly disable them. # type: flags possible values: jungles, biomeblend, mudflow, snowbiomes, flat, trees, nojungles, nobiomeblend, nomudflow, nosnowbiomes, noflat, notrees # mgv6_spflags = jungles,biomeblend,mudflow,snowbiomes,trees -# Controls size of deserts and beaches in Mapgen v6. -# When snowbiomes are enabled 'mgv6_freq_desert' is ignored. +# Deserts occur when np_biome exceeds this value. +# When the new biome system is enabled, this is ignored. # type: float # mgv6_freq_desert = 0.45 +# Sandy beaches occur when np_beach exceeds this value. # type: float # mgv6_freq_beach = 0.15 +# Y-level of lower terrain and lakebeds. # type: noise_params # mgv6_np_terrain_base = -4, 20, (250, 250, 250), 82341, 5, 0.6, 2.0 +# Y-level of higher (cliff-top) terrain. # type: noise_params # mgv6_np_terrain_higher = 20, 16, (500, 500, 500), 85039, 5, 0.6, 2.0 +# Varies steepness of cliffs. # type: noise_params # mgv6_np_steepness = 0.85, 0.5, (125, 125, 125), -932, 5, 0.7, 2.0 +# Defines areas of 'terrain_higher' (cliff-top terrain). # type: noise_params # mgv6_np_height_select = 0.5, 1, (250, 250, 250), 4213, 5, 0.69, 2.0 +# Varies depth of biome surface nodes. # type: noise_params # mgv6_np_mud = 4, 2, (200, 200, 200), 91013, 3, 0.55, 2.0 +# Defines areas with sandy beaches. # type: noise_params # mgv6_np_beach = 0, 1, (250, 250, 250), 59420, 3, 0.50, 2.0 +# Temperature variation for biomes. # type: noise_params # mgv6_np_biome = 0, 1, (500, 500, 500), 9130, 3, 0.50, 2.0 +# Variation of number of caves. # type: noise_params # mgv6_np_cave = 6, 6, (250, 250, 250), 34329, 3, 0.50, 2.0 +# Humidity variation for biomes. # type: noise_params # mgv6_np_humidity = 0.5, 0.5, (500, 500, 500), 72384, 3, 0.50, 2.0 +# Defines tree areas and tree density. # type: noise_params # mgv6_np_trees = 0, 1, (125, 125, 125), 2, 4, 0.66, 2.0 +# Defines areas where trees have apples. # type: noise_params # mgv6_np_apple_trees = 0, 1, (100, 100, 100), 342902, 3, 0.45, 2.0 #### Mapgen v7 # Map generation attributes specific to Mapgen v7. -# 'ridges' are the rivers. +# The 'ridges' flag enables the rivers. +# Floatlands are currently experimental and subject to change. # Flags that are not specified in the flag string are not modified from the default. -# Flags starting with "no" are used to explicitly disable them. -# type: flags possible values: mountains, ridges, nomountains, noridges -# mgv7_spflags = mountains,ridges +# Flags starting with 'no' are used to explicitly disable them. +# type: flags possible values: mountains, ridges, floatlands, caverns, nomountains, noridges, nofloatlands, nocaverns +# mgv7_spflags = mountains,ridges,nofloatlands,caverns + +# Controls width of tunnels, a smaller value creates wider tunnels. +# type: float +# mgv7_cave_width = 0.09 + +# Controls the density of floatland mountain terrain. +# Is an offset added to the 'np_mountain' noise value. +# type: float +# mgv7_float_mount_density = 0.6 + +# Typical maximum height, above and below midpoint, of floatland mountain terrain. +# type: float +# mgv7_float_mount_height = 128.0 +# Y-level of floatland midpoint and lake surface. +# type: int +# mgv7_floatland_level = 1280 + +# Y-level to which floatland shadows extend. +# type: int +# mgv7_shadow_limit = 1024 + +# Y-level of cavern upper limit. +# type: int +# mgv7_cavern_limit = -256 + +# Y-distance over which caverns expand to full size. +# type: int +# mgv7_cavern_taper = 256 + +# Defines full size of caverns, smaller values create larger caverns. +# type: float +# mgv7_cavern_threshold = 0.7 + +# Y-level of higher (cliff-top) terrain. # type: noise_params # mgv7_np_terrain_base = 4, 70, (600, 600, 600), 82341, 5, 0.6, 2.0 +# Y-level of lower terrain and lakebeds. # type: noise_params # mgv7_np_terrain_alt = 4, 25, (600, 600, 600), 5934, 5, 0.6, 2.0 +# Varies roughness of terrain. +# Defines the 'persistence' value for terrain_base and terrain_alt noises. # type: noise_params # mgv7_np_terrain_persist = 0.6, 0.1, (2000, 2000, 2000), 539, 3, 0.6, 2.0 +# Defines areas of higher (cliff-top) terrain and affects steepness of cliffs. # type: noise_params -# mgv7_np_height_select = -12, 24, (500, 500, 500), 4213, 6, 0.7, 2.0 +# mgv7_np_height_select = -8, 16, (500, 500, 500), 4213, 6, 0.7, 2.0 +# Variation of biome filler depth. # type: noise_params # mgv7_np_filler_depth = 0, 1.2, (150, 150, 150), 261, 3, 0.7, 2.0 +# Variation of maximum mountain height (in nodes). # type: noise_params # mgv7_np_mount_height = 256, 112, (1000, 1000, 1000), 72449, 3, 0.6, 2.0 +# Defines large-scale river channel structure. # type: noise_params # mgv7_np_ridge_uwater = 0, 1, (1000, 1000, 1000), 85039, 5, 0.6, 2.0 +# Defines areas of floatland smooth terrain. +# Smooth floatlands occur when noise > 0. +# type: noise_params +# mgv7_np_floatland_base = -0.6, 1.5, (600, 600, 600), 114, 5, 0.6, 2.0 + +# Variation of hill height and lake depth on floatland smooth terrain. +# type: noise_params +# mgv7_np_float_base_height = 48, 24, (300, 300, 300), 907, 4, 0.7, 2.0 + +# 3D noise defining mountain structure and height. +# Also defines structure of floatland mountain terrain. # type: noise_params # mgv7_np_mountain = -0.6, 1, (250, 350, 250), 5333, 5, 0.63, 2.0 +# 3D noise defining structure of river canyon walls. # type: noise_params # mgv7_np_ridge = 0, 1, (100, 100, 100), 6467, 4, 0.75, 2.0 +# 3D noise defining giant caverns. # type: noise_params -# mgv7_np_cave1 = 0, 12, (100, 100, 100), 52534, 4, 0.5, 2.0 +# mgv7_np_cavern = 0, 1, (384, 128, 384), 723, 5, 0.63, 2.0 +# First of 2 3D noises that together define tunnels. # type: noise_params -# mgv7_np_cave2 = 0, 12, (100, 100, 100), 10325, 4, 0.5, 2.0 +# mgv7_np_cave1 = 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0 + +# Second of 2 3D noises that together define tunnels. +# type: noise_params +# mgv7_np_cave2 = 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0 #### Mapgen flat # Map generation attributes specific to Mapgen flat. -# Occasional lakes and hills added to the flat world. +# Occasional lakes and hills can be added to the flat world. # Flags that are not specified in the flag string are not modified from the default. -# Flags starting with "no" are used to explicitly disable them. +# Flags starting with 'no' are used to explicitly disable them. # type: flags possible values: lakes, hills, nolakes, nohills # mgflat_spflags = nolakes,nohills @@ -1197,6 +1477,10 @@ # type: int # mgflat_large_cave_depth = -33 +# Controls width of tunnels, a smaller value creates wider tunnels. +# type: float +# mgflat_cave_width = 0.09 + # Terrain noise threshold for lakes. # Controls proportion of world area covered by lakes. # Adjust towards 0.0 for a larger proportion. @@ -1217,37 +1501,52 @@ # type: float # mgflat_hill_steepness = 64.0 -# Determines terrain shape. -# The 3 numbers in brackets control the scale of the -# terrain, the 3 numbers should be identical. +# Defines location and terrain of optional hills and lakes. # type: noise_params # mgflat_np_terrain = 0, 1, (600, 600, 600), 7244, 5, 0.6, 2.0 +# Variation of biome filler depth. # type: noise_params # mgflat_np_filler_depth = 0, 1.2, (150, 150, 150), 261, 3, 0.7, 2.0 +# First of 2 3D noises that together define tunnels. # type: noise_params -# mgflat_np_cave1 = 0, 12, (128, 128, 128), 52534, 4, 0.5, 2.0 +# mgflat_np_cave1 = 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0 +# Second of 2 3D noises that together define tunnels. # type: noise_params -# mgflat_np_cave2 = 0, 12, (128, 128, 128), 10325, 4, 0.5, 2.0 +# mgflat_np_cave2 = 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0 #### Mapgen fractal -# Choice of 8 4-dimensional fractals. -# 1 = "Roundy" mandelbrot set. -# 2 = "Roundy" julia set. -# 3 = "Squarry" mandelbrot set. -# 4 = "Squarry" julia set. -# 5 = "Mandy Cousin" mandelbrot set. -# 6 = "Mandy Cousin" julia set. -# 7 = "Variation" mandelbrot set. -# 8 = "Variation" julia set. -# type: int min: 1 max: 8 -# mgfractal_formula = 1 +# Controls width of tunnels, a smaller value creates wider tunnels. +# type: float +# mgfractal_cave_width = 0.09 + +# Choice of 18 fractals from 9 formulas. +# 1 = 4D "Roundy" mandelbrot set. +# 2 = 4D "Roundy" julia set. +# 3 = 4D "Squarry" mandelbrot set. +# 4 = 4D "Squarry" julia set. +# 5 = 4D "Mandy Cousin" mandelbrot set. +# 6 = 4D "Mandy Cousin" julia set. +# 7 = 4D "Variation" mandelbrot set. +# 8 = 4D "Variation" julia set. +# 9 = 3D "Mandelbrot/Mandelbar" mandelbrot set. +# 10 = 3D "Mandelbrot/Mandelbar" julia set. +# 11 = 3D "Christmas Tree" mandelbrot set. +# 12 = 3D "Christmas Tree" julia set. +# 13 = 3D "Mandelbulb" mandelbrot set. +# 14 = 3D "Mandelbulb" julia set. +# 15 = 3D "Cosine Mandelbulb" mandelbrot set. +# 16 = 3D "Cosine Mandelbulb" julia set. +# 17 = 4D "Mandelbulb" mandelbrot set. +# 18 = 4D "Mandelbulb" julia set. +# type: int min: 1 max: 18 +# mgfractal_fractal = 1 # Iterations of the recursive function. -# Controls scale of finest detail. +# Controls the amount of fine detail. # type: int # mgfractal_iterations = 11 @@ -1255,62 +1554,217 @@ # type: v3f # mgfractal_scale = (4096.0, 1024.0, 4096.0) -# (X,Y,Z) offset of fractal from world centre. +# (X,Y,Z) offset of fractal from world centre in units of 'scale'. # Used to move a suitable spawn area of low land close to (0, 0). -# The default is suitable for mandelbrot sets, it needs to be edited for julia sets, -# do this by greatly reducing 'scale' and setting 'offset' initially to (0, 0, 0). +# The default is suitable for mandelbrot sets, it needs to be edited for julia sets. # Range roughly -2 to 2. Multiply by 'scale' for offset in nodes. # type: v3f # mgfractal_offset = (1.79, 0.0, 0.0) -# W co-ordinate of the generated 3D slice of the 4D shape. -# Alters the generated 3D shape. +# W co-ordinate of the generated 3D slice of a 4D fractal. +# Determines which 3D slice of the 4D shape is generated. +# Has no effect on 3D fractals. # Range roughly -2 to 2. # type: float # mgfractal_slice_w = 0.0 -# Julia set only: X value determining the 4D shape. +# Julia set only: X component of hypercomplex constant determining julia shape. # Range roughly -2 to 2. # type: float # mgfractal_julia_x = 0.33 -# Julia set only: Y value determining the 4D shape. +# Julia set only: Y component of hypercomplex constant determining julia shape. # Range roughly -2 to 2. # type: float # mgfractal_julia_y = 0.33 -# Julia set only: Z value determining the 4D shape. +# Julia set only: Z component of hypercomplex constant determining julia shape. # Range roughly -2 to 2. # type: float # mgfractal_julia_z = 0.33 -# Julia set only: W value determining the 4D shape. +# Julia set only: W component of hypercomplex constant determining julia shape. +# Has no effect on 3D fractals. # Range roughly -2 to 2. # type: float # mgfractal_julia_w = 0.33 +# Y-level of seabed. # type: noise_params # mgfractal_np_seabed = -14, 9, (600, 600, 600), 41900, 5, 0.6, 2.0 +# Variation of biome filler depth. # type: noise_params # mgfractal_np_filler_depth = 0, 1.2, (150, 150, 150), 261, 3, 0.7, 2.0 +# First of 2 3D noises that together define tunnels. # type: noise_params -# mgfractal_np_cave1 = 0, 12, (128, 128, 128), 52534, 4, 0.5, 2.0 +# mgfractal_np_cave1 = 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0 +# Second of 2 3D noises that together define tunnels. # type: noise_params -# mgfractal_np_cave2 = 0, 12, (128, 128, 128), 10325, 4, 0.5, 2.0 +# mgfractal_np_cave2 = 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0 + +#### Mapgen Valleys + +##### General + +# Map generation attributes specific to Mapgen Valleys. +# 'altitude_chill' makes higher elevations colder, which may cause biome issues. +# 'humid_rivers' modifies the humidity around rivers and in areas where water would tend to pool, +# it may interfere with delicately adjusted biomes. +# Flags that are not specified in the flag string are not modified from the default. +# Flags starting with 'no' are used to explicitly disable them. +# type: flags possible values: altitude_chill, noaltitude_chill, humid_rivers, nohumid_rivers +# mg_valleys_spflags = altitude_chill,humid_rivers + +# The altitude at which temperature drops by 20C +# type: int +# mgvalleys_altitude_chill = 90 + +# Depth below which you'll find large caves. +# type: int +# mgvalleys_large_cave_depth = -33 + +# Creates unpredictable lava features in caves. +# These can make mining difficult. Zero disables them. (0-10) +# type: int +# mgvalleys_lava_features = 0 + +# Depth below which you'll find massive caves. +# type: int +# mgvalleys_massive_cave_depth = -256 + +# How deep to make rivers +# type: int +# mgvalleys_river_depth = 4 + +# How wide to make rivers +# type: int +# mgvalleys_river_size = 5 + +# Creates unpredictable water features in caves. +# These can make mining difficult. Zero disables them. (0-10) +# type: int +# mgvalleys_water_features = 0 + +# Controls width of tunnels, a smaller value creates wider tunnels. +# type: float +# mgvalleys_cave_width = 0.09 + +##### Noises + +# Caves and tunnels form at the intersection of the two noises +# type: noise_params +# mgvalleys_np_cave1 = 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0 + +# Caves and tunnels form at the intersection of the two noises +# type: noise_params +# mgvalleys_np_cave2 = 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0 + +# The depth of dirt or other filler +# type: noise_params +# mgvalleys_np_filler_depth = 0, 1.2, (256, 256, 256), 1605, 3, 0.5, 2.0 + +# Massive caves form here. +# type: noise_params +# mgvalleys_np_massive_caves = 0, 1, (768, 256, 768), 59033, 6, 0.63, 2.0 + +# River noise -- rivers occur close to zero +# type: noise_params +# mgvalleys_np_rivers = 0, 1, (256, 256, 256), -6050, 5, 0.6, 2.0 + +# Base terrain height +# type: noise_params +# mgvalleys_np_terrain_height = -10, 50, (1024, 1024, 1024), 5202, 6, 0.4, 2.0 + +# Raises terrain to make valleys around the rivers +# type: noise_params +# mgvalleys_np_valley_depth = 5, 4, (512, 512, 512), -1914, 1, 1.0, 2.0 + +# Slope and fill work together to modify the heights +# type: noise_params +# mgvalleys_np_inter_valley_fill = 0, 1, (256, 512, 256), 1993, 6, 0.8, 2.0 + +# Amplifies the valleys +# type: noise_params +# mgvalleys_np_valley_profile = 0.6, 0.5, (512, 512, 512), 777, 1, 1.0, 2.0 + +# Slope and fill work together to modify the heights +# type: noise_params +# mgvalleys_np_inter_valley_slope = 0.5, 0.5, (128, 128, 128), 746, 1, 1.0, 2.0 ## Security # Prevent mods from doing insecure things like running shell commands. # type: bool -# secure.enable_security = false +# secure.enable_security = true # Comma-separated list of trusted mods that are allowed to access insecure # functions even when mod security is on (via request_insecure_environment()). # type: string -# secure.trusted_mods = +# secure.trusted_mods = + +# Comma-separated list of mods that are allowed to access HTTP APIs, which +# allow them to upload and download data to/from the internet. +# type: string +# secure.http_mods = + +## Advanced + +### Profiling + +# Load the game profiler to collect game profiling data. +# Provides a /profiler command to access the compiled profile. +# Useful for mod developers and server operators. +# type: bool +# profiler.load = false + +# The default format in which profiles are being saved, +# when calling `/profiler save [format]` without format. +# type: enum values: txt, csv, lua, json, json_pretty +# profiler.default_report_format = txt + +# The file path relative to your worldpath in which profiles will be saved to. +# type: string +# profiler.report_path = "" + +#### Instrumentation + +# Instrument the methods of entities on registration. +# type: bool +# instrument.entity = true + +# Instrument the action function of Active Block Modifiers on registration. +# type: bool +# instrument.abm = true + +# Instrument the action function of Loading Block Modifiers on registration. +# type: bool +# instrument.lbm = true + +# Instrument chatcommands on registration. +# type: bool +# instrument.chatcommand = true + +# Instrument global callback functions on registration. +# (anything you pass to a minetest.register_*() function) +# type: bool +# instrument.global_callback = true + +##### Advanced + +# Instrument builtin. +# This is usually only needed by core/builtin contributors +# type: bool +# instrument.builtin = false + +# Have the profiler instrument itself: +# * Instrument an empty function. +# This estimates the overhead, that instrumentation is adding (+1 function call). +# * Instrument the sampler being used to update the statistics. +# type: bool +# instrument.profiler = false # # Client and Server @@ -1320,12 +1774,12 @@ # When running a server, clients connecting with this name are admins. # When starting from the main menu, this is overridden. # type: string -# name = +# name = # Set the language. Leave empty to use the system language. # A restart is required after changing this. -# type: enum values: , be, cs, da, de, eo, es, et, fr, hu, id, it, ja, jbo, ko, ky, lt, nb, nl, pl, pt, pt_BR, ro, ru, tr, uk, zh_CN, zh_TW -# language = +# type: enum values: , be, ca, cs, da, de, en, eo, es, et, fr, he, hu, id, it, ja, jbo, ko, ky, lt, nb, nl, pl, pt, pt_BR, ro, ru, sr_Cyrl, tr, uk, zh_CN, zh_TW +# language = # Level of logging to be written to debug.txt: # - (no logging) @@ -1335,7 +1789,7 @@ # - action # - info # - verbose -# type: enum values: , warning, action, info, verbose +# type: enum values: , none, error, warning, action, info, verbose # debug_log_level = action # IPv6 support. @@ -1367,7 +1821,7 @@ # Replaces the default main menu with a custom one. # type: string -# main_menu_script = +# main_menu_script = # type: int # main_menu_game_mgr = 0 @@ -1384,3 +1838,6 @@ # type: string # modstore_details_url = https://forum.minetest.net/mmdb/mod/*/ +# Print the engine's profiling data in regular intervals (in seconds). 0 = disable. Useful for developers. +# type: int +# profiler_print_interval = 0