]> git.lizzy.rs Git - minetest.git/blobdiff - minetest.conf.example
Clean up font caching, fix bitmap fonts
[minetest.git] / minetest.conf.example
index 64fe7ef2933c66e4d9b7f236365aa811a7e25b43..7a97d67fdf2b33eb99f5965593e8345cc6f97e2e 100644 (file)
 
 #    The time in seconds it takes between repeated right clicks when holding the right
 #    mouse button.
-#    type: float
+#    type: float min: 0.001
 # repeat_rightclick_time = 0.25
 
 #    Automatically jump up single-node obstacles.
 #    type: bool
-#    type: bool
 # autojump = false
 
 #    Prevent digging and placing from repeating when holding the mouse buttons.
 
 #    The time in seconds it takes between repeated events
 #    when holding down a joystick button combination.
-#    type: float
+#    type: float min: 0.001
 # repeat_joystick_button_time = 0.17
 
 #    The sensitivity of the joystick axes for moving the
 #    Key for toggling pitch move mode.
 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
 #    type: key
-# keymap_pitchmove = KEY_KEY_L
+# keymap_pitchmove = KEY_KEY_P
 
 #    Key for toggling fast mode.
 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
 #    type: enum values: 0, 1, 2, 4, 8, 16
 # fsaa = 0
 
-#    Undersampling is similar to using lower screen resolution, but it applies
+#    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
+#    It should give a significant performance boost at the cost of less detailed image.
+#    Higher values result in a less detailed image.
+#    type: int min: 1 max: 8
+# undersampling = 1
 
 ### Shaders
 
 
 #    If FPS would go higher than this, limit it by sleeping
 #    to not waste CPU power for no benefit.
-#    type: int
+#    type: int min: 1
 # fps_max = 60
 
 #    Maximum FPS when game is paused.
-#    type: int
+#    type: int min: 1
 # pause_fps_max = 20
 
 #    Open the pause menu when the window's focus is lost. Does not pause if a formspec is
 #    type: int min: 20 max: 4000
 # viewing_range = 100
 
-#    Camera near plane distance in nodes, between 0 and 0.5
+#    Camera 'near clipping plane' distance in nodes, between 0 and 0.5.
 #    Most users will not need to change this.
 #    Increasing can reduce artifacting on weaker GPUs.
 #    0.1 = Default, 0.25 = Good value for weaker tablets.
 # near_plane = 0.1
 
 #    Width component of the initial window size.
-#    type: int
+#    type: int min: 1
 # screen_w = 1024
 
 #    Height component of the initial window size.
-#    type: int
+#    type: int min: 1
 # screen_h = 600
 
 #    Save window size automatically when modified.
 
 #    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: 0.5 max: 3
+#    type: float min: 0.5 max: 10
 # display_gamma = 1.0
 
 #    Gradient of light curve at minimum light level.
 #    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.
-#    type: float
+#    type: float min: 0.001
 # gui_scaling = 1.0
 
 #    When gui_scaling_filter is true, all GUI images need to be
 #    type: filepath
 # font_path = fonts/liberationsans.ttf
 
-#    type: int
+#    type: int min: 1
 # font_size = 16
 
 #    Font shadow offset, if 0 then shadow will not be drawn.
 #    type: filepath
 # mono_font_path = fonts/liberationmono.ttf
 
-#    type: int
+#    type: int min: 1
 # mono_font_size = 15
 
 #    This font will be used for certain languages.
 #    type: filepath
 # fallback_font_path = fonts/DroidSansFallbackFull.ttf
 
-#    type: int
+#    type: int min: 1
 # fallback_font_size = 15
 
 #    type: int
 ## Advanced
 
 #    Adjust dpi configuration to your screen (non X11/Android only) e.g. for 4k screens.
-#    type: int
+#    type: int min: 1
 # screen_dpi = 72
 
 #    Windows systems only: Start Minetest with the command line window in the background.
 #    type: int
 # max_out_chat_queue_size = 20
 
+#    Enable register confirmation when connecting to server.
+#    If disabled, new account will be registered automatically.
+#    type: bool
+# enable_register_confirmation = true
+
 ## Advanced
 
 #    Timeout for client to remove unused map data from memory.
 #    type: bool
 # enable_rollback_recording = false
 
