Technical tricks - Revision history

Ziusudra: /* Locating configuration files */ consistent delimiters

2025-10-03T03:00:41Z

Locating configuration files: consistent delimiters

Ziusudra: /* Locating configuration files */ updated for portable mode

2025-10-03T02:59:04Z

Locating configuration files: updated for portable mode

Ziusudra: /* d_init.txt */ removed WALKING_SPREADS_SPATTER_ADV since it's available in game now

2025-10-03T02:52:50Z

d_init.txt: removed WALKING_SPREADS_SPATTER_ADV since it's available in game now

Ziusudra: changed to for/see template

2025-06-09T04:57:08Z

changed to for/see template

Ziusudra: /* init.txt */ clarified when settings are saved to prefs, tweaks

2023-11-24T06:51:40Z

init.txt: clarified when settings are saved to prefs, tweaks

Ziusudra: /* init.txt */ changed font options tip from fixed rendering issue to saving info

2023-11-24T04:23:56Z

init.txt: changed font options tip from fixed rendering issue to saving info

Ziusudra: added template for Esc menu

2023-06-24T04:10:08Z

added template for Esc menu

Ziusudra: /* Locating configuration files */ added game using last token, disabling by removing leading bracket

2023-06-23T11:10:29Z

Locating configuration files: added game using last token, disabling by removing leading bracket

Ziusudra: /* init.txt */ added uncapped FPS

2023-06-23T09:43:07Z

init.txt: added uncapped FPS

Ziusudra: /* init.txt */ added version template to note

2023-06-20T11:03:47Z

init.txt: added version template to note

@@ Line 16: / Line 16: @@
 These configuration files might be found in two of three places in the [[Installation|install]] folder:
 * <code>data\init\</code> - files here contain the default values installed with the game and also may contain some explanations of the settings.
