|
|
(18 intermediate revisions by 7 users not shown) |
Line 1: |
Line 1: |
| {{DISPLAYTITLE:minetest.conf}} | | {{DISPLAYTITLE:minetest.conf}} |
− | '''minetest.conf''' is the configuration file used for numerous purposes. This file is read every time the game starts and is always created/modified when the menu quits.
| + | {{Languages}} |
| | | |
− | The configuration file is located in one of these locations:
| + | '''Note:''' Since version 0.4.14, Luanti has an “advanced settings” feature to change virtually all settings in Luanti, including a brief description of what each setting does. You will now rarely need to edit minetest.conf manually. |
− | * <code>../minetest.conf</code> - (RUN_IN_PLACE version, relative to executable)
| |
− | * <code>../../minetest.conf</code> - (RUN_IN_PLACE version, relative to executable)
| |
− | * <code>~/.minetest/minetest.conf</code> - (globally installed version on Linux)
| |
| | | |
− | A custom path to a configuration file can be specified in command line using the option <code>--config /path/to/minetest.conf</code>.
| + | '''minetest.conf''' is the configuration file used for numerous purposes. This file is read every time the game starts and is always created/modified when the menu quits. |
| | | |
− | A file called [https://github.com/celeron55/minetest/blob/master/minetest.conf.example minetest.conf.example] is provided as an example. See that file for a more complete list of options.<br /> | + | A file called [https://github.com/minetest/minetest/blob/master/minetest.conf.example minetest.conf.example] is provided as an example. See that file for a more complete list of options. |
− | This C++ code automatically generates minetest.conf, it contains all the default settings: [https://github.com/celeron55/minetest/blob/master/src/defaultsettings.cpp]
| |
| | | |
− | == Default settings == | + | == Location == |
| + | If you are running a portable build of Luanti (aka RUN_IN_PLACE=1, user data is stored alongside the executable), it loads from: |
| + | * <code>../minetest.conf</code> |
| + | * <code>../../minetest.conf</code> (it can load settings from this location too, but will not write to it) |
| | | |
− | <pre>
| + | If you are running a system-wide build of Luanti (user data is stored separate from the executable), it loads from: |
− | fullscreen = false
| + | * <code>~/.minetest/minetest.conf</code> |
− | screenW = 800
| |
− | screenH = 600
| |
− | vsync = false
| |
− | video_driver = opengl
| |
− | | |
− | enable_clouds = true
| |
− | enable_3d_clouds = true
| |
− | new_style_leaves = true
| |
− | opaque_water = false
| |
− | new_style_water = false
| |
− | smooth_lighting = true
| |
− | enable_fog = true
| |
− | | |
− | wanted_fps = 30
| |
− | fps_max = 60
| |
− | viewing_range_nodes_min = 35
| |
− | viewing_range_nodes_max = 160
| |
− | view_bobbing_amount = 1.0
| |
− | desynchronize_mapblock_texture_animation = true
| |
− | fsaa = false
| |
− | fullscreen_bpp = 24
| |
− | | |
− | enable_texture_atlas = true
| |
− | | |
− | enable_farmesh = false
| |
− | farmesh_trees = true
| |
− | farmesh_distance = 40
| |
− | | |
− | console_color = (0,0,0)
| |
− | console_alpha = 192
| |
− | | |
− | | |
− | enable_sound = true
| |
− | sound_volume = 0.5
| |
− | | |
− | | |
− | creative_mode = false
| |
− | enable_damage = true
| |
− | fast_move = true
| |
− | free_move = false
| |
− | time_speed = 96
| |
− | | |
− | default_game = minetest
| |
− | only_peaceful_mobs = false
| |
− | give_initial_stuff = false
| |
| | | |
| + | A custom path to a configuration file can be specified in command line using the option <code>--config /path/to/minetest.conf</code>. |
| | | |
| + | == Controls == |
| + | In <code>minetest.conf</code>, you can configure most (but not all) keys, but a few more keys can be configured which are not configurable in the in-game settings menu; most notably, camera mode and minimap. |
| | | |
− | active_object_send_range_blocks = 3
| + | A few things to note: |
− | active_block_range = 2
| |
− | server_map_save_interval = 5.3
| |
− | ignore_world_load_errors = false
| |
− | motd =
| |
| | | |
− | disallow_empty_password = false
| + | * Controls are written in the format <code>keymap_<action name> = <key name></code>, e.g. <code>keymap_forward = KEY_KEY_W</code> |
− | enable_pvp = true
| + | * The list of possible controls (value right of the equals sign) can be seen in [https://github.com/minetest/irrlicht/blob/master/include/Keycodes.h]. If your key isn't listed there, try writing the literal character |
− | default_privs = interact,shout
| + | * To disable a control completely, leave the part right of the equals sign empty, e.g. <code>keymap_toggle_debug =</code> |
− | | |
− | max_users = 100
| |
− | unlimited_player_transfer_distance = true
| |
− | strict_protocol_version_checking = true
| |
− | disable_anticheat = false
| |
− | enable_rollback_recording = false
| |
− | | |
− | max_simultaneous_block_sends_per_client = 2
| |
− | max_simultaneous_block_sends_server_total = 8
| |
− | max_block_send_distance = 10
| |
− | max_block_generate_distance = 6
| |
− | time_send_interval = 5
| |
− | full_block_send_enable_min_time_from_building = 2.0
| |
− | server_unload_unused_data_timeout = 29
| |
− | dedicated_server_step = 0.05
| |
− | | |
− | | |
− | address =
| |
− | name = | |
− | port = 30000
| |
− | client_unload_unused_data_timeout = 600
| |
− | | |
− | texture_path = ../textures/all
| |
− | screenshot_path = ../sceeenshots
| |
− | | |
− | | |
− | selected_mainmenu_tab = 0
| |
− | selected_world_path =
| |
− | | |
− | | |
− | keymap_forward = KEY_KEY_W | |
− | keymap_backward = KEY_KEY_S
| |
− | keymap_left = KEY_KEY_A
| |
− | keymap_right = KEY_KEY_D
| |
− | | |
− | invert_mouse = false
| |
− | | |
− | keymap_jump = KEY_SPACE
| |
− | keymap_sneak = KEY_LSHIFT
| |
− | keymap_inventory = KEY_KEY_I
| |
− | keymap_special1 = KEY_KEY_E
| |
− | aux1_descends = false
| |
− | | |
− | keymap_chat = KEY_KEY_T
| |
− | keymap_cmd = /
| |
− | keyman_console = KEY_F10
| |
− | | |
− | keymap_rangeselect = KEY_KEY_R
| |
− | keymap_freemove = KEY_KEY_K
| |
− | keymap_fastmove = KEY_KEY_J
| |
− | keymap_screenshot = KEY_F12
| |
− | | |
− | | |
− | keymap_print_debug_stacks = KEY_KEY_P
| |
− | keymap_quicktune_prev = KEY_HOME
| |
− | keymap_quicktune_next = KEY_END
| |
− | keymap_quicktune_dec = KEY_NEXT
| |
− | keymap_quicktune_inc = KEY_PRIOR
| |
− | random_input = false
| |
− | continuous_forward = false
| |
− | </pre> | |
− | | |
− | == Default Settings ==
| |
− | | |
− | {| class="wikitable"
| |
− | |-
| |
− | ! Key
| |
− | ! Type
| |
− | ! Default Value
| |
− | ! Description
| |
− | | |
− | |-
| |
− | | '''video_driver'''
| |
− | | string
| |
− | | opengl
| |
− | | Allows the user to chose the video renderer used to render Minetest.
| |
− | :'''null''' - No rendering at all.
| |
− | :'''software''' - Software rendering (not accelerated by graphics card, everything done by the processor), ''very slow''.
| |
− | :'''burningsvideo''' - Also software rendering, ''very slow''.
| |
− | :'''direct3d8''' - Uses Direct3D 8, ''unlikely to work''.
| |
− | :'''directdd9''' - Uses Direct3D 9, ''may not work''.
| |
− | :'''opengl''' - Uses OpenGL, latest version possible. '''Best stability.'''
| |
− | | |
− | |-
| |
− | | '''address'''
| |
− | | string
| |
− | | ''blank''
| |
− | | The address used for connecting to a server, if it is blank, the game will start a local server when attempting to connect.
| |
− | | |
− | |-
| |
− | | '''port'''
| |
− | | integer
| |
− | | 30000
| |
− | | The port used when connecting to, or creating a server. For creating a server, ports above 1024 are preferred for security, compatibility and standards compliance reasons.
| |
− | | |
− | |-
| |
− | | '''creative_mode'''
| |
− | | boolean
| |
− | | 0
| |
− | | Enables [[creative mode]]. ''This only affects local server.''
| |
− | :'''1''' - Creative mode enabled.
| |
− | :'''0''' - Creative mode disabled.
| |
− | | |
− | |-
| |
− | | '''enable_damage'''
| |
− | | boolean
| |
− | | 0
| |
− | | Enables damage. When disabled, players cannot die or receive damage of any kind. ''This only affects local server.''
| |
− | :'''1''' - Damage enabled.
| |
− | :'''0''' - Damage disabled.
| |
− | | |
− | |-
| |
− | | '''name'''
| |
− | | string
| |
− | | ''blank''
| |
− | | The name of the player.
| |
− | | |
− | |-
| |
− | | '''new_style_leaves'''
| |
− | | boolean
| |
− | | 1
| |
− | | Whether to make [[leaves]] transparent (1) or opaque (0); opaque leaves are faster, thus recommended on slower computers.
| |
− | :'''1''' - Leaves are transparent.
| |
− | :'''0''' - Leaves are opaque.
| |
− | | |
− | |-
| |
− | | '''new_style_water'''
| |
− | | boolean
| |
− | | 0
| |
− | | Whether to lower water surface (1) or not (0) compared to other nodes; default water is faster to render and more accurate.
| |
− | :'''1''' - Water surface is lowered compared to other nodes, does not affect physics or gameplay.
| |
− | :'''0''' - Water surfaced is not lowered.
| |
− | | |
− | |-
| |
− | | '''opaque_water'''
| |
− | | boolean
| |
− | | 0
| |
− | | Whether to enable opaque [[water]].
| |
− | :'''1''' - Opaque water enabled.
| |
− | :'''0''' - Opaque water disabled.
| |
− | | |
− | |-
| |
− | | '''show_debug'''
| |
− | | boolean
| |
− | | 0
| |
− | | Whether to enable debug info (coordinates, draw times...) on startup.
| |
− | :'''1''' - Debug info shown by default.
| |
− | :'''0''' - Debug info hidden by default.
| |
− | | |
− | |-
| |
− | | '''smooth_lighting'''
| |
− | | boolean
| |
− | | 1
| |
− | | Whether to use smooth lighting.
| |
− | :'''1''' - Smooth lighting enabled.
| |
− | :'''0''' - Smooth lighting disabled.
| |
− | | |
− | |-
| |
− | | '''client_delete_unused_sectors_timeout'''
| |
− | | integer
| |
− | | 600
| |
− | | This will set the client to delete parts of the map from memory when they haven't been accessed for N seconds.
| |
− | | |
− | |-
| |
− | | '''enable_texture_atlas'''
| |
− | | boolean
| |
− | | 1
| |
− | | You can disable the building of the texture atlas with this line. (A texture atlas is a big texture with multiple smaller textures tiled in it).
| |
− | | |
− | |-
| |
− | | '''invert_mouse'''
| |
− | | boolean
| |
− | | 0
| |
− | | Allows the user to invert their mouse vertical axis.
| |
− | :'''1''' - Mouse vertical axis inverted. | |
− | :'''0''' - Mouse vertical axis not inverted.
| |
− | | |
− | |-
| |
− | | '''texture_path'''
| |
− | | string
| |
− | | ''blank''
| |
− | | Allows the user to specify an additional texture directory, from which Minetest will first search for textures.
| |
− | | |
− | |-
| |
− | | '''time_speed'''
| |
− | | integer
| |
− | | 72
| |
− | | This changes the speed of the [[Day/night cycle|day/night cycle]] (also applies to local/singleplayer game). When set to 0, the day/night cycle stops. The higher is the value, the faster the day/night cycle will be.
| |
− | | |
− | |-
| |
− | | '''viewing_range_nodes_min'''
| |
− | | integer
| |
− | | 25
| |
− | | Allows the user to change their minimal view range. This is very useful for slow computers.
| |
− | | |
− | |-
| |
− | | '''viewing_range_nodes_max'''
| |
− | | integer
| |
− | | 160
| |
− | | Allows the user to change their maximal view range. This is very useful for slow computers.
| |
− | | |
− | |-
| |
− | | '''fov'''
| |
− | | integer
| |
− | | 72
| |
− | | Allows the user to change their field of view.
| |
− | | |
− | |-
| |
− | | '''view_bobbing'''
| |
− | | boolean
| |
− | | 1
| |
− | | Whether to enable view and wielded tool bobbing.
| |
− | :'''1''' - View bobbing enabled.
| |
− | :'''0''' - View bobbing disabled.
| |
− | | |
− | |-
| |
− | | '''view_bobbing_amount'''
| |
− | | float
| |
− | | 1.0
| |
− | | Controls view bobbing intensity, 1.0 being 100%, 1.5 being 150% and so on.
| |
− | | |
− | |-
| |
− | | '''enable_fog'''
| |
− | | boolean
| |
− | | 1
| |
− | | Whether to fog out the end of the visible area.
| |
− | :'''1''' - Fog enabled.
| |
− | :'''0''' - Fog disabled.
| |
− | | |
− | |-
| |
− | | '''enable_clouds'''
| |
− | | boolean
| |
− | | 1
| |
− | | Whether to draw clouds.
| |
− | :'''1''' - Clouds enabled.
| |
− | :'''0''' - Clouds disabled.
| |
− | | |
− | |-
| |
− | | '''enable_3d_clouds'''
| |
− | | boolean
| |
− | | 0
| |
− | | Allows the user to enable 3D clouds.
| |
− | :'''1''' - 3D clouds enabled.
| |
− | :'''0''' - 3D clouds disabled (2D clouds used instead).
| |
− | | |
− | |-
| |
− | | '''enable_sound'''
| |
− | | boolean
| |
− | | 1
| |
− | | Whether to enable sound; sound can only be enabled if you have installed OpenAL.
| |
− | :'''1''' - Sound enabled.
| |
− | :'''0''' - Sound disabled.
| |
− | | |
− | |-
| |
− | | '''sound_volume'''
| |
− | | float
| |
− | | 0.8
| |
− | | Allows the user to change sound volume. 1 is 100% volume whereas 0 is 0% volume.
| |
− | | |
− | |}
| |
− | | |
− | == Controls ==
| |
| | | |
− | The key bindings are configurable in the “settings” menu.
| + | See [[Controls]] for a list of controls and their setting name (if available). |
| | | |
| [[Category:Server]] | | [[Category:Server]] |