+#    Format of player chat messages. The following strings are valid placeholders:
+#    @name, @message, @timestamp (optional)
+#    type: string
+# chat_message_format = <@name> @message
+
 #    A message to be displayed to all clients when the server shuts down.
 #    type: string
 # kick_msg_shutdown = Server shutting down.
 #    to maintain active objects up to this distance in the direction the
 #    player is looking. (This can avoid mobs suddenly disappearing from view)
 #    type: int
-# active_object_send_range_blocks = 3
+# active_object_send_range_blocks = 4
 
 #    The radius of the volume of blocks around every player that is subject to the
 #    active block stuff, stated in mapblocks (16 nodes).
 
 #    From how far blocks are sent to clients, stated in mapblocks (16 nodes).
 #    type: int
-# max_block_send_distance = 9
+# max_block_send_distance = 10
 
 #    Maximum number of forceloaded mapblocks.
 #    type: int
 
 #    Time of day when a new world is started, in millihours (0-23999).
 #    type: int min: 0 max: 23999
-# world_start_time = 5250
+# world_start_time = 6125
 
 #    Interval of saving important changes in the world, stated in seconds.
 #    type: float
 
 ### Physics
 
+#    Horizontal and vertical acceleration on ground or when climbing,
+#    in nodes per second per second.
 #    type: float
 # movement_acceleration_default = 3
 
+#    Horizontal acceleration in air when jumping or falling,
+#    in nodes per second per second.
 #    type: float
 # movement_acceleration_air = 2
 
+#    Horizontal and vertical acceleration in fast mode,
+#    in nodes per second per second.
 #    type: float
 # movement_acceleration_fast = 10
 
+#    Walking and flying speed, in nodes per second.
 #    type: float
 # movement_speed_walk = 4
 
+#    Sneaking speed, in nodes per second.
 #    type: float
 # movement_speed_crouch = 1.35
 
+#    Walking, flying and climbing speed in fast mode, in nodes per second.
 #    type: float
 # movement_speed_fast = 20
 
+#    Vertical climbing speed, in nodes per second.
 #    type: float
 # movement_speed_climb = 3
 
+#    Initial vertical speed when jumping, in nodes per second.
 #    type: float
 # movement_speed_jump = 6.5
 
+#    Decrease this to increase liquid resistence to movement.
 #    type: float
 # movement_liquid_fluidity = 1
 
+#    Maximum liquid resistence. Controls deceleration when entering liquid at
+#    high speed.
 #    type: float
 # movement_liquid_fluidity_smooth = 0.5
 
+#    Controls sinking speed in liquid.
 #    type: float
 # movement_liquid_sink = 10
 
+#    Acceleration of gravity, in nodes per second per second.
 #    type: float
 # movement_gravity = 9.81
 
 #    type: bool
 # server_side_occlusion_culling = true
 
-#    Restricts the access of certain client-side functions on servers
-#    Combine these byteflags below to restrict client-side features:
-#    LOAD_CLIENT_MODS: 1 (disable client mods loading)
+#    Restricts the access of certain client-side functions on servers.
+#    Combine the byteflags below to restrict client-side features, or set to 0
+#    for no restrictions:
+#    LOAD_CLIENT_MODS: 1 (disable loading client-provided mods)
 #    CHAT_MESSAGES: 2 (disable send_chat_message call client-side)
 #    READ_ITEMDEFS: 4 (disable get_item_def call client-side)
 #    READ_NODEDEFS: 8 (disable get_node_def call client-side)
 #    type: enum values: , none, error, warning, action, info, verbose
 # debug_log_level = action
 
+#    If the file size of debug.txt exceeds the number of megabytes specified in
+#    this setting when it is opened, the file is moved to debug.txt.1,
+#    deleting an older debug.txt.1 if it exists.
+#    debug.txt is only moved if this setting is positive.
+#    type: int
+# debug_log_size_max = 50
+
 #    IPv6 support.
 #    type: bool
 # enable_ipv6 = true
 # high_precision_fpu = true
 
 #    Changes the main menu UI:
-#    -   Full:  Multple singleplayer worlds, game choice, texture pack chooser, etc.
+#    -   Full:  Multiple singleplayer worlds, game choice, texture pack chooser, etc.
 #    -   Simple: One singleplayer world, no game or texture pack choosers. May be
 #    necessary for smaller screens.
