aboutsummaryrefslogtreecommitdiff
path: root/minetest.conf.example
diff options
context:
space:
mode:
Diffstat (limited to 'minetest.conf.example')
-rw-r--r--minetest.conf.example177
1 files changed, 89 insertions, 88 deletions
diff --git a/minetest.conf.example b/minetest.conf.example
index 47c03ff80..7f4b5d946 100644
--- a/minetest.conf.example
+++ b/minetest.conf.example
@@ -30,7 +30,7 @@
# type: bool
# pitch_move = false
-# Fast movement (via the "special" key).
+# Fast movement (via the "Aux1" key).
# This requires the "fast" privilege on the server.
# type: bool
# fast_move = false
@@ -61,7 +61,7 @@
# type: float
# mouse_sensitivity = 0.2
-# If enabled, "special" key instead of "sneak" key is used for climbing down and
+# If enabled, "Aux1" key instead of "Sneak" key is used for climbing down and
# descending.
# type: bool
# aux1_descends = false
@@ -70,7 +70,7 @@
# type: bool
# doubletap_jump = false
-# If disabled, "special" key is used to fly fast if both fly and fast mode are
+# If disabled, "Aux1" key is used to fly fast if both fly and fast mode are
# enabled.
# type: bool
# always_fly_fast = true
@@ -107,10 +107,10 @@
# type: bool
# fixed_virtual_joystick = false
-# (Android) Use virtual joystick to trigger "aux" button.
-# If enabled, virtual joystick will also tap "aux" button when out of main circle.
+# (Android) Use virtual joystick to trigger "Aux1" button.
+# If enabled, virtual joystick will also tap "Aux1" button when out of main circle.
# type: bool
-# virtual_joystick_triggers_aux = false
+# virtual_joystick_triggers_aux1 = false
# Enable joysticks
# type: bool
@@ -121,7 +121,7 @@
# 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
@@ -129,12 +129,12 @@
# 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
@@ -188,7 +188,7 @@
# Key for moving fast in fast mode.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
# type: key
-# keymap_special1 = KEY_KEY_E
+# keymap_aux1 = KEY_KEY_E
# Key for opening the chat window.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
@@ -503,7 +503,7 @@
### 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
@@ -533,6 +533,11 @@
# 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
@@ -551,7 +556,7 @@
### 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
@@ -570,9 +575,9 @@
# 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.
+# which PNG optimizers usually discard, often resulting in dark or
+# light edges to transparent textures. Apply a filter to clean that up
+# at texture load time. This is automatically enabled if mipmapping is enabled.
# type: bool
# texture_clean_transparent = false
@@ -580,9 +585,8 @@
# 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. Setting this higher than 1 may not
-# have a visible effect unless bilinear/trilinear/anisotropic filtering is
-# enabled.
+# 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: int
@@ -694,11 +698,11 @@
# type: float min: 0 max: 0.25
# near_plane = 0.1
-# Width component of the initial window size.
+# Width component of the initial window size. Ignored in fullscreen mode.
# type: int min: 1
# screen_w = 1024
-# Height component of the initial window size.
+# Height component of the initial window size. Ignored in fullscreen mode.
# type: int min: 1
# screen_h = 600
@@ -710,10 +714,6 @@
# type: bool
# fullscreen = false
-# Bits per pixel (aka color depth) in fullscreen mode.
-# type: int
-# fullscreen_bpp = 24
-
# Vertical screen synchronization.
# type: bool
# vsync = false
@@ -761,12 +761,12 @@
# type: path
# texture_path =
-# The rendering back-end for Irrlicht.
+# The rendering back-end.
# A restart is required after changing this.
# 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.
@@ -843,7 +843,7 @@
# 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
@@ -860,7 +860,7 @@
# 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
@@ -974,11 +974,6 @@
# 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
@@ -993,13 +988,18 @@
# 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
@@ -1011,15 +1011,20 @@
# font_path_italic = fonts/Arimo-Italic.ttf
# type: filepath
-# font_path_bolditalic = fonts/Arimo-BoldItalic.ttf
+# font_path_bold_italic = fonts/Arimo-BoldItalic.ttf
+
+# Font size of the monospace font where 1 unit = 1 pixel at 96 DPI
+# type: int min: 1
+# mono_font_size = 16
-# Font size of the monospace font in point (pt).
+# 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 = 15
+# mono_font_size_divisible_by = 1
-# 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.
+# 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
@@ -1031,23 +1036,9 @@
# mono_font_path_italic = fonts/Cousine-Italic.ttf
# type: filepath
-# mono_font_path_bolditalic = fonts/Cousine-BoldItalic.ttf
-
-# Font size of the fallback font in point (pt).
-# type: int min: 1
-# fallback_font_size = 15
-
-# Shadow offset (in pixels) of the fallback font. If 0, then shadow will not be drawn.
-# type: int
-# fallback_font_shadow = 1
+# mono_font_path_bold_italic = fonts/Cousine-BoldItalic.ttf
-# Opaqueness (alpha) of the shadow behind the fallback font, between 0 and 255.
-# type: int min: 0 max: 255
-# fallback_font_shadow_alpha = 128
-
-# 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
@@ -1063,7 +1054,7 @@
# 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.
@@ -1078,6 +1069,10 @@
# 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
@@ -1110,6 +1105,14 @@
# Client
#
+# Clickable weblinks (middle-click or Ctrl+left-click) enabled in chat console output.
+# type: bool
+# clickable_chat_weblinks = false
+
+# Optional override for chat weblink color.
+# type: string
+# chat_weblink_color =
+
## Network
# Address to connect to.
@@ -1124,9 +1127,9 @@
# 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
@@ -1261,11 +1264,10 @@
# 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
@@ -1364,6 +1366,11 @@
# type: string
# chat_message_format = <@name> @message
+# If the execution of a chat command takes longer than this specified time in
+# seconds, add the time information to the chat command message
+# type: float
+# chatcommand_msg_time_threshold = 0.1
+
# A message to be displayed to all clients when the server shuts down.
# type: string
# kick_msg_shutdown = Server shutting down.
@@ -1495,7 +1502,7 @@
# 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
@@ -1513,13 +1520,12 @@
# 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.
@@ -1647,7 +1653,7 @@
# type: bool
# instrument.lbm = true
-# Instrument chatcommands on registration.
+# Instrument chat commands on registration.
# type: bool
# instrument.chatcommand = true
@@ -1682,7 +1688,7 @@
# Set the language. Leave empty to use the system language.
# A restart is required after changing this.
-# type: enum values: , ar, ca, cs, da, de, dv, el, en, eo, es, et, eu, fil, fr, hu, id, it, ja, ja_KS, jbo, kk, kn, lo, lt, ms, my, nb, nl, nn, pl, pt, pt_BR, ro, ru, sl, sr_Cyrl, sv, sw, th, tr, uk, vi
+# type: enum values: , be, bg, ca, cs, da, de, el, en, eo, es, et, eu, fi, fr, gd, gl, hu, id, it, ja, jbo, kk, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt_BR, ro, ru, sk, sl, sr_Cyrl, sr_Latn, sv, sw, tr, uk, vi, zh_CN, zh_TW
# language =
# Level of logging to be written to debug.txt:
@@ -1714,10 +1720,9 @@
## Advanced
-# Default timeout for cURL, stated in milliseconds.
-# Only has an effect if compiled with cURL.
+# Maximum time an interactive request (e.g. server list fetch) may take, stated in milliseconds.
# type: int
-# curl_timeout = 5000
+# curl_timeout = 20000
# Limits number of parallel HTTP requests. Affects:
# - Media fetch if server uses remote_media setting.
@@ -1727,14 +1732,10 @@
# type: int
# curl_parallel_limit = 8
-# Maximum time in ms a file download (e.g. a mod download) may take.
+# Maximum time a file download (e.g. a mod download) may take, stated in milliseconds.
# type: int
# curl_file_download_timeout = 300000
-# Makes DirectX work with LuaJIT. Disable if it causes troubles.
-# type: bool
-# high_precision_fpu = true
-
# Replaces the default main menu with a custom one.
# type: string
# main_menu_script =
@@ -1766,12 +1767,12 @@
# 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
@@ -3352,17 +3353,17 @@
# 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.