# joystick_id = 0
# The type of joystick
-# type: enum values: auto, generic, xbox
+# type: enum values: auto, generic, xbox, dragonrise_gamecube
# joystick_type = auto
# The time in seconds it takes between repeated events
# type: float min: 0.001
# repeat_joystick_button_time = 0.17
-# The deadzone of the joystick
+# The dead zone of the joystick
# type: int
# joystick_deadzone = 2048
# The sensitivity of the joystick axes for moving the
-# ingame view frustum around.
+# in-game view frustum around.
# type: float
# joystick_frustum_sensitivity = 170
### Basic
-# Whether nametag backgrounds should be shown by default.
+# Whether name tag backgrounds should be shown by default.
# Mods may still set a background.
# type: bool
# show_nametag_backgrounds = true
# type: bool
# smooth_lighting = true
+# Enables tradeoffs that reduce CPU load or increase rendering performance
+# at the expense of minor visual glitches that do not impact game playability.
+# type: bool
+# performance_tradeoffs = false
+
# Clouds are a client side effect.
# type: bool
# enable_clouds = true
### Filtering
-# Use mip mapping to scale textures. May slightly increase performance,
+# Use mipmapping to scale textures. May slightly increase performance,
# especially when using a high resolution texture pack.
# Gamma correct downscaling is not supported.
# type: bool
# can be blurred, so automatically upscale them with nearest-neighbor
# interpolation to preserve crisp pixels. This sets the minimum texture size
# for the upscaled textures; higher values look sharper, but require more
-# memory. Powers of 2 are recommended. This setting is ONLY applies if
+# memory. Powers of 2 are recommended. This setting is ONLY applied if
# bilinear/trilinear/anisotropic filtering is enabled.
# This is also used as the base node texture size for world-aligned
# texture autoscaling.
# type: bool
# enable_dynamic_shadows = false
-# Set the shadow strength.
+# Set the shadow strength gamma.
+# Adjusts the intensity of in-game dynamic shadows.
# Lower value means lighter shadows, higher value means darker shadows.
-# type: float min: 0.05 max: 1
-# shadow_strength = 0.2
+# type: float min: 0.1 max: 10
+# shadow_strength_gamma = 1.0
# Maximum distance to render shadows.
# type: float min: 10 max: 1000
# Texture size to render the shadow map on.
# This must be a power of two.
-# Bigger numbers create better shadowsbut it is also more expensive.
+# Bigger numbers create better shadows but it is also more expensive.
# type: int min: 128 max: 8192
# shadow_map_texture_size = 1024
# type: bool
# shadow_map_texture_32bit = true
-# Enable poisson disk filtering.
-# On true uses poisson disk to make "soft shadows". Otherwise uses PCF filtering.
+# Enable Poisson disk filtering.
+# On true uses Poisson disk to make "soft shadows". Otherwise uses PCF filtering.
# type: bool
# shadow_poisson_filter = true
-# Define shadow filtering quality
-# This simulates the soft shadows effect by applying a PCF or poisson disk
+# Define shadow filtering quality.
+# This simulates the soft shadows effect by applying a PCF or Poisson disk
# but also uses more resources.
# type: enum values: 0, 1, 2
# shadow_filters = 1
-# Enable colored shadows.
+# Enable colored shadows.
# On true translucent nodes cast colored shadows. This is expensive.
# type: bool
# shadow_map_color = false
-# Set the shadow update time.
-# Lower value means shadows and map updates faster, but it consume more resources.
-# Minimun value 0.001 seconds max value 0.2 seconds
-# type: float min: 0.001 max: 0.2
-# shadow_update_time = 0.2
+# Spread a complete update of shadow map over given amount of frames.
+# Higher values might make shadows laggy, lower values
+# will consume more resources.
+# Minimum value: 1; maximum value: 16
+# type: int min: 1 max: 16
+# shadow_update_frames = 8
# Set the soft shadow radius size.
-# Lower values mean sharper shadows bigger values softer.
-# Minimun value 1.0 and max value 10.0
+# Lower values mean sharper shadows, bigger values mean softer shadows.
+# Minimum value: 1.0; maximum value: 10.0
# type: float min: 1 max: 10
# shadow_soft_radius = 1.0
-# Set the tilt of Sun/Moon orbit in degrees
+# Set the tilt of Sun/Moon orbit in degrees.
# Value of 0 means no tilt / vertical orbit.
-# Minimun value 0.0 and max value 60.0
+# Minimum value: 0.0; maximum value: 60.0
# type: float min: 0 max: 60
# shadow_sky_body_orbit_tilt = 0.0
# Note: On Android, stick with OGLES1 if unsure! App may fail to start otherwise.
# On other platforms, OpenGL is recommended.
# Shaders are supported by OpenGL (desktop only) and OGLES2 (experimental)
-# type: enum values: null, software, burningsvideo, direct3d8, direct3d9, opengl, ogles1, ogles2
+# type: enum values: opengl, ogles1, ogles2
# video_driver = opengl
# Radius of cloud area stated in number of 64 node cloud squares.
# crosshair_color = (255,255,255)
# Crosshair alpha (opaqueness, between 0 and 255).
-# Also controls the object crosshair color
+# This also applies to the object crosshair.
# type: int min: 0 max: 255
# crosshair_alpha = 255
# type: float
# hud_hotbar_max_width = 1.0
-# Modifies the size of the hudbar elements.
+# Modifies the size of the HUD elements.
# type: float
# hud_scaling = 1.0
# type: bool
# show_entity_selectionbox = false
+# Distance in nodes at which transparency depth sorting is enabled
+# Use this to limit the performance impact of transparency depth sorting
+# type: int min: 0 max: 128
+# transparency_sorting_distance = 16
+
## Menus
# Use a cloud animation for the main menu background.
# type: bool
# tooltip_append_itemname = false
-# Whether FreeType fonts are used, requires FreeType support to be compiled in.
-# If disabled, bitmap and XML vectors fonts are used instead.
-# type: bool
-# freetype = true
-
# type: bool
# font_bold = false
# type: int min: 0 max: 255
# font_shadow_alpha = 127
-# Font size of the default font in point (pt).
+# Font size of the default font where 1 unit = 1 pixel at 96 DPI
# type: int min: 1
# font_size = 16
-# Path to the default font.
-# If “freetype” setting is enabled: Must be a TrueType font.
-# If “freetype” setting is disabled: Must be a bitmap or XML vectors font.
+# For pixel-style fonts that do not scale well, this ensures that font sizes used
+# with this font will always be divisible by this value, in pixels. For instance,
+# a pixel font 16 pixels tall should have this set to 16, so it will only ever be
+# sized 16, 32, 48, etc., so a mod requesting a size of 25 will get 32.
+# type: int min: 1
+# font_size_divisible_by = 1
+
+# Path to the default font. Must be a TrueType font.
# The fallback font will be used if the font cannot be loaded.
# type: filepath
# font_path = fonts/Arimo-Regular.ttf
# type: filepath
# font_path_bold_italic = fonts/Arimo-BoldItalic.ttf
-# Font size of the monospace font in point (pt).
+# Font size of the monospace font where 1 unit = 1 pixel at 96 DPI
# type: int min: 1
-# mono_font_size = 15
+# mono_font_size = 16
-# Path to the monospace font.
-# If “freetype” setting is enabled: Must be a TrueType font.
-# If “freetype” setting is disabled: Must be a bitmap or XML vectors font.
+# For pixel-style fonts that do not scale well, this ensures that font sizes used
+# with this font will always be divisible by this value, in pixels. For instance,
+# a pixel font 16 pixels tall should have this set to 16, so it will only ever be
+# sized 16, 32, 48, etc., so a mod requesting a size of 25 will get 32.
+# type: int min: 1
+# mono_font_size_divisible_by = 1
+
+# Path to the monospace font. Must be a TrueType font.
# This font is used for e.g. the console and profiler screen.
# type: filepath
# mono_font_path = fonts/Cousine-Regular.ttf
# type: filepath
# mono_font_path_bold_italic = fonts/Cousine-BoldItalic.ttf
-# Path of the fallback font.
-# If “freetype” setting is enabled: Must be a TrueType font.
-# If “freetype” setting is disabled: Must be a bitmap or XML vectors font.
+# Path of the fallback font. Must be a TrueType font.
# This font will be used for certain languages or if the default font is unavailable.
# type: filepath
# fallback_font_path = fonts/DroidSansFallbackFull.ttf
# screenshot_path = screenshots
# Format of screenshots.
-# type: enum values: png, jpg, bmp, pcx, ppm, tga
+# type: enum values: png, jpg
# screenshot_format = png
# Screenshot quality. Only used for JPEG format.
# type: int min: 1
# screen_dpi = 72
+# Adjust the detected display density, used for scaling UI elements.
+# type: float
+# display_density_factor = 1
+
# 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
# Client
#
-# If enabled, http links in chat can be middle-clicked or ctrl-left-clicked to open the link in the OS's default web browser.
+# Clickable weblinks (middle-click or Ctrl+left-click) enabled in chat console output.
# type: bool
-# clickable_chat_weblinks = false
+# clickable_chat_weblinks = true
-# If clickable_chat_weblinks is enabled, specify the color (as 24-bit hexadecimal) of weblinks in chat.
+# Optional override for chat weblink color.
# type: string
-# chat_weblink_color = #8888FF
+# chat_weblink_color =
## Network
# remote_port = 30000
# Prometheus listener address.
-# If minetest is compiled with ENABLE_PROMETHEUS option enabled,
+# If Minetest is compiled with ENABLE_PROMETHEUS option enabled,
# enable metrics listener for Prometheus on that address.
-# Metrics can be fetch on http://127.0.0.1:30000/metrics
+# Metrics can be fetched on http://127.0.0.1:30000/metrics
# type: string
# prometheus_listener_address = 127.0.0.1:30000
# type: int
# max_packets_per_iteration = 1024
-# ZLib compression level to use when sending mapblocks to the client.
-# -1 - Zlib's default compression level
-# 0 - no compresson, fastest
+# Compression level to use when sending mapblocks to the client.
+# -1 - use default compression level
+# 0 - least compression, fastest
# 9 - best compression, slowest
-# (levels 1-3 use Zlib's "fast" method, 4-9 use the normal method)
# type: int min: -1 max: 9
# map_compression_level_net = -1
# ask_reconnect_on_crash = false
# From how far clients know about objects, stated in mapblocks (16 nodes).
-#
+#
# Setting this larger than active_block_range will also cause the server
# to maintain active objects up to this distance in the direction the
# player is looking. (This can avoid mobs suddenly disappearing from view)
# deprecated_lua_api_handling = log
# Number of extra blocks that can be loaded by /clearobjects at once.
-# This is a trade-off between sqlite transaction overhead and
+# This is a trade-off between SQLite transaction overhead and
# memory consumption (4096=100MB, as a rule of thumb).
# type: int
# max_clearobjects_extra_loaded_blocks = 4096
# Maximum number of statically stored objects in a block.
# type: int
-# max_objects_per_block = 64
+# max_objects_per_block = 256
# See https://www.sqlite.org/pragma.html#pragma_synchronous
# type: enum values: 0, 1, 2
# sqlite_synchronous = 2
-# ZLib compression level to use when saving mapblocks to disk.
-# -1 - Zlib's default compression level
-# 0 - no compresson, fastest
+# Compression level to use when saving mapblocks to disk.
+# -1 - use default compression level
+# 0 - least compression, fastest
# 9 - best compression, slowest
-# (levels 1-3 use Zlib's "fast" method, 4-9 use the normal method)
# type: int min: -1 max: 9
-# map_compression_level_disk = 3
+# map_compression_level_disk = -1
# Length of a server tick and the interval at which objects are generally updated over
# network.
# type: bool
# instrument.lbm = true
-# Instrument chatcommands on registration.
+# Instrument chat commands on registration.
# type: bool
# instrument.chatcommand = true
# - action
# - info
# - verbose
-# type: enum values: , none, error, warning, action, info, verbose
+# - trace
+# type: enum values: , none, error, warning, action, info, verbose, trace
# debug_log_level = action
# If the file size of debug.txt exceeds the number of megabytes specified in
# debug_log_size_max = 50
# Minimal level of logging to be written to chat.
-# type: enum values: , none, error, warning, action, info, verbose
+# type: enum values: , none, error, warning, action, info, verbose, trace
# chat_log_level = error
# Enable IPv6 support (for both client and server).
# 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
-# mapgen_limit = 31000
+# type: int min: 0 max: 31007
+# mapgen_limit = 31007
# 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.
+# and jungle grass, in all other mapgens this flag controls all decorations.
# type: flags possible values: caves, dungeons, light, decorations, biomes, ores, nocaves, nodungeons, nolight, nodecorations, nobiomes, noores
# mg_flags = caves,dungeons,light,decorations,biomes,ores
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# Second of two 3D noises that together define tunnels.
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# 3D noise defining giant caverns.
# octaves = 5,
# persistence = 0.63,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# 3D noise defining terrain.
# octaves = 2,
# persistence = 0.8,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
## Mapgen V6
# octaves = 5,
# persistence = 0.63,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# 3D noise defining structure of river canyon walls.
# octaves = 4,
# persistence = 0.75,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# 3D noise defining structure of floatlands.
# octaves = 4,
# persistence = 0.75,
# lacunarity = 1.618,
-# flags =
+# flags =
# }
# 3D noise defining giant caverns.
# octaves = 5,
# persistence = 0.63,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# First of two 3D noises that together define tunnels.
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# Second of two 3D noises that together define tunnels.
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# 3D noise that determines number of dungeons per mapchunk.
# octaves = 2,
# persistence = 0.8,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
## Mapgen Carpathian
# octaves = 5,
# persistence = 0.55,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# First of two 3D noises that together define tunnels.
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# Second of two 3D noises that together define tunnels.
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# 3D noise defining giant caverns.
# octaves = 5,
# persistence = 0.63,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# 3D noise that determines number of dungeons per mapchunk.
# octaves = 2,
# persistence = 0.8,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
## Mapgen Flat
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# Second of two 3D noises that together define tunnels.
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# 3D noise defining giant caverns.
# octaves = 5,
# persistence = 0.63,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# 3D noise that determines number of dungeons per mapchunk.
# octaves = 2,
# persistence = 0.8,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
## Mapgen Fractal
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# Second of two 3D noises that together define tunnels.
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# 3D noise that determines number of dungeons per mapchunk.
# octaves = 2,
# persistence = 0.8,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
## Mapgen Valleys
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# Second of two 3D noises that together define tunnels.
# octaves = 3,
# persistence = 0.5,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# The depth of dirt or other biome filler node.
# octaves = 6,
# persistence = 0.63,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# Defines large-scale river channel structure.
# octaves = 6,
# persistence = 0.8,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
# Amplifies the valleys.
# octaves = 2,
# persistence = 0.8,
# lacunarity = 2.0,
-# flags =
+# flags =
# }
## Advanced
# enable_mapgen_debug_info = false
# Maximum number of blocks that can be queued for loading.
-# type: int
+# type: int min: 1 max: 1000000
# emergequeue_limit_total = 1024
# Maximum number of blocks to be queued that are to be loaded from file.
# This limit is enforced per player.
-# type: int
+# type: int min: 1 max: 1000000
# emergequeue_limit_diskonly = 128
# Maximum number of blocks to be queued that are to be generated.
# This limit is enforced per player.
-# type: int
+# type: int min: 1 max: 1000000
# emergequeue_limit_generate = 128
# Number of emerge threads to use.