v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "40d:Init.txt"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
m (Bot: Adding {{av}})
m (grammar bother)
 
(17 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 +
{{Quality|Superior|20:26, 31 August 2014 (UTC)}}
 +
{{file|DF/data/init/init.txt}}
 
{{av}}
 
{{av}}
 
The '''init.txt''' file is used to make many adjustments to the game presentation and feel, such as [[Technical tricks|improving framerate]], [[Technical tricks#Screen_sizes|screen size]], or for the use of [[Tilesets]] and [[List of user character sets|Character sets]].
 
The '''init.txt''' file is used to make many adjustments to the game presentation and feel, such as [[Technical tricks|improving framerate]], [[Technical tricks#Screen_sizes|screen size]], or for the use of [[Tilesets]] and [[List of user character sets|Character sets]].
Line 4: Line 6:
 
This file is located at Dwarf Fortress/data/init/init.txt.
 
This file is located at Dwarf Fortress/data/init/init.txt.
  
The contents of the '''init.txt''' file by default can be found [[Default init|here]].
+
The contents of the '''init.txt''' file are as follows:
  
 +
{{gamedata|Change this to turn sound off.
  
 +
[SOUND:ON]
  
===== Additional hotlinked topics on this page=====
+
The sound volume runs from 0 (off) to 255 (full).  You can set the volume from the ESC options menu as well.
{| id="toc"
+
 
| Use these links to skip directly to certain key locations in the init file.
+
[VOLUME:255]
* [[#WINDOWED|[WINDOWED], [FULLSCREEN], etc]]
+
 
* [[#GRID|[GRID<nowiki>]</nowiki>]]
+
Change this to skip the wonderful intro movies.
* [[#FPS|[FPS], etc]]
 
* [[#FINDER|[SHOW_EMBARK_xxxxx<nowiki>]</nowiki>]]
 
* [[#POPULATION|[POPULATION_CAP], etc]]
 
* [[#FLOW|[SHOW_FLOW_AMOUNTS<nowiki>]</nowiki>]]
 
|}
 
  
 +
[INTRO:ON]
  
===Default init.txt {{v|0.28.181.40d}} ===
+
This lets you set the starting windowed/fullscreen setting. Can be YES, NO or PROMPT.
  
=====Audio/Visual=====
+
[WINDOWED:PROMPT]
  
*[SOUND:ON]
+
This is the size and font for windowed mode.  Changing to 800x600 and the 800x600 font might make you happier.
  
:Change this to turn '''sound''' OFF.
+
[WINDOWEDX:640]
 +
[WINDOWEDY:300]
 +
[FONT:curses_640x300.bmp]
  
 +
Full screen info.
  
----
+
[FULLSCREENX:800]
 +
[FULLSCREENY:600]
 +
[FULLFONT:curses_800x600.bmp]
  
 +
If this is set to YES, the tiles will not be stretched, but rather the game view will be centralized, surrounded by black space.  Tiles that are too large will always be compressed rather than running off the screen.
  
*[VOLUME:255]
+
[BLACK_SPACE:NO]
  
:The sound '''volume''' runs from 0 (off) to 255 (full)You can set the volume from the ESC options menu as well.
+
Graphics info, most of it as above.  Set GRAPHICS to YES to turn it all on.  This will use the "raw/graphics" folder for tile information.  Currently this is limited to whatever creature graphics you have downloaded.  The game comes with a few pictures to demonstrateAs of September 2008, the Dwarf Fortress Wiki has graphical tilesets available at http://www.dwarffortresswiki.net/index.php/List_of_user_graphics_sets.
  
 +
[GRAPHICS:NO]
 +
[GRAPHICS_WINDOWEDX:1280]
 +
[GRAPHICS_WINDOWEDY:400]
 +
[GRAPHICS_FONT:curses_square_16x16.bmp]
 +
[GRAPHICS_FULLSCREENX:1280]
 +
[GRAPHICS_FULLSCREENY:800]
 +
[GRAPHICS_FULLFONT:curses_square_16x16.bmp]
 +
[GRAPHICS_BLACK_SPACE:YES]
  
----
+
This is the dimensions in tiles of the display grid.  Minimum x is 80.  Minimum y is 25.  Maximums are 200.  Make sure the window size or full screen resolution matches the grid/tile size if you don't want the display to be squashed or stretched.  The default windowed font has tiles that are 8x12 pixels, for instance, so for a 80x25 grid, you use a 640x300 window, and for a 125x50 grid, you'd use a 1000x600 window.  FULLGRID is used in full screen mode, whether graphics is on or not.
  
 +
[GRID:80:25]
 +
[FULLGRID:80:25]
  
*[INTRO:ON]
+
Change this to YES to only refresh portions of the screen that need to be refreshed.  This can have a significant impact on frame rate, especially for people that have slow frame rates on the title screen.  The number refers to how many frames it will redo a printed tile before skipping it, so you might try increasing it a bit.  PARTIAL_PRINT only works on certain systems, so you might have to disable it again if you notice your display isn't working properly.  Fixes are being investigated.
  
:Change this to skip the wonderful '''intro''' movies.
+
[PARTIAL_PRINT:NO:2]
  
 +
Change this to YES to keep the DF window on top of your other windows.
  
----
+
[TOPMOST:NO]
  
 +
Change this to YES if you want to see an FPS counter at the top left.
  
*[WINDOWED:PROMPT]
+
[FPS:NO]
  
:{{a|WINDOWED|This}} lets you set the starting '''windowed/fullscreen''' settingCan be YES, NO or PROMPT.
+
Use this to set the maximum frame rate during play.  The movies are always capped at 100.  A frame in this case is not graphical but related to the movement speed of a creatureA healthy, unencumbered dwarven peasant takes one step every 10 frames.
  
 +
[FPS_CAP:100]
  
----
+
Use this to set the maximum graphical frame refresh rate during play.
  
 +
[G_FPS_CAP:50]
  
*[WINDOWEDX:640]<br>
+
This sets the applications vertical synchronization behavior.  Changing this to ON can impact your FPS if your G_FPS is high.  The other options are ON and DEFAULT.  DEFAULT uses whatever settings you have your system at in general.
*[WINDOWEDY:300]<br>
 
*[FONT:curses_640x300.bmp]<br>
 
  
:This is the size and font for '''windowed mode'''.  Changing to 800x600 and the 800x600 font might make you happier.<br>
+
[VSYNC:OFF]
  
 +
Change this to LINEAR if you want the texture values to be averaged over the adjacent pixels.
  
----
+
[TEXTURE_PARAM:NEAREST]
  
 +
Change this to make the dwarfort.exe process have a different priority.  From highest to lowest, the options are REALTIME, HIGH, ABOVE_NORMAL, NORMAL, BELOW_NORMAL and IDLE.
  
*[FULLSCREENX:800]<br>
+
[PRIORITY:NORMAL]
*[FULLSCREENY:600]<br>
 
*[FULLFONT:curses_800x600.bmp]<br>
 
  
:'''Full screen''' info.'
+
Change this to NO if you don't want to have the mouse involved at all.
  
 +
[MOUSE:YES]
  
----
+
Change this to YES if you'd like to use a BMP for the mouse cursor.  The image currently lags when the game is lagging however.
  
 +
[MOUSE_PICTURE:NO]
  
*[BLACK_SPACE:NO]
+
Use these to control the automatic saving behavior in the dwarf fortress mode of game.  AUTOSAVE can be set to NONE, SEASONAL or YEARLY.  This updates your save at these intervals, so that some of your progress will be saved in case of system instability.  You can set AUTOBACKUP to YES if you want the updated save to be copied to another folder so that you'll have several copies of your world at different times.  Set AUTOSAVE_PAUSE to YES if you want the game to pause every time it autosaves.
  
:If this is set to YES, the tiles will not be stretched, but rather the game view will be centralized, surrounded by '''black space'''.  Tiles that are too large will always be compressed rather than running off the screen.
+
[AUTOSAVE:NONE]
 +
[AUTOBACKUP:NO]
 +
[AUTOSAVE_PAUSE:NO]
  
 +
Set this to YES if you want it to save the game when you start a new fortress.  If AUTOBACKUP above is set to YES, it will also create a copy of this new save.
  
----
+
[INITIAL_SAVE:NO]
  
 +
Set this to YES to make Dwarf Fortress start paused whenever you load an active game.
  
*[GRAPHICS:NO]<br>
+
[PAUSE_ON_LOAD:NO]
*[GRAPHICS_WINDOWEDX:1280]<br>
 
*[GRAPHICS_WINDOWEDY:400]<br>
 
*[GRAPHICS_FONT:curses_square_16x16.bmp]<br>
 
*[GRAPHICS_FULLSCREENX:1280]<br>
 
*[GRAPHICS_FULLSCREENY:800]<br>
 
*[GRAPHICS_FULLFONT:curses_square_16x16.bmp]<br>
 
*[GRAPHICS_BLACK_SPACE:YES]<br>
 
  
:'''Graphics''' info, most of it as above.  Set GRAPHICS to YES to turn it all on.  This will use the "raw/graphics" folder for tile information.  Currently this is limited to whatever creature graphics you have downloaded.  The game comes with a few pictures to demonstrate.  As of February 2008, the Dwarf Fortress Wiki has graphical tilesets available at http://www.dwarffortresswiki.net/index.php/Graphics_sets.
+
Set this to YES if you want Dwarf Fortress to show the warning window on embark as a confirmation even if there are no issues.
  
 +
[EMBARK_WARNING_ALWAYS:NO]
  
----
+
You can change these to ALWAYS and NO.  More restrictive world parameter settings override these.  ALWAYS lets you see the features in the Local view during embark, and NO stops you from looking for features in the site finder (though if you really want to stop the finder, it might be better for you to generate worlds that restrict the use of this feature completely, in which case you don't need to change the settings here).
  
 +
[SHOW_EMBARK_RIVER:FINDER]
 +
[SHOW_EMBARK_POOL:FINDER]
 +
[SHOW_EMBARK_M_PIPE:FINDER]
 +
[SHOW_EMBARK_M_POOL:FINDER]
 +
[SHOW_EMBARK_CHASM:FINDER]
 +
[SHOW_EMBARK_PIT:FINDER]
 +
[SHOW_EMBARK_OTHER:FINDER]
 +
[SHOW_EMBARK_TUNNEL:FINDER]
  
*[GRID:80:25]
+
Use these options to remove features from the game.  Permitted values are YES and NO.  Removal might speed the game up in the case of temperature and weather.
*[FULLGRID:80:25]
 
  
:{{a|GRID|This}} is the dimensions in tiles of the '''display grid'''.  Minimum x is 80.  Minimum y is 25.  Maximums are 200.  Make sure the window size or full screen resolution matches the grid/tile size if you don't want the display to be squashed or stretched.  The default windowed font has tiles that are 8x12 pixels, for instance, so for a 80x25 grid, you use a 640x300 window, and for a 125x50 grid, you'd use a 1000x600 window.  FULLGRID is used in full screen mode, whether graphics is on or not.
+
[TEMPERATURE:YES]
 +
[WEATHER:YES]
 +
[ECONOMY:YES]
 +
[INVADERS:YES]
 +
[CAVEINS:YES]
 +
[ARTIFACTS:YES]
 +
[ZERO_RENT:NO]
  
 +
Change this to YES to output the reasons for world map rejection into a file.
  
----
+
[LOG_MAP_REJECTS:NO]
  
 +
Change these numbers to make the embark rectangle start at a different size.  The format is (EMBARK_RECTANGLE:<width>:<height>).  Numbers may run from 2 to 16.  The map size warning message will go by these numbers.
  
*[PARTIAL_PRINT:NO:2]
+
[EMBARK_RECTANGLE:6:6]
  
:Change this to YES to only refresh portions of the screen that need to be refreshed.  This can have a significant impact on frame rate, especially for people that have slow frame rates on the title screenThe number refers to how many frames it will redo a printed tile before skipping it, so you might try increasing it a bit.  '''PARTIAL_PRINT''' only works on certain systems, so you might have to disable it again if you notice your display isn't working properly. Fixes are being investigated.
+
Change these numbers to set the default weights for traffic designationsIf you make the last numbers too large, pathfinding might lag.
 +
The format is (PATH_COST:<high>:<normal>:<low>:<restricted>).
  
 +
[PATH_COST:1:2:5:25]
  
----
+
Alter these options to control how aggressively your dwarves place objects in a container with like items (rather than an empty container).  The default options are very aggressive.  STORE_DIST_ITEM_DECREASE controls the cap on objects it will consider -- for each object it finds in a container, one tile is removed from its apparent distance to the dwarf, up to this cap.  The others control how many tiles are removed for each combination type for any match at all.  For instance, if ITEM_DECREASE is set to 20, and SEED_COMBINE is set to 100, a dwarf carrying seeds will see a seed bag with 15 seeds as 115 tiles closer than it actually is (and thus pass up any empties within that distance), whereas a seed bag with 30 seeds would be treated as 120 tiles closer (because it hits the ITEM_DECREASE cap).  Values from 2 to 1000 are permitted.  Before these init options, the behavior was roughly ITEM_DECREASE 2, SEED_COMBINE 2 and the rest at 1000.
  
 +
[STORE_DIST_ITEM_DECREASE:20]
 +
[STORE_DIST_SEED_COMBINE:1000]
 +
[STORE_DIST_BUCKET_COMBINE:1000]
 +
[STORE_DIST_BARREL_COMBINE:1000]
 +
[STORE_DIST_BIN_COMBINE:1000]
  
*[TOPMOST:NO]
+
Change this to YES to disallow pets from coffin burial as the default option.
  
:Change this to YES to keep the DF window on '''top''' of your other windows.<br>
+
[COFFIN_NO_PETS_DEFAULT:NO]
  
 +
This controls the display of areas that are far below outside.  The format is SKY:<character>:<foreground color>:<background color>:<brightness>.  The <character> can be either an ASCII tile number or a character in quotes, like '#'.
  
----
+
[SKY:178:3:0:0]
  
 +
As above, for inside/subterranean areas.
  
*[FPS:NO]
+
[CHASM:250:0:0:1]
  
:{{a|FPS|Change}} this to YES if you want to see an '''FPS counter''' at the top left.
+
This controls the "IDLERS: <number>" that is displayed in dwarf mode.  You can set it to TOP, BOTTOM or OFF.
  
 +
[IDLERS:TOP]
  
----
+
You can set the maximum population of your fortress here.  Keep in mind that your population must be at least 80 to get a king and 100 to obtain the current game features.
  
 +
[POPULATION_CAP:200]
  
*[FPS_CAP:100]
+
This allows you to control the number of babies+children in your fortress.  The first number is an absolute cap on the number of babies+children.  The second is a percentage of the current number of adults in your fortress (the default is the essentially meaningless 1000% here).  The lower number is used as the cap.  The cap only prevents further pregancies, so migrant children, multiple births and existing pregnancies from old saves can still push you over the cap.  Setting either number to zero will disallow pregnancies in the fortress.
  
:Use this to set the '''maximum frame rate''' during play.  The movies are always capped at 100.  A frame in this case is not graphical but related to the movement speed of a creature.  A healthy, unencumbered dwarven peasant takes one step every 10 frames.
+
[BABY_CHILD_CAP:100:1000]
  
 +
If you don't like the ,.`' ground, try setting this to NO.  The ground will turn into periods only.
  
----
+
[VARIED_GROUND_TILES:YES]
  
 +
If you'd like your engravings to start off looking the same (you can toggle them on individual later), set this to YES.
  
*[G_FPS_CAP:50]
+
[ENGRAVINGS_START_OBSCURED:NO]
  
:Use this to set the maximum '''graphical frame refresh rate''' during play.
+
If you get annoyed by seeing items like *<*sword*>* you can
 +
get rid of the outside ** by setting this to NO.
  
 +
[SHOW_IMP_QUALITY:YES]
  
----
+
Set this to YES to display fluids as numbers indicating depth.
 
  
*[VSYNC:OFF]
+
[SHOW_FLOW_AMOUNTS:NO]
  
:This sets the applications '''vertical synchronization''' behavior. Changing this to ON can impact your FPS if your G_FPS is high.  The other options are ON and DEFAULT.  DEFAULT uses whatever settings you have your system at in general.
+
If you'd prefer to have it show the history behind every engraving you view in dwarf mode, etc., then set this to YES.
  
 +
[SHOW_ALL_HISTORY_IN_DWARF_MODE:NO]
  
----
+
This controls the number of milliseconds that must pass before a held key sends a repeat press to the game.  You might need to adjust this.
  
 +
[KEY_HOLD_MS:150]
  
*[TEXTURE_PARAM:NEAREST]
+
This controls the number of milliseconds that must pass before input works again after the view recenters on an event in dwarf mode.
  
:Change this to LINEAR if you want the '''texture''' values to be averaged over the adjacent pixels.
+
[RECENTER_INTERFACE_SHUTDOWN_MS:0]
  
 +
This controls "more" in adventure mode.  If MORE is set to NO, all announcements will be skipped.  DISPLAY_LENGTH controls how many lines are printed before it gives you the "more" prompt.
  
----
+
[MORE:YES]
 +
[DISPLAY_LENGTH:23]
  
 +
Set this to YES if you want traps to affect you in adventure mode.  This is not recommended -- there are lockup issues with cage traps, and you cannot disarm any of the traps yet, so they effectively stop you from exploring your old fortresses.
  
*[PRIORITY:NORMAL]
+
[ADVENTURER_TRAPS:NO]
  
:Change this to make the dwarfort.exe process have a different '''priority'''.  From highest to lowest, the options are REALTIME, HIGH, ABOVE_NORMAL, NORMAL, BELOW_NORMAL and IDLE.
+
Set this to NO if you want the game to recenter on your adventurer only when you've gotten close to the edge of the view.
  
 +
[ADVENTURER_ALWAYS_CENTER:YES]
  
----
+
This controls the up/down views in adventure mode.  The first parameter can be OFF, UNHIDDEN, CREATURE or ON.  UNHIDDEN makes the view appear when it contains any unhidden square.  CREATURE makes the view appear when it contains a creature.  The second parameter is the size of the view.  It can be 3, 5, 7 or 9.  A smaller view lets it stack more of them in the column (3 at size 5, and 5 at size 3).
  
 +
[ADVENTURER_Z_VIEWS:UNHIDDEN:9]
  
*[MOUSE:YES]
+
You can use these to say how nicknames are displayed in each mode
 +
Options are REPLACE_FIRST, CENTRALIZE (between first and last), REPLACE_ALL
 +
[NICKNAME_DWARF:REPLACE_FIRST]
 +
[NICKNAME_ADVENTURE:REPLACE_FIRST]
 +
[NICKNAME_LEGENDS:REPLACE_FIRST]
  
:Change this to NO if you don't want to have the '''mouse''' involved at all.
+
These are the display colors in RGB.  The game is actually displaying extended ASCII characters in OpenGL, so you can modify the colors.
  
 +
[BLACK_R:0]
 +
[BLACK_G:0]
 +
[BLACK_B:0]
 +
[BLUE_R:0]
 +
[BLUE_G:0]
 +
[BLUE_B:128]
 +
[GREEN_R:0]
 +
[GREEN_G:128]
 +
[GREEN_B:0]
 +
[CYAN_R:0]
 +
[CYAN_G:128]
 +
[CYAN_B:128]
 +
[RED_R:128]
 +
[RED_G:0]
 +
[RED_B:0]
 +
[MAGENTA_R:128]
 +
[MAGENTA_G:0]
 +
[MAGENTA_B:128]
 +
[BROWN_R:128]
 +
[BROWN_G:128]
 +
[BROWN_B:0]
 +
[LGRAY_R:192]
 +
[LGRAY_G:192]
 +
[LGRAY_B:192]
 +
[DGRAY_R:128]
 +
[DGRAY_G:128]
 +
[DGRAY_B:128]
 +
[LBLUE_R:0]
 +
[LBLUE_G:0]
 +
[LBLUE_B:255]
 +
[LGREEN_R:0]
 +
[LGREEN_G:255]
 +
[LGREEN_B:0]
 +
[LCYAN_R:0]
 +
[LCYAN_G:255]
 +
[LCYAN_B:255]
 +
[LRED_R:255]
 +
[LRED_G:0]
 +
[LRED_B:0]
 +
[LMAGENTA_R:255]
 +
[LMAGENTA_G:0]
 +
[LMAGENTA_B:255]
 +
[YELLOW_R:255]
 +
[YELLOW_G:255]
 +
[YELLOW_B:0]
 +
[WHITE_R:255]
 +
[WHITE_G:255]
 +
[WHITE_B:255]}}
  
----
+
=== Additional hotlinked topics on this page===
 +
{| id="toc"
 +
| Use these links to skip directly to certain key locations in the init file.
 +
* [[#WINDOWED|[WINDOWED], [FULLSCREEN], etc]]
 +
* [[#GRID|[GRID<nowiki>]</nowiki>]]
 +
* [[#FPS|[FPS], etc]]
 +
* [[#FINDER|[SHOW_EMBARK_xxxxx<nowiki>]</nowiki>]]
 +
* [[#POPULATION|[POPULATION_CAP], etc]]
 +
* [[#FLOW|[SHOW_FLOW_AMOUNTS<nowiki>]</nowiki>]]
 +
|}
  
 +
==Default init.txt ==
  
*[MOUSE_PICTURE:NO]
+
===Audio/Visual===
  
:Change this to YES if you'd like to use a BMP for the '''mouse cursor'''.  The image currently lags when the game is lagging however.
+
:[SOUND:ON]
  
 +
Change this to turn '''sound''' OFF.
  
 
----
 
----
  
 +
:[VOLUME:255]
  
=====Seasonal autosave=====
+
The sound '''volume''' runs from 0 (off) to 255 (full).  You can set the volume from the ESC options menu as well.
  
*[AUTOSAVE:NONE]
+
----
*[AUTOBACKUP:NO]
 
*[AUTOSAVE_PAUSE:NO]
 
  
:Use these to control the '''automatic saving''' behavior in the dwarf fortress mode of game.  AUTOSAVE can be set to NONE, SEASONAL or YEARLY.  This updates your save at these intervals, so that some of your progress will be saved in case of system instability.  You can set AUTOBACKUP to YES if you want the updated save to be copied to another folder so that you'll have several copies of your world at different times.  Set AUTOSAVE_PAUSE to YES if you want the game to pause every time it autosaves.
+
:[INTRO:ON]
  
 +
Change this to skip the wonderful '''intro''' movies.
  
 
----
 
----
  
 +
:[WINDOWED:PROMPT]
  
*[INITIAL_SAVE:NO]
+
{{a|WINDOWED|This}} lets you set the starting '''windowed/fullscreen''' setting.  Can be YES, NO or PROMPT.
  
:Set this to YES if you want it to '''automatically save the game when you start''' a new fortress.  If AUTOBACKUP above is set to YES, it will also create a copy of this new save.
+
----
  
 +
:[WINDOWEDX:640]
 +
:[WINDOWEDY:300]
 +
:[FONT:curses_640x300.bmp]
 +
 +
This is the size and font for '''windowed mode'''.  Changing to 800x600 and the 800x600 font might make you happier.<br>
  
 
----
 
----
  
 +
:[FULLSCREENX:800]
 +
:[FULLSCREENY:600]
 +
:[FULLFONT:curses_800x600.bmp]
 +
 +
'''Full screen''' info.
  
*[PAUSE_ON_LOAD:NO]
+
----
  
:Set this to YES to make Dwarf Fortress '''start paused''' whenever you load an active game.
+
:[BLACK_SPACE:NO]
  
 +
If this is set to YES, the tiles will not be stretched, but rather the game view will be centralized, surrounded by '''black space'''.  Tiles that are too large will always be compressed rather than running off the screen.
  
 
----
 
----
  
 +
:[GRAPHICS:NO]
 +
:[GRAPHICS_WINDOWEDX:1280]
 +
:[GRAPHICS_WINDOWEDY:400]
 +
:[GRAPHICS_FONT:curses_square_16x16.bmp]
 +
:[GRAPHICS_FULLSCREENX:1280]
 +
:[GRAPHICS_FULLSCREENY:800]
 +
:[GRAPHICS_FULLFONT:curses_square_16x16.bmp]
 +
:[GRAPHICS_BLACK_SPACE:YES]
  
*[EMBARK_WARNING_ALWAYS:NO]
+
'''Graphics''' info, most of it as above.  Set GRAPHICS to YES to turn it all on.  This will use the "raw/graphics" folder for tile information.  Currently this is limited to whatever creature graphics you have downloaded.  The game comes with a few pictures to demonstrate.  As of February 2008, the Dwarf Fortress Wiki has graphical tilesets available at http://www.dwarffortresswiki.org/index.php/Graphics_sets.
 +
 
 +
----
  
:Set this to YES if you want Dwarf Fortress to show the '''warning window on embark''' as a confirmation even if there are no issues.
+
:[GRID:80:25]
 +
:[FULLGRID:80:25]
  
 +
{{a|GRID|This}} is the dimensions in tiles of the '''display grid'''.  Minimum x is 80.  Minimum y is 25.  Maximums are 200.  Make sure the window size or full screen resolution matches the grid/tile size if you don't want the display to be squashed or stretched.  The default windowed font has tiles that are 8x12 pixels, for instance, so for a 80x25 grid, you use a 640x300 window, and for a 125x50 grid, you'd use a 1000x600 window.  FULLGRID is used in full screen mode, whether graphics is on or not.
  
 
----
 
----
  
 +
:[PARTIAL_PRINT:NO:2]
 +
 +
Change this to YES to only refresh portions of the screen that need to be refreshed.  This can have a significant impact on frame rate, especially for people that have slow frame rates on the title screen.  The number refers to how many frames it will redo a printed tile before skipping it, so you might try increasing it a bit.  '''PARTIAL_PRINT''' only works on certain systems, so you might have to disable it again if you notice your display isn't working properly.  Fixes are being investigated.
  
*[SHOW_EMBARK_RIVER:FINDER]
+
----
*[SHOW_EMBARK_POOL:FINDER]
 
*[SHOW_EMBARK_M_PIPE:FINDER]
 
*[SHOW_EMBARK_M_POOL:FINDER]
 
*[SHOW_EMBARK_CHASM:FINDER]
 
*[SHOW_EMBARK_PIT:FINDER]
 
*[SHOW_EMBARK_OTHER:FINDER]
 
*[SHOW_EMBARK_TUNNEL:FINDER]
 
  
:{{a|FINDER|You}} can change these to ALWAYS and NO.  More restrictive world parameter settings override these.  ALWAYS lets you see the features in the Local view during embark, and NO stops you from '''searching for features with the site finder''', which is the default (FINDER). ''(If you really want to stop the finder, it might be better for you to generate worlds that restrict the use of this feature completely, in which case you don't need to change the settings here).''
+
:[TOPMOST:NO]
  
 +
Change this to YES to keep the DF window on '''top''' of your other windows.<br>
  
 
----
 
----
  
 +
:[FPS:NO]
  
*[TEMPERATURE:YES]
+
{{a|FPS|Change}} this to YES if you want to see an '''FPS counter''' at the top left.
*[WEATHER:YES]
 
*[ECONOMY:YES]
 
*[INVADERS:YES]
 
*[CAVEINS:YES]
 
*[ARTIFACTS:YES]
 
*[ZERO_RENT:NO]
 
  
:Use these options to '''remove features''' from the game.  Permitted values are YES and NO.  Removal might improve [[FPS|game speed]] in the case of temperature and weather.
+
----
  
Setting TEMPERATURE to NO will disable such things as magma melting objects, water freezing in cold climates, and fires.  Setting WEATHER to NO will stop rainfall.  Setting ECONOMY to NO will turn off the dwarven economy.  Setting INVASIONS to NO will disable sieges, ambushes, thieves, babysnatchers, and animal swarms such as [[rhesus macaque]].  Setting CAVEINS to NO will stop unconnected constructions and natural features from falling.  Setting ARTIFACTS to NO will disable strange [[mood]]s in your fortresses.  Setting ZERO_RENT to YES makes the rent on all rooms 0 (relevant to the economy).
+
:[FPS_CAP:100]
  
 +
Use this to set the '''maximum frame rate''' during play.  The movies are always capped at 100.  A frame in this case is not graphical but related to the movement speed of a creature.  A healthy, unencumbered dwarven peasant takes one step every 10 frames.
  
 
----
 
----
  
 +
:[G_FPS_CAP:50]
  
*[LOG_MAP_REJECTS:NO]
+
Use this to set the maximum '''graphical frame refresh rate''' during play.
  
:Change this to YES to output the reasons for world '''map rejection into a file'''.
+
----
 +
 +
:[VSYNC:OFF]
  
 +
This sets the applications '''vertical synchronization''' behavior.  Changing this to ON can impact your FPS if your G_FPS is high.  The other options are ON and DEFAULT.  DEFAULT uses whatever settings you have your system at in general.
  
 
----
 
----
  
 +
:[TEXTURE_PARAM:NEAREST]
  
*[EMBARK_RECTANGLE:6:6]
+
Change this to LINEAR if you want the '''texture''' values to be averaged over the adjacent pixels.
 
 
:Change these numbers to make the default '''embark rectangle''' a different size. (You can still change it in the embark screen.) The format is (EMBARK_RECTANGLE:<width>:<height>).  Numbers may run from 2 to 16.  The map size warning message will go by these numbers.
 
 
 
  
 
----
 
----
  
 +
:[PRIORITY:NORMAL]
  
*[PATH_COST:1:2:5:25]
+
Change this to make the dwarfort.exe process have a different '''priority'''.  From highest to lowest, the options are REALTIME, HIGH, ABOVE_NORMAL, NORMAL, BELOW_NORMAL and IDLE.
  
:Change these numbers to set the default '''weights for traffic''' designations.  If you make the last numbers too large, pathfinding might lag.
+
----
:The format is (PATH_COST:<high>:<normal>:<low>:<restricted>).
 
  
 +
:[MOUSE:YES]
  
 +
Change this to NO if you don't want to have the '''mouse''' involved at all.
  
 
----
 
----
  
 +
:[MOUSE_PICTURE:NO]
  
*[STORE_DIST_ITEM_DECREASE:20]
+
Change this to YES if you'd like to use a BMP for the '''mouse cursor'''.  The image currently lags when the game is lagging however.
*[STORE_DIST_SEED_COMBINE:1000]
 
*[STORE_DIST_BUCKET_COMBINE:1000]
 
*[STORE_DIST_BARREL_COMBINE:1000]
 
*[STORE_DIST_BIN_COMBINE:1000]
 
  
:Alter these options to control how aggressively your dwarves place objects in a '''container with like items''' (rather than an empty container).  The default options are very aggressive.  STORE_DIST_ITEM_DECREASE controls the cap on objects it will consider -- for each object it finds in a container, one tile is removed from its apparent distance to the dwarf, up to this cap.  The others control how many tiles are removed for each combination type for any match at all. 
+
===Seasonal autosave===
  
::(For instance, if ITEM_DECREASE is set to 20, and SEED_COMBINE is set to 100, a dwarf carrying seeds will see a seed bag with 15 seeds as 115 tiles closer than it actually is (and thus pass up any empties within that distance), whereas a seed bag with 30 seeds would be treated as 120 tiles closer (because it hits the ITEM_DECREASE cap).  Values from 2 to 1000 are permitted.  Before these init options, the behavior was roughly ITEM_DECREASE 2, SEED_COMBINE 2 and the rest at 1000.)
+
:[AUTOSAVE:NONE]
 +
:[AUTOBACKUP:NO]
 +
:[AUTOSAVE_PAUSE:NO]
  
 +
Use these to control the '''automatic saving''' behavior in the dwarf fortress mode of game.  AUTOSAVE can be set to NONE, SEASONAL or YEARLY.  This updates your save at these intervals, so that some of your progress will be saved in case of system instability.  You can set AUTOBACKUP to YES if you want the updated save to be copied to another folder so that you'll have several copies of your world at different times.  Set AUTOSAVE_PAUSE to YES if you want the game to pause every time it autosaves.
  
 
----
 
----
  
 +
:[INITIAL_SAVE:NO]
  
*[COFFIN_NO_PETS_DEFAULT:NO]
+
Set this to YES if you want it to '''automatically save the game when you start''' a new fortress.  If AUTOBACKUP above is set to YES, it will also create a copy of this new save.
  
:Change this to YES to disallow '''pets from coffin burial''' as the default option.
+
----
  
 +
:[PAUSE_ON_LOAD:NO]
  
 +
Set this to YES to make Dwarf Fortress '''start paused''' whenever you load an active game.
  
 
----
 
----
  
 +
:[EMBARK_WARNING_ALWAYS:NO]
 +
 +
Set this to YES if you want Dwarf Fortress to show the '''warning window on embark''' as a confirmation even if there are no issues.
  
*[SKY:178:3:0:0]
+
----
  
:This controls the '''display of areas''' that are far below outside.  The format is SKY:<character>:<foreground color>:<background color>:<brightness>.  The <character> can be either an ASCII tile number or a character in quotes, like '#'.
+
:[SHOW_EMBARK_RIVER:FINDER]
 +
:[SHOW_EMBARK_POOL:FINDER]
 +
:[SHOW_EMBARK_M_PIPE:FINDER]
 +
:[SHOW_EMBARK_M_POOL:FINDER]
 +
:[SHOW_EMBARK_CHASM:FINDER]
 +
:[SHOW_EMBARK_PIT:FINDER]
 +
:[SHOW_EMBARK_OTHER:FINDER]
 +
:[SHOW_EMBARK_TUNNEL:FINDER]
  
 +
{{a|FINDER|You}} can change these to ALWAYS and NO.  More restrictive world parameter settings override these.  ALWAYS lets you see the features in the Local view during embark, and NO stops you from '''searching for features with the site finder''', which is the default (FINDER). ''(If you really want to stop the finder, it might be better for you to generate worlds that restrict the use of this feature completely, in which case you don't need to change the settings here).''
  
 
----
 
----
  
 +
:[TEMPERATURE:YES]
 +
:[WEATHER:YES]
 +
:[ECONOMY:YES]
 +
:[INVADERS:YES]
 +
:[CAVEINS:YES]
 +
:[ARTIFACTS:YES]
 +
:[ZERO_RENT:NO]
  
*[CHASM:250:0:0:1]
+
Use these options to '''remove features''' from the game.  Permitted values are YES and NO.  Removal might improve [[FPS|game speed]] in the case of temperature and weather.
 
 
:As above, for '''inside/subterranean''' areas.
 
  
 +
Setting TEMPERATURE to NO will disable such things as magma melting objects, water freezing in cold climates, and fires.  Setting WEATHER to NO will stop rainfall.  Setting ECONOMY to NO will turn off the dwarven economy.  Setting INVASIONS to NO will disable sieges, ambushes, thieves, babysnatchers, and animal swarms such as [[rhesus macaque]].  Setting CAVEINS to NO will stop unconnected constructions and natural features from falling.  Setting ARTIFACTS to NO will disable strange [[mood]]s in your fortresses.  Setting ZERO_RENT to YES makes the rent on all rooms 0 (relevant to the economy).
  
 
----
 
----
  
 +
:[LOG_MAP_REJECTS:NO]
  
*[IDLERS:TOP]
+
Change this to YES to output the reasons for world '''map rejection into a file'''.
  
:This controls the "'''IDLERS: <number>'''" that is displayed in dwarf mode.  You can set it to TOP, BOTTOM or OFF.
+
----
  
 +
:[EMBARK_RECTANGLE:6:6]
  
 +
Change these numbers to make the default '''embark rectangle''' a different size. (You can still change it in the embark screen.) The format is (EMBARK_RECTANGLE:<width>:<height>).  Numbers may run from 2 to 16.  The map size warning message will go by these numbers.
  
 
----
 
----
  
 +
:[PATH_COST:1:2:5:25]
  
*[POPULATION_CAP:200]
+
Change these numbers to set the default '''weights for traffic''' designations. If you make the last numbers too large, pathfinding might lag.
 
 
:'''{{a|POPULATION|The "Population cap"}}''' feature is poorly named. When this limit is reached, it stops [[Immigration|immigration]] - but if you are so much as 1 dwarf under the cap, a full wave of 2 dozen or more migrants can arrive - and then births can push that even higher.  Keep in mind that your population must be at least 80 to get a king and 100 to obtain all the current game features. (Setting the pop cap somewhere around 15-25 ''under'' your target goal is recommended.)
 
:Setting this cap below about 20-30 doesn't appear to have any effect. <sup>(More research needed.)</sup>
 
  
 +
The format is (PATH_COST:<high>:<normal>:<low>:<restricted>).
  
 
----
 
----
  
 +
:[STORE_DIST_ITEM_DECREASE:20]
 +
:[STORE_DIST_SEED_COMBINE:1000]
 +
:[STORE_DIST_BUCKET_COMBINE:1000]
 +
:[STORE_DIST_BARREL_COMBINE:1000]
 +
:[STORE_DIST_BIN_COMBINE:1000]
  
*[BABY_CHILD_CAP:100:1000]
+
Alter these options to control how aggressively your dwarves place objects in a '''container with like items''' (rather than an empty container).  The default options are very aggressive.  STORE_DIST_ITEM_DECREASE controls the cap on objects it will consider -- for each object it finds in a container, one tile is removed from its apparent distance to the dwarf, up to this cap.  The others control how many tiles are removed for each combination type for any match at all. 
  
:This allows you to control the number of''' babies+children''' in your fortress.  The first number is an absolute cap on the number of babies+children.  The second is a percentage of the current number of adults in your fortress (the default is the essentially meaningless 1000% here).  The lower number is used as the capThe cap only prevents further pregnancies, so migrant children, multiple births and existing pregnancies from old saves can still push you over the cap.  Setting either number to zero will disallow pregnancies in the fortress.
+
For instance, if ITEM_DECREASE is set to 20, and SEED_COMBINE is set to 100, a dwarf carrying seeds will see a seed bag with 15 seeds as 115 tiles closer than it actually is (and thus pass up any empties within that distance), whereas a seed bag with 30 seeds would be treated as 120 tiles closer (because it hits the ITEM_DECREASE cap).  Values from 2 to 1000 are permittedBefore these init options, the behavior was roughly ITEM_DECREASE 2, SEED_COMBINE 2 and the rest at 1000.
  
 +
----
  
----
+
:[COFFIN_NO_PETS_DEFAULT:NO]
  
 +
Change this to YES to disallow '''pets from coffin burial''' as the default option.
  
*[VARIED_GROUND_TILES:YES]
+
----
  
:If you don't like the ''',.`' ground''', try setting this to NO.  The ground will turn into periods only.
+
:[SKY:178:3:0:0]
  
 +
:his controls the '''display of areas''' that are far below outside.  The format is SKY:<character>:<foreground color>:<background color>:<brightness>.  The <character> can be either an ASCII tile number or a character in quotes, like '#'.
  
 
----
 
----
  
 +
:[CHASM:250:0:0:1]
 +
 +
As above, for '''inside/subterranean''' areas.
  
*[ENGRAVINGS_START_OBSCURED:NO]
+
----
  
:If you'd like your '''engravings''' to start off looking the same (you can toggle them on individual later), set this to YES.
+
:[IDLERS:TOP]
  
 +
This controls the "'''IDLERS: <number>'''" that is displayed in dwarf mode.  You can set it to TOP, BOTTOM or OFF.
  
 
----
 
----
  
 +
:[POPULATION_CAP:200]
  
*[SHOW_IMP_QUALITY:YES]
+
'''{{a|POPULATION|The "Population cap"}}''' feature is poorly named. When this limit is reached, it stops [[Immigration|immigration]] - but if you are so much as 1 dwarf under the cap, a full wave of 2 dozen or more migrants can arrive - and then births can push that even higher.  Keep in mind that your population must be at least 80 to get a king and 100 to obtain all the current game features. (Setting the pop cap somewhere around 15-25 ''under'' your target goal is recommended.)
 
 
:If you get annoyed by seeing '''improved/decorated items''' like *<*sword*>* you can
 
get rid of the outside ** by setting this to NO.
 
  
 +
Setting this cap below about 20-30 doesn't seem to work.
  
 
----
 
----
  
 +
:[BABY_CHILD_CAP:100:1000]
  
*[SHOW_FLOW_AMOUNTS:NO]
+
This allows you to control the number of''' babies+children''' in your fortress.  The first number is an absolute cap on the number of babies+children.  The second is a percentage of the current number of adults in your fortress (the default is the essentially meaningless 1000% here).  The lower number is used as the cap.  The cap only prevents further pregnancies, so migrant children, multiple births and existing pregnancies from old saves can still push you over the cap.  Setting either number to zero will disallow pregnancies in the fortress.
  
:{{a|FLOW|Set}} this to YES to '''display fluids''' as numbers indicating depth.
+
----
  
 +
:[VARIED_GROUND_TILES:YES]
 +
 +
If you don't like the ''',.`' ground''', try setting this to NO.  The ground will turn into periods only.
  
 
----
 
----
  
 +
:[ENGRAVINGS_START_OBSCURED:NO]
  
*[SHOW_ALL_HISTORY_IN_DWARF_MODE:NO]
+
If you'd like your '''engravings''' to start off looking the same (you can toggle them on individual later), set this to YES.
  
:If you'd prefer to have it show the '''history''' behind every engraving you view in dwarf mode, etc., then set this to YES.
+
----
  
 +
:[SHOW_IMP_QUALITY:YES]
 +
 +
If you get annoyed by seeing '''improved/decorated items''' like *<*sword*>* you can
 +
get rid of the outside ** by setting this to NO.
  
 
----
 
----
  
 +
:[SHOW_FLOW_AMOUNTS:NO]
  
*[KEY_HOLD_MS:150]
+
{{a|FLOW|Set}} this to YES to '''display fluids''' as numbers indicating depth.
 
 
:This controls the number of milliseconds that must pass '''before a held key sends a repeat''' press to the game.  You might need to adjust this.
 
 
 
  
 
----
 
----
  
 +
:[SHOW_ALL_HISTORY_IN_DWARF_MODE:NO]
  
*[RECENTER_INTERFACE_SHUTDOWN_MS:0]
+
If you'd prefer to have it show the '''history''' behind every engraving you view in dwarf mode, etc., then set this to YES.
 
 
:This controls the number of milliseconds that must pass '''before input works again''' after the view recenters on an event in dwarf mode.
 
  
 
===== Adventure mode =====
 
 
----
 
----
  
 +
:[KEY_HOLD_MS:150]
  
*[MORE:YES]
+
This controls the number of milliseconds that must pass '''before a held key sends a repeat''' press to the gameYou might need to adjust this.
*[DISPLAY_LENGTH:23]
 
 
 
:This controls '''"more" in adventure mode'''.  If MORE is set to NO, all announcements will be skipped.  DISPLAY_LENGTH controls how many lines are printed before it gives you the "more" prompt.
 
  
 +
----
  
----
+
:[RECENTER_INTERFACE_SHUTDOWN_MS:0]
  
 +
This controls the number of milliseconds that must pass '''before input works again''' after the view recenters on an event in dwarf mode.
  
*[ADVENTURER_TRAPS:NO]
+
=== Adventurer mode ===
  
:Set this to YES if you want '''traps''' to affect you in adventure mode.  This is not recommended -- there are lockup issues with cage traps, and you cannot disarm any of the traps yet, so they effectively stops you from exploring your old fortresses.
+
:[MORE:YES]
 +
:[DISPLAY_LENGTH:23]
  
 +
This controls '''"more" in adventure mode'''.  If MORE is set to NO, all announcements will be skipped.  DISPLAY_LENGTH controls how many lines are printed before it gives you the "more" prompt.
  
 
----
 
----
  
 +
:[ADVENTURER_TRAPS:NO]
  
*[ADVENTURER_ALWAYS_CENTER:YES]
+
Set this to YES if you want '''traps''' to affect you in adventure mode.  This is not recommended -- there are lockup issues with cage traps, and you cannot disarm any of the traps yet, so they effectively stops you from exploring your old fortresses.
 
 
:Set this to NO if you want the game to '''recenter on your adventurer''' only when you've gotten close to the edge of the view.
 
  
 +
'''NOTE''': Due to a bug, it isn't actually possible to turn this setting on - if you try, it'll just turn on the "ADVENTURER_ALWAYS_CENTER" setting instead.
  
 
----
 
----
  
 +
:[ADVENTURER_ALWAYS_CENTER:YES]
  
*[ADVENTURER_Z_VIEWS:UNHIDDEN:9]
+
Set this to NO if you want the game to '''recenter on your adventurer''' only when you've gotten close to the edge of the view.
 
 
:This controls the '''up/down views''' in adventure mode.  The first parameter can be OFF, UNHIDDEN, CREATURE or ON.  UNHIDDEN makes the view appear when it contains any unhidden square.  CREATURE makes the view appear when it contains a creature.  The second parameter is the size of the view. It can be 3, 5, 7 or 9.  A smaller view lets it stack more of them in the column (3 at size 5, and 5 at size 3).
 
 
 
  
 
----
 
----
  
 +
:[ADVENTURER_Z_VIEWS:UNHIDDEN:9]
  
=====Nicknames=====
+
This controls the '''up/down views''' in adventure mode.  The first parameter can be OFF, UNHIDDEN, CREATURE or ON.  UNHIDDEN makes the view appear when it contains any unhidden square.  CREATURE makes the view appear when it contains a creature.  The second parameter is the size of the view.  It can be 3, 5, 7 or 9.  A smaller view lets it stack more of them in the column (3 at size 5, and 5 at size 3).
  
*[NICKNAME_DWARF:REPLACE_FIRST]
+
===Nicknames===
*[NICKNAME_ADVENTURE:REPLACE_FIRST]
 
*[NICKNAME_LEGENDS:REPLACE_FIRST]
 
  
:You can use these to say how '''nicknames''' are displayed in both Adventure and Fortress mode.
+
:[NICKNAME_DWARF:REPLACE_FIRST]
:Options are REPLACE_FIRST, CENTRALIZE (between first and last), REPLACE_ALL.
+
:[NICKNAME_ADVENTURE:REPLACE_FIRST]
 
+
:[NICKNAME_LEGENDS:REPLACE_FIRST]
 
 
----
 
  
 +
You can use these to say how '''nicknames''' are displayed in both Adventure and Fortress mode. Options are REPLACE_FIRST, CENTRALIZE (between first and last), REPLACE_ALL.
  
==== Display Colors in RGB ====
+
=== Display Colors in RGB ===
 
These next ''(and last!)'' are the '''display colors''' in RGB, Red/Green/Blue format.  The game is actually displaying extended ASCII characters that are in OpenGL, so you can modify the [[color scheme]] to suit.
 
These next ''(and last!)'' are the '''display colors''' in RGB, Red/Green/Blue format.  The game is actually displaying extended ASCII characters that are in OpenGL, so you can modify the [[color scheme]] to suit.
  
 
The [[Color_scheme#Default_Scheme|default color scheme]] is shown below.
 
The [[Color_scheme#Default_Scheme|default color scheme]] is shown below.
  
[BLACK_R:0]<br>
+
:[BLACK_R:0]
[BLACK_G:0]<br>
+
:[BLACK_G:0]
[BLACK_B:0]<br>
+
:[BLACK_B:0]
[BLUE_R:0]<br>
+
:[BLUE_R:0]
[BLUE_G:0]<br>
+
:[BLUE_G:0]
[BLUE_B:128]<br>
+
:[BLUE_B:128]
[GREEN_R:0]<br>
+
:[GREEN_R:0]
[GREEN_G:128]<br>
+
:[GREEN_G:128]
[GREEN_B:0]<br>
+
:[GREEN_B:0]
[CYAN_R:0]<br>
+
:[CYAN_R:0]
[CYAN_G:128]<br>
+
:[CYAN_G:128]
[CYAN_B:128]<br>
+
:[CYAN_B:128]
[RED_R:128]<br>
+
:[RED_R:128]
[RED_G:0]<br>
+
:[RED_G:0]
[RED_B:0]<br>
+
:[RED_B:0]
[MAGENTA_R:128]<br>
+
:[MAGENTA_R:128]
[MAGENTA_G:0]<br>
+
:[MAGENTA_G:0]
[MAGENTA_B:128]<br>
+
:[MAGENTA_B:128]
[BROWN_R:128]<br>
+
:[BROWN_R:128]
[BROWN_G:128]<br>
+
:[BROWN_G:128]
[BROWN_B:0]<br>
+
:[BROWN_B:0]
[LGRAY_R:192]<br>
+
:[LGRAY_R:192]
[LGRAY_G:192]<br>
+
:[LGRAY_G:192]
[LGRAY_B:192]<br>
+
:[LGRAY_B:192]
[DGRAY_R:128]<br>
+
:[DGRAY_R:128]
[DGRAY_G:128]<br>
+
:[DGRAY_G:128]
[DGRAY_B:128]<br>
+
:[DGRAY_B:128]
[LBLUE_R:0]<br>
+
:[LBLUE_R:0]
[LBLUE_G:0]<br>
+
:[LBLUE_G:0]
[LBLUE_B:255]<br>
+
:[LBLUE_B:255]
[LGREEN_R:0]<br>
+
:[LGREEN_R:0]
[LGREEN_G:255]<br>
+
:[LGREEN_G:255]
[LGREEN_B:0]<br>
+
:[LGREEN_B:0]
[LCYAN_R:0]<br>
+
:[LCYAN_R:0]
[LCYAN_G:255]<br>
+
:[LCYAN_G:255]
[LCYAN_B:255]<br>
+
:[LCYAN_B:255]
[LRED_R:255]<br>
+
:[LRED_R:255]
[LRED_G:0]<br>
+
:[LRED_G:0]
[LRED_B:0]<br>
+
:[LRED_B:0]
[LMAGENTA_R:255]<br>
+
:[LMAGENTA_R:255]
[LMAGENTA_G:0]<br>
+
:[LMAGENTA_G:0]
[LMAGENTA_B:255]<br>
+
:[LMAGENTA_B:255]
[YELLOW_R:255]<br>
+
:[YELLOW_R:255]
[YELLOW_G:255]<br>
+
:[YELLOW_G:255]
[YELLOW_B:0]<br>
+
:[YELLOW_B:0]
[WHITE_R:255]<br>
+
:[WHITE_R:255]
[WHITE_G:255]<br>
+
:[WHITE_G:255]
[WHITE_B:255]<br>
+
:[WHITE_B:255]
  
[[Category:Files]]
+
[[Category:40d:Files]]

Latest revision as of 10:32, 10 May 2024

File

Folder-orange.svg Dwarf Fortress

Folder.svg data

Folder.svg init

Text-x-generic.svg init.txt

This article is about an older version of DF.

The init.txt file is used to make many adjustments to the game presentation and feel, such as improving framerate, screen size, or for the use of Tilesets and Character sets.

This file is located at Dwarf Fortress/data/init/init.txt.

The contents of the init.txt file are as follows:

Additional hotlinked topics on this page[edit]

Use these links to skip directly to certain key locations in the init file.

Default init.txt[edit]

Audio/Visual[edit]

[SOUND:ON]

Change this to turn sound OFF.


[VOLUME:255]

The sound volume runs from 0 (off) to 255 (full). You can set the volume from the ESC options menu as well.


[INTRO:ON]

Change this to skip the wonderful intro movies.


[WINDOWED:PROMPT]

This lets you set the starting windowed/fullscreen setting. Can be YES, NO or PROMPT.


[WINDOWEDX:640]
[WINDOWEDY:300]
[FONT:curses_640x300.bmp]

This is the size and font for windowed mode. Changing to 800x600 and the 800x600 font might make you happier.


[FULLSCREENX:800]
[FULLSCREENY:600]
[FULLFONT:curses_800x600.bmp]

Full screen info.


[BLACK_SPACE:NO]

If this is set to YES, the tiles will not be stretched, but rather the game view will be centralized, surrounded by black space. Tiles that are too large will always be compressed rather than running off the screen.


[GRAPHICS:NO]
[GRAPHICS_WINDOWEDX:1280]
[GRAPHICS_WINDOWEDY:400]
[GRAPHICS_FONT:curses_square_16x16.bmp]
[GRAPHICS_FULLSCREENX:1280]
[GRAPHICS_FULLSCREENY:800]
[GRAPHICS_FULLFONT:curses_square_16x16.bmp]
[GRAPHICS_BLACK_SPACE:YES]

Graphics info, most of it as above. Set GRAPHICS to YES to turn it all on. This will use the "raw/graphics" folder for tile information. Currently this is limited to whatever creature graphics you have downloaded. The game comes with a few pictures to demonstrate. As of February 2008, the Dwarf Fortress Wiki has graphical tilesets available at http://www.dwarffortresswiki.org/index.php/Graphics_sets.


[GRID:80:25]
[FULLGRID:80:25]

This is the dimensions in tiles of the display grid. Minimum x is 80. Minimum y is 25. Maximums are 200. Make sure the window size or full screen resolution matches the grid/tile size if you don't want the display to be squashed or stretched. The default windowed font has tiles that are 8x12 pixels, for instance, so for a 80x25 grid, you use a 640x300 window, and for a 125x50 grid, you'd use a 1000x600 window. FULLGRID is used in full screen mode, whether graphics is on or not.


[PARTIAL_PRINT:NO:2]

Change this to YES to only refresh portions of the screen that need to be refreshed. This can have a significant impact on frame rate, especially for people that have slow frame rates on the title screen. The number refers to how many frames it will redo a printed tile before skipping it, so you might try increasing it a bit. PARTIAL_PRINT only works on certain systems, so you might have to disable it again if you notice your display isn't working properly. Fixes are being investigated.


[TOPMOST:NO]

Change this to YES to keep the DF window on top of your other windows.


[FPS:NO]

Change this to YES if you want to see an FPS counter at the top left.


[FPS_CAP:100]

Use this to set the maximum frame rate during play. The movies are always capped at 100. A frame in this case is not graphical but related to the movement speed of a creature. A healthy, unencumbered dwarven peasant takes one step every 10 frames.


[G_FPS_CAP:50]

Use this to set the maximum graphical frame refresh rate during play.


[VSYNC:OFF]

This sets the applications vertical synchronization behavior. Changing this to ON can impact your FPS if your G_FPS is high. The other options are ON and DEFAULT. DEFAULT uses whatever settings you have your system at in general.


[TEXTURE_PARAM:NEAREST]

Change this to LINEAR if you want the texture values to be averaged over the adjacent pixels.


[PRIORITY:NORMAL]

Change this to make the dwarfort.exe process have a different priority. From highest to lowest, the options are REALTIME, HIGH, ABOVE_NORMAL, NORMAL, BELOW_NORMAL and IDLE.


[MOUSE:YES]

Change this to NO if you don't want to have the mouse involved at all.


[MOUSE_PICTURE:NO]

Change this to YES if you'd like to use a BMP for the mouse cursor. The image currently lags when the game is lagging however.

Seasonal autosave[edit]

[AUTOSAVE:NONE]
[AUTOBACKUP:NO]
[AUTOSAVE_PAUSE:NO]

Use these to control the automatic saving behavior in the dwarf fortress mode of game. AUTOSAVE can be set to NONE, SEASONAL or YEARLY. This updates your save at these intervals, so that some of your progress will be saved in case of system instability. You can set AUTOBACKUP to YES if you want the updated save to be copied to another folder so that you'll have several copies of your world at different times. Set AUTOSAVE_PAUSE to YES if you want the game to pause every time it autosaves.


[INITIAL_SAVE:NO]

Set this to YES if you want it to automatically save the game when you start a new fortress. If AUTOBACKUP above is set to YES, it will also create a copy of this new save.


[PAUSE_ON_LOAD:NO]

Set this to YES to make Dwarf Fortress start paused whenever you load an active game.


[EMBARK_WARNING_ALWAYS:NO]

Set this to YES if you want Dwarf Fortress to show the warning window on embark as a confirmation even if there are no issues.


[SHOW_EMBARK_RIVER:FINDER]
[SHOW_EMBARK_POOL:FINDER]
[SHOW_EMBARK_M_PIPE:FINDER]
[SHOW_EMBARK_M_POOL:FINDER]
[SHOW_EMBARK_CHASM:FINDER]
[SHOW_EMBARK_PIT:FINDER]
[SHOW_EMBARK_OTHER:FINDER]
[SHOW_EMBARK_TUNNEL:FINDER]

You can change these to ALWAYS and NO. More restrictive world parameter settings override these. ALWAYS lets you see the features in the Local view during embark, and NO stops you from searching for features with the site finder, which is the default (FINDER). (If you really want to stop the finder, it might be better for you to generate worlds that restrict the use of this feature completely, in which case you don't need to change the settings here).


[TEMPERATURE:YES]
[WEATHER:YES]
[ECONOMY:YES]
[INVADERS:YES]
[CAVEINS:YES]
[ARTIFACTS:YES]
[ZERO_RENT:NO]

Use these options to remove features from the game. Permitted values are YES and NO. Removal might improve game speed in the case of temperature and weather.

Setting TEMPERATURE to NO will disable such things as magma melting objects, water freezing in cold climates, and fires. Setting WEATHER to NO will stop rainfall. Setting ECONOMY to NO will turn off the dwarven economy. Setting INVASIONS to NO will disable sieges, ambushes, thieves, babysnatchers, and animal swarms such as rhesus macaque. Setting CAVEINS to NO will stop unconnected constructions and natural features from falling. Setting ARTIFACTS to NO will disable strange moods in your fortresses. Setting ZERO_RENT to YES makes the rent on all rooms 0 (relevant to the economy).


[LOG_MAP_REJECTS:NO]

Change this to YES to output the reasons for world map rejection into a file.


[EMBARK_RECTANGLE:6:6]

Change these numbers to make the default embark rectangle a different size. (You can still change it in the embark screen.) The format is (EMBARK_RECTANGLE:<width>:<height>). Numbers may run from 2 to 16. The map size warning message will go by these numbers.


[PATH_COST:1:2:5:25]

Change these numbers to set the default weights for traffic designations. If you make the last numbers too large, pathfinding might lag.

The format is (PATH_COST:<high>:<normal>:<low>:<restricted>).


[STORE_DIST_ITEM_DECREASE:20]
[STORE_DIST_SEED_COMBINE:1000]
[STORE_DIST_BUCKET_COMBINE:1000]
[STORE_DIST_BARREL_COMBINE:1000]
[STORE_DIST_BIN_COMBINE:1000]

Alter these options to control how aggressively your dwarves place objects in a container with like items (rather than an empty container). The default options are very aggressive. STORE_DIST_ITEM_DECREASE controls the cap on objects it will consider -- for each object it finds in a container, one tile is removed from its apparent distance to the dwarf, up to this cap. The others control how many tiles are removed for each combination type for any match at all.

For instance, if ITEM_DECREASE is set to 20, and SEED_COMBINE is set to 100, a dwarf carrying seeds will see a seed bag with 15 seeds as 115 tiles closer than it actually is (and thus pass up any empties within that distance), whereas a seed bag with 30 seeds would be treated as 120 tiles closer (because it hits the ITEM_DECREASE cap). Values from 2 to 1000 are permitted. Before these init options, the behavior was roughly ITEM_DECREASE 2, SEED_COMBINE 2 and the rest at 1000.


[COFFIN_NO_PETS_DEFAULT:NO]

Change this to YES to disallow pets from coffin burial as the default option.


[SKY:178:3:0:0]
his controls the display of areas that are far below outside. The format is SKY:<character>:<foreground color>:<background color>:<brightness>. The <character> can be either an ASCII tile number or a character in quotes, like '#'.

[CHASM:250:0:0:1]

As above, for inside/subterranean areas.


[IDLERS:TOP]

This controls the "IDLERS: <number>" that is displayed in dwarf mode. You can set it to TOP, BOTTOM or OFF.


[POPULATION_CAP:200]

The "Population cap" feature is poorly named. When this limit is reached, it stops immigration - but if you are so much as 1 dwarf under the cap, a full wave of 2 dozen or more migrants can arrive - and then births can push that even higher. Keep in mind that your population must be at least 80 to get a king and 100 to obtain all the current game features. (Setting the pop cap somewhere around 15-25 under your target goal is recommended.)

Setting this cap below about 20-30 doesn't seem to work.


[BABY_CHILD_CAP:100:1000]

This allows you to control the number of babies+children in your fortress. The first number is an absolute cap on the number of babies+children. The second is a percentage of the current number of adults in your fortress (the default is the essentially meaningless 1000% here). The lower number is used as the cap. The cap only prevents further pregnancies, so migrant children, multiple births and existing pregnancies from old saves can still push you over the cap. Setting either number to zero will disallow pregnancies in the fortress.


[VARIED_GROUND_TILES:YES]

If you don't like the ,.`' ground, try setting this to NO. The ground will turn into periods only.


[ENGRAVINGS_START_OBSCURED:NO]

If you'd like your engravings to start off looking the same (you can toggle them on individual later), set this to YES.


[SHOW_IMP_QUALITY:YES]

If you get annoyed by seeing improved/decorated items like *<*sword*>* you can get rid of the outside ** by setting this to NO.


[SHOW_FLOW_AMOUNTS:NO]

Set this to YES to display fluids as numbers indicating depth.


[SHOW_ALL_HISTORY_IN_DWARF_MODE:NO]

If you'd prefer to have it show the history behind every engraving you view in dwarf mode, etc., then set this to YES.


[KEY_HOLD_MS:150]

This controls the number of milliseconds that must pass before a held key sends a repeat press to the game. You might need to adjust this.


[RECENTER_INTERFACE_SHUTDOWN_MS:0]

This controls the number of milliseconds that must pass before input works again after the view recenters on an event in dwarf mode.

Adventurer mode[edit]

[MORE:YES]
[DISPLAY_LENGTH:23]

This controls "more" in adventure mode. If MORE is set to NO, all announcements will be skipped. DISPLAY_LENGTH controls how many lines are printed before it gives you the "more" prompt.


[ADVENTURER_TRAPS:NO]

Set this to YES if you want traps to affect you in adventure mode. This is not recommended -- there are lockup issues with cage traps, and you cannot disarm any of the traps yet, so they effectively stops you from exploring your old fortresses.

NOTE: Due to a bug, it isn't actually possible to turn this setting on - if you try, it'll just turn on the "ADVENTURER_ALWAYS_CENTER" setting instead.


[ADVENTURER_ALWAYS_CENTER:YES]

Set this to NO if you want the game to recenter on your adventurer only when you've gotten close to the edge of the view.


[ADVENTURER_Z_VIEWS:UNHIDDEN:9]

This controls the up/down views in adventure mode. The first parameter can be OFF, UNHIDDEN, CREATURE or ON. UNHIDDEN makes the view appear when it contains any unhidden square. CREATURE makes the view appear when it contains a creature. The second parameter is the size of the view. It can be 3, 5, 7 or 9. A smaller view lets it stack more of them in the column (3 at size 5, and 5 at size 3).

Nicknames[edit]

[NICKNAME_DWARF:REPLACE_FIRST]
[NICKNAME_ADVENTURE:REPLACE_FIRST]
[NICKNAME_LEGENDS:REPLACE_FIRST]

You can use these to say how nicknames are displayed in both Adventure and Fortress mode. Options are REPLACE_FIRST, CENTRALIZE (between first and last), REPLACE_ALL.

Display Colors in RGB[edit]

These next (and last!) are the display colors in RGB, Red/Green/Blue format. The game is actually displaying extended ASCII characters that are in OpenGL, so you can modify the color scheme to suit.

The default color scheme is shown below.

[BLACK_R:0]
[BLACK_G:0]
[BLACK_B:0]
[BLUE_R:0]
[BLUE_G:0]
[BLUE_B:128]
[GREEN_R:0]
[GREEN_G:128]
[GREEN_B:0]
[CYAN_R:0]
[CYAN_G:128]
[CYAN_B:128]
[RED_R:128]
[RED_G:0]
[RED_B:0]
[MAGENTA_R:128]
[MAGENTA_G:0]
[MAGENTA_B:128]
[BROWN_R:128]
[BROWN_G:128]
[BROWN_B:0]
[LGRAY_R:192]
[LGRAY_G:192]
[LGRAY_B:192]
[DGRAY_R:128]
[DGRAY_G:128]
[DGRAY_B:128]
[LBLUE_R:0]
[LBLUE_G:0]
[LBLUE_B:255]
[LGREEN_R:0]
[LGREEN_G:255]
[LGREEN_B:0]
[LCYAN_R:0]
[LCYAN_G:255]
[LCYAN_B:255]
[LRED_R:255]
[LRED_G:0]
[LRED_B:0]
[LMAGENTA_R:255]
[LMAGENTA_G:0]
[LMAGENTA_B:255]
[YELLOW_R:255]
[YELLOW_G:255]
[YELLOW_B:0]
[WHITE_R:255]
[WHITE_G:255]
[WHITE_B:255]