-#    -   Auto: Simple on Android, full on everything else.
-#    type: enum values: auto, full, simple
-# main_menu_style = auto
+#    type: enum values: full, simple
+# main_menu_style = full
 
 #    Replaces the default main menu with a custom one.
 #    type: string
 
 #    Name of map generator to be used when creating a new world.
 #    Creating a world in the main menu will override this.
-#    Current stable mapgens:
-#    v5, v6, v7 (except floatlands), flat, singlenode.
-#    'stable' means the terrain shape in an existing world will not be changed
-#    in the future. Note that biomes are defined by games and may still change.
-#    type: enum values: v5, v6, v7, valleys, carpathian, fractal, flat, singlenode
+#    Current mapgens in a highly unstable state:
+#    -    The optional floatlands of v7 (disabled by default).
+#    type: enum values: v7, valleys, carpathian, v5, flat, fractal, singlenode, v6
 # mg_name = v7
 
 #    Water surface level of the world.
 
 #    From how far blocks are generated for clients, stated in mapblocks (16 nodes).
 #    type: int
-# max_block_generate_distance = 6
+# max_block_generate_distance = 8
 
 #    Limit of map generation, in nodes, in all 6 directions from (0, 0, 0).
 #    Only mapchunks completely within the mapgen limit are generated.
 #    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 enabled are not modified from the default.
-#    Flags starting with 'no' are used to explicitly disable them.
 #    type: flags possible values: caves, dungeons, light, decorations, biomes, nocaves, nodungeons, nolight, nodecorations, nobiomes
 # mg_flags = caves,dungeons,light,decorations,biomes
 
-#    Whether dungeons occasionally project from the terrain.
-#    type: bool
-# projecting_dungeons = true
-
 ## Biome API temperature and humidity noise parameters
 
 #    Temperature variation for biomes.
 ## Mapgen V5
 
 #    Map generation attributes specific to Mapgen v5.
-#    Flags that are not enabled 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
 
 #    type: int
 # mgv5_large_cave_depth = -256
 
+#    Deprecated, define and locate cave liquids using biome definitions instead.
 #    Y of upper limit of lava in large caves.
 #    type: int
 # mgv5_lava_depth = -256
 #    flags       = eased
 # }
 
+#    3D noise that determines number of dungeons per mapchunk.
+#    type: noise_params_3d
+# mgv5_np_dungeons = {
+#    offset      = 0.9,
+#    scale       = 0.5,
+#    spread      = (500, 500, 500),
+#    seed        = 0,
+#    octaves     = 2,
+#    persistence = 0.8,
+#    lacunarity  = 2.0,
+#    flags       = 
+# }
+
 ## Mapgen V6
 
 #    Map generation attributes specific to Mapgen v6.
 #    The 'snowbiomes' flag enables the new 5 biome system.
-#    When the new biome system is enabled jungles are automatically enabled and
+#    When the 'snowbiomes' flag is enabled jungles are automatically enabled and
 #    the 'jungles' flag is ignored.
-#    Flags that are not enabled are not modified from the default.
-#    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
+# mgv6_spflags = jungles,biomeblend,mudflow,snowbiomes,noflat,trees
 
 #    Deserts occur when np_biome exceeds this value.
-#    When the new biome system is enabled, this is ignored.
+#    When the 'snowbiomes' flag is enabled, this is ignored.
 #    type: float
 # mgv6_freq_desert = 0.45
 
 
 #    Map generation attributes specific to Mapgen v7.
 #    'ridges' enables the rivers.
-#    Flags that are not enabled are not modified from the default.
-#    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
 
 #    type: int
 # mgv7_large_cave_depth = -33
 
+#    Deprecated, define and locate cave liquids using biome definitions instead.
 #    Y of upper limit of lava in large caves.
 #    type: int
 # mgv7_lava_depth = -256
 #    flags       = 
 # }
 
+#    3D noise that determines number of dungeons per mapchunk.
+#    type: noise_params_3d
+# mgv7_np_dungeons = {
+#    offset      = 0.9,
+#    scale       = 0.5,
+#    spread      = (500, 500, 500),
+#    seed        = 0,
+#    octaves     = 2,
+#    persistence = 0.8,
+#    lacunarity  = 2.0,
+#    flags       = 
+# }
+
 ## Mapgen Carpathian
 
 #    Map generation attributes specific to Mapgen Carpathian.
