updated on Sun Jan 15 20:01:04 UTC 2012

[aur-mirror.git] / dfg / init.txt

Change this to turn sound off.\r
\r
[SOUND:OFF]\r
\r
The sound volume runs from 0 (off) to 255 (full).  You can set the volume from the ESC options menu as well.\r
\r
[VOLUME:255]\r
\r
Change this to skip the wonderful intro movies.\r
\r
[INTRO:OFF]\r
\r
This lets you set the starting windowed/fullscreen setting.  Can be YES, NO or PROMPT.\r
\r
[WINDOWED:PROMPT]\r
\r
This is the size and font for windowed mode.  Changing to 800x600 and the 800x600 font might make you happier.\r
\r
[WINDOWEDX:640]\r
[WINDOWEDY:300]\r
[FONT:curses_640x300.png]\r
\r
Full screen info.  The 0s below mean that the game will choose a resolution for you, but you can set it yourself as well.\r
\r
[FULLSCREENX:0]\r
[FULLSCREENY:0]\r
[FULLFONT:curses_640x300.png]\r
\r
If this is set to NO, tiles will be stretched to fit the screen if there is a resolution mismatch.\r
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.\r
\r
[BLACK_SPACE:YES]\r
\r
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 September 2008, the Dwarf Fortress Wiki has graphical tilesets available at http://www.dwarffortresswiki.net/index.php/List_of_user_graphics_sets.\r
\r
[GRAPHICS:YES]\r
[GRAPHICS_WINDOWEDX:1024]\r
[GRAPHICS_WINDOWEDY:400]\r
[GRAPHICS_FONT:mayday.png]\r
[GRAPHICS_FULLSCREENX:0]\r
[GRAPHICS_FULLSCREENY:0]\r
[GRAPHICS_FULLFONT:mayday.png]\r
[GRAPHICS_BLACK_SPACE:YES]\r
\r
These settings can have a significant impact on frame rate, especially for people that have slow frame rates on the title screen.  Available modes are STANDARD, PARTIAL:<number>, ACCUM_BUFFER, FRAME_BUFFER and VBO.  The number after PARTIAL refers to how many frames it will redo a printed tile before skipping it, so you might try increasing it a bit if you have flickering when PARTIAL is set.  Please note that any of these combinations might cause frame rates to drop significantly or cause unpleasant side effects like flickering.\r
\r
[PRINT_MODE:STANDARD]\r
[SINGLE_BUFFER:NO]\r
\r
Change this to YES to keep the DF window on top of your other windows.\r
\r
[TOPMOST:NO]\r
\r
Change this to YES if you want to see an FPS counter at the top left.\r
\r
[FPS:NO]\r
\r
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.\r
\r
[FPS_CAP:100]\r
\r
Use this to set the maximum graphical frame refresh rate during play.\r
\r
[G_FPS_CAP:20]\r
\r
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.\r
\r
[VSYNC:OFF]\r
\r
Change this to NEAREST if you want the texture values to use the nearest pixel without averaging.\r
Change this to LINEAR if you want the texture values to be averaged over the adjacent pixels.\r
\r
[TEXTURE_PARAM:NEAREST]\r
\r
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.\r
\r
[PRIORITY:NORMAL]\r
\r
Use this to set how fast the game zooms.  The default corresponds to multiplying by a factor of 1.1 each time the zoom action occurs.  You can set it anywhere from 1.001 to 1.999.\r
\r
[ZOOM_FACTOR:1.999]\r
\r
Change this to NO if you don't want to have the mouse involved at all.\r
\r
[MOUSE:YES]\r
\r
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.\r
\r
[MOUSE_PICTURE:NO]\r
\r
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.\r
\r
[AUTOSAVE:NONE]\r
[AUTOBACKUP:NO]\r
[AUTOSAVE_PAUSE:NO]\r
\r
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.\r
\r
[INITIAL_SAVE:NO]\r
\r
Set this to YES to make Dwarf Fortress start paused whenever you load an active game.\r
\r
[PAUSE_ON_LOAD:NO]\r
\r
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.\r
\r
[EMBARK_WARNING_ALWAYS:NO]\r
\r
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).\r
\r
[SHOW_EMBARK_RIVER:FINDER]\r
[SHOW_EMBARK_POOL:FINDER]\r
[SHOW_EMBARK_M_PIPE:FINDER]\r
[SHOW_EMBARK_M_POOL:FINDER]\r
[SHOW_EMBARK_CHASM:FINDER]\r
[SHOW_EMBARK_PIT:FINDER]\r
[SHOW_EMBARK_OTHER:FINDER]\r
[SHOW_EMBARK_TUNNEL:FINDER]\r
\r
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.\r
\r
[TEMPERATURE:YES]\r
[WEATHER:YES]\r
[ECONOMY:YES]\r
[INVADERS:YES]\r
[CAVEINS:YES]\r
[ARTIFACTS:YES]\r
[ZERO_RENT:NO]\r
\r
Change this to YES to output the reasons for world map rejection into a file.\r
\r
[LOG_MAP_REJECTS:NO]\r
\r
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.\r
\r
[EMBARK_RECTANGLE:6:6]\r
\r
Change these numbers to set the default weights for traffic designations.  If you make the last numbers too large, pathfinding might lag.\r
The format is (PATH_COST:<high>:<normal>:<low>:<restricted>).\r
\r
[PATH_COST:1:2:5:25]\r
\r
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.\r
\r
[STORE_DIST_ITEM_DECREASE:20]\r
[STORE_DIST_SEED_COMBINE:1000]\r
[STORE_DIST_BUCKET_COMBINE:1000]\r
[STORE_DIST_BARREL_COMBINE:1000]\r
[STORE_DIST_BIN_COMBINE:1000]\r
\r
Change this to YES to disallow pets from coffin burial as the default option.\r
\r
[COFFIN_NO_PETS_DEFAULT:NO]\r
\r
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 '#'.\r
\r
[SKY:178:3:0:0]\r
\r
As above, for inside/subterranean areas.\r
\r
[CHASM:250:0:0:1]\r
\r
This controls the "IDLERS: <number>" that is displayed in dwarf mode.  You can set it to TOP, BOTTOM or OFF.\r
\r
[IDLERS:TOP]\r
\r
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.\r
\r
[POPULATION_CAP:200]\r
\r
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.\r
\r
[BABY_CHILD_CAP:100:1000]\r
\r
If you don't like the ,.`' ground, try setting this to NO.  The ground will turn into periods only.\r
\r
[VARIED_GROUND_TILES:YES]\r
\r
If you'd like your engravings to start off looking the same (you can toggle them on individual later), set this to YES.\r
\r
[ENGRAVINGS_START_OBSCURED:YES]\r
\r
If you get annoyed by seeing items like *<*sword*>* you can\r
get rid of the outside ** by setting this to NO.\r
\r
[SHOW_IMP_QUALITY:YES]\r
\r
Set this to YES to display fluids as numbers indicating depth.\r
\r
[SHOW_FLOW_AMOUNTS:NO]\r
\r
If you'd prefer to have it show the history behind every engraving you view in dwarf mode, etc., then set this to YES.\r
\r
[SHOW_ALL_HISTORY_IN_DWARF_MODE:YES]\r
\r
This controls the number of milliseconds that must pass before a held key sends an initial repeat press to the game.  You might need to adjust this.\r
\r
[KEY_HOLD_MS:150]\r
\r
This controls the number of milliseconds that must pass before a held key sends a repeat press to the game after the repeat process has begun.\r
\r
[KEY_REPEAT_MS:150]\r
\r
This controls the number of milliseconds between macro instructions.\r
\r
[MACRO_MS:1]\r
\r
This controls the number of milliseconds that must pass before input works again after the view recenters on an event in dwarf mode.\r
\r
[RECENTER_INTERFACE_SHUTDOWN_MS:0]\r
\r
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.\r
\r
[MORE:YES]\r
[DISPLAY_LENGTH:23]\r
\r
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.\r
\r
[ADVENTURER_TRAPS:NO]\r
\r
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.\r
\r
[ADVENTURER_ALWAYS_CENTER:YES]\r
\r
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).\r
\r
[ADVENTURER_Z_VIEWS:UNHIDDEN:9]\r
\r
You can use these to say how nicknames are displayed in each mode\r
Options are REPLACE_FIRST, CENTRALIZE (between first and last), REPLACE_ALL\r
[NICKNAME_DWARF:REPLACE_FIRST]\r
[NICKNAME_ADVENTURE:REPLACE_FIRST]\r
[NICKNAME_LEGENDS:REPLACE_FIRST]\r
\r
These are the display colors in RGB.  The game is actually displaying extended ASCII characters in OpenGL, so you can modify the colors.\r
\r
[BLACK_R:0]\r
[BLACK_G:0]\r
[BLACK_B:0]\r
\r
[BLUE_R:30]\r
[BLUE_G:50]\r
[BLUE_B:168]\r
\r
[GREEN_R:96]\r
[GREEN_G:170]\r
[GREEN_B:0]\r
\r
[CYAN_R:0]\r
[CYAN_G:128]\r
[CYAN_B:140]\r
\r
[RED_R:200]\r
[RED_G:20]\r
[RED_B:0]\r
\r
[MAGENTA_R:128]\r
[MAGENTA_G:50]\r
[MAGENTA_B:200]\r
\r
[BROWN_R:140]\r
[BROWN_G:98]\r
[BROWN_B:56]\r
\r
[LGRAY_R:192]\r
[LGRAY_G:192]\r
[LGRAY_B:192]\r
\r
[DGRAY_R:128]\r
[DGRAY_G:128]\r
[DGRAY_B:128]\r
\r
[LBLUE_R:0]\r
[LBLUE_G:120]\r
[LBLUE_B:255]\r
\r
[LGREEN_R:134]\r
[LGREEN_G:213]\r
[LGREEN_B:0]\r
\r
[LCYAN_R:0]\r
[LCYAN_G:200]\r
[LCYAN_B:255]\r
\r
[LRED_R:255]\r
[LRED_G:50]\r
[LRED_B:0]\r
\r
[LMAGENTA_R:210]\r
[LMAGENTA_G:10]\r
[LMAGENTA_B:255]\r
\r
[YELLOW_R:255]\r
[YELLOW_G:232]\r
[YELLOW_B:76]\r
\r
[WHITE_R:255]\r
[WHITE_G:250]\r
[WHITE_B:230]