- 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.
Difference between revisions of "40d:Init.txt"
m (moved Init.txt to 40d:Init.txt: 40d namespace migration) |
m (Bot: Adding {{av}}) |
||
Line 1: | Line 1: | ||
+ | {{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]]. | ||
Revision as of 08:06, 26 March 2010
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 by default can be found here.
Additional hotlinked topics on this page
Use these links to skip directly to certain key locations in the init file. |
Default init.txt v0.28.181.40d
Audio/Visual
- [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.net/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
- [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]
- 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 '#'.
- [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 appear to have any effect. (More research needed.)
- [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.
Adventure mode
- [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.
- [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
- [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
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]