Settings: Difference between revisions

From OpenMW Wiki
Jump to navigation Jump to search
(Add warning about editing the file.)
(Changed link to reflect new RTD structure.)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page documents OpenMW configuration settings in the settings.cfg file.  Caution should be exercised when editing the settings.cfg file directly, since invalid values may cause poor performance, unexpected behavior, or even crashes.
Settings information can now be found in the OpenMW source documentation at:
 
http://openmw.readthedocs.io/en/master/reference/modding/settings/index.html
 
<!--
This page documents OpenMW configuration settings in the settings.cfg file.  Caution should be exercised when editing the settings.cfg file directly, since invalid values may cause poor performance, unexpected behavior, or even crashes
 
For the most current list of available settings in the development version of OpenMW, please see the [https://github.com/OpenMW/openmw/blob/master/files/settings-default.cfg settings-default.cfg] file at GitHub.
 
There's also older documentation available on [[Config file tweaks]].


==Location==
==Location==


The location of the settings.cfg file operating system dependent. See [[Paths]] for more information.
The effective settings are supposed to be loaded from a sequence of files providing successive overrides of the values.
 
The OpenMW launcher looks for default settings in an operating system dependent path:
 
* Linux /usr/local/etc/openmw/settings-default.cfg
* Windows: ?
* Mac: ?
 
Then the settings-default.cfg in the current directory is loaded if one exists.
 
Then the user's personal settings.cfg file is loaded from an operating system dependent path:
 
* Linux: $HOME/.config/openmw
* Windows: C:\Users\username\Documents\my games\openmw (harddrive, username and language may vary)
* Mac: $HOME/Library/Preferences/openmw
 
Some of these [[Paths]] are documented elsewhere. Cleanup required?


==Format==
==Format==
Line 38: Line 63:
* [[Video Settings Section]] - Resolution, screens, frame rates, etc.
* [[Video Settings Section]] - Resolution, screens, frame rates, etc.
* [[Water Settings Section]] - Water shader configuration.
* [[Water Settings Section]] - Water shader configuration.
* [[Objects Settings Section]] - Object shader configuration.
* [[Terrain Settings Section]] - Terrain shader configuration.
* [[Shadows Settings Section]] - Shadow shader configuration.
* [[Windows Settings Section]] - Size and location of GUI windows.
* [[Windows Settings Section]] - Size and location of GUI windows.
-->

Latest revision as of 05:05, 17 February 2017

Settings information can now be found in the OpenMW source documentation at:

http://openmw.readthedocs.io/en/master/reference/modding/settings/index.html