-#    Flags that are not enabled are not modified from the default.
-#    Flags starting with 'no' are used to explicitly disable them.
-#    type: flags possible values: caverns, nocaverns
-# mgcarpathian_spflags = caverns
+#    type: flags possible values: caverns, rivers, nocaverns, norivers
+# mgcarpathian_spflags = caverns,norivers
 
 #    Defines the base ground level.
 #    type: float
 # mgcarpathian_base_level = 12.0
 
+#    Defines the width of the river channel.
+#    type: float
+# mgcarpathian_river_width = 0.05
+
+#    Defines the depth of the river channel.
+#    type: float
+# mgcarpathian_river_depth = 24.0
+
+#    Defines the width of the river valley.
+#    type: float
+# mgcarpathian_valley_width = 0.25
+
 #    Controls width of tunnels, a smaller value creates wider tunnels.
 #    type: float
 # mgcarpathian_cave_width = 0.09
 #    type: int
 # mgcarpathian_large_cave_depth = -33
 
+#    Deprecated, define and locate cave liquids using biome definitions instead.
 #    Y of upper limit of lava in large caves.
 #    type: int
 # mgcarpathian_lava_depth = -256
 #    flags       = eased
 # }
 
-#    2D noise that controls the size/occurance of rolling hills.
+#    2D noise that controls the size/occurrence of rolling hills.
 #    type: noise_params_2d
 # mgcarpathian_np_hills_terrain = {
 #    offset      = 1,
 #    flags       = eased
 # }
 
-#    2D noise that controls the size/occurance of ridged mountain ranges.
+#    2D noise that controls the size/occurrence of ridged mountain ranges.
 #    type: noise_params_2d
 # mgcarpathian_np_ridge_terrain = {
 #    offset      = 1,
 #    flags       = eased
 # }
 
-#    2D noise that controls the size/occurance of step mountain ranges.
+#    2D noise that controls the size/occurrence of step mountain ranges.
 #    type: noise_params_2d
 # mgcarpathian_np_step_terrain = {
 #    offset      = 1,
 #    flags       = eased
 # }
 
+#    2D noise that locates the river valleys and channels.
+#    type: noise_params_2d
+# mgcarpathian_np_rivers = {
+#    offset      = 0,
+#    scale       = 1,
+#    spread      = (1000, 1000, 1000),
+#    seed        = 85039,
+#    octaves     = 5,
+#    persistence = 0.6,
+#    lacunarity  = 2.0,
+#    flags       = eased
+# }
+
 #    3D noise for mountain overhangs, cliffs, etc. Usually small variations.
 #    type: noise_params_3d
 # mgcarpathian_np_mnt_var = {
 #    flags       = 
 # }
 
+#    3D noise that determines number of dungeons per mapchunk.
+#    type: noise_params_3d
+# mgcarpathian_np_dungeons = {
+#    offset      = 0.9,
+#    scale       = 0.5,
+#    spread      = (500, 500, 500),
+#    seed        = 0,
+#    octaves     = 2,
+#    persistence = 0.8,
+#    lacunarity  = 2.0,
+#    flags       = 
+# }
+
 ## Mapgen Flat
 
 #    Map generation attributes specific to Mapgen flat.
 #    Occasional lakes and hills can be added to the flat world.
-#    Flags that are not enabled are not modified from the default.
-#    Flags starting with 'no' are used to explicitly disable them.
 #    type: flags possible values: lakes, hills, nolakes, nohills
 # mgflat_spflags = nolakes,nohills
 
 #    type: int
 # mgflat_large_cave_depth = -33
 
+#    Deprecated, define and locate cave liquids using biome definitions instead.
 #    Y of upper limit of lava in large caves.
 #    type: int
 # mgflat_lava_depth = -256
 #    flags       = 
 # }
 
+#    3D noise that determines number of dungeons per mapchunk.
+#    type: noise_params_3d
+# mgflat_np_dungeons = {
+#    offset      = 0.9,
+#    scale       = 0.5,
+#    spread      = (500, 500, 500),
+#    seed        = 0,
+#    octaves     = 2,
+#    persistence = 0.8,
+#    lacunarity  = 2.0,
+#    flags       = 
+# }
+
 ## Mapgen Fractal
 
+#    Map generation attributes specific to Mapgen flat.
+#    'terrain' enables the generation of non-fractal terrain:
+#    ocean, islands and underground.
+#    type: flags possible values: terrain, noterrain
+# mgfractal_spflags = terrain
+
 #    Controls width of tunnels, a smaller value creates wider tunnels.
 #    type: float
 # mgfractal_cave_width = 0.09
 #    type: int
 # mgfractal_large_cave_depth = -33
 
