BRNSystems/minetest
1
0
Fork 0
forked from Mirrorlandia_minetest/minetest
Code Pull Requests 1 Activity
7199dc7559
minetest/builtin/settingtypes.txt

2162 lines
89 KiB
Plaintext
Raw Normal View History

New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# This file contains all settings displayed in the settings menu.
#
# General format:
# name (Readable name) type type_args
#
Settingtypes.txt: Clarify comments, correct spelling
2016-08-28 16:02:33 +02:00
# Note that the parts are separated by exactly one space
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
#
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# `type` can be:
# - int
# - string
# - bool
# - float
# - enum
# - path
Improve the path select GUI (#5852) - Allow lua to chose whatever directories or files can be selected - Fix selecting directories - Rename dialog to `guiPathSelectMenu` from `guiFileSelectMenu` - Rename lua function for opening the menu from `show_file_open_dialog` to `show_path_select_dialog` - Remove duplicate code and fix code style. Related changes - fix `clang-format` whitelist. - Regenerate minetest.conf.example
2017-06-11 09:43:31 +02:00
# - filepath
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# - key (will be ignored in GUI, since a special key change dialog exists)
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# - flags
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
# - noise_params_2d
# - noise_params_3d
# - v3f
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
#
# `type_args` can be:
# * int:
# - default
# - default min max
# * string:
# - default (if default is not specified then "" is set)
# * bool:
# - default
# * float:
# - default
# - default min max
# * enum:
# - default value1,value2,...
# * path:
# - default (if default is not specified then "" is set)
Improve the path select GUI (#5852) - Allow lua to chose whatever directories or files can be selected - Fix selecting directories - Rename dialog to `guiPathSelectMenu` from `guiFileSelectMenu` - Rename lua function for opening the menu from `show_file_open_dialog` to `show_path_select_dialog` - Remove duplicate code and fix code style. Related changes - fix `clang-format` whitelist. - Regenerate minetest.conf.example
2017-06-11 09:43:31 +02:00
# * filepath:
# - default (if default is not specified then "" is set)
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# * key:
# - default
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# * flags:
# Flags are always separated by comma without spaces.
# - default possible_flags
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
# * noise_params_2d:
# Format is <offset>, <scale>, (<spreadX>, <spreadY>, <spreadZ>), <seed>, <octaves>, <persistance>, <lacunarity>[, <default flags>]
# - default
# * noise_params_3d:
# Format is <offset>, <scale>, (<spreadX>, <spreadY>, <spreadZ>), <seed>, <octaves>, <persistance>, <lacunarity>[, <default flags>]
# - default
# * v3f:
# Format is (<X>, <Y>, <Z>)
# - default
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
#
# Comments directly above a setting are bound to this setting.
# All other comments are ignored.
#
# Comments and (Readable name) are handled by gettext.
# Comments should be complete sentences that describe the setting and possibly
# give the user additional useful insight.
# Sections are marked by a single line in the format: [Section Name]
# Sub-section are marked by adding * in front of the section name: [*Sub-section]
# Sub-sub-sections have two * etc.
# There shouldn't be too much settings per category; settings that shouldn't be
# modified by the "average user" should be in (sub-)categories called "Advanced".
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[Controls]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# If enabled, you can place blocks at the position (feet + eye level) where you stand.
# This is helpful when working with nodeboxes in small areas.
enable_build_where_you_stand (Build inside player) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Player is able to fly without being affected by gravity.
# This requires the "fly" privilege on the server.
free_move (Flying) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Extend pitch fly mode to swimming (#7943)
2018-12-31 01:07:30 +01:00
# If enabled, makes move directions relative to the player's pitch when flying or swimming.
pitch_move (Pitch move mode) bool false
Added pitch fly mode (#7817) In pitch fly mode, you fly to the exact direction you are pointing at, using the forward key. Other move directions are also pitched accordingly. It allows smoother and more complex movements. Can be enabled/disabled by L key by default (set keymap_pitchfly in minetest.conf)
2018-12-01 10:01:32 +01:00
Change “Use” key name to “Special”
2017-07-29 19:24:10 +02:00
# Fast movement (via the "special" key).
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# This requires the "fast" privilege on the server.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
fast_move (Fast movement) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# If enabled together with fly mode, player is able to fly through solid nodes.
# This requires the "noclip" privilege on the server.
noclip (Noclip) bool false
Remove cinematic toggle on F8 Also update cinematic mode's description to include mouse
2016-07-04 19:01:58 +02:00
# Smooths camera when looking around. Also called look or mouse smoothing.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Useful for recording videos.
cinematic (Cinematic mode) bool false
# Smooths rotation of camera. 0 to disable.
camera_smoothing (Camera smoothing) float 0.0 0.0 0.99
# Smooths rotation of camera in cinematic mode. 0 to disable.
cinematic_camera_smoothing (Camera smoothing in cinematic mode) float 0.7 0.0 0.99
# Invert vertical mouse movement.
invert_mouse (Invert mouse) bool false
# Mouse sensitivity multiplier.
mouse_sensitivity (Mouse sensitivity) float 0.2
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# If enabled, "special" key instead of "sneak" key is used for climbing down and
# descending.
Change “Use” key name to “Special”
2017-07-29 19:24:10 +02:00
aux1_descends (Special key for climbing/descending) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Double-tapping the jump key toggles fly mode.
doubletap_jump (Double tap jump for fly) bool false
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# If disabled, "special" key is used to fly fast if both fly and fast mode are
# enabled.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
always_fly_fast (Always fly and fast) bool true
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# The time in seconds it takes between repeated right clicks when holding the right
# mouse button.
All Settings: Set min limit for crtitical settings (#9000)
2019-10-01 19:09:37 +02:00
repeat_rightclick_time (Rightclick repetition interval) float 0.25 0.001
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Client-side autojump. Remove Android-only stepheight autojump (#7228) Works by detecting a collision while moving forward and then simulating a jump. If the simulated jump is more successful, an artificial jump key press is injected in the client. Includes setting and key change GUI element for enabling and disabling this feature.
2018-11-22 22:47:15 +01:00
# Automatically jump up single-node obstacles.
autojump (Automatic jumping) bool false
Safe digging and placing (#6127) * Setting: Safe digging and placing * New setting 'safe_dig_and_place' under Controls * If set, digging and placing will not auto-repeat * Releasing buttons unblocks the respective action again * Useful for inexperienced users in creative mode where default repeat times may be too short * Safe placing (right click repetition) does not need a guarding flag * Added new setting to minetest.conf.example
2017-08-24 08:30:46 +02:00
# Prevent digging and placing from repeating when holding the mouse buttons.
# Enable this when you dig or place too often by accident.
safe_dig_and_place (Safe digging and placing) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Enable random user input (only used for testing).
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
random_input (Random input) bool false
Rename CSM flavours to restrictions & Satisfy LINT
2018-06-20 22:36:08 +02:00
# Continuous forward movement, toggled by autoforward key.
Stop autoforward on BACKWARD key-press (#7417)
2018-06-06 14:31:34 +02:00
# Press the autoforward key again or the backwards movement to disable.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
continuous_forward (Continuous forward) bool false
Android: Replace movement buttons with joystick (#7126) * Android: Replace movement buttons with joystick Replace movement control buttons (arrows at bottom left screen) with virtual joystick. Joystick has 8 directions (same as keyboard). Basically, just map it to keyboard input. Joystick applies only on left 1/3 of screen. Joystick's position can be fixed by enabling fixed_virtual_joystick setting. Three new images: (1) placeholder joystick, (2) joystick container (background), and (3) joystick cursor. Remove unused images: movement control buttons (*_arrow.png). New data type: touch_gui_joystick_move_id Joystick's fixed position is spaced one button size from bottom and from left of screen. Remove unused variable: m_joystick_downlocation
2018-04-10 22:55:17 +02:00
# The length in pixels it takes for touch screen interaction to start.
touchscreen_threshold (Touch screen threshold) int 20 0 100
# (Android) Fixes the position of virtual joystick.
# If disabled, virtual joystick will center to first-touch's position.
fixed_virtual_joystick (Fixed virtual joystick) bool false
Android: Add 'aux' button (#7477) Add 'aux' button. Use joystick to trigger 'aux' button when forward and out of main circle, by enabling 'virtual_joystick_triggers_aux' setting.
2018-07-11 00:33:40 +02:00
# (Android) Use virtual joystick to trigger "aux" button.
# If enabled, virtual joystick will also tap "aux" button when out of main circle.
virtual_joystick_triggers_aux (Virtual joystick triggers aux button) bool false
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
# Enable joysticks
enable_joysticks (Enable joysticks) bool false
Initial Gamepad support Adds initial ingame gamepad support to minetest. Full Formspec support is not implemented yet and can be added by a later change.
2016-05-27 08:35:07 +02:00
Add Joystick type detection and Xbox controller support * Add joystick type detection (with joystick_type setting to override it) * Fix multiple joysticks from interfering with each other by only reading from one (add joystick_id setting) * Add support for Xbox controllers
2017-04-03 00:00:34 +02:00
# The identifier of the joystick to use
joystick_id (Joystick ID) int 0
# The type of joystick
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
joystick_type (Joystick type) enum auto auto,generic,xbox
Add Joystick type detection and Xbox controller support * Add joystick type detection (with joystick_type setting to override it) * Fix multiple joysticks from interfering with each other by only reading from one (add joystick_id setting) * Add support for Xbox controllers
2017-04-03 00:00:34 +02:00
Initial Gamepad support Adds initial ingame gamepad support to minetest. Full Formspec support is not implemented yet and can be added by a later change.
2016-05-27 08:35:07 +02:00
# The time in seconds it takes between repeated events
# when holding down a joystick button combination.
All Settings: Set min limit for crtitical settings (#9000)
2019-10-01 19:09:37 +02:00
repeat_joystick_button_time (Joystick button repetition interval) float 0.17 0.001
Initial Gamepad support Adds initial ingame gamepad support to minetest. Full Formspec support is not implemented yet and can be added by a later change.
2016-05-27 08:35:07 +02:00
# The sensitivity of the joystick axes for moving the
# ingame view frustum around.
joystick_frustum_sensitivity (Joystick frustum sensitivity) float 170
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for moving the player forward.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
keymap_forward (Forward key) key KEY_KEY_W
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for moving the player backward.
Stop autoforward on BACKWARD key-press (#7417)
2018-06-06 14:31:34 +02:00
# Will also disable autoforward, when active.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_backward (Backward key) key KEY_KEY_S
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for moving the player left.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_left (Left key) key KEY_KEY_A
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for moving the player right.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_right (Right key) key KEY_KEY_D
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for jumping.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_jump (Jump key) key KEY_SPACE
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for sneaking.
# Also used for climbing down and descending in water if aux1_descends is disabled.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_sneak (Sneak key) key KEY_LSHIFT
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for opening the inventory.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_inventory (Inventory key) key KEY_KEY_I
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for moving fast in fast mode.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
Change “Use” key name to “Special”
2017-07-29 19:24:10 +02:00
keymap_special1 (Special key) key KEY_KEY_E
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for opening the chat window.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_chat (Chat key) key KEY_KEY_T
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for opening the chat window to type commands.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_cmd (Command key) key /
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Change command prefix to "." and add "help" command.
2017-03-25 00:43:36 +01:00
# Key for opening the chat window to type local commands.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_cmd_local (Command key) key .
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for toggling unlimited view range.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_rangeselect (Range select key) key KEY_KEY_R
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for toggling flying.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_freemove (Fly key) key KEY_KEY_K
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Extend pitch fly mode to swimming (#7943)
2018-12-31 01:07:30 +01:00
# Key for toggling pitch move mode.
Added pitch fly mode (#7817) In pitch fly mode, you fly to the exact direction you are pointing at, using the forward key. Other move directions are also pitched accordingly. It allows smoother and more complex movements. Can be enabled/disabled by L key by default (set keymap_pitchfly in minetest.conf)
2018-12-01 10:01:32 +01:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
Change pitch fly binding to 'P', add to change keys menu (#8314)
2019-04-03 22:37:30 +02:00
keymap_pitchmove (Pitch move key) key KEY_KEY_P
Added pitch fly mode (#7817) In pitch fly mode, you fly to the exact direction you are pointing at, using the forward key. Other move directions are also pitched accordingly. It allows smoother and more complex movements. Can be enabled/disabled by L key by default (set keymap_pitchfly in minetest.conf)
2018-12-01 10:01:32 +01:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for toggling fast mode.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_fastmove (Fast key) key KEY_KEY_J
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for toggling noclip mode.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_noclip (Noclip key) key KEY_KEY_H
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Add configurable key bindings for hotbar scrolling, and for changing volume.
2014-07-03 07:46:19 +02:00
# Key for selecting the next item in the hotbar.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_hotbar_next (Hotbar next key) key KEY_KEY_N
# Key for selecting the previous item in the hotbar.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_hotbar_previous (Hotbar previous key) key KEY_KEY_B
# Key for muting the game.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_mute (Mute key) key KEY_KEY_M
# Key for increasing the volume.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_increase_volume (Inc. volume key) key
# Key for decreasing the volume.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_decrease_volume (Dec. volume key) key
Autorun: Change to 'autoforward' (#5926) Minetest does not have 'run'. Automatic forwards is very often used while flying or swimming, so a general word is more suitable.
2017-06-08 09:57:00 +02:00
# Key for toggling autoforward.
Document keymap_autorun in settingtypes.txt and minetest.conf.example (#4486)
2016-08-30 05:40:48 +02:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
Remove 's' from 'automatic forwards' (#8272)
2019-02-23 02:12:33 +01:00
keymap_autoforward (Automatic forward key) key
Document keymap_autorun in settingtypes.txt and minetest.conf.example (#4486)
2016-08-30 05:40:48 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for toggling cinematic mode.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
Remove cinematic toggle on F8 Also update cinematic mode's description to include mouse
2016-07-04 19:01:58 +02:00
keymap_cinematic (Cinematic mode key) key
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for toggling display of minimap.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_minimap (Minimap key) key KEY_F9
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for taking screenshots.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_screenshot (Screenshot) key KEY_F12
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for dropping the currently selected item.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_drop (Drop item key) key KEY_KEY_Q
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
# Key to use view zoom when possible.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_zoom (View zoom key) key KEY_KEY_Z
Make direct item selection keys freely bindable
2016-12-18 23:34:52 +01:00
# Key for selecting the first hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot1 (Hotbar slot 1 key) key KEY_KEY_1
# Key for selecting the second hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot2 (Hotbar slot 2 key) key KEY_KEY_2
# Key for selecting the third hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot3 (Hotbar slot 3 key) key KEY_KEY_3
# Key for selecting the fourth hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot4 (Hotbar slot 4 key) key KEY_KEY_4
# Key for selecting the fifth hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot5 (Hotbar slot 5 key) key KEY_KEY_5
# Key for selecting the sixth hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot6 (Hotbar slot 6 key) key KEY_KEY_6
# Key for selecting the seventh hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot7 (Hotbar slot 7 key) key KEY_KEY_7
# Key for selecting the eighth hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot8 (Hotbar slot 8 key) key KEY_KEY_8
# Key for selecting the ninth hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot9 (Hotbar slot 9 key) key KEY_KEY_9
# Key for selecting the tenth hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot10 (Hotbar slot 10 key) key KEY_KEY_0
# Key for selecting the 11th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot11 (Hotbar slot 11 key) key
# Key for selecting the 12th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot12 (Hotbar slot 12 key) key
# Key for selecting the 13th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot13 (Hotbar slot 13 key) key
# Key for selecting the 14th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot14 (Hotbar slot 14 key) key
# Key for selecting the 15th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot15 (Hotbar slot 15 key) key
# Key for selecting the 16th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot16 (Hotbar slot 16 key) key
# Key for selecting the 17th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot17 (Hotbar slot 17 key) key
# Key for selecting the 18th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot18 (Hotbar slot 18 key) key
# Key for selecting the 19th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot19 (Hotbar slot 19 key) key
# Key for selecting the 20th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot20 (Hotbar slot 20 key) key
Raise hotbar limit to 32 slots, add associated keybinding options (#7916) add associated keybinding options update docs and settingtypes
2018-12-02 23:34:29 +01:00
# Key for selecting the 21st hotbar slot.
Make direct item selection keys freely bindable
2016-12-18 23:34:52 +01:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot21 (Hotbar slot 21 key) key
Raise hotbar limit to 32 slots, add associated keybinding options (#7916) add associated keybinding options update docs and settingtypes
2018-12-02 23:34:29 +01:00
# Key for selecting the 22nd hotbar slot.
Make direct item selection keys freely bindable
2016-12-18 23:34:52 +01:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot22 (Hotbar slot 22 key) key
Raise hotbar limit to 32 slots, add associated keybinding options (#7916) add associated keybinding options update docs and settingtypes
2018-12-02 23:34:29 +01:00
# Key for selecting the 23rd hotbar slot.
Make direct item selection keys freely bindable
2016-12-18 23:34:52 +01:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot23 (Hotbar slot 23 key) key
Raise hotbar limit to 32 slots, add associated keybinding options (#7916) add associated keybinding options update docs and settingtypes
2018-12-02 23:34:29 +01:00
# Key for selecting the 24th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot24 (Hotbar slot 24 key) key
# Key for selecting the 25th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot25 (Hotbar slot 25 key) key
# Key for selecting the 26th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot26 (Hotbar slot 26 key) key
# Key for selecting the 27th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot27 (Hotbar slot 27 key) key
# Key for selecting the 28th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot28 (Hotbar slot 28 key) key
# Key for selecting the 29th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot29 (Hotbar slot 29 key) key
# Key for selecting the 30th hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot30 (Hotbar slot 30 key) key
# Key for selecting the 31st hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot31 (Hotbar slot 31 key) key
# Key for selecting the 32nd hotbar slot.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_slot32 (Hotbar slot 32 key) key
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for toggling the display of the HUD.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_toggle_hud (HUD toggle key) key KEY_F1
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# Key for toggling the display of chat.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_toggle_chat (Chat toggle key) key KEY_F2
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
# Key for toggling the display of the large chat console.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_console (Large chat console key) key KEY_F10
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# Key for toggling the display of fog.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_toggle_force_fog_off (Fog toggle key) key KEY_F3
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Settingtypes.txt: Clarify comments, correct spelling
2016-08-28 16:02:33 +02:00
# Key for toggling the camera update. Only used for development
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_toggle_update_camera (Camera update toggle key) key
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for toggling the display of debug info.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_toggle_debug (Debug info toggle key) key KEY_F5
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for toggling the display of the profiler. Used for development.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_toggle_profiler (Profiler toggle key) key KEY_F6
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Key for switching between first- and third-person camera.
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_camera_mode (Toggle camera mode key) key KEY_F7
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Camera: remove auto tune FPS, single view range setting
2016-02-20 04:42:35 +01:00
# Key for increasing the viewing range.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_increase_viewing_range_min (View range increase key) key +
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Camera: remove auto tune FPS, single view range setting
2016-02-20 04:42:35 +01:00
# Key for decreasing the viewing range.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
keymap_decrease_viewing_range_min (View range decrease key) key -
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[Graphics]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[*In-Game]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[**Basic]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Enable vertex buffer objects.
# This should greatly improve graphics performance.
Mapblock mesh: Allow to use VBO
2016-02-22 04:26:32 +01:00
enable_vbo (VBO) bool true
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Whether to fog out the end of the visible area.
enable_fog (Fog) bool true
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Leaves style:
# - Fancy: all faces visible
# - Simple: only outer faces, if defined special_tiles are used
# - Opaque: disable transparency
leaves_style (Leaves style) enum fancy fancy,simple,opaque
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Connects glass if supported by node.
connected_glass (Connect glass) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Enable smooth lighting with simple ambient occlusion.
# Disable for speed or for different looks.
smooth_lighting (Smooth lighting) bool true
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Clouds are a client side effect.
enable_clouds (Clouds) bool true
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Use 3D cloud look instead of flat.
enable_3d_clouds (3D clouds) bool true
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Cleanup selection mesh code, add shaders for halo and selection boxes
2016-02-07 04:08:43 +01:00
# Method used to highlight selected object.
Add option to use neither node highlighting nor outlining
2017-05-12 00:18:36 +02:00
node_highlighting (Node highlighting) enum box box,halo,none
Cleanup selection mesh code, add shaders for halo and selection boxes
2016-02-07 04:08:43 +01:00
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
# Adds particles when digging a node.
enable_particles (Digging particles) bool true
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[**Filtering]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Update mip mapping and textarea documentation (#7315) * Fix textarea formspec documentation The label is shown and the background isn't * Document the missing gamma correction when generating mip maps * Remove duplicate text (such as size parameter descriptions)
2018-07-19 18:28:26 +02:00
# Use mip mapping to scale textures. May slightly increase performance,
# especially when using a high resolution texture pack.
# Gamma correct downscaling is not supported.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
mip_map (Mipmapping) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Use anisotropic filtering when viewing at textures from an angle.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
anisotropic_filter (Anisotropic filtering) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Use bilinear filtering when scaling textures.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
bilinear_filter (Bilinear filtering) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Use trilinear filtering when scaling textures.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
trilinear_filter (Trilinear filtering) bool false
# Filtered textures can blend RGB values with fully-transparent neighbors,
# which PNG optimizers usually discard, sometimes resulting in a dark or
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# light edge to transparent textures. Apply this filter to clean that up
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# at texture load time.
texture_clean_transparent (Clean transparent textures) bool false
# When using bilinear/trilinear/anisotropic filters, low-resolution textures
# can be blurred, so automatically upscale them with nearest-neighbor
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# interpolation to preserve crisp pixels. This sets the minimum texture size
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# for the upscaled textures; higher values look sharper, but require more
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# memory. Powers of 2 are recommended. Setting this higher than 1 may not
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# have a visible effect unless bilinear/trilinear/anisotropic filtering is
# enabled.
Real global textures (#6105) * Real global textures * Add world-aligned textures * Update minimal to support world-aligned tiles * Update minimal
2017-10-15 09:34:14 +02:00
# This is also used as the base node texture size for world-aligned
# texture autoscaling.
texture_min_size (Minimum texture size) int 64
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Experimental option, might cause visible spaces between blocks
# when set to higher number than 0.
fsaa (FSAA) enum 0 0,1,2,4,8,16
Improve undersampling settings The setting now accepts values between 1 and 8 in the Advanced Settings menu. Values 0 and 1 now behave the same way (setting it to 1 won't disable MSAA anymore), so there's no need to expose 0 as a value. This closes #8939.
2019-09-17 06:13:17 +02:00
# Undersampling is similar to using a lower screen resolution, but it applies
Hard-coded undersampling. Adds uniform undersampling for the 3D rendered scene. GUI elements are not undersampled, resulting in better playability for users with low-performance platforms with readable fonts and formspecs. The undersampling setting can be set to 0 (disabled), 2, 3, 4 pixels which translates into a resolution reduction of x4, x9 or x16, and is significant.
2017-01-12 10:19:36 +01:00
# to the game world only, keeping the GUI intact.
Improve undersampling settings The setting now accepts values between 1 and 8 in the Advanced Settings menu. Values 0 and 1 now behave the same way (setting it to 1 won't disable MSAA anymore), so there's no need to expose 0 as a value. This closes #8939.
2019-09-17 06:13:17 +02:00
# It should give a significant performance boost at the cost of less detailed image.
# Higher values result in a less detailed image.
undersampling (Undersampling) int 1 1 8
Hard-coded undersampling. Adds uniform undersampling for the 3D rendered scene. GUI elements are not undersampled, resulting in better playability for users with low-performance platforms with readable fonts and formspecs. The undersampling setting can be set to 0 (disabled), 2, 3, 4 pixels which translates into a resolution reduction of x4, x9 or x16, and is significant.
2017-01-12 10:19:36 +01:00
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[**Shaders]
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# Shaders allow advanced visual effects and may increase performance on some video
# cards.
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
# This only works with the OpenGL video backend.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
enable_shaders (Shaders) bool true
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
# Path to shader directory. If no path is defined, default location will be used.
shader_path (Shader path) path
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[***Tone Mapping]
Filmic HDR tone mapping
2016-01-25 13:33:22 +01:00
Settingtypes.txt: Various improvements (#9047)
2019-10-14 04:30:54 +02:00
# Enables Hable's 'Uncharted 2' filmic tone mapping.
# Simulates the tone curve of photographic film and how this approximates the
# appearance of high dynamic range images. Mid-range contrast is slightly
# enhanced, highlights and shadows are gradually compressed.
Filmic HDR tone mapping
2016-01-25 13:33:22 +01:00
tone_mapping (Filmic tone mapping) bool false
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[***Bumpmapping]
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Enables bumpmapping for textures. Normalmaps need to be supplied by the texture pack
# or need to be auto-generated.
# Requires shaders to be enabled.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
enable_bumpmapping (Bumpmapping) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Enables on the fly normalmap generation (Emboss effect).
# Requires bumpmapping to be enabled.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
generate_normalmaps (Generate normalmaps) bool false
# Strength of generated normalmaps.
normalmaps_strength (Normalmaps strength) float 0.6
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Defines sampling step of texture.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# A higher value results in smoother normal maps.
normalmaps_smooth (Normalmaps sampling) int 0 0 2
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[***Parallax Occlusion]
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Enables parallax occlusion mapping.
# Requires shaders to be enabled.
enable_parallax_occlusion (Parallax occlusion) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# 0 = parallax occlusion with slope information (faster).
# 1 = relief mapping (slower, more accurate).
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
parallax_occlusion_mode (Parallax occlusion mode) int 1 0 1
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Strength of parallax.
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
3d_paralax_strength (Parallax occlusion strength) float 0.025
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Number of parallax occlusion iterations.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
parallax_occlusion_iterations (Parallax occlusion iterations) int 4
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Overall scale of parallax occlusion effect.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
parallax_occlusion_scale (Parallax occlusion scale) float 0.08
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Overall bias of parallax occlusion effect, usually scale/2.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
parallax_occlusion_bias (Parallax occlusion bias) float 0.04
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[***Waving Nodes]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Set to true to enable waving liquids (like water).
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Requires shaders to be enabled.
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
enable_waving_water (Waving liquids) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# The maximum height of the surface of waving liquids.
Allow wave_heights up to two nodes. #9220
2019-12-21 15:33:59 +01:00
# 4.0 = Wave height is two nodes.
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# 0.0 = Wave doesn't move at all.
Allow wave_heights up to two nodes. #9220
2019-12-21 15:33:59 +01:00
# Default is 1.0 (1/2 node).
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Requires waving liquids to be enabled.
Allow wave_heights up to two nodes. #9220
2019-12-21 15:33:59 +01:00
water_wave_height (Waving liquids wave height) float 1.0 0.0 4.0
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Length of liquid waves.
# Requires waving liquids to be enabled.
water_wave_length (Waving liquids wavelength) float 20.0 0.1
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# How fast liquid waves will move. Higher = faster.
# If negative, liquid waves will move backwards.
# Requires waving liquids to be enabled.
water_wave_speed (Waving liquids wave speed) float 5.0
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Set to true to enable waving leaves.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Requires shaders to be enabled.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
enable_waving_leaves (Waving leaves) bool false
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Set to true to enable waving plants.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Requires shaders to be enabled.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
enable_waving_plants (Waving plants) bool false
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[**Advanced]
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Add Arm Inertia (#6050)
2017-06-26 20:03:48 +02:00
# Arm inertia, gives a more realistic movement of
# the arm when the camera moves.
arm_inertia (Arm inertia) bool true
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# If FPS would go higher than this, limit it by sleeping
# to not waste CPU power for no benefit.
All Settings: Set min limit for crtitical settings (#9000)
2019-10-01 19:09:37 +02:00
fps_max (Maximum FPS) int 60 1
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Maximum FPS when game is paused.
All Settings: Set min limit for crtitical settings (#9000)
2019-10-01 19:09:37 +02:00
pause_fps_max (FPS in pause menu) int 20 1
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# Open the pause menu when the window's focus is lost. Does not pause if a formspec is
# open.
Add check to pause game on lost window focus
2017-09-10 04:17:47 +02:00
pause_on_lost_focus (Pause on lost window focus) bool false
Camera: remove auto tune FPS, single view range setting
2016-02-20 04:42:35 +01:00
# View distance in nodes.
View range: Set maximum to 4000 nodes The network protocol does not support larger than 255 mapblocks.
2016-12-11 00:23:32 +01:00
viewing_range (Viewing range) int 100 20 4000
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# Camera 'near clipping plane' distance in nodes, between 0 and 0.5.
Add setting for near plane distance. (#6395) * Allow setting the near plane * - Add near_plane limit of 0.5 to prevent x-ray. - Add more details to near_plane setting.
2017-10-07 15:11:48 +02:00
# 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.
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
near_plane (Near clipping plane) float 0.1 0 0.5
Add setting for near plane distance. (#6395) * Allow setting the near plane * - Add near_plane limit of 0.5 to prevent x-ray. - Add more details to near_plane setting.
2017-10-07 15:11:48 +02:00
Fix some setting documentation * Horizontal and vertical are used wrongly. Use height and width because horizontal/vertical describes different things. Thanks @kilbith for pointing out. * Update minetest.conf.example and settings_translation_file.cpp * Correct maximum/minimum copy paste mistake.
2015-12-10 18:25:28 +01:00
# Width component of the initial window size.
All Settings: Set min limit for crtitical settings (#9000)
2019-10-01 19:09:37 +02:00
screen_w (Screen width) int 1024 1
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Fix some setting documentation * Horizontal and vertical are used wrongly. Use height and width because horizontal/vertical describes different things. Thanks @kilbith for pointing out. * Update minetest.conf.example and settings_translation_file.cpp * Correct maximum/minimum copy paste mistake.
2015-12-10 18:25:28 +01:00
# Height component of the initial window size.
All Settings: Set min limit for crtitical settings (#9000)
2019-10-01 19:09:37 +02:00
screen_h (Screen height) int 600 1
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Save minetest screen width/height options when modified (#5683) * Save minetest screen width/height options when modified * Add autosave_screensize setting (default true) * Fix @SmallJoker comments
2017-05-05 13:47:11 +02:00
# Save window size automatically when modified.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
autosave_screensize (Autosave screen size) bool true
Save minetest screen width/height options when modified (#5683) * Save minetest screen width/height options when modified * Add autosave_screensize setting (default true) * Fix @SmallJoker comments
2017-05-05 13:47:11 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Fullscreen mode.
fullscreen (Full screen) bool false
# Bits per pixel (aka color depth) in fullscreen mode.
fullscreen_bpp (Full screen BPP) int 24
# Vertical screen synchronization.
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
vsync (VSync) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Field of view in degrees.
FOV: Raise lower limit to avoid zoom-loading of distant world (#7234) In the client, raise lower limit from 30 to 45 degrees, to avoid server seeing this as a zoom and loading world beyond the server-set limit. Add minimum in settingtypes.txt and enforce lower limit when set using minetest.conf. In the server, distrust the client-sent FOV if below the heuristic zoom threshold and use the player object property 'zoom_fov' to check it, to protect against hacked clients.
2018-04-15 22:56:05 +02:00
fov (Field of view) int 72 45 160
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Improve light curve parameter limits and documentation (#9054) Revert gamma upper limit to 3.0 because that was raised based on a misunderstanding and had no benefit. A sane upper limit is needed as players on a competitive server tend to use the maximum. Set gamma lower limit to 0.33 for consistency with 3.0. Set sane limits on alpha, beta, boost and enforce these in code to limit values entered in minetest.conf and to avoid easy cheating by editing settingtypes.txt. Improve documentation and 'readable' setting names. Clarify that gamma does not significantly affect natural night light. light.cpp: Various codestyle and comment improvements.
2019-10-24 02:08:49 +02:00
# Alters the light curve by applying 'gamma correction' to it.
# Higher values make middle and lower light levels brighter.
# Value '1.0' leaves the light curve unaltered.
# This only has significant effect on daylight and artificial
# light, it has very little effect on natural night light.
display_gamma (Light curve gamma) float 1.0 0.33 3.0
New lighting curve (#5279) * New lighting curve * Make polynomial lighting curve * Update default lighting settings
2017-08-17 00:23:20 +02:00
Light curve: Add and tune mid boost gaussian Create a closer match to the light curve of 0.4.16 stable. Results in darker shadows while maintaining the 'brightness' and light spread.
2017-11-18 01:22:15 +01:00
# Gradient of light curve at minimum light level.
Improve light curve parameter limits and documentation (#9054) Revert gamma upper limit to 3.0 because that was raised based on a misunderstanding and had no benefit. A sane upper limit is needed as players on a competitive server tend to use the maximum. Set gamma lower limit to 0.33 for consistency with 3.0. Set sane limits on alpha, beta, boost and enforce these in code to limit values entered in minetest.conf and to avoid easy cheating by editing settingtypes.txt. Improve documentation and 'readable' setting names. Clarify that gamma does not significantly affect natural night light. light.cpp: Various codestyle and comment improvements.
2019-10-24 02:08:49 +02:00
# Controls the contrast of the lowest light levels.
lighting_alpha (Light curve low gradient) float 0.0 0.0 3.0
New lighting curve (#5279) * New lighting curve * Make polynomial lighting curve * Update default lighting settings
2017-08-17 00:23:20 +02:00
Light curve: Add and tune mid boost gaussian Create a closer match to the light curve of 0.4.16 stable. Results in darker shadows while maintaining the 'brightness' and light spread.
2017-11-18 01:22:15 +01:00
# Gradient of light curve at maximum light level.
Improve light curve parameter limits and documentation (#9054) Revert gamma upper limit to 3.0 because that was raised based on a misunderstanding and had no benefit. A sane upper limit is needed as players on a competitive server tend to use the maximum. Set gamma lower limit to 0.33 for consistency with 3.0. Set sane limits on alpha, beta, boost and enforce these in code to limit values entered in minetest.conf and to avoid easy cheating by editing settingtypes.txt. Improve documentation and 'readable' setting names. Clarify that gamma does not significantly affect natural night light. light.cpp: Various codestyle and comment improvements.
2019-10-24 02:08:49 +02:00
# Controls the contrast of the highest light levels.
lighting_beta (Light curve high gradient) float 1.5 0.0 3.0
# Strength of light curve boost.
# The 3 'boost' parameters define a range of the light
# curve that is boosted in brightness.
lighting_boost (Light curve boost) float 0.2 0.0 0.4
# Center of light curve boost range.
# Where 0.0 is minimum light level, 1.0 is maximum light level.
lighting_boost_center (Light curve boost center) float 0.5 0.0 1.0
# Spread of light curve boost range.
# Controls the width of the range to be boosted.
# Standard deviation of the light curve boost Gaussian.
lighting_boost_spread (Light curve boost spread) float 0.2 0.0 0.4
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Path to texture directory. All textures are first searched from here.
texture_path (Texture path) path
# The rendering back-end for Irrlicht.
Disable shaders GUI on unsupported drivers (#7563) * Disable shaders GUI on unsupported drivers (#2060) * Disable shaders if unavailable
2018-07-21 09:26:40 +02:00
# A restart is required after changing this.
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# Note: On Android, stick with OGLES1 if unsure! App may fail to start otherwise.
Disable shaders GUI on unsupported drivers (#7563) * Disable shaders GUI on unsupported drivers (#2060) * Disable shaders if unavailable
2018-07-21 09:26:40 +02:00
# On other platforms, OpenGL is recommended, and it’s the only driver with
# shader support currently.
Add Android drivers to the video_driver drop-down menu Adds the Android video drivers ogles1 and ogles2 to the video_drivers drop-down menu
2018-01-21 21:41:04 +01:00
video_driver (Video driver) enum opengl null,software,burningsvideo,direct3d8,direct3d9,opengl,ogles1,ogles2
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Radius of cloud area stated in number of 64 node cloud squares.
# Values larger than 26 will start to produce sharp cutoffs at cloud area corners.
cloud_radius (Cloud radius) int 12
Footsteps without view bobbing (#5645) * Remove redundant view_bobbing setting Also fixes bug where disabling view_bobbing disables footstep sounds. * Removes redundant view_bobbing setting Setting view_bobbing amount to 0 is now the only way to turn view_bobbing on and off. Also fixed a bug where footstep sounds would not play when view_bobbing was disabled.
2017-04-25 13:11:51 +02:00
# Enable view bobbing and amount of view bobbing.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# For example: 0 for no view bobbing; 1.0 for normal; 2.0 for double.
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
view_bobbing_amount (View bobbing factor) float 1.0
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Multiplier for fall bobbing.
# For example: 0 for no view bobbing; 1.0 for normal; 2.0 for double.
Enable subtle fall bobbing (#7856) Set the default value of fall_bobbing_amount to 0.03
2018-11-12 19:34:47 +01:00
fall_bobbing_amount (Fall bobbing factor) float 0.03
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# 3D support.
# Currently supported:
# - none: no 3d output.
# - anaglyph: cyan/magenta color 3d.
# - interlaced: odd/even line based polarisation screen support.
# - topbottom: split screen top/bottom.
# - sidebyside: split screen side by side.
Add crossview support (#7361)
2018-05-29 18:38:58 +02:00
# - crossview: Cross-eyed 3d
New 3D Mode: Pageflip The pageflip mode requires a stereo quadbuffer, and a modern graphic card. Patch tested with NVidia 3D Vision. The mini-map is not drawn, but that's what is done for topbottom and sidebyside modes as well. Also most of the time the user would prefer the HUD to be off. That's for the user to decide though, and toggle it manually. Finally, the interocular distance (aka eye separation) is twice as much as the "3d_paralax_strength" settings. I find this a strange design decision. I didn't want to chance this though, since it's how the other 3d modes interpret this settings.
2015-12-14 22:01:32 +01:00
# - pageflip: quadbuffer based 3d.
Rewrite rendering engine (#6253) * Clean draw_*() arguments * Split rendering core * Add anaglyph 3D * Interlaced 3D * Drop obsolete methods
2017-10-31 19:27:10 +01:00
# Note that the interlaced mode requires shaders to be enabled.
Add crossview support (#7361)
2018-05-29 18:38:58 +02:00
3d_mode (3D mode) enum none none,anaglyph,interlaced,topbottom,sidebyside,crossview,pageflip
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Add console height setting (#5136)
2017-01-29 17:10:17 +01:00
# In-game chat console height, between 0.1 (10%) and 1.0 (100%).
Adjust default console height #6797
2017-12-17 05:38:54 +01:00
console_height (Console height) float 0.6 0.1 1.0
Add console height setting (#5136)
2017-01-29 17:10:17 +01:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# In-game chat console background color (R,G,B).
console_color (Console color) string (0,0,0)
# In-game chat console background alpha (opaqueness, between 0 and 255).
console_alpha (Console alpha) int 200 0 255
Formspec: Add options to set background color and opacity (fullscreen mode + default mode) (#5493) * Formspec: Add options to set background color and opacity (fullscreen mode) * Enhance previous comment: Set formspec background when regenerate UI. * This permit to do the calcul only at regen and override it with bgcolor tag * Add a setting for default background color into formspec, separated from fullscreen * Add a little performance gain on formspecs using a const ref instead of copying formspec string
2017-08-29 19:25:16 +02:00
# Formspec full-screen background opacity (between 0 and 255).
formspec_fullscreen_bg_opacity (Formspec Full-Screen Background Opacity) int 140 0 255
# Formspec full-screen background color (R,G,B).
formspec_fullscreen_bg_color (Formspec Full-Screen Background Color) string (0,0,0)
# Formspec default background opacity (between 0 and 255).
formspec_default_bg_opacity (Formspec Default Background Opacity) int 140 0 255
# Formspec default background color (R,G,B).
formspec_default_bg_color (Formspec Default Background Color) string (0,0,0)
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Selection box border color (R,G,B).
selectionbox_color (Selection box color) string (0,0,0)
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Width of the selection box lines around nodes.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
selectionbox_width (Selection box width) int 2 1 5
# Crosshair color (R,G,B).
crosshair_color (Crosshair color) string (255,255,255)
# Crosshair alpha (opaqueness, between 0 and 255).
crosshair_alpha (Crosshair alpha) int 255 0 255
don't pass g_settings around, and use it directly
2017-10-16 02:22:22 +02:00
# Maximum number of recent chat messages to show
recent_chat_messages (Recent Chat Messages) int 6 2 20
Implement #6096
2017-10-16 01:28:42 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Whether node texture animations should be desynchronized per mapblock.
desynchronize_mapblock_texture_animation (Desynchronize block animation) bool true
# Maximum proportion of current window to be used for hotbar.
# Useful if there's something to be displayed right or left of hotbar.
hud_hotbar_max_width (Maximum hotbar width) float 1.0
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
# Modifies the size of the hudbar elements.
hud_scaling (HUD scale factor) float 1.0
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Enables caching of facedir rotated meshes.
enable_mesh_cache (Mesh cache) bool false
Add mesh generation delay
2017-02-18 19:53:05 +01:00
# 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.
mesh_generation_interval (Mapblock mesh generation delay) int 0 0 50
MeshUpdateQueue: Add a MapBlock cache that minimizes the amount of MapBlock copying done in the main thread Cache size is configurable by the meshgen_block_cache_size (default 20 MB). New profiler stats: - MeshUpdateQueue MapBlock cache hit % - MeshUpdateQueue MapBlock cache size kB Removes one type of stutter that was seen on the client when received MapBlocks were being handled. (the "MeshMakeData::fill" stutter) Kind of related to at least #5239 Originally preceded by these commits, now includes them: - Move the mesh generator thread into src/mesh_generator_thread.{cpp,h} - mesh_generator_thread.cpp: Update code style - MeshUpdateThread: Modify interface to house a different implementation: Actual functionality will be changed by next commits. - MeshMakeData: Add fillBlockData() interface (so that caller can fill in stuff from eg. a MapBlock cache)
2017-04-15 09:55:52 +02:00
# 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.
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
meshgen_block_cache_size (Mapblock mesh generator's MapBlock cache size in MB) int 20 0 1000
MeshUpdateQueue: Add a MapBlock cache that minimizes the amount of MapBlock copying done in the main thread Cache size is configurable by the meshgen_block_cache_size (default 20 MB). New profiler stats: - MeshUpdateQueue MapBlock cache hit % - MeshUpdateQueue MapBlock cache size kB Removes one type of stutter that was seen on the client when received MapBlocks were being handled. (the "MeshMakeData::fill" stutter) Kind of related to at least #5239 Originally preceded by these commits, now includes them: - Move the mesh generator thread into src/mesh_generator_thread.{cpp,h} - mesh_generator_thread.cpp: Update code style - MeshUpdateThread: Modify interface to house a different implementation: Actual functionality will be changed by next commits. - MeshMakeData: Add fillBlockData() interface (so that caller can fill in stuff from eg. a MapBlock cache)
2017-04-15 09:55:52 +02:00
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Enables minimap.
enable_minimap (Minimap) bool true
# Shape of the minimap. Enabled = round, disabled = square.
minimap_shape_round (Round minimap) bool true
# True = 256
# False = 128
Settingtypes.txt: Various improvements (#9047)
2019-10-14 04:30:54 +02:00
# Usable to make minimap smoother on slower machines.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
minimap_double_scan_height (Minimap scan height) bool true
# Make fog and sky colors depend on daytime (dawn/sunset) and view direction.
directional_colored_fog (Colored fog) bool true
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# The strength (darkness) of node ambient-occlusion shading.
# Lower is darker, Higher is lighter. The valid range of values for this
# setting is 0.25 to 4.0 inclusive. If the value is out of range it will be
# set to the nearest valid value.
ambient_occlusion_gamma (Ambient occlusion gamma) float 2.2 0.25 4.0
Use meshes to display inventory items
2016-01-24 14:19:17 +01:00
# Enables animation of inventory items.
inventory_items_animations (Inventory items animations) bool false
Fog: Make fraction of visible distance at which fog starts configurable Optimise the fetching of global settings 'camera_smoothing', 'cinematic' and 'cinematic_camera_smoothing'. Cache 'cam_smoothing'.
2016-12-04 06:43:25 +01:00
# Fraction of the visible distance at which fog starts to be rendered
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
fog_start (Fog start) float 0.4 0.0 0.99
Fog: Make fraction of visible distance at which fog starts configurable Optimise the fetching of global settings 'camera_smoothing', 'cinematic' and 'cinematic_camera_smoothing'. Cache 'cam_smoothing'.
2016-12-04 06:43:25 +01:00
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
# Makes all liquids opaque
opaque_water (Opaque liquids) bool false
Real global textures (#6105) * Real global textures * Add world-aligned textures * Update minimal to support world-aligned tiles * Update minimal
2017-10-15 09:34:14 +02:00
# Textures on a node may be aligned either to the node or to the world.
# The former mode suits better things like machines, furniture, etc., while
# the latter makes stairs and microblocks fit surroundings better.
# However, as this possibility is new, thus may not be used by older servers,
# this option allows enforcing it for certain node types. Note though that
# that is considered EXPERIMENTAL and may not work properly.
world_aligned_mode (World-aligned textures mode) enum enable disable,enable,force_solid,force_nodebox
# World-aligned textures may be scaled to span several nodes. However,
# the server may not send the scale you want, especially if you use
# a specially-designed texture pack; with this option, the client tries
# to determine the scale automatically basing on the texture size.
# See also texture_min_size.
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# Warning: This option is EXPERIMENTAL!
Real global textures (#6105) * Real global textures * Add world-aligned textures * Update minimal to support world-aligned tiles * Update minimal
2017-10-15 09:34:14 +02:00
autoscale_mode (Autoscaling mode) enum disable disable,enable,force
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
# Show entity selection boxes
show_entity_selectionbox (Show entity selection boxes) bool true
[*Menus]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Use a cloud animation for the main menu background.
menu_clouds (Clouds in menu) bool true
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Scale GUI by a user specified value.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Use a nearest-neighbor-anti-alias filter to scale the GUI.
# This will smooth over some of the rough edges, and blend
# pixels when scaling down, at the cost of blurring some
# edge pixels when images are scaled by non-integer sizes.
All Settings: Set min limit for crtitical settings (#9000)
2019-10-01 19:09:37 +02:00
gui_scaling (GUI scaling) float 1.0 0.001
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# When gui_scaling_filter is true, all GUI images need to be
# filtered in software, but some images are generated directly
# to hardware (e.g. render-to-texture for nodes in inventory).
gui_scaling_filter (GUI scaling filter) bool false
# When gui_scaling_filter_txr2img is true, copy those images
# from hardware to software for scaling. When false, fall back
# to the old scaling method, for video drivers that don't
Settingtypes.txt: Clarify comments, correct spelling
2016-08-28 16:02:33 +02:00
# properly support downloading textures back from hardware.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
gui_scaling_filter_txr2img (GUI scaling filter txr2img) bool true
# Delay showing tooltips, stated in milliseconds.
tooltip_show_delay (Tooltip delay) int 400
Correct tooltip_append_itemstring terminology (#6421)
2017-09-16 18:42:17 +02:00
# Append item name to tooltip.
tooltip_append_itemname (Append item name) bool false
Add setting to display the itemstring after the tooltip in the inventory. (#6413) * Add setting to display the itemstring after the tooltip in the inventory.
2017-09-15 14:31:32 +02:00
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# Whether FreeType fonts are used, requires FreeType support to be compiled in.
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# If disabled, bitmap and XML vectors fonts are used instead.
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
freetype (FreeType fonts) bool true
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Formspec: add hypertext element
2019-09-10 15:11:26 +02:00
font_bold (Font bold by default) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Formspec: add hypertext element
2019-09-10 15:11:26 +02:00
font_italic (Font italic by default) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Shadow offset (in pixels) of the default font. If 0, then shadow will not be drawn.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
font_shadow (Font shadow) int 1
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Opaqueness (alpha) of the shadow behind the default font, between 0 and 255.
Increase default font size by 1
2016-09-15 17:53:17 +02:00
font_shadow_alpha (Font shadow alpha) int 127 0 255
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Formspec: add hypertext element
2019-09-10 15:11:26 +02:00
# Font size of the default font in point (pt).
font_size (Font size) int 16 1
# Path to the default font.
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# If “freetype” setting is enabled: Must be a TrueType font.
# If “freetype” setting is disabled: Must be a bitmap or XML vectors font.
Formspec: add hypertext element
2019-09-10 15:11:26 +02:00
# The fallback font will be used if the font cannot be loaded.
font_path (Regular font path) filepath fonts/Arimo-Regular.ttf
font_path_bold (Bold font path) filepath fonts/Arimo-Bold.ttf
font_path_italic (Italic font path) filepath fonts/Arimo-Italic.ttf
font_path_bolditalic (Bold and italic font path) filepath fonts/Arimo-BoldItalic.ttf
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Font size of the monospace font in point (pt).
All Settings: Set min limit for crtitical settings (#9000)
2019-10-01 19:09:37 +02:00
mono_font_size (Monospace font size) int 15 1
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Formspec: add hypertext element
2019-09-10 15:11:26 +02:00
# Path to the monospace font.
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# If “freetype” setting is enabled: Must be a TrueType font.
# If “freetype” setting is disabled: Must be a bitmap or XML vectors font.
Formspec: add hypertext element
2019-09-10 15:11:26 +02:00
# This font is used for e.g. the console and profiler screen.
mono_font_path (Monospace font path) filepath fonts/Cousine-Regular.ttf
mono_font_path_bold (Bold monospace font path) filepath fonts/Cousine-Bold.ttf
mono_font_path_italic (Italic monospace font path) filepath fonts/Cousine-Italic.ttf
mono_font_path_bolditalic (Bold and italic monospace font path) filepath fonts/Cousine-BoldItalic.ttf
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Font size of the fallback font in point (pt).
All Settings: Set min limit for crtitical settings (#9000)
2019-10-01 19:09:37 +02:00
fallback_font_size (Fallback font size) int 15 1
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Shadow offset (in pixels) of the fallback font. If 0, then shadow will not be drawn.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
fallback_font_shadow (Fallback font shadow) int 1
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Opaqueness (alpha) of the shadow behind the fallback font, between 0 and 255.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
fallback_font_shadow_alpha (Fallback font shadow alpha) int 128 0 255
Formspec: add hypertext element
2019-09-10 15:11:26 +02:00
# 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.
# This font will be used for certain languages or if the default font is unavailable.
fallback_font_path (Fallback font path) filepath fonts/DroidSansFallbackFull.ttf
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Path to save screenshots at.
screenshot_path (Screenshot folder) path
Add options for screenshot format and quality
2016-03-07 23:09:07 +01:00
# Format of screenshots.
screenshot_format (Screenshot format) enum png png,jpg,bmp,pcx,ppm,tga
# Screenshot quality. Only used for JPEG format.
# 1 means worst quality; 100 means best quality.
# Use 0 for default quality.
screenshot_quality (Screenshot quality) int 0 0 100
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[*Advanced]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Adjust dpi configuration to your screen (non X11/Android only) e.g. for 4k screens.
All Settings: Set min limit for crtitical settings (#9000)
2019-10-01 19:09:37 +02:00
screen_dpi (DPI) int 72 1
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
# Windows systems only: Start Minetest with the command line window in the background.
# Contains the same information as the file debug.txt (default name).
enable_console (Enable console window) bool false
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[Sound]
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Enables the sound system.
# If disabled, this completely disables all sounds everywhere and the in-game
# sound controls will be non-functional.
# Changing this setting requires a restart.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
enable_sound (Sound) bool true
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Volume of all sounds.
# Requires the sound system to be enabled.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
sound_volume (Volume) float 0.7 0.0 1.0
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Whether to mute sounds. You can unmute sounds at any time, unless the
# sound system is disabled (enable_sound=false).
# In-game, you can toggle the mute state with the mute key or by using the
# pause menu.
Add mute setting (toggled by the mute key and in the volume menu) (#6415) * Add mute setting (toggled by the mute key and in the volume menu)
2017-09-26 08:17:50 +02:00
mute_sound (Mute sound) bool false
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
[Client]
[*Network]
# Address to connect to.
# Leave this blank to start a local server.
# Note that the address field in the main menu overrides this setting.
address (Server address) string
# Port to connect to (UDP).
# Note that the port field in the main menu overrides this setting.
remote_port (Remote port) int 30000 1 65535
# Save the map received by the client on disk.
enable_local_map_saving (Saving map received from server) bool false
# 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.
enable_remote_media_server (Connect to external media server) bool true
# Enable Lua modding support on client.
# This support is experimental and API can change.
enable_client_modding (Client modding) bool false
# URL to the server list displayed in the Multiplayer Tab.
serverlist_url (Serverlist URL) string servers.minetest.net
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# File in client/serverlist/ that contains your favorite servers displayed in the
# Multiplayer Tab.
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
serverlist_file (Serverlist file) string favoriteservers.txt
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# Maximum size of the out chat queue.
# 0 to disable queueing and -1 to make the queue size unlimited.
Advanced settings: Make 'controls', 'graphics', 'sound' more accessible Move client 'controls', 'graphics' and 'sound' into the first level to be immediately visible to players who may not realise these come under 'client'. These are the settings that new players or players on a server are likely to want to access while not having understanding of what comes under 'client'. Leave client 'network' and 'advanced' under 'client' as these are more advanced. Move 'show entity selection boxes' from the bizarre location in 'client'>'network' to 'graphics'>'in game'>'advanced'.
2017-08-28 00:48:51 +02:00
max_out_chat_queue_size (Maximum size of the out chat queue) int 20
Add setting to disable confirmation on new player registration (#8102)
2019-01-26 20:26:37 +01:00
# Enable register confirmation when connecting to server.
# If disabled, new account will be registered automatically.
enable_register_confirmation (Enable register confirmation) bool true
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
[*Advanced]
# Timeout for client to remove unused map data from memory.
client_unload_unused_data_timeout (Mapblock unload timeout) int 600
# Maximum number of mapblocks for client to be kept in memory.
# Set to -1 for unlimited amount.
client_mapblock_limit (Mapblock limit) int 5000
# Whether to show the client debug info (has the same effect as hitting F5).
show_debug (Show debug info) bool false
[Server / Singleplayer]
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Name of the server, to be displayed when players join and in the serverlist.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
server_name (Server name) string Minetest server
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Description of server, to be displayed when players join and in the serverlist.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
server_description (Server description) string mine here
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Domain name of server, to be displayed in the serverlist.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
server_address (Server address) string game.minetest.net
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Homepage of server, to be displayed in the serverlist.
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
server_url (Server URL) string https://minetest.net
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Fix spelling of setting descriptions (#7829)
2018-12-02 15:33:49 +01:00
# Automatically report to the serverlist.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
server_announce (Announce server) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Announce to this serverlist.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
serverlist_url (Serverlist URL) string servers.minetest.net
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Remove color codes from incoming chat messages
# Use this to stop players from being able to use color in their messages
Add a server-sided way to remove color codes from incoming chat messages (#5948) These code be generated by CSM, a modded client or just copy and pasted by the player. Changes - Update configuration example and setting translation file. - Remove colour codes before logging chat. - Add setting to remove colour codes before processing the chat.
2017-06-10 13:49:44 +02:00
strip_color_codes (Strip color codes) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
[*Network]
# Network port to listen (UDP).
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# This value will be overridden when starting from the main menu.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
port (Server port) int 30000
# The network interface that the server listens on.
bind_address (Bind address) string
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Enable to disallow old clients from connecting.
# Older clients are compatible in the sense that they will not crash when connecting
# to new servers, but they may not support all new features that you are expecting.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
strict_protocol_version_checking (Strict protocol checking) bool false
# Specifies URL from which client fetches media instead of using UDP.
# $filename should be accessible from $remote_media$filename via cURL
# (obviously, remote_media should end with a slash).
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Files that are not present will be fetched the usual way.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
remote_media (Remote media) string
Remove obsolete section in ipv6_server description This section no longer applies since c66d97726931aa8dde7d8a1ffa5b8e41234f4660.
2018-11-18 15:38:44 +01:00
# Enable/disable running an IPv6 server.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Ignored if bind_address is set.
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Needs enable_ipv6 to be enabled.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
ipv6_server (IPv6 server) bool false
[**Advanced]
Settingtypes.txt: Clarify comments, correct spelling
2016-08-28 16:02:33 +02:00
# Maximum number of blocks that are simultaneously sent per client.
Server: Calculate maximal total block sends dynamically (#6393) The block sends per client is 1/2 when reaching the maximal player count.
2017-09-09 00:36:48 +02:00
# The maximum total count is calculated dynamically:
# max_total = ceil((#clients + max_users) * per_client / 4)
Adjust some settings to modern environments and networks. (#7549)
2018-07-13 22:11:49 +02:00
max_simultaneous_block_sends_per_client (Maximum simultaneous block sends per client) int 40
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# To reduce lag, block transfers are slowed down when a player is building something.
# This determines how long they are slowed down after placing or removing a node.
Settingtypes.txt: Clarify comments, correct spelling
2016-08-28 16:02:33 +02:00
full_block_send_enable_min_time_from_building (Delay in sending blocks after building) float 2.0
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Maximum number of packets sent per send step, if you have a slow connection
# try reducing it, but don't reduce it to a number below double of targeted
# client number.
max_packets_per_iteration (Max. packets per iteration) int 1024
[*Game]
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Default game when creating a new world.
# This will be overridden when creating a world from the main menu.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
default_game (Default game) string minetest
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Message of the day displayed to players connecting.
motd (Message of the day) string
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Maximum number of players that can be connected simultaneously.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
max_users (Maximum users) int 15
# World directory (everything in the world is stored here).
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Not needed if starting from the main menu.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
map-dir (Map directory) path
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Time in seconds for item entity (dropped items) to live.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Setting it to -1 disables the feature.
item_entity_ttl (Item entity TTL) int 900
# Enable players getting damage and dying.
enable_damage (Damage) bool false
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
# Enable creative mode for new created maps.
creative_mode (Creative) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# A chosen map seed for a new map, leave empty for random.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Will be overridden when creating a new world in the main menu.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
fixed_map_seed (Fixed map seed) string
# New users need to input this password.
default_password (Default password) string
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# The privileges that new users automatically get.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# See /privs in game for a full list on your server and mod configuration.
default_privs (Default privileges) string interact, shout
Builtin: Add basic_privs setting
2016-04-09 17:07:45 +02:00
# Privileges that players with basic_privs can grant
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
basic_privs (Basic privileges) string interact, shout
Builtin: Add basic_privs setting
2016-04-09 17:07:45 +02:00
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Whether players are shown to clients without any range limit.
# Deprecated, use the setting player_transfer_distance instead.
unlimited_player_transfer_distance (Unlimited player transfer distance) bool true
# Defines the maximal player transfer distance in blocks (0 = unlimited).
player_transfer_distance (Player transfer distance) int 0
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Whether to allow players to damage and kill each other.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
enable_pvp (Player versus player) bool true
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Implement mod communication channels (#6351) Implement network communication for channels * Implement ModChannel manager server side to route incoming messages from clients to other clients * Add signal handler switch on client & ModChannelMgr on client to handle channels * Add Lua API bindings + client packet sending + unittests * Implement server message sending * Add callback from received message handler to Lua API using registration method
2017-09-26 00:11:20 +02:00
# Enable mod channels support.
enable_mod_channels (Mod channels) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# If this is set, players will always (re)spawn at the given position.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
static_spawnpoint (Static spawnpoint) string
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# If enabled, new players cannot join with an empty password.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
disallow_empty_password (Disallow empty passwords) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# If enabled, disable cheat prevention in multiplayer.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
disable_anticheat (Disable anticheat) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# If enabled, actions are recorded for rollback.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# This option is only read when server starts.
enable_rollback_recording (Rollback recording) bool false
Allow customizing chat message format (#8529)
2019-08-08 18:04:46 +02:00
# Format of player chat messages. The following strings are valid placeholders:
# @name, @message, @timestamp (optional)
chat_message_format (Chat message format) string <@name> @message
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# A message to be displayed to all clients when the server shuts down.
kick_msg_shutdown (Shutdown message) string Server shutting down.
# A message to be displayed to all clients when the server crashes.
kick_msg_crash (Crash message) string This server has experienced an internal error. You will now be disconnected.
# Whether to ask clients to reconnect after a (Lua) crash.
# Set this to true if your server is set up to restart automatically.
ask_reconnect_on_crash (Ask to reconnect after crash) bool false
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# From how far clients know about objects, stated in mapblocks (16 nodes).
Document extended meaning of active_object_send_range_blocks setting.
2017-12-04 02:56:39 +01:00
#
# 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)
Settings: Slightly increase block generate, block send, object send distances (#8147)
2019-01-31 20:28:14 +01:00
active_object_send_range_blocks (Active object send range) int 4
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# The radius of the volume of blocks around every player that is subject to the
# active block stuff, stated in mapblocks (16 nodes).
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# In active blocks objects are loaded and ABMs run.
Document extended meaning of active_object_send_range_blocks setting.
2017-12-04 02:56:39 +01:00
# This is also the minimum range in which active objects (mobs) are maintained.
# This should be configured together with active_object_range.
Process ABMs in a spherical volume instead of cubic Increase active_block_range default to a 3 mapblock radius.
2016-12-10 19:31:17 +01:00
active_block_range (Active block range) int 3
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# From how far blocks are sent to clients, stated in mapblocks (16 nodes).
Settings: Slightly increase block generate, block send, object send distances (#8147)
2019-01-31 20:28:14 +01:00
max_block_send_distance (Max block send distance) int 10
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Maximum number of forceloaded mapblocks.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
max_forceloaded_blocks (Maximum forceloaded blocks) int 16
# Interval of sending time of day to clients.
time_send_interval (Time send interval) int 5
# Controls length of day/night cycle.
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# Examples:
# 72 = 20min, 360 = 4min, 1 = 24hour, 0 = day/night/whatever stays unchanged.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
time_speed (Time speed) int 72
World start time: Add setting for this, default unchanged
2017-09-02 04:18:42 +02:00
# Time of day when a new world is started, in millihours (0-23999).
World start time: Move to first full light (day night ratio = 1000) (#8410) 6125 is the time of first full light according to 'get_node_light()', and the time of first full light visually when basic shaders are on. This is the optimum default new world start time, taking all possible games into account. The previous time assumed a game similar to Minetest Game. Games should set this setting themselves according to their needs.
2019-04-13 02:46:38 +02:00
world_start_time (World start time) int 6125 0 23999
World start time: Add setting for this, default unchanged
2017-09-02 04:18:42 +02:00
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Interval of saving important changes in the world, stated in seconds.
server_map_save_interval (Map save interval) float 5.3
Chat: new settings to prevent spam Added the following chat coreside features * Chat messages length limit * Message rate limiting * Message rate kicking Note: * handleChat now takes RemotePlayer pointer instead of u16 to remove useless lookups
2016-10-04 18:17:12 +02:00
# Set the maximum character length of a chat message sent by clients.
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
chat_message_max_size (Chat message max length) int 500
Chat: new settings to prevent spam Added the following chat coreside features * Chat messages length limit * Message rate limiting * Message rate kicking Note: * handleChat now takes RemotePlayer pointer instead of u16 to remove useless lookups
2016-10-04 18:17:12 +02:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Amount of messages a player may send per 10 seconds.
chat_message_limit_per_10sec (Chat message count limit) float 10.0
Chat: new settings to prevent spam Added the following chat coreside features * Chat messages length limit * Message rate limiting * Message rate kicking Note: * handleChat now takes RemotePlayer pointer instead of u16 to remove useless lookups
2016-10-04 18:17:12 +02:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Kick players who sent more than X messages per 10 seconds.
chat_message_limit_trigger_kick (Chat message kick threshold) int 50
Chat: new settings to prevent spam Added the following chat coreside features * Chat messages length limit * Message rate limiting * Message rate kicking Note: * handleChat now takes RemotePlayer pointer instead of u16 to remove useless lookups
2016-10-04 18:17:12 +02:00
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
[**Physics]
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# Horizontal and vertical acceleration on ground or when climbing,
# in nodes per second per second.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
movement_acceleration_default (Default acceleration) float 3
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# Horizontal acceleration in air when jumping or falling,
# in nodes per second per second.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
movement_acceleration_air (Acceleration in air) float 2
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# Horizontal and vertical acceleration in fast mode,
# in nodes per second per second.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
movement_acceleration_fast (Fast mode acceleration) float 10
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# Walking and flying speed, in nodes per second.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
movement_speed_walk (Walking speed) float 4
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# Sneaking speed, in nodes per second.
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
movement_speed_crouch (Sneaking speed) float 1.35
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# Walking, flying and climbing speed in fast mode, in nodes per second.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
movement_speed_fast (Fast mode speed) float 20
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# Vertical climbing speed, in nodes per second.
Climb speed: Increase default setting from 2 to 3
2017-03-06 09:35:13 +01:00
movement_speed_climb (Climbing speed) float 3
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# Initial vertical speed when jumping, in nodes per second.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
movement_speed_jump (Jumping speed) float 6.5
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
Settingtypes.txt: Various improvements (#9047)
2019-10-14 04:30:54 +02:00
# Decrease this to increase liquid resistance to movement.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
movement_liquid_fluidity (Liquid fluidity) float 1
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
Settingtypes.txt: Various improvements (#9047)
2019-10-14 04:30:54 +02:00
# Maximum liquid resistance. Controls deceleration when entering liquid at
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# high speed.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
movement_liquid_fluidity_smooth (Liquid fluidity smoothing) float 0.5
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# Controls sinking speed in liquid.
movement_liquid_sink (Liquid sinking) float 10
# Acceleration of gravity, in nodes per second per second.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
movement_gravity (Gravity) float 9.81
[**Advanced]
Settingtypes.txt: Various improvements (#9047)
2019-10-14 04:30:54 +02:00
# Handling for deprecated Lua API calls:
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# - legacy: (try to) mimic old behaviour (default for release).
# - log: mimic and log backtrace of deprecated call (default for debug).
# - error: abort on usage of deprecated call (suggested for mod developers).
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
deprecated_lua_api_handling (Deprecated Lua API handling) enum legacy legacy,log,error
# Number of extra blocks that can be loaded by /clearobjects at once.
# This is a trade-off between sqlite transaction overhead and
# memory consumption (4096=100MB, as a rule of thumb).
max_clearobjects_extra_loaded_blocks (Max. clearobjects extra blocks) int 4096
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# How much the server will wait before unloading unused mapblocks.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Higher value is smoother, but will use more RAM.
server_unload_unused_data_timeout (Unload unused server data) int 29
# Maximum number of statically stored objects in a block.
Changes to static object storage limit and error message Move static object storage force-delete message from errorstream to warningstream. Increase 'max objects per block' setting to 64. Add missing spaces in warning code.
2016-10-19 02:37:12 +02:00
max_objects_per_block (Maximum objects per block) int 64
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# See https://www.sqlite.org/pragma.html#pragma_synchronous
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
sqlite_synchronous (Synchronous SQLite) enum 2 0,1,2
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# Length of a server tick and the interval at which objects are generally updated over
# network.
Reduce dedicated server step to 0.09 (#6252) Minetest performance improvement has been huge since months, server step reduction will permit to handle client events a little bit faster without too many penalty costs due to core engine
2017-08-17 19:16:02 +02:00
dedicated_server_step (Dedicated server step) float 0.09
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# Length of time between active block management cycles
active_block_mgmt_interval (Active block management interval) float 2.0
Allow NodeTimer, ABM and block mgmt interval changes. ABM's are hardcoded to run every 1.0s, NodeTimers are hard coded to run at every 1.0s. Block mgmt is running every 2.0sec. However, these timers can be better tuned for both higher and lower values by server owners. Some server owners want to, and have the resources to send more packets per second to clients, and so they may wish to send smaller updates sooner. Right now all ABM's are coalesced into 1.0 second intervals, resulting in large send queues to all clients. By reducing the amount of possible timers, one can get a far better response rate and lower the perception of lag. On the other side of the camp, some servers may want to increase these values, which again isn't easily doable. The global settings abm_interval and nodetimer_interval are set to current values by default. I've tested with 0.2/0.5 type values and noticed a greatly improved response and better scattering of nodetimers, as well as enjoying not faceplanting into doors with pressure plates anymore.
2016-03-02 08:14:26 +01:00
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# Length of time between Active Block Modifier (ABM) execution cycles
abm_interval (ABM interval) float 1.0
Allow NodeTimer, ABM and block mgmt interval changes. ABM's are hardcoded to run every 1.0s, NodeTimers are hard coded to run at every 1.0s. Block mgmt is running every 2.0sec. However, these timers can be better tuned for both higher and lower values by server owners. Some server owners want to, and have the resources to send more packets per second to clients, and so they may wish to send smaller updates sooner. Right now all ABM's are coalesced into 1.0 second intervals, resulting in large send queues to all clients. By reducing the amount of possible timers, one can get a far better response rate and lower the perception of lag. On the other side of the camp, some servers may want to increase these values, which again isn't easily doable. The global settings abm_interval and nodetimer_interval are set to current values by default. I've tested with 0.2/0.5 type values and noticed a greatly improved response and better scattering of nodetimers, as well as enjoying not faceplanting into doors with pressure plates anymore.
2016-03-02 08:14:26 +01:00
# Length of time between NodeTimer execution cycles
Change default nodetimer_interval to 0.2s. (#5193) We want to reduce the chance that we get lots and lots of node timers all happening once a second, because we're better off doing small bits of work as they are available. Reducing this to 0.2 seconds will greatly reduce the total amount of nodetimers that elapse at the same instance, while not effecting total work load. This results in a far better chance of the server keeping up with work loads.
2017-02-09 08:00:37 +01:00
nodetimer_interval (NodeTimer interval) float 0.2
Allow NodeTimer, ABM and block mgmt interval changes. ABM's are hardcoded to run every 1.0s, NodeTimers are hard coded to run at every 1.0s. Block mgmt is running every 2.0sec. However, these timers can be better tuned for both higher and lower values by server owners. Some server owners want to, and have the resources to send more packets per second to clients, and so they may wish to send smaller updates sooner. Right now all ABM's are coalesced into 1.0 second intervals, resulting in large send queues to all clients. By reducing the amount of possible timers, one can get a far better response rate and lower the perception of lag. On the other side of the camp, some servers may want to increase these values, which again isn't easily doable. The global settings abm_interval and nodetimer_interval are set to current values by default. I've tested with 0.2/0.5 type values and noticed a greatly improved response and better scattering of nodetimers, as well as enjoying not faceplanting into doors with pressure plates anymore.
2016-03-02 08:14:26 +01:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# If enabled, invalid world data won't cause the server to shut down.
# Only enable this if you know what you are doing.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
ignore_world_load_errors (Ignore world errors) bool false
# Max liquids processed per step.
liquid_loop_max (Liquid loop max) int 100000
# The time (in seconds) that the liquids queue may grow beyond processing
# capacity until an attempt is made to decrease its size by dumping old queue
# items. A value of 0 disables the functionality.
liquid_queue_purge_time (Liquid queue purge time) int 0
# Liquid update interval in seconds.
liquid_update (Liquid update tick) float 1.0
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# 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).
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
block_send_optimize_distance (Block send optimize distance) int 4 2
Optionally disable optimization that causes underwater and cave rendering glitches. (#4686)
2016-10-31 04:35:55 +01:00
Allow server side occlusion culling.
2017-02-28 08:06:15 +01:00
# 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.
Enable server side occlusion culling by default.
2017-03-03 21:40:50 +01:00
server_side_occlusion_culling (Server side occlusion culling) bool true
Allow server side occlusion culling.
2017-02-28 08:06:15 +01:00
CSM restrictions: Make 'LOAD_CLIENT_MODS' disable loading of 'builtin' (#8000) Previously, when the CSM restriction 'LOAD_CLIENT_MODS' was used a client was still able to add CSM code to 'builtin' to bypass that restriction, because 'builtin' is not yet verified. Until server-sent CSM and verifying of 'builtin' are complete, make 'LOAD_CLIENT_MODS' disable the loading of builtin. Clarify code comments and messages to distinguish between client-side modding and client-side scripting. 'Scripting' includes 'builtin', 'modding' does not.
2019-01-03 12:10:07 +01:00
# 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)
[CSM] Add flavour limits controlled by server (#5930) * [CSM] Add flavour limits controlled by server Server send flavour limits to client permitting to disable or limit some Lua calls * Add limits for reading nodedefs and itemdefs * flavour: Add lookup node limits * Merge get_node_or_nil into get_node. Sending fake node doesn't make sense in CSM, just return nil if node is not available for any reason * Add node range customization when noderange flavour is enabled (default 8 nodes) * Limit nodes range & disable chat message sending by default * Bump protocol version
2017-07-18 21:39:55 +02:00
# 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)
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# LOOKUP_NODES_LIMIT: 16 (limits get_node call client-side to
# csm_restriction_noderange)
CSM restrictions: Make 'LOAD_CLIENT_MODS' disable loading of 'builtin' (#8000) Previously, when the CSM restriction 'LOAD_CLIENT_MODS' was used a client was still able to add CSM code to 'builtin' to bypass that restriction, because 'builtin' is not yet verified. Until server-sent CSM and verifying of 'builtin' are complete, make 'LOAD_CLIENT_MODS' disable the loading of builtin. Clarify code comments and messages to distinguish between client-side modding and client-side scripting. 'Scripting' includes 'builtin', 'modding' does not.
2019-01-03 12:10:07 +01:00
# READ_PLAYERINFO: 32 (disable get_player_names call client-side)
CSM: add requested CSM_RF_READ_PLAYERINFO (#8007) * CSM: add requested CSM_RF_READ_PLAYERINFO This new CSM limit permit to limit PLAYERINFO read from server. It affects get_player_names call
2018-12-24 10:51:10 +01:00
csm_restriction_flags (Client side modding restrictions) int 62
[CSM] Add flavour limits controlled by server (#5930) * [CSM] Add flavour limits controlled by server Server send flavour limits to client permitting to disable or limit some Lua calls * Add limits for reading nodedefs and itemdefs * flavour: Add lookup node limits * Merge get_node_or_nil into get_node. Sending fake node doesn't make sense in CSM, just return nil if node is not available for any reason * Add node range customization when noderange flavour is enabled (default 8 nodes) * Limit nodes range & disable chat message sending by default * Bump protocol version
2017-07-18 21:39:55 +02:00
Rename CSM flavours to restrictions & Satisfy LINT
2018-06-20 22:36:08 +02:00
# If the CSM restriction for node range is enabled, get_node calls are limited
# to this distance from the player to the node.
CSM: Disallow exploitable clientside mod functions by default (#7547)
2018-07-19 04:58:48 +02:00
csm_restriction_noderange (Client side node lookup range restriction) int 0
[CSM] Add flavour limits controlled by server (#5930) * [CSM] Add flavour limits controlled by server Server send flavour limits to client permitting to disable or limit some Lua calls * Add limits for reading nodedefs and itemdefs * flavour: Add lookup node limits * Merge get_node_or_nil into get_node. Sending fake node doesn't make sense in CSM, just return nil if node is not available for any reason * Add node range customization when noderange flavour is enabled (default 8 nodes) * Limit nodes range & disable chat message sending by default * Bump protocol version
2017-07-18 21:39:55 +02:00
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[*Security]
# Prevent mods from doing insecure things like running shell commands.
secure.enable_security (Enable mod security) bool true
# Comma-separated list of trusted mods that are allowed to access insecure
# functions even when mod security is on (via request_insecure_environment()).
secure.trusted_mods (Trusted mods) string
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Comma-separated list of mods that are allowed to access HTTP APIs, which
# allow them to upload and download data to/from the internet.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
secure.http_mods (HTTP mods) string
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[*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.
profiler.load (Load the game profiler) bool false
# The default format in which profiles are being saved,
# when calling `/profiler save [format]` without format.
profiler.default_report_format (Default report format) enum txt txt,csv,lua,json,json_pretty
# The file path relative to your worldpath in which profiles will be saved to.
profiler.report_path (Report path) string ""
[***Instrumentation]
# Instrument the methods of entities on registration.
instrument.entity (Entity methods) bool true
# Instrument the action function of Active Block Modifiers on registration.
instrument.abm (Active Block Modifiers) bool true
# Instrument the action function of Loading Block Modifiers on registration.
instrument.lbm (Loading Block Modifiers) bool true
# Instrument chatcommands on registration.
instrument.chatcommand (Chatcommands) bool true
# Instrument global callback functions on registration.
# (anything you pass to a minetest.register_*() function)
instrument.global_callback (Global callbacks) bool true
[****Advanced]
# Instrument builtin.
# This is usually only needed by core/builtin contributors
instrument.builtin (Builtin) bool 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.
instrument.profiler (Profiler) bool false
[Client and Server]
# Name of the player.
# When running a server, clients connecting with this name are admins.
# When starting from the main menu, this is overridden.
name (Player name) string
# Set the language. Leave empty to use the system language.
# A restart is required after changing this.
Add missing languages from menu (#6953) The following languages exist in Minetest PO folder were missing from the selection menu: - dv (Dhivehi) - ms (Malay) - sl (Slovenian) - sv (Swedish) - sw (Swahili)
2018-01-23 19:27:41 +01:00
language (Language) enum ,be,ca,cs,da,de,dv,en,eo,es,et,fr,he,hu,id,it,ja,jbo,ko,ky,lt,ms,nb,nl,pl,pt,pt_BR,ro,ru,sl,sr_Cyrl,sv,sw,tr,uk,zh_CN,zh_TW
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
# Level of logging to be written to debug.txt:
# - <nothing> (no logging)
# - none (messages with no level)
# - error
# - warning
# - action
# - info
# - verbose
debug_log_level (Debug log level) enum action ,none,error,warning,action,info,verbose
Move debug.txt after it grows too big (#8904) Before opening the file for writing, its file size is tested. If it exceeds 50 MB, it is moved to debut.txt.1, otherwise the log is appended to the old messages. An old debut.txt.1 is removed if it already exists.
2019-09-07 19:38:54 +02:00
# 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.
debug_log_size_max (Debug log file size threshold) int 50
Add help texts for settings that lack one (#9007)
2019-10-25 22:29:02 +02:00
# Enable IPv6 support (for both client and server).
# Required for IPv6 connections to work at all.
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
enable_ipv6 (IPv6) bool true
[*Advanced]
# Default timeout for cURL, stated in milliseconds.
# Only has an effect if compiled with cURL.
curl_timeout (cURL timeout) int 5000
# Limits number of parallel HTTP requests. Affects:
# - Media fetch if server uses remote_media setting.
# - Serverlist download and server announcement.
# - Downloads performed by main menu (e.g. mod manager).
# Only has an effect if compiled with cURL.
curl_parallel_limit (cURL parallel limit) int 8
# Maximum time in ms a file download (e.g. a mod download) may take.
curl_file_download_timeout (cURL file download timeout) int 300000
# Makes DirectX work with LuaJIT. Disable if it causes troubles.
high_precision_fpu (High-precision FPU) bool true
Add main_menu_style setting
2017-12-05 06:01:49 +01:00
# Changes the main menu UI:
Make advanced settings noiseparams strings translatable (#8062) Various minor language improvements in settingtypes.txt.
2019-01-20 19:49:17 +01:00
# - Full: Multiple singleplayer worlds, game choice, texture pack chooser, etc.
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# - Simple: One singleplayer world, no game or texture pack choosers. May be
# necessary for smaller screens.
Main menu style: Set to 'full' for Android, remove 'auto' option (#7936)
2018-12-07 00:52:11 +01:00
main_menu_style (Main menu style) enum full full,simple
Add main_menu_style setting
2017-12-05 06:01:49 +01:00
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
# Replaces the default main menu with a custom one.
main_menu_script (Main menu script) string
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# Print the engine's profiling data in regular intervals (in seconds).
# 0 = disable. Useful for developers.
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
profiler_print_interval (Engine profiling data print interval) int 0
[Mapgen]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Name of map generator to be used when creating a new world.
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Creating a world in the main menu will override this.
Document 'highly unstable' mapgens instead of 'stable' mapgens (#8404)
2019-03-20 05:37:33 +01:00
# Current mapgens in a highly unstable state:
# - The optional floatlands of v7 (disabled by default).
Re-order mapgens in mainmenu and 'all settings' mapgen selection (#8705) v6 always last to discourage selection. Special mapgens flat, fractal, singlenode, next to last. Of these, singlenode last to discourage selection. Of the remaining, v5 last due to age, v7 first due to being the default.
2019-07-25 21:46:28 +02:00
mg_name (Mapgen name) enum v7 v7,valleys,carpathian,v5,flat,fractal,singlenode,v6
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
# Water surface level of the world.
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
water_level (Water level) int 1
# From how far blocks are generated for clients, stated in mapblocks (16 nodes).
Settings: Slightly increase block generate, block send, object send distances (#8147)
2019-01-31 20:28:14 +01:00
max_block_generate_distance (Max block generate distance) int 8
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Map generation limit: Make per-world The setting limits map generation but affects nothing else. Add 'mapgen_limit' to global mapgen parameters. Move 'blockpos_over_mapgen_limit()' to the only place it is called from: map.cpp. Allow teleportation to any part of the world even if over the set mapgen limit. Simplify the reading of this limit in mgvalleys. Remove the 'map_generation_limit' setting.
2017-03-23 01:18:59 +01:00
# 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.
mapgen_limit (Map generation limit) int 31000 0 31000
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
# Global map generation attributes.
Mapgen: Add global 'decorations' flag Flag is set by default in MapgenParams The global 'trees' flag remains but is now undocumented and unset by default in MapgenParams Add mgv6_spflag 'trees' set by default in defaultsettings.cpp to affect new worlds only This is automatically backwards compatible for existing worlds
2015-11-15 12:55:45 +01:00
# In Mapgen v6 the 'decorations' flag controls all decorations except trees
# and junglegrass, in all other mapgens this flag controls all decorations.
Mapgen flags: Add 'biomes' global mapgen flag (#7355) Previously the only way to disable biomes was to 'clear' the registered biomes in a mod, but this method causes large amounts of unnecessary processing: 1. Calculation of 4 2D noises. 2. Looping through all nodes of a mapchunk replacing nodes with identical nodes. The new flag disables those operations.
2018-06-09 00:24:36 +02:00
mg_flags (Mapgen flags) flags caves,dungeons,light,decorations,biomes caves,dungeons,light,decorations,biomes,nocaves,nodungeons,nolight,nodecorations,nobiomes
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[*Biome API temperature and humidity noise parameters]
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Temperature variation for biomes.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mg_biome_np_heat (Heat noise) noise_params_2d 50, 50, (1000, 1000, 1000), 5349, 3, 0.5, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Small-scale temperature variation for blending biomes on borders.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mg_biome_np_heat_blend (Heat blend noise) noise_params_2d 0, 1.5, (8, 8, 8), 13, 2, 1.0, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Humidity variation for biomes.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mg_biome_np_humidity (Humidity noise) noise_params_2d 50, 50, (1000, 1000, 1000), 842, 3, 0.5, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Small-scale humidity variation for blending biomes on borders.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mg_biome_np_humidity_blend (Humidity blend noise) noise_params_2d 0, 1.5, (8, 8, 8), 90003, 2, 1.0, 2.0, eased
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[*Mapgen V5]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Map generation attributes specific to Mapgen v5.
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
mgv5_spflags (Mapgen V5 specific flags) flags caverns caverns,nocaverns
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Mapgen: Make 3D noise tunnels' width settable Correct parameter names mg_valleys to mgvalleys Remove biome NoiseParams from MapgenValleysParams Improve format of parameter code
2016-04-25 12:47:25 +02:00
# Controls width of tunnels, a smaller value creates wider tunnels.
Tunnels: Completely disable generation when 'cave width' >= 10.0 (#9093) Previously, the only way to disable the 3D noise tunnels was to set 'cave width' > 1.0, however doing so did not disable the very intensive noise calculations or the generation loop. All the other types of cave generation (randomwalk caves, caverns) can already be independently and completely disabled. This feature is now needed more because the small randomwalk caves are now available for use as an alternative to the 3D noise tunnels.
2019-11-09 03:09:52 +01:00
# Value >= 10.0 completely disables generation of tunnels and avoids the
# intensive noise calculations.
Mgv5: Change tunnel parameters to those of other mapgens (#7641) Make tunnels wider and use the noise parameters of most other mapgens. All other underground features are already identical to all other non-mgv6 mapgens, this final change modernises and improves the tunnels.
2018-08-16 20:10:56 +02:00
mgv5_cave_width (Cave width) float 0.09
Mapgen: Make 3D noise tunnels' width settable Correct parameter names mg_valleys to mgvalleys Remove biome NoiseParams from MapgenValleysParams Improve format of parameter code
2016-04-25 12:47:25 +02:00
CavesRandomWalk: Make 'lava_depth' a mapgen parameter As with 'large_cave_depth', lava depth was previously a fixed y value and therefore incompatible with the ability to shift terrain vertically. Add 'lava_depth' mapgen parameter to mgflat, mgfractal, mgv5, mgv7.
2017-06-21 05:20:18 +02:00
# Y of upper limit of large caves.
Mgv5/v7/fractal: Add 'large_cave_depth' parameter to replace fixed value The value cannot be fixed because we can shift terrain vertically. This also makes these mapgens consistent with mgflat and mgvalleys which have 'large_cave_depth' parameters.
2017-06-20 05:55:32 +02:00
mgv5_large_cave_depth (Large cave depth) int -256
Randomwalk caves: Add parameters for number, proportion flooded. Allow small caves (#8928) Add mapgen parameters to set the range of the random number of randomwalk caves per mapchunk, and to set the proportion that are flooded with liquids. Default values are, for now, unchanged from the previous hardcoded values. Add parameters to allow small randomwalk caves Disabled by default for now as they have never been present in the non-mgv6 mapgens.
2019-11-08 04:09:43 +01:00
# Minimum limit of random number of small caves per mapchunk.
mgv5_small_cave_num_min (Small cave minimum number) int 0 0 256
# Maximum limit of random number of small caves per mapchunk.
mgv5_small_cave_num_max (Small cave maximum number) int 0 0 256
# Minimum limit of random number of large caves per mapchunk.
mgv5_large_cave_num_min (Large cave minimum number) int 0 0 64
# Maximum limit of random number of large caves per mapchunk.
mgv5_large_cave_num_max (Large cave maximum number) int 2 0 64
# Proportion of large caves that contain liquid.
mgv5_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
Cavegen/Mgv5/Mgv7: Add optional giant caverns Add to MapgenBasic for use by multiple mapgens. Add to mgv5 and mgv7, enabled by default. Similar to mgvalleys caverns but half the scale. Parameters for upper y limit, distance caverns taper to full size, and noise threshold (full cavern size). As with mgvalleys caverns are generated first and classic caves are disabled in any mapchunk containing a cavern, to avoid excessive spreading volumes of liquids. This also avoids floating blobs of liquid where a large classic cave has overgenerated out into a neighbouring previously-generated mapchunk.
2017-03-12 14:26:09 +01:00
# Y-level of cavern upper limit.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv5_cavern_limit (Cavern limit) int -256
Cavegen/Mgv5/Mgv7: Add optional giant caverns Add to MapgenBasic for use by multiple mapgens. Add to mgv5 and mgv7, enabled by default. Similar to mgvalleys caverns but half the scale. Parameters for upper y limit, distance caverns taper to full size, and noise threshold (full cavern size). As with mgvalleys caverns are generated first and classic caves are disabled in any mapchunk containing a cavern, to avoid excessive spreading volumes of liquids. This also avoids floating blobs of liquid where a large classic cave has overgenerated out into a neighbouring previously-generated mapchunk.
2017-03-12 14:26:09 +01:00
# Y-distance over which caverns expand to full size.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv5_cavern_taper (Cavern taper) int 256
Cavegen/Mgv5/Mgv7: Add optional giant caverns Add to MapgenBasic for use by multiple mapgens. Add to mgv5 and mgv7, enabled by default. Similar to mgvalleys caverns but half the scale. Parameters for upper y limit, distance caverns taper to full size, and noise threshold (full cavern size). As with mgvalleys caverns are generated first and classic caves are disabled in any mapchunk containing a cavern, to avoid excessive spreading volumes of liquids. This also avoids floating blobs of liquid where a large classic cave has overgenerated out into a neighbouring previously-generated mapchunk.
2017-03-12 14:26:09 +01:00
# Defines full size of caverns, smaller values create larger caverns.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv5_cavern_threshold (Cavern threshold) float 0.7
Dungeons: Add Y limits in all mapgens Preserve the upper limit used in mgvalleys.
2018-02-17 18:43:13 +01:00
# Lower Y limit of dungeons.
mgv5_dungeon_ymin (Dungeon minimum Y) int -31000
# Upper Y limit of dungeons.
mgv5_dungeon_ymax (Dungeon maximum Y) int 31000
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[**Noises]
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Variation of biome filler depth.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv5_np_filler_depth (Filler depth noise) noise_params_2d 0, 1, (150, 150, 150), 261, 4, 0.7, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Variation of terrain vertical scale.
Settings: Update documentation (#5534) Now documented (sorted a-z): enable_console enable_particles creative_mode hud_scaling inventory_image_hack keymap_console keymap_zoom shader_path view_bobbing
2017-04-07 17:10:26 +02:00
# When noise is < -0.55 terrain is near-flat.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv5_np_factor (Factor noise) noise_params_2d 0, 1, (250, 250, 250), 920381, 3, 0.45, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Y-level of average terrain surface.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv5_np_height (Height noise) noise_params_2d 0, 10, (250, 250, 250), 84174, 4, 0.5, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# First of two 3D noises that together define tunnels.
Mgv5: Change tunnel parameters to those of other mapgens (#7641) Make tunnels wider and use the noise parameters of most other mapgens. All other underground features are already identical to all other non-mgv6 mapgens, this final change modernises and improves the tunnels.
2018-08-16 20:10:56 +02:00
mgv5_np_cave1 (Cave1 noise) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Second of two 3D noises that together define tunnels.
Mgv5: Change tunnel parameters to those of other mapgens (#7641) Make tunnels wider and use the noise parameters of most other mapgens. All other underground features are already identical to all other non-mgv6 mapgens, this final change modernises and improves the tunnels.
2018-08-16 20:10:56 +02:00
mgv5_np_cave2 (Cave2 noise) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# 3D noise defining giant caverns.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv5_np_cavern (Cavern noise) noise_params_3d 0, 1, (384, 128, 384), 723, 5, 0.63, 2.0
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# 3D noise defining terrain.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv5_np_ground (Ground noise) noise_params_3d 0, 40, (80, 80, 80), 983240, 4, 0.55, 2.0, eased
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Dungeons: Settable density noise, move number calculation to mapgens (#8473) Add user-settable noise parameters for dungeon density to each mapgen, except V6 which hardcodes this noise parameter. Move the calculation of number of dungeons generated in a mapchunk out of dungeongen.cpp and into mapgen code, to allow mapgens to generate any desired number of dungeons in a mapchunk, instead of being forced to have number of dungeons determined by a density noise. This is more flexible and allows mapgens to use dungeon generation to create custom structures, such as occasional mega-dungeons.
2019-06-01 21:50:43 +02:00
# 3D noise that determines number of dungeons per mapchunk.
mgv5_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[*Mapgen V6]
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Mgfractal: Add documentation to conf.example and settingtypes
2015-11-04 03:18:37 +01:00
# Map generation attributes specific to Mapgen v6.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# The 'snowbiomes' flag enables the new 5 biome system.
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# When the 'snowbiomes' flag is enabled jungles are automatically enabled and
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# the 'jungles' flag is ignored.
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
mgv6_spflags (Mapgen V6 specific flags) flags jungles,biomeblend,mudflow,snowbiomes,noflat,trees jungles,biomeblend,mudflow,snowbiomes,flat,trees,nojungles,nobiomeblend,nomudflow,nosnowbiomes,noflat,notrees
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Deserts occur when np_biome exceeds this value.
Various settingtypes.txt improvements (#8867) Improve 'readable' setting names for waving water settings. Change 'near plane' to 'near clipping plane'. Document physics settings. mgv6_spflags: Change 'new biome system' to 'snowbiomes flag' for clarity. Add missing 'noflat' flag to default flags.
2019-08-28 02:39:33 +02:00
# When the 'snowbiomes' flag is enabled, this is ignored.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv6_freq_desert (Desert noise threshold) float 0.45
# Sandy beaches occur when np_beach exceeds this value.
mgv6_freq_beach (Beach noise threshold) float 0.15
Dungeons: Add Y limits in all mapgens Preserve the upper limit used in mgvalleys.
2018-02-17 18:43:13 +01:00
# Lower Y limit of dungeons.
mgv6_dungeon_ymin (Dungeon minimum Y) int -31000
# Upper Y limit of dungeons.
mgv6_dungeon_ymax (Dungeon maximum Y) int 31000
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[**Noises]
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Y-level of lower terrain and seabed.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_terrain_base (Terrain base noise) noise_params_2d -4, 20, (250, 250, 250), 82341, 5, 0.6, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Y-level of higher terrain that creates cliffs.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_terrain_higher (Terrain higher noise) noise_params_2d 20, 16, (500, 500, 500), 85039, 5, 0.6, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Varies steepness of cliffs.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_steepness (Steepness noise) noise_params_2d 0.85, 0.5, (125, 125, 125), -932, 5, 0.7, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Defines distribution of higher terrain.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_height_select (Height select noise) noise_params_2d 0.5, 1, (250, 250, 250), 4213, 5, 0.69, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Varies depth of biome surface nodes.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_mud (Mud noise) noise_params_2d 4, 2, (200, 200, 200), 91013, 3, 0.55, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Defines areas with sandy beaches.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_beach (Beach noise) noise_params_2d 0, 1, (250, 250, 250), 59420, 3, 0.50, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Temperature variation for biomes.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_biome (Biome noise) noise_params_2d 0, 1, (500, 500, 500), 9130, 3, 0.50, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Variation of number of caves.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_cave (Cave noise) noise_params_2d 6, 6, (250, 250, 250), 34329, 3, 0.50, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Humidity variation for biomes.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_humidity (Humidity noise) noise_params_2d 0.5, 0.5, (500, 500, 500), 72384, 3, 0.50, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Defines tree areas and tree density.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_trees (Trees noise) noise_params_2d 0, 1, (125, 125, 125), 2, 4, 0.66, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Defines areas where trees have apples.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv6_np_apple_trees (Apple trees noise) noise_params_2d 0, 1, (100, 100, 100), 342902, 3, 0.45, 2.0, eased
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[*Mapgen V7]
Mgfractal: Add documentation to conf.example and settingtypes
2015-11-04 03:18:37 +01:00
# Map generation attributes specific to Mapgen v7.
Mgv7: Add option to repeat surface biomes in floatlands
2017-07-13 22:03:16 +02:00
# 'ridges' enables the rivers.
Biome API: Revert biomes, decos, ores being relative to water level Feature is unnecessary and would greatly complicate future development, it would also make 'get biome at pos' extremely complex. Mgv7: Revert option to repeat surface biomes in floatlands, which depended on the above.
2017-09-17 01:26:20 +02:00
mgv7_spflags (Mapgen V7 specific flags) flags mountains,ridges,nofloatlands,caverns mountains,ridges,floatlands,caverns,nomountains,noridges,nofloatlands,nocaverns
Improve Lua settings menu * Add key settings to setting table and ignore them later This way they are added to the auto-generated minetest.conf.example * Add flags type * Add input validation for int, float and flags * Break in-game graphic settings into multiple sections * Parse settingtpes.txt in mods and games * Improve description for a lot of settings * Fix typos and wording in settingtypes.txt * Convert language setting to an enum
2015-10-18 10:41:52 +02:00
Mgv7: Add 'mount_zero_level' parameter Allows setting of the mountain 'zero level' (y where density gradient is zero). It is easy to vertically shift smooth terrain by editing noise parameter 'offset', but vertically shifting mountain terrain was complex and imprecise, involving making a calculation based on an average of the mountain height parameter.
2017-07-24 23:50:42 +02:00
# Y of mountain density gradient zero level. Used to shift mountains vertically.
mgv7_mount_zero_level (Mountain zero level) int 0
Mapgen: Make 3D noise tunnels' width settable Correct parameter names mg_valleys to mgvalleys Remove biome NoiseParams from MapgenValleysParams Improve format of parameter code
2016-04-25 12:47:25 +02:00
# Controls width of tunnels, a smaller value creates wider tunnels.
Tunnels: Completely disable generation when 'cave width' >= 10.0 (#9093) Previously, the only way to disable the 3D noise tunnels was to set 'cave width' > 1.0, however doing so did not disable the very intensive noise calculations or the generation loop. All the other types of cave generation (randomwalk caves, caverns) can already be independently and completely disabled. This feature is now needed more because the small randomwalk caves are now available for use as an alternative to the 3D noise tunnels.
2019-11-09 03:09:52 +01:00
# Value >= 10.0 completely disables generation of tunnels and avoids the
# intensive noise calculations.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv7_cave_width (Cave width) float 0.09
Mapgen: Make 3D noise tunnels' width settable Correct parameter names mg_valleys to mgvalleys Remove biome NoiseParams from MapgenValleysParams Improve format of parameter code
2016-04-25 12:47:25 +02:00
CavesRandomWalk: Make 'lava_depth' a mapgen parameter As with 'large_cave_depth', lava depth was previously a fixed y value and therefore incompatible with the ability to shift terrain vertically. Add 'lava_depth' mapgen parameter to mgflat, mgfractal, mgv5, mgv7.
2017-06-21 05:20:18 +02:00
# Y of upper limit of large caves.
Mgv5/v7/fractal: Add 'large_cave_depth' parameter to replace fixed value The value cannot be fixed because we can shift terrain vertically. This also makes these mapgens consistent with mgflat and mgvalleys which have 'large_cave_depth' parameters.
2017-06-20 05:55:32 +02:00
mgv7_large_cave_depth (Large cave depth) int -33
Randomwalk caves: Add parameters for number, proportion flooded. Allow small caves (#8928) Add mapgen parameters to set the range of the random number of randomwalk caves per mapchunk, and to set the proportion that are flooded with liquids. Default values are, for now, unchanged from the previous hardcoded values. Add parameters to allow small randomwalk caves Disabled by default for now as they have never been present in the non-mgv6 mapgens.
2019-11-08 04:09:43 +01:00
# Minimum limit of random number of small caves per mapchunk.
mgv7_small_cave_num_min (Small cave minimum number) int 0 0 256
# Maximum limit of random number of small caves per mapchunk.
mgv7_small_cave_num_max (Small cave maximum number) int 0 0 256
# Minimum limit of random number of large caves per mapchunk.
mgv7_large_cave_num_min (Large cave minimum number) int 0 0 64
# Maximum limit of random number of large caves per mapchunk.
mgv7_large_cave_num_max (Large cave maximum number) int 2 0 64
# Proportion of large caves that contain liquid.
mgv7_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
Mgv7: Add docs for the new floatland exponent parameter
2018-01-04 01:41:36 +01:00
# Controls the density of mountain-type floatlands.
# Is a noise offset added to the 'mgv7_np_mountain' noise value.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv7_float_mount_density (Floatland mountain density) float 0.6
Mgv7: Add optional floatlands, disabled by default
2016-09-16 05:59:25 +02:00
Mgv7: Add docs for the new floatland exponent parameter
2018-01-04 01:41:36 +01:00
# Typical maximum height, above and below midpoint, of floatland mountains.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv7_float_mount_height (Floatland mountain height) float 128.0
Mgv7: Add optional floatlands, disabled by default
2016-09-16 05:59:25 +02:00
Mgv7: Add docs for the new floatland exponent parameter
2018-01-04 01:41:36 +01:00
# Alters how mountain-type floatlands taper above and below midpoint.
mgv7_float_mount_exponent (Floatland mountain exponent) float 0.75
Mgv7: Add optional floatlands, disabled by default
2016-09-16 05:59:25 +02:00
# Y-level of floatland midpoint and lake surface.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv7_floatland_level (Floatland level) int 1280
Mgv7: Add optional floatlands, disabled by default
2016-09-16 05:59:25 +02:00
# Y-level to which floatland shadows extend.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv7_shadow_limit (Shadow limit) int 1024
Mgv7: Add optional floatlands, disabled by default
2016-09-16 05:59:25 +02:00
Cavegen/Mgv5/Mgv7: Add optional giant caverns Add to MapgenBasic for use by multiple mapgens. Add to mgv5 and mgv7, enabled by default. Similar to mgvalleys caverns but half the scale. Parameters for upper y limit, distance caverns taper to full size, and noise threshold (full cavern size). As with mgvalleys caverns are generated first and classic caves are disabled in any mapchunk containing a cavern, to avoid excessive spreading volumes of liquids. This also avoids floating blobs of liquid where a large classic cave has overgenerated out into a neighbouring previously-generated mapchunk.
2017-03-12 14:26:09 +01:00
# Y-level of cavern upper limit.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv7_cavern_limit (Cavern limit) int -256
Cavegen/Mgv5/Mgv7: Add optional giant caverns Add to MapgenBasic for use by multiple mapgens. Add to mgv5 and mgv7, enabled by default. Similar to mgvalleys caverns but half the scale. Parameters for upper y limit, distance caverns taper to full size, and noise threshold (full cavern size). As with mgvalleys caverns are generated first and classic caves are disabled in any mapchunk containing a cavern, to avoid excessive spreading volumes of liquids. This also avoids floating blobs of liquid where a large classic cave has overgenerated out into a neighbouring previously-generated mapchunk.
2017-03-12 14:26:09 +01:00
# Y-distance over which caverns expand to full size.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv7_cavern_taper (Cavern taper) int 256
Cavegen/Mgv5/Mgv7: Add optional giant caverns Add to MapgenBasic for use by multiple mapgens. Add to mgv5 and mgv7, enabled by default. Similar to mgvalleys caverns but half the scale. Parameters for upper y limit, distance caverns taper to full size, and noise threshold (full cavern size). As with mgvalleys caverns are generated first and classic caves are disabled in any mapchunk containing a cavern, to avoid excessive spreading volumes of liquids. This also avoids floating blobs of liquid where a large classic cave has overgenerated out into a neighbouring previously-generated mapchunk.
2017-03-12 14:26:09 +01:00
# Defines full size of caverns, smaller values create larger caverns.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgv7_cavern_threshold (Cavern threshold) float 0.7
Dungeons: Add Y limits in all mapgens Preserve the upper limit used in mgvalleys.
2018-02-17 18:43:13 +01:00
# Lower Y limit of dungeons.
mgv7_dungeon_ymin (Dungeon minimum Y) int -31000
# Upper Y limit of dungeons.
mgv7_dungeon_ymax (Dungeon maximum Y) int 31000
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[**Noises]
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Y-level of higher terrain that creates cliffs.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_terrain_base (Terrain base noise) noise_params_2d 4, 70, (600, 600, 600), 82341, 5, 0.6, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Y-level of lower terrain and seabed.
mgv7_np_terrain_alt (Terrain alternative noise) noise_params_2d 4, 25, (600, 600, 600), 5934, 5, 0.6, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Varies roughness of terrain.
# Defines the 'persistence' value for terrain_base and terrain_alt noises.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_terrain_persist (Terrain persistence noise) noise_params_2d 0.6, 0.1, (2000, 2000, 2000), 539, 3, 0.6, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Defines distribution of higher terrain and steepness of cliffs.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_height_select (Height select noise) noise_params_2d -8, 16, (500, 500, 500), 4213, 6, 0.7, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Variation of biome filler depth.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_filler_depth (Filler depth noise) noise_params_2d 0, 1.2, (150, 150, 150), 261, 3, 0.7, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Variation of maximum mountain height (in nodes).
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_mount_height (Mountain height noise) noise_params_2d 256, 112, (1000, 1000, 1000), 72449, 3, 0.6, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Defines large-scale river channel structure.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_ridge_uwater (Ridge underwater noise) noise_params_2d 0, 1, (1000, 1000, 1000), 85039, 5, 0.6, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Defines areas of floatland smooth terrain.
# Smooth floatlands occur when noise > 0.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_floatland_base (Floatland base noise) noise_params_2d -0.6, 1.5, (600, 600, 600), 114, 5, 0.6, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Variation of hill height and lake depth on floatland smooth terrain.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_float_base_height (Floatland base height noise) noise_params_2d 48, 24, (300, 300, 300), 907, 4, 0.7, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# 3D noise defining mountain structure and height.
# Also defines structure of floatland mountain terrain.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_mountain (Mountain noise) noise_params_3d -0.6, 1, (250, 350, 250), 5333, 5, 0.63, 2.0
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# 3D noise defining structure of river canyon walls.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_ridge (Ridge noise) noise_params_3d 0, 1, (100, 100, 100), 6467, 4, 0.75, 2.0
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# 3D noise defining giant caverns.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_cavern (Cavern noise) noise_params_3d 0, 1, (384, 128, 384), 723, 5, 0.63, 2.0
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# First of two 3D noises that together define tunnels.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_cave1 (Cave1 noise) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Second of two 3D noises that together define tunnels.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgv7_np_cave2 (Cave2 noise) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Dungeons: Settable density noise, move number calculation to mapgens (#8473) Add user-settable noise parameters for dungeon density to each mapgen, except V6 which hardcodes this noise parameter. Move the calculation of number of dungeons generated in a mapchunk out of dungeongen.cpp and into mapgen code, to allow mapgens to generate any desired number of dungeons in a mapchunk, instead of being forced to have number of dungeons determined by a density noise. This is more flexible and allows mapgens to use dungeon generation to create custom structures, such as occasional mega-dungeons.
2019-06-01 21:50:43 +02:00
# 3D noise that determines number of dungeons per mapchunk.
mgv7_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[*Mapgen Carpathian]
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
# Map generation attributes specific to Mapgen Carpathian.
All settings: Fix missing flags checkbox caused by 'possible flags' order (#8997) Previously, the 'rivers' checkbox was missing for mgcarpathian, caused by the 'possible flags' order: 'caverns,nocaverns,rivers,norivers'. Also reorder mgcarpathian 'possible flags', but only for consistency.
2019-09-27 20:13:08 +02:00
mgcarpathian_spflags (Mapgen Carpathian specific flags) flags caverns,norivers caverns,rivers,nocaverns,norivers
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Mgcarpathian: Remove insignificant 'base' noise variation (#7209) Was only +-1 node over a scale of thousands of nodes. Replace with 'base_level' parameter value.
2018-04-05 22:52:10 +02:00
# Defines the base ground level.
mgcarpathian_base_level (Base ground level) float 12.0
Mapgen Carpathian: Add optional rivers (#7977) Rivers are disabled by default and will not be added to existing worlds. Rewrite getSpawnLevelAtPoint() to be simpler and more consistent with generateTerrain().
2019-06-19 02:06:08 +02:00
# Defines the width of the river channel.
mgcarpathian_river_width (River channel width) float 0.05
# Defines the depth of the river channel.
mgcarpathian_river_depth (River channel depth) float 24.0
# Defines the width of the river valley.
mgcarpathian_valley_width (River valley width) float 0.25
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
# Controls width of tunnels, a smaller value creates wider tunnels.
Tunnels: Completely disable generation when 'cave width' >= 10.0 (#9093) Previously, the only way to disable the 3D noise tunnels was to set 'cave width' > 1.0, however doing so did not disable the very intensive noise calculations or the generation loop. All the other types of cave generation (randomwalk caves, caverns) can already be independently and completely disabled. This feature is now needed more because the small randomwalk caves are now available for use as an alternative to the 3D noise tunnels.
2019-11-09 03:09:52 +01:00
# Value >= 10.0 completely disables generation of tunnels and avoids the
# intensive noise calculations.
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
mgcarpathian_cave_width (Cave width) float 0.09
Mapgen Carpathian: Add lava_depth parameter
2017-07-07 05:49:55 +02:00
# Y of upper limit of large caves.
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
mgcarpathian_large_cave_depth (Large cave depth) int -33
Randomwalk caves: Add parameters for number, proportion flooded. Allow small caves (#8928) Add mapgen parameters to set the range of the random number of randomwalk caves per mapchunk, and to set the proportion that are flooded with liquids. Default values are, for now, unchanged from the previous hardcoded values. Add parameters to allow small randomwalk caves Disabled by default for now as they have never been present in the non-mgv6 mapgens.
2019-11-08 04:09:43 +01:00
# Minimum limit of random number of small caves per mapchunk.
mgcarpathian_small_cave_num_min (Small cave minimum number) int 0 0 256
# Maximum limit of random number of small caves per mapchunk.
mgcarpathian_small_cave_num_max (Small cave maximum number) int 0 0 256
# Minimum limit of random number of large caves per mapchunk.
mgcarpathian_large_cave_num_min (Large cave minimum number) int 0 0 64
# Maximum limit of random number of large caves per mapchunk.
mgcarpathian_large_cave_num_max (Large cave maximum number) int 2 0 64
# Proportion of large caves that contain liquid.
mgcarpathian_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
# Y-level of cavern upper limit.
mgcarpathian_cavern_limit (Cavern limit) int -256
# Y-distance over which caverns expand to full size.
mgcarpathian_cavern_taper (Cavern taper) int 256
# Defines full size of caverns, smaller values create larger caverns.
mgcarpathian_cavern_threshold (Cavern threshold) float 0.7
Dungeons: Add Y limits in all mapgens Preserve the upper limit used in mgvalleys.
2018-02-17 18:43:13 +01:00
# Lower Y limit of dungeons.
mgcarpathian_dungeon_ymin (Dungeon minimum Y) int -31000
# Upper Y limit of dungeons.
mgcarpathian_dungeon_ymax (Dungeon maximum Y) int 31000
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[**Noises]
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
# Variation of biome filler depth.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_filler_depth (Filler depth noise) noise_params_2d 0, 1, (128, 128, 128), 261, 3, 0.7, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
# First of 4 2D noises that together define hill/mountain range height.
mgcarpathian_np_height1 (Hilliness1 noise) noise_params_2d 0, 5, (251, 251, 251), 9613, 5, 0.5, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
# Second of 4 2D noises that together define hill/mountain range height.
mgcarpathian_np_height2 (Hilliness2 noise) noise_params_2d 0, 5, (383, 383, 383), 1949, 5, 0.5, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
# Third of 4 2D noises that together define hill/mountain range height.
mgcarpathian_np_height3 (Hilliness3 noise) noise_params_2d 0, 5, (509, 509, 509), 3211, 5, 0.5, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
# Fourth of 4 2D noises that together define hill/mountain range height.
mgcarpathian_np_height4 (Hilliness4 noise) noise_params_2d 0, 5, (631, 631, 631), 1583, 5, 0.5, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Make advanced settings noiseparams strings translatable (#8062) Various minor language improvements in settingtypes.txt.
2019-01-20 19:49:17 +01:00
# 2D noise that controls the size/occurrence of rolling hills.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_hills_terrain (Rolling hills spread noise) noise_params_2d 1, 1, (1301, 1301, 1301), 1692, 3, 0.5, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Make advanced settings noiseparams strings translatable (#8062) Various minor language improvements in settingtypes.txt.
2019-01-20 19:49:17 +01:00
# 2D noise that controls the size/occurrence of ridged mountain ranges.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_ridge_terrain (Ridge mountain spread noise) noise_params_2d 1, 1, (1889, 1889, 1889), 3568, 3, 0.5, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Make advanced settings noiseparams strings translatable (#8062) Various minor language improvements in settingtypes.txt.
2019-01-20 19:49:17 +01:00
# 2D noise that controls the size/occurrence of step mountain ranges.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_step_terrain (Step mountain spread noise) noise_params_2d 1, 1, (1889, 1889, 1889), 4157, 3, 0.5, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
# 2D noise that controls the shape/size of rolling hills.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_hills (Rolling hill size noise) noise_params_2d 0, 3, (257, 257, 257), 6604, 6, 0.5, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
# 2D noise that controls the shape/size of ridged mountains.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_ridge_mnt (Ridged mountain size noise) noise_params_2d 0, 12, (743, 743, 743), 5520, 6, 0.7, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
# 2D noise that controls the shape/size of step mountains.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_step_mnt (Step mountain size noise) noise_params_2d 0, 8, (509, 509, 509), 2590, 6, 0.6, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Mapgen Carpathian: Add optional rivers (#7977) Rivers are disabled by default and will not be added to existing worlds. Rewrite getSpawnLevelAtPoint() to be simpler and more consistent with generateTerrain().
2019-06-19 02:06:08 +02:00
# 2D noise that locates the river valleys and channels.
mgcarpathian_np_rivers (River noise) noise_params_2d 0, 1, (1000, 1000, 1000), 85039, 5, 0.6, 2.0, eased
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
# 3D noise for mountain overhangs, cliffs, etc. Usually small variations.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_mnt_var (Mountain variation noise) noise_params_3d 0, 1, (499, 499, 499), 2490, 5, 0.55, 2.0
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# First of two 3D noises that together define tunnels.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_cave1 (Cave1 noise) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Second of two 3D noises that together define tunnels.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_cave2 (Cave2 noise) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
# 3D noise defining giant caverns.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgcarpathian_np_cavern (Cavern noise) noise_params_3d 0, 1, (384, 128, 384), 723, 5, 0.63, 2.0
Mapgen: Add Carpathian mapgen (#6015)
2017-07-06 13:53:56 +02:00
Dungeons: Settable density noise, move number calculation to mapgens (#8473) Add user-settable noise parameters for dungeon density to each mapgen, except V6 which hardcodes this noise parameter. Move the calculation of number of dungeons generated in a mapchunk out of dungeongen.cpp and into mapgen code, to allow mapgens to generate any desired number of dungeons in a mapchunk, instead of being forced to have number of dungeons determined by a density noise. This is more flexible and allows mapgens to use dungeon generation to create custom structures, such as occasional mega-dungeons.
2019-06-01 21:50:43 +02:00
# 3D noise that determines number of dungeons per mapchunk.
mgcarpathian_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[*Mapgen Flat]
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
Settingtypes.txt: Various improvements (#9047)
2019-10-14 04:30:54 +02:00
# Map generation attributes specific to Mapgen Flat.
Documentation: Clarify global and mapgen-specific mapgen flags
2016-03-11 17:24:55 +01:00
# Occasional lakes and hills can be added to the flat world.
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
mgflat_spflags (Mapgen Flat specific flags) flags nolakes,nohills lakes,hills,nolakes,nohills
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
# Y of flat ground.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgflat_ground_level (Ground level) int 8
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
CavesRandomWalk: Make 'lava_depth' a mapgen parameter As with 'large_cave_depth', lava depth was previously a fixed y value and therefore incompatible with the ability to shift terrain vertically. Add 'lava_depth' mapgen parameter to mgflat, mgfractal, mgv5, mgv7.
2017-06-21 05:20:18 +02:00
# Y of upper limit of large caves.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgflat_large_cave_depth (Large cave depth) int -33
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
Randomwalk caves: Add parameters for number, proportion flooded. Allow small caves (#8928) Add mapgen parameters to set the range of the random number of randomwalk caves per mapchunk, and to set the proportion that are flooded with liquids. Default values are, for now, unchanged from the previous hardcoded values. Add parameters to allow small randomwalk caves Disabled by default for now as they have never been present in the non-mgv6 mapgens.
2019-11-08 04:09:43 +01:00
# Minimum limit of random number of small caves per mapchunk.
mgflat_small_cave_num_min (Small cave minimum number) int 0 0 256
# Maximum limit of random number of small caves per mapchunk.
mgflat_small_cave_num_max (Small cave maximum number) int 0 0 256
# Minimum limit of random number of large caves per mapchunk.
mgflat_large_cave_num_min (Large cave minimum number) int 0 0 64
# Maximum limit of random number of large caves per mapchunk.
mgflat_large_cave_num_max (Large cave maximum number) int 2 0 64
# Proportion of large caves that contain liquid.
mgflat_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
Mapgen: Make 3D noise tunnels' width settable Correct parameter names mg_valleys to mgvalleys Remove biome NoiseParams from MapgenValleysParams Improve format of parameter code
2016-04-25 12:47:25 +02:00
# Controls width of tunnels, a smaller value creates wider tunnels.
Tunnels: Completely disable generation when 'cave width' >= 10.0 (#9093) Previously, the only way to disable the 3D noise tunnels was to set 'cave width' > 1.0, however doing so did not disable the very intensive noise calculations or the generation loop. All the other types of cave generation (randomwalk caves, caverns) can already be independently and completely disabled. This feature is now needed more because the small randomwalk caves are now available for use as an alternative to the 3D noise tunnels.
2019-11-09 03:09:52 +01:00
# Value >= 10.0 completely disables generation of tunnels and avoids the
# intensive noise calculations.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgflat_cave_width (Cave width) float 0.09
Mapgen: Make 3D noise tunnels' width settable Correct parameter names mg_valleys to mgvalleys Remove biome NoiseParams from MapgenValleysParams Improve format of parameter code
2016-04-25 12:47:25 +02:00
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
# Terrain noise threshold for lakes.
# Controls proportion of world area covered by lakes.
# Adjust towards 0.0 for a larger proportion.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgflat_lake_threshold (Lake threshold) float -0.45
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
# Controls steepness/depth of lake depressions.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgflat_lake_steepness (Lake steepness) float 48.0
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
# Terrain noise threshold for hills.
# Controls proportion of world area covered by hills.
# Adjust towards 0.0 for a larger proportion.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgflat_hill_threshold (Hill threshold) float 0.45
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
# Controls steepness/height of hills.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgflat_hill_steepness (Hill steepness) float 64.0
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
Dungeons: Add Y limits in all mapgens Preserve the upper limit used in mgvalleys.
2018-02-17 18:43:13 +01:00
# Lower Y limit of dungeons.
mgflat_dungeon_ymin (Dungeon minimum Y) int -31000
# Upper Y limit of dungeons.
mgflat_dungeon_ymax (Dungeon maximum Y) int 31000
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[**Noises]
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Defines location and terrain of optional hills and lakes.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgflat_np_terrain (Terrain noise) noise_params_2d 0, 1, (600, 600, 600), 7244, 5, 0.6, 2.0, eased
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Variation of biome filler depth.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgflat_np_filler_depth (Filler depth noise) noise_params_2d 0, 1.2, (150, 150, 150), 261, 3, 0.7, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# First of two 3D noises that together define tunnels.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgflat_np_cave1 (Cave1 noise) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Second of two 3D noises that together define tunnels.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgflat_np_cave2 (Cave2 noise) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
Mapgen: Add flat mapgen in hidden form
2015-10-30 03:45:38 +01:00
Dungeons: Settable density noise, move number calculation to mapgens (#8473) Add user-settable noise parameters for dungeon density to each mapgen, except V6 which hardcodes this noise parameter. Move the calculation of number of dungeons generated in a mapchunk out of dungeongen.cpp and into mapgen code, to allow mapgens to generate any desired number of dungeons in a mapchunk, instead of being forced to have number of dungeons determined by a density noise. This is more flexible and allows mapgens to use dungeon generation to create custom structures, such as occasional mega-dungeons.
2019-06-01 21:50:43 +02:00
# 3D noise that determines number of dungeons per mapchunk.
mgflat_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[*Mapgen Fractal]
Mgfractal: Add documentation to conf.example and settingtypes
2015-11-04 03:18:37 +01:00
Settingtypes.txt: Various improvements (#9047)
2019-10-14 04:30:54 +02:00
# Map generation attributes specific to Mapgen Fractal.
Mgfractal: Make non-fractal terrain optional (#8702) Enabled by default. Only allow spawn on fractal, not on seabed terrain. Various codestyle and comment improvements.
2019-07-25 20:58:35 +02:00
# 'terrain' enables the generation of non-fractal terrain:
# ocean, islands and underground.
mgfractal_spflags (Mapgen Fractal specific flags) flags terrain terrain,noterrain
Mapgen: Make 3D noise tunnels' width settable Correct parameter names mg_valleys to mgvalleys Remove biome NoiseParams from MapgenValleysParams Improve format of parameter code
2016-04-25 12:47:25 +02:00
# Controls width of tunnels, a smaller value creates wider tunnels.
Tunnels: Completely disable generation when 'cave width' >= 10.0 (#9093) Previously, the only way to disable the 3D noise tunnels was to set 'cave width' > 1.0, however doing so did not disable the very intensive noise calculations or the generation loop. All the other types of cave generation (randomwalk caves, caverns) can already be independently and completely disabled. This feature is now needed more because the small randomwalk caves are now available for use as an alternative to the 3D noise tunnels.
2019-11-09 03:09:52 +01:00
# Value >= 10.0 completely disables generation of tunnels and avoids the
# intensive noise calculations.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgfractal_cave_width (Cave width) float 0.09
Mapgen: Make 3D noise tunnels' width settable Correct parameter names mg_valleys to mgvalleys Remove biome NoiseParams from MapgenValleysParams Improve format of parameter code
2016-04-25 12:47:25 +02:00
CavesRandomWalk: Make 'lava_depth' a mapgen parameter As with 'large_cave_depth', lava depth was previously a fixed y value and therefore incompatible with the ability to shift terrain vertically. Add 'lava_depth' mapgen parameter to mgflat, mgfractal, mgv5, mgv7.
2017-06-21 05:20:18 +02:00
# Y of upper limit of large caves.
Mgv5/v7/fractal: Add 'large_cave_depth' parameter to replace fixed value The value cannot be fixed because we can shift terrain vertically. This also makes these mapgens consistent with mgflat and mgvalleys which have 'large_cave_depth' parameters.
2017-06-20 05:55:32 +02:00
mgfractal_large_cave_depth (Large cave depth) int -33
Randomwalk caves: Add parameters for number, proportion flooded. Allow small caves (#8928) Add mapgen parameters to set the range of the random number of randomwalk caves per mapchunk, and to set the proportion that are flooded with liquids. Default values are, for now, unchanged from the previous hardcoded values. Add parameters to allow small randomwalk caves Disabled by default for now as they have never been present in the non-mgv6 mapgens.
2019-11-08 04:09:43 +01:00
# Minimum limit of random number of small caves per mapchunk.
mgfractal_small_cave_num_min (Small cave minimum number) int 0 0 256
# Maximum limit of random number of small caves per mapchunk.
mgfractal_small_cave_num_max (Small cave maximum number) int 0 0 256
# Minimum limit of random number of large caves per mapchunk.
mgfractal_large_cave_num_min (Large cave minimum number) int 0 0 64
# Maximum limit of random number of large caves per mapchunk.
mgfractal_large_cave_num_max (Large cave maximum number) int 2 0 64
# Proportion of large caves that contain liquid.
mgfractal_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
Dungeons: Add Y limits in all mapgens Preserve the upper limit used in mgvalleys.
2018-02-17 18:43:13 +01:00
# Lower Y limit of dungeons.
mgfractal_dungeon_ymin (Dungeon minimum Y) int -31000
# Upper Y limit of dungeons.
mgfractal_dungeon_ymax (Dungeon maximum Y) int 31000
Mgfractal / chunksize: Improve documentation
2018-03-20 03:30:25 +01:00
# Selects one of 18 fractal types.
Settingtypes.txt: Various improvements (#9047)
2019-10-14 04:30:54 +02:00
# 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.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgfractal_fractal (Fractal type) int 1 1 18
Mgfractal: Create a choice of 4 mandelbrot formulas
2015-11-11 06:05:20 +01:00
Mgfractal: Revert unnecessary duplication of parameters
2015-11-14 10:18:01 +01:00
# Iterations of the recursive function.
Mgfractal / chunksize: Improve documentation
2018-03-20 03:30:25 +01:00
# Increasing this increases the amount of fine detail, but also
# increases processing load.
# At iterations = 20 this mapgen has a similar load to mapgen V7.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgfractal_iterations (Iterations) int 11
Settingtypes: Correct documentation for mgfractal Use type 'string' for v3fs and add comments
2015-11-05 00:07:29 +01:00
Mgfractal / chunksize: Improve documentation
2018-03-20 03:30:25 +01:00
# (X,Y,Z) scale of fractal in nodes.
# Actual fractal size will be 2 to 3 times larger.
# These numbers can be made very large, the fractal does
# not have to fit inside the world.
# Increase these to 'zoom' into the detail of the fractal.
# Default is for a vertically-squashed shape suitable for
# an island, set all 3 numbers equal for the raw shape.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgfractal_scale (Scale) v3f (4096.0, 1024.0, 4096.0)
Settingtypes: Correct documentation for mgfractal Use type 'string' for v3fs and add comments
2015-11-05 00:07:29 +01:00
Fix spelling of setting descriptions (#7829)
2018-12-02 15:33:49 +01:00
# (X,Y,Z) offset of fractal from world center in units of 'scale'.
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# Can be used to move a desired point to (0, 0) to create a
Mgfractal / chunksize: Improve documentation
2018-03-20 03:30:25 +01:00
# suitable spawn point, or to allow 'zooming in' on a desired
# point by increasing 'scale'.
Settingtypes.txt: Various improvements (#9047)
2019-10-14 04:30:54 +02:00
# The default is tuned for a suitable spawn point for Mandelbrot
Mgfractal / chunksize: Improve documentation
2018-03-20 03:30:25 +01:00
# sets with default parameters, it may need altering in other
# situations.
Mgfractal: Move julia set selection into formula parameter Improve default parameters Update and improve documentation Unhide mapgen, but is still unstable
2015-11-21 21:22:45 +01:00
# Range roughly -2 to 2. Multiply by 'scale' for offset in nodes.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgfractal_offset (Offset) v3f (1.79, 0.0, 0.0)
Mgfractal: Add documentation to conf.example and settingtypes
2015-11-04 03:18:37 +01:00
Fix spelling of setting descriptions (#7829)
2018-12-02 15:33:49 +01:00
# W coordinate of the generated 3D slice of a 4D fractal.
Mgfractal: Add 3D and 4D fractals 3D Mandelbrot/Mandelbar 3D Christmas Tree 3D Mandelbulb 3D Cosine Mandelbulb 4D Mandelbulb Plus corresponding julia set for each Add credits for formulas Rename parameter 'formula' to 'fractal' Speed optimisations
2015-12-08 06:40:36 +01:00
# Determines which 3D slice of the 4D shape is generated.
Mgfractal / chunksize: Improve documentation
2018-03-20 03:30:25 +01:00
# Alters the shape of the fractal.
Mgfractal: Add 3D and 4D fractals 3D Mandelbrot/Mandelbar 3D Christmas Tree 3D Mandelbulb 3D Cosine Mandelbulb 4D Mandelbulb Plus corresponding julia set for each Add credits for formulas Rename parameter 'formula' to 'fractal' Speed optimisations
2015-12-08 06:40:36 +01:00
# Has no effect on 3D fractals.
Conf.example, settingtypes: Improve mgfractal documentation
2015-11-06 09:38:01 +01:00
# Range roughly -2 to 2.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgfractal_slice_w (Slice w) float 0.0
Mgfractal: Add documentation to conf.example and settingtypes
2015-11-04 03:18:37 +01:00
Mgfractal / chunksize: Improve documentation
2018-03-20 03:30:25 +01:00
# Julia set only.
# X component of hypercomplex constant.
# Alters the shape of the fractal.
Conf.example, settingtypes: Improve mgfractal documentation
2015-11-06 09:38:01 +01:00
# Range roughly -2 to 2.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgfractal_julia_x (Julia x) float 0.33
Mgfractal: Add documentation to conf.example and settingtypes
2015-11-04 03:18:37 +01:00
Mgfractal / chunksize: Improve documentation
2018-03-20 03:30:25 +01:00
# Julia set only.
# Y component of hypercomplex constant.
# Alters the shape of the fractal.
Conf.example, settingtypes: Improve mgfractal documentation
2015-11-06 09:38:01 +01:00
# Range roughly -2 to 2.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgfractal_julia_y (Julia y) float 0.33
Mgfractal: Add documentation to conf.example and settingtypes
2015-11-04 03:18:37 +01:00
Mgfractal / chunksize: Improve documentation
2018-03-20 03:30:25 +01:00
# Julia set only.
# Z component of hypercomplex constant.
# Alters the shape of the fractal.
Conf.example, settingtypes: Improve mgfractal documentation
2015-11-06 09:38:01 +01:00
# Range roughly -2 to 2.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgfractal_julia_z (Julia z) float 0.33
Mgfractal: Add documentation to conf.example and settingtypes
2015-11-04 03:18:37 +01:00
Mgfractal / chunksize: Improve documentation
2018-03-20 03:30:25 +01:00
# Julia set only.
# W component of hypercomplex constant.
# Alters the shape of the fractal.
Mgfractal: Add 3D and 4D fractals 3D Mandelbrot/Mandelbar 3D Christmas Tree 3D Mandelbulb 3D Cosine Mandelbulb 4D Mandelbulb Plus corresponding julia set for each Add credits for formulas Rename parameter 'formula' to 'fractal' Speed optimisations
2015-12-08 06:40:36 +01:00
# Has no effect on 3D fractals.
Conf.example, settingtypes: Improve mgfractal documentation
2015-11-06 09:38:01 +01:00
# Range roughly -2 to 2.
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
mgfractal_julia_w (Julia w) float 0.33
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[**Noises]
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Y-level of seabed.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgfractal_np_seabed (Seabed noise) noise_params_2d -14, 9, (600, 600, 600), 41900, 5, 0.6, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
# Variation of biome filler depth.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgfractal_np_filler_depth (Filler depth noise) noise_params_2d 0, 1.2, (150, 150, 150), 261, 3, 0.7, 2.0, eased
Mapgen documentation: Add descriptions to noise parameters Shorten 'readable names'. Add a new advanced settings menu section for Biome API noises. Various minor edits and improvements.
2017-04-04 12:59:52 +02:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# First of two 3D noises that together define tunnels.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgfractal_np_cave1 (Cave1 noise) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
Mgfractal: Add documentation to conf.example and settingtypes
2015-11-04 03:18:37 +01:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Second of two 3D noises that together define tunnels.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgfractal_np_cave2 (Cave2 noise) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
Mgfractal: Add documentation to conf.example and settingtypes
2015-11-04 03:18:37 +01:00
Dungeons: Settable density noise, move number calculation to mapgens (#8473) Add user-settable noise parameters for dungeon density to each mapgen, except V6 which hardcodes this noise parameter. Move the calculation of number of dungeons generated in a mapchunk out of dungeongen.cpp and into mapgen code, to allow mapgens to generate any desired number of dungeons in a mapchunk, instead of being forced to have number of dungeons determined by a density noise. This is more flexible and allows mapgens to use dungeon generation to create custom structures, such as occasional mega-dungeons.
2019-06-01 21:50:43 +02:00
# 3D noise that determines number of dungeons per mapchunk.
mgfractal_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[*Mapgen Valleys]
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
# Map generation attributes specific to Mapgen Valleys.
Mgvalleys: Make river depth variation and humidity drop optional (#7532) Add 2 new mapgen flags to make river depth variation and humidity drop with altitude independently optional, instead of both being enabled by the 'humid rivers' flag. Simplify and clarify related code by removing a low priority optimisation regarding 't_heat'. Remove unnecessary optimisation bools and use spflags directly instead. Improve and fix documentation in settingtypes.txt. A few minor code cleanups.
2018-07-18 04:34:05 +02:00
# 'altitude_chill': Reduces heat with altitude.
Make advanced settings noiseparams strings translatable (#8062) Various minor language improvements in settingtypes.txt.
2019-01-20 19:49:17 +01:00
# 'humid_rivers': Increases humidity around rivers.
Mgvalleys: Make river depth variation and humidity drop optional (#7532) Add 2 new mapgen flags to make river depth variation and humidity drop with altitude independently optional, instead of both being enabled by the 'humid rivers' flag. Simplify and clarify related code by removing a low priority optimisation regarding 't_heat'. Remove unnecessary optimisation bools and use spflags directly instead. Improve and fix documentation in settingtypes.txt. A few minor code cleanups.
2018-07-18 04:34:05 +02:00
# 'vary_river_depth': If enabled, low humidity and high heat causes rivers
# to become shallower and occasionally dry.
# 'altitude_dry': Reduces humidity with altitude.
'All Settings': Don't use checkboxes for 'no...' mapgen flags (#7847)
2019-09-01 23:43:41 +02:00
mgvalleys_spflags (Mapgen Valleys specific flags) flags altitude_chill,humid_rivers,vary_river_depth,altitude_dry altitude_chill,humid_rivers,vary_river_depth,altitude_dry,noaltitude_chill,nohumid_rivers,novary_river_depth,noaltitude_dry
Mgvalleys: Make river depth variation and humidity drop optional (#7532) Add 2 new mapgen flags to make river depth variation and humidity drop with altitude independently optional, instead of both being enabled by the 'humid rivers' flag. Simplify and clarify related code by removing a low priority optimisation regarding 't_heat'. Remove unnecessary optimisation bools and use spflags directly instead. Improve and fix documentation in settingtypes.txt. A few minor code cleanups.
2018-07-18 04:34:05 +02:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# The vertical distance over which heat drops by 20 if 'altitude_chill' is
# enabled. Also the vertical distance over which humidity drops by 10 if
# 'altitude_dry' is enabled.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
mgvalleys_altitude_chill (Altitude chill) int 90
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Depth below which you'll find large caves.
Mapgen: Make 3D noise tunnels' width settable Correct parameter names mg_valleys to mgvalleys Remove biome NoiseParams from MapgenValleysParams Improve format of parameter code
2016-04-25 12:47:25 +02:00
mgvalleys_large_cave_depth (Large cave depth) int -33
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Randomwalk caves: Add parameters for number, proportion flooded. Allow small caves (#8928) Add mapgen parameters to set the range of the random number of randomwalk caves per mapchunk, and to set the proportion that are flooded with liquids. Default values are, for now, unchanged from the previous hardcoded values. Add parameters to allow small randomwalk caves Disabled by default for now as they have never been present in the non-mgv6 mapgens.
2019-11-08 04:09:43 +01:00
# Minimum limit of random number of small caves per mapchunk.
mgvalleys_small_cave_num_min (Small cave minimum number) int 0 0 256
# Maximum limit of random number of small caves per mapchunk.
mgvalleys_small_cave_num_max (Small cave maximum number) int 0 0 256
# Minimum limit of random number of large caves per mapchunk.
mgvalleys_large_cave_num_min (Large cave minimum number) int 0 0 64
# Maximum limit of random number of large caves per mapchunk.
mgvalleys_large_cave_num_max (Large cave maximum number) int 2 0 64
# Proportion of large caves that contain liquid.
mgvalleys_large_cave_flooded (Large cave proportion flooded) float 0.5 0.0 1.0
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Depth below which you'll find giant caverns.
Mgvalleys: Update settingtypes.txt
2018-04-24 03:25:51 +02:00
mgvalleys_cavern_limit (Cavern upper limit) int -256
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Y-distance over which caverns expand to full size.
Mgvalleys: Update settingtypes.txt
2018-04-24 03:25:51 +02:00
mgvalleys_cavern_taper (Cavern taper) int 192
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Defines full size of caverns, smaller values create larger caverns.
Mgvalleys: Update settingtypes.txt
2018-04-24 03:25:51 +02:00
mgvalleys_cavern_threshold (Cavern threshold) float 0.6
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# How deep to make rivers.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
mgvalleys_river_depth (River depth) int 4
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# How wide to make rivers.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
mgvalleys_river_size (River size) int 5
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Mapgen: Make 3D noise tunnels' width settable Correct parameter names mg_valleys to mgvalleys Remove biome NoiseParams from MapgenValleysParams Improve format of parameter code
2016-04-25 12:47:25 +02:00
# Controls width of tunnels, a smaller value creates wider tunnels.
Tunnels: Completely disable generation when 'cave width' >= 10.0 (#9093) Previously, the only way to disable the 3D noise tunnels was to set 'cave width' > 1.0, however doing so did not disable the very intensive noise calculations or the generation loop. All the other types of cave generation (randomwalk caves, caverns) can already be independently and completely disabled. This feature is now needed more because the small randomwalk caves are now available for use as an alternative to the 3D noise tunnels.
2019-11-09 03:09:52 +01:00
# Value >= 10.0 completely disables generation of tunnels and avoids the
# intensive noise calculations.
Cavegen: Wider tunnels in mgflat, mgfractal, mgvalleys As mgv7 is now the default mapgen i re-checked its tunnel width on request, discovered they needed to be wider, and have made this change. This commit widens the identical 3D noise tunnels in the other mapgens in exactly the same way.
2016-12-13 05:08:23 +01:00
mgvalleys_cave_width (Cave width) float 0.09
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Dungeons: Add Y limits in all mapgens Preserve the upper limit used in mgvalleys.
2018-02-17 18:43:13 +01:00
# Lower Y limit of dungeons.
mgvalleys_dungeon_ymin (Dungeon minimum Y) int -31000
# Upper Y limit of dungeons.
Settingtypes.txt: Fix valleys dungeon ymax error
2018-02-21 15:06:53 +01:00
mgvalleys_dungeon_ymax (Dungeon maximum Y) int 63
Dungeons: Add Y limits in all mapgens Preserve the upper limit used in mgvalleys.
2018-02-17 18:43:13 +01:00
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
[**Noises]
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# First of two 3D noises that together define tunnels.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgvalleys_np_cave1 (Cave noise #1) noise_params_3d 0, 12, (61, 61, 61), 52534, 3, 0.5, 2.0
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Second of two 3D noises that together define tunnels.
Improvements/fixes for noise parameter input in advanced settings Formspec input for each individual noise parameter and flag. Allow noise flags to be set in advanced settings, previously only settable in minetest.conf. Standardise 'group format' for noise parameters set in minetest.conf, as only these support noise flags. However the older 'single line' format is still accepted to support existing minetest.conf files. Therefore auto-generate minetest.conf.example with noise parameters in 'group format'. Setting 'type' in settingtypes.txt is now either 'noise_params_2D' or 'noise_params_3D', the dimension number is displayed in the advanced settings edit page.
2017-09-09 19:49:12 +02:00
mgvalleys_np_cave2 (Cave noise #2) noise_params_3d 0, 12, (67, 67, 67), 10325, 3, 0.5, 2.0
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# The depth of dirt or other biome filler node.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
mgvalleys_np_filler_depth (Filler depth) noise_params_2d 0, 1.2, (256, 256, 256), 1605, 3, 0.5, 2.0, eased
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# 3D noise defining giant caverns.
Mgvalleys: Update settingtypes.txt
2018-04-24 03:25:51 +02:00
mgvalleys_np_cavern (Cavern noise) noise_params_3d 0, 1, (768, 256, 768), 59033, 6, 0.63, 2.0
Mgvalleys: use standard caves Replace simple caves with V5 caves, adding unpredictable water and lava settings and massive caves based on subterrain. Remove fast terrain mode and accompanying settings. Remove superfluous temperature/humidity settings. Remove lava/water height setting. Fix errors in humidity handling and remove humidity_break_point setting. Move cave noises to generateCaves. Fix minor formatting/naming issues and use MYMAX/MYMIN/myround.
2016-01-31 09:59:15 +01:00
Settingtypes.txt: Various language improvements, document stable mapgens (#7801)
2018-10-20 10:35:39 +02:00
# Defines large-scale river channel structure.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
mgvalleys_np_rivers (River noise) noise_params_2d 0, 1, (256, 256, 256), -6050, 5, 0.6, 2.0, eased
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Base terrain height.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
mgvalleys_np_terrain_height (Terrain height) noise_params_2d -10, 50, (1024, 1024, 1024), 5202, 6, 0.4, 2.0, eased
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Raises terrain to make valleys around the rivers.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
mgvalleys_np_valley_depth (Valley depth) noise_params_2d 5, 4, (512, 512, 512), -1914, 1, 1.0, 2.0, eased
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Slope and fill work together to modify the heights.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
mgvalleys_np_inter_valley_fill (Valley fill) noise_params_3d 0, 1, (256, 512, 256), 1993, 6, 0.8, 2.0
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Amplifies the valleys.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
mgvalleys_np_valley_profile (Valley profile) noise_params_2d 0.6, 0.5, (512, 512, 512), 777, 1, 1.0, 2.0, eased
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Settings: Fix indents, chat_message_*. Update translations (#7580)
2018-07-25 18:07:11 +02:00
# Slope and fill work together to modify the heights.
Mainmenu: Make capitalisation consistent in mainmenu and advanced settings
2017-11-13 20:02:26 +01:00
mgvalleys_np_inter_valley_slope (Valley slope) noise_params_2d 0.5, 0.5, (128, 128, 128), 746, 1, 1.0, 2.0, eased
Add Valleys mapgen.
2016-01-14 04:57:02 +01:00
Dungeons: Settable density noise, move number calculation to mapgens (#8473) Add user-settable noise parameters for dungeon density to each mapgen, except V6 which hardcodes this noise parameter. Move the calculation of number of dungeons generated in a mapchunk out of dungeongen.cpp and into mapgen code, to allow mapgens to generate any desired number of dungeons in a mapchunk, instead of being forced to have number of dungeons determined by a density noise. This is more flexible and allows mapgens to use dungeon generation to create custom structures, such as occasional mega-dungeons.
2019-06-01 21:50:43 +02:00
# 3D noise that determines number of dungeons per mapchunk.
mgvalleys_np_dungeons (Dungeon noise) noise_params_3d 0.9, 0.5, (500, 500, 500), 0, 2, 0.8, 2.0
Builtin/profiler: Replace game profiler (#4245) Use the setting "profiler.load" to enable profiling. Other settings can be found in settingtypes.txt. * /profiler print [filter] - report statistics to in-game console * /profiler dump [filter] - report statistics to STDOUT and debug.txt * /profiler save [format [filter]] - saves statistics to a file in your worldpath * txt (default) - same treetable format as used by the dump and print commands * csv - ready for spreadsheet import * json - useful for adhoc D3 visualizations * json_pretty - line wrapped and intended json for humans * lua - serialized lua table of the profile-data, for adhoc scripts * /profiler reset - reset all gathered profile data. This can be helpful to discard of any startup measurements that often spike during loading or to get more useful min-values. [filter] allows limiting the output of the data via substring/pattern matching against the modname. Note: Serialized data structures might be subject to change with changed or added measurements. csv might be the most stable, due to flat structure. Changes to the previous version include: * Updated and extended API monitoring * Correct calculation of average (mean) values (undistorted by idleness) * Reduce instrumentation overhead. * Fix crashes related to missing parameters for the future and occasional DIV/0's. * Prevent issues caused by timetravel (overflow, timejump, NTP corrections) * Prevent modname clashes with internal names. * Measure each instrumentation individually and label based on registration order. * Labeling of ABM's and LBM's for easier classification. Giving several ABM's or LBM's the same label will treat them as one. Missing labels will be autogenerated based on name or registration order. * Configurable instrumentation and reporting. Skip e.g. builtin if you don't need it. * Profile the profiler to measure instrumentation overhead.
2016-07-12 21:51:10 +02:00
[*Advanced]
Add a warning to the 'chunksize' setting (#7775) Several users have been causing problems by increasing this value.
2018-10-10 22:23:37 +02:00
# Size of mapchunks generated by mapgen, stated in mapblocks (16 nodes).
# WARNING!: There is no benefit, and there are several dangers, in
# increasing this value above 5.
# Reducing this value increases cave and dungeon density.
# Altering this value is for special usage, leaving it unchanged is
# recommended.
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
chunksize (Chunk size) int 5
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Various grammar improvements (#7769) In builtin//pkgmgr.lua, README.md and settingtypes.txt. Based on 2 pull requests by comradekingu.
2018-10-06 04:43:26 +02:00
# Dump the mapgen debug information.
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
enable_mapgen_debug_info (Mapgen debug) bool false
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
# Maximum number of blocks that can be queued for loading.
Adjust some settings to modern environments and networks. (#7549)
2018-07-13 22:11:49 +02:00
emergequeue_limit_total (Absolute limit of emerge queues) int 512
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
# Maximum number of blocks to be queued that are to be loaded from file.
# Set to blank for an appropriate amount to be chosen automatically.
Adjust some settings to modern environments and networks. (#7549)
2018-07-13 22:11:49 +02:00
emergequeue_limit_diskonly (Limit of emerge queues on disk) int 64
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Advanced settings: Re-organise mapgen settings for ease of use Add a comment about the auto-generated minetest.conf.example possibly appearing in the bin folder.
2017-08-13 20:01:04 +02:00
# Maximum number of blocks to be queued that are to be generated.
# Set to blank for an appropriate amount to be chosen automatically.
Adjust some settings to modern environments and networks. (#7549)
2018-07-13 22:11:49 +02:00
emergequeue_limit_generate (Limit of emerge queues to generate) int 64
New settings tab contain all possible settings Settings are automatically parsed from builtin/settingtypes.txt The edit dialog automatically adjust based on the type of setting
2015-10-15 21:32:31 +02:00
Settingtypes.txt: Limit comments to 90 columns to fix clipped lines (#7777)
2018-10-11 04:23:08 +02:00
# Number of emerge threads to use.
num_emerge_threads: Warn of crashes when > 1 (#8357)
2019-03-14 13:49:33 +01:00
# 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'.
num_emerge_threads: Fix documentation of automatic selection
2019-03-17 09:38:15 +01:00
# Value 0:
Settingtypes.txt: Rewrite documentation of 'num_emerge_threads' (#8066)
2019-01-09 09:00:50 +01:00
# - 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.
num_emerge_threads: Warn of crashes when > 1 (#8357)
2019-03-14 13:49:33 +01:00
# WARNING: Increasing the number of emerge threads increases engine mapgen
Settingtypes.txt: Rewrite documentation of 'num_emerge_threads' (#8066)
2019-01-09 09:00:50 +01:00
# speed, but this may harm game performance by interfering with other
# processes, especially in singleplayer and/or when running Lua code in
num_emerge_threads: Warn of crashes when > 1 (#8357)
2019-03-14 13:49:33 +01:00
# 'on_generated'. For many users the optimum setting may be '1'.
Change 'num_emerge_threads' default to 1 (#8303)
2019-03-05 23:58:38 +01:00
num_emerge_threads (Number of emerge threads) int 1
Content store: Add show_nonfree_packages setting to advanced settings (#7846)
2018-11-09 00:33:59 +01:00
Rename 'Content Store' to 'Online Content Repository' in Advanced Settings
2019-02-03 19:07:14 +01:00
[Online Content Repository]
Content store: Add show_nonfree_packages setting to advanced settings (#7846)
2018-11-09 00:33:59 +01:00
Add setting to hide mature content from ContentDB
2019-02-03 18:54:56 +01:00
# The URL for the content repository
contentdb_url (ContentDB URL) string 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',
Content store: Add show_nonfree_packages setting to advanced settings (#7846)
2018-11-09 00:33:59 +01:00
# as defined by the Free Software Foundation.
Add setting to hide mature content from ContentDB
2019-02-03 18:54:56 +01:00
# 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/
contentdb_flag_blacklist (ContentDB Flag Blacklist) string nonfree, desktop_default
Copy Permalink