Difference between revisions of "Minetest.conf"

From Luanti Wiki
Jump to navigation Jump to search
(remove outdated list of settings, redundant with .conf.example)
Line 6: Line 6:
 
'''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.
 
'''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.
  
The configuration file is located in one of these locations:
+
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.
* <code>../minetest.conf</code> - (RUN_IN_PLACE version, relative to executable)
+
 
* <code>../../minetest.conf</code> - (RUN_IN_PLACE version, relative to executable)
+
== Location ==
* <code>~/.minetest/minetest.conf</code> - (globally installed version on Linux)
+
If you are running a RUN_IN_PLACE build of Minetest (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)
 +
 
 +
If you are running a system-wide build of Minetest (user data is stored separate from the executable), it loads from:
 +
* <code>~/.minetest/minetest.conf</code> (system-wide 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>.
 
A custom path to a configuration file can be specified in command line using the option <code>--config /path/to/minetest.conf</code>.
 
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.
 
  
 
== Controls ==
 
== Controls ==

Revision as of 16:16, 5 March 2023

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

Note: Since version 0.4.14, Minetest has an “advanced settings” feature to change virtually all settings in Minetest, 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 RUN_IN_PLACE build of Minetest (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 Minetest (user data is stored separate from the executable), it loads from:

  • ~/.minetest/minetest.conf (system-wide on Linux)

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).