+#    Deprecated, define and locate cave liquids using biome definitions instead.
 #    Y of upper limit of lava in large caves.
 #    type: int
 # mgfractal_lava_depth = -256
 #    flags       = 
 # }
 
+#    3D noise that determines number of dungeons per mapchunk.
+#    type: noise_params_3d
+# mgfractal_np_dungeons = {
+#    offset      = 0.9,
+#    scale       = 0.5,
+#    spread      = (500, 500, 500),
+#    seed        = 0,
+#    octaves     = 2,
+#    persistence = 0.8,
+#    lacunarity  = 2.0,
+#    flags       = 
+# }
+
 ## Mapgen Valleys
 
 #    Map generation attributes specific to Mapgen Valleys.
 #    'altitude_chill': Reduces heat with altitude.
-#    'humid_rivers': Increases humidity around rivers and where water pools.
+#    'humid_rivers': Increases humidity around rivers.
 #    'vary_river_depth': If enabled, low humidity and high heat causes rivers
 #    to become shallower and occasionally dry.
 #    'altitude_dry': Reduces humidity with altitude.
-#    type: flags possible values: altitude_chill, noaltitude_chill, humid_rivers, nohumid_rivers, vary_river_depth, novary_river_depth, altitude_dry, noaltitude_dry
+#    type: flags possible values: altitude_chill, humid_rivers, vary_river_depth, altitude_dry, noaltitude_chill, nohumid_rivers, novary_river_depth, noaltitude_dry
 # mgvalleys_spflags = altitude_chill,humid_rivers,vary_river_depth,altitude_dry
 
 #    The vertical distance over which heat drops by 20 if 'altitude_chill' is
 #    type: int
 # mgvalleys_large_cave_depth = -33
 
+#    Deprecated, define and locate cave liquids using biome definitions instead.
 #    Y of upper limit of lava in large caves.
 #    type: int
 # mgvalleys_lava_depth = 1
 #    flags       = eased
 # }
 
+#    3D noise that determines number of dungeons per mapchunk.
+#    type: noise_params_3d
+# mgvalleys_np_dungeons = {
+#    offset      = 0.9,
+#    scale       = 0.5,
+#    spread      = (500, 500, 500),
+#    seed        = 0,
+#    octaves     = 2,
+#    persistence = 0.8,
+#    lacunarity  = 2.0,
+#    flags       = 
+# }
+
 ## Advanced
 
 #    Size of mapchunks generated by mapgen, stated in mapblocks (16 nodes).
 # emergequeue_limit_generate = 64
 
 #    Number of emerge threads to use.
-#    Make this field blank or 0, or increase this number to use multiple threads.
-#    On multiprocessor systems, this will improve mapgen speed greatly at the cost
-#    of slightly buggy caves.
-#    type: int
-# num_emerge_threads = 0
+#    WARNING: Currently there are multiple bugs that may cause crashes when
+#    'num_emerge_threads' is larger than 1. Until this warning is removed it is
+#    strongly recommended this value is set to the default '1'.
+#    Value 0:
+#    -    Automatic selection. The number of emerge threads will be
+#    -    'number of processors - 2', with a lower limit of 1.
+#    Any other value:
+#    -    Specifies the number of emerge threads, with a lower limit of 1.
+#    WARNING: Increasing the number of emerge threads increases engine mapgen
+#    speed, but this may harm game performance by interfering with other
+#    processes, especially in singleplayer and/or when running Lua code in
+#    'on_generated'. For many users the optimum setting may be '1'.
+#    type: int
+# num_emerge_threads = 1
 
 #
-# Content Store
+# Online Content Repository
 #
 
-#    Show packages in the content store that do not qualify as 'free software'
+#    The URL for the content repository
+#    type: string
+# contentdb_url = https://content.minetest.net
+
+#    Comma-separated list of flags to hide in the content repository.
+#    "nonfree" can be used to hide packages which do not qualify as 'free software',
 #    as defined by the Free Software Foundation.
-#    type: bool
-# show_nonfree_packages = false
+#    You can also specify content ratings.
+#    These flags are independent from Minetest versions,
+#    so see a full list at https://content.minetest.net/help/content_flags/
+#    type: string
+# contentdb_flag_blacklist = nonfree, desktop_default