-* <code>prefs\</code> - files here contain the current values saved by the game, the location of the <code>prefs</code> [[Game folders and files|folder]] depends on the [[Settings#Portable_mode|portable mode setting]] (there is also a <code>data</code> folder there, but <code>data/init/</code> files will always be in the game installation folder).
+* <code>prefs\</code> - files here contain the current values saved by the game, the location of the <code>prefs</code> [[Game folders and files|folder]] depends on the [[Settings#Portable_mode|portable mode setting]] (there is also a <code>data</code> folder there, but <code>data\init\</code> files will always be in the game installation folder).
 You can edit the configuration files with any plain text editing software, such as Notepad, Vim, or Emacs.

@@ Line 14: / Line 14: @@
 == Locating configuration files ==
-These configuration files might be found in two places in the [[Installation|install]] folder:
+These configuration files might be found in two of three places in the [[Installation|install]] folder:
 * <code>data\init\</code> - files here contain the default values installed with the game and also may contain some explanations of the settings.
-* <code>prefs\</code> - files here contain the current values saved by the game.
+* <code>prefs\</code> - files here contain the current values saved by the game, the location of the <code>prefs</code> [[Game folders and files|folder]] depends on the [[Settings#Portable_mode|portable mode setting]] (there is also a <code>data</code> folder there, but <code>data/init/</code> files will always be in the game installation folder).
 You can edit the configuration files with any plain text editing software, such as Notepad, Vim, or Emacs.
@@ Line 22: / Line 22: @@
 Most data in these files is in [[token]] form. Each token is defined by the text between an opening square bracket, <code>[</code>, and the next closing square bracket, <code>]</code>. The token identifier and any values are separated by a colons, <code>:</code>.
-If anything goes wrong, you can completely reset the game's saved settings by deleting the <code>prefs\</code> folder while the game is not running, assuming the defaults have not been changed. This does not work with the files in <code>data\init\</code>, so you should make backups of them before modifying them. The game also uses the last occurrence of a token, so you could add your changes after the default values. You could then just remove the leading <code>[</code> to disable your entries and use the defaults.
+If anything goes wrong, you can completely reset the game's saved settings by deleting the <code>prefs\</code> folder, while the game is not running, assuming the defaults have not been changed. Individual files can also be deleted to just reset those settings. This does not work with the files in <code>data\init\</code>, so you should make backups of them before modifying them. The game also uses the last occurrence of a token, so you could add your changes after the default values. You could then just remove the leading <code>[</code> to disable your entries and use the defaults.
 == d_init.txt ==

@@ Line 25: / Line 25: @@
 == d_init.txt ==
-{{for/see|settings that can be changed in game|[[Settings]]}}
+:''All settings can be changed in game, see [[Settings]].''
 == init.txt ==

@@ Line 25: / Line 25: @@
 == d_init.txt ==
-For settings that can be changed in game see: [[Settings]].
+{{for/see|settings that can be changed in game|[[Settings]]}}
 *[WALKING_SPREADS_SPATTER_ADV:YES] - Still in the files but currently has no effect, of course. Turns on or off the spread of blood spatter and other [[contaminant]]s between creatures and ground tiles in [[Adventurer mode]].
 == init.txt ==
-For settings that can be changed in game see: [[Settings]].
+{{for/see|settings that can be changed in game|[[Settings]]}}
 *[SOUND:YES] - Change the argument from "YES" to "NO" to completely remove sound and music from the game. If this is "NO", it will not be possible to change the volume from the in game options menu.

@@ Line 34: / Line 34: @@
 *[WINDOWED:PROMPT] - Changes the window mode that ''Dwarf Fortress'' runs in. If this is "PROMPT" the game will ask you if you want to run in windowed or fullscreen mode. If this is "NO" the game will be fullscreen with no prompt, and if this is "YES" the game will be in windowed mode with no prompt.
-{{TipBox|#fb0|float=center|'''The game does not save the following font options to {{tt|/prefs/init.txt}}; you can add them but they will be removed the next time you change any settings in game.''' To make them persistent add them to {{tt|data/init/init_default.txt}}.}}
+{{TipBox|#fb0|float=center|'''The game does not save the following font options to {{tt|/prefs/init.txt}}; you can add them but they will be removed the next time you exit Settings in game.''' To make them persistent add them to {{tt|/data/init/init_default.txt}}.}}
-*[FONT:curses_640x300.png] - The font file that ''Dwarf Fortress'' uses. This value can be any .bmp or .png image in the data/art folder.
+*[FONT:curses_640x300.png] - The font file that ''Dwarf Fortress'' uses in windowed mode. These values can be any .bmp or .png image in the {{tt|/data/art}} folder.
-*[FULLFONT:curses_800x600.png] - The font file that ''Dwarf Fortress'' uses. This value can be any .bmp or .png image in the data/art folder.
+*[FULLFONT:curses_800x600.png] - The font file used in fullscreen mode.
-*[BASIC_FONT:curses_640x300.png] - This font is used during the initial load sequence and menus.
+*[BASIC_FONT:curses_640x300.png] - The font used during the initial load sequence and menus.
 *[FPS_CAP:0] - Setting this to zero will cause it to be uncapped, allowing simulation to happen as fast as possible. This may cause the FPS display to show negative numbers when the game is paused and in the main menu.

@@ Line 2: / Line 2: @@
 {{av}}
 {{TOC right}}
-''Dwarf Fortress'' has various settings that can affect the game experience. You can configure these in ''[[Settings]]'' accessed from the main menu or ESC menu. However, some settings can only be changed by directly editing the game configuration files, which include:
+''Dwarf Fortress'' has various settings that can affect the game experience. You can configure these in ''[[Settings]]'' accessed from the main menu or {{Menu icon|Esc}} menu. However, some settings can only be changed by directly editing the game configuration files, which include:
 * [[announcements.txt]] - contains configuration for the various game announcements.
 * [[arena.txt]] - contains layouts of [[object testing arena]] maps.