Difference between revisions of "Minetest.conf"

From Luanti Wiki
Jump to navigation Jump to search
(rename Minetest to Luanti)
 
(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]]

Latest revision as of 23:11, 22 October 2024

Languages Language: English • Deutsch • français • 日本語

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.

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 minetest.conf.example is provided as an example. See that file for a more complete list of options.

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:

  • ../minetest.conf
  • ../../minetest.conf (it can load settings from this location too, but will not write to it)

If you are running a system-wide build of Luanti (user data is stored separate from the executable), it loads from:

  • ~/.minetest/minetest.conf

A custom path to a configuration file can be specified in command line using the option --config /path/to/minetest.conf.

Controls

In minetest.conf, 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.

A few things to note:

  • Controls are written in the format keymap_<action name> = <key name>, e.g. keymap_forward = KEY_KEY_W
  • The list of possible controls (value right of the equals sign) can be seen in [1]. If your key isn't listed there, try writing the literal character
  • To disable a control completely, leave the part right of the equals sign empty, e.g. keymap_toggle_debug =

See Controls for a list of controls and their setting name (if available).