interface.txt

xTATTEREDx  · +FINE+  · *SUPERIOR*  · ≡EXCEPTIONAL≡  · ☼MASTERWORK☼

v50.14 · v0.47.05 This article is about the current version of DF. Note that some content may still need to be updated. More Info · V

File
Dwarf Fortress
data
init
colors.txt

See Controls for the default key binds.

Key bindings

Key bindings determine how the game responds to the user (you) pressing different keys on their keyboard, numberpad, laptop, whatever.

To access the key bindings, start a game(or just edit interface.txt), then hit Esc - using the up/down arrows, highlight "Key Bindings" and hit Enter. This then shows the various game mode/screen categories (and Macros) selecting one shows all of the bindable game commands in that category.

On the left you see you see list of bindable commands and on the right side you see "Add binding" option the "Don't repeat", "Delayed repeat" and "Immediate repeat" after that refer to what happens when you hold down the key, the one in red is selected and finally the ones starting with "By position: " and "By letter: " are the currently set binds of the command.

For example if you wanted to add 9 to "Select" command(odd, but your choice) you would then select the General category, press right on the first command(Select) and hit Enter on the "Add binding" option to open a key registration prompt and then press 9 and select whether you want to bind by position or by key and hit Enter or if you hit the wrong button Esc(or whatever you have set to "Main menu" or "Leave screen" keys) to abort. However, you'd then have to find any action that also is controlled by 9, or you'll be sending both commands every time you hit that key. Changes should be planned carefully with that last in mind. To remove the command you added select the "By letter: 9" or "By position: 9" or "By position: Numpad 9" on the select command with arrow keys and press backspace(your "String: Backspace" key) to delete the keybind.

Additional commands can be viewed by scrolling using the up/down arrows, or by screen using the page up/page down keys (unless you've changed those).

Additional Up/Down Z-Level Keys

One of the more common key binding changes, is to use the comma , and period ., rather than < and > (the same keys + Shift) for up/down z-levels, thus avoiding the need to use two hands/keys for this common action.

You'll need to add the following in the general category.

Move view/cursor up (z)                By position/letter: ,
Move view/cursor down (z)              By position/letter: .

Then, also be sure remove the following entry from the dwarf mode,

Main: One-Step                          By letter: .

This avoids advancing the game one step each time you move the game view "down" one z-level, since both would be controlled by the . key. But advancing one step would become unbound so you could use < or > or any other unused key for that.

Some players may feel more comfortable by switching the PgDn/PgUp keys to control moving between z-levels, though this is not recommended should you use the numpad for movement.

Laptop Bindings

40d version required some editing to use non-numpad versions of keys but this is no longer necessary so there are no longer any changes possible that could make laptop keyboards easier to use for playing DF.

Vanilla interface.txt

Raws
Edit

Key syntax

SYM

SYM is used for keys listed as By position in the keybinding menu.

Syntax:

[SYM:Modifiers:Key]

The modifiers are represented as the sum of their codes listed below:

Modifier	Value
Shift	1
Ctrl	2
Alt	4

For example, [SYM:0:A] represents a, [SYM:1:Enter] represents Shift-Enter, and [SYM:6:Left] represents Ctrl-Alt-←.

The key can be any letter or number, or can be listed by name. This is useful when typing the actual symbol would cause a syntax error (for example, [KEY:0:]] and [KEY:0::] cause errors instead of representing ] and :), or when the symbol isn't type-able (it's hard to insert a backspace character in a basic text editor without deleting something).

KEY

KEY is a simpler version of SYM, only allowing plain keys (no modifiers). These are listed as By letter in the keybinding menu.

Syntax:

[KEY:Key]

For example, [KEY:a] represents the a key.

Differences between KEY and SYM

KEY does allow special characters if they are able to be typed. For example, [KEY:%] is equivalent to [SYM:1:5]. Note that SYM requires the key on the keyboard, while KEY requires the letter generated.

Mac-specific

• Some keys unavailable on the keyboard (such as PgDown) can be generated with the fn key. Dwarf fortress sees these as independent keys; the fn key is essentially invisible to DF. There is no modifier code for fn.
• Characters like å aren't recognized when typed as alt-a.
• The Command key is unrecognized by DF and can't be used as a modifier.

V · T · E Files
Settings	colors.txt • init.txt • interface.txt
Gameplay settings	announcements.txt • d_init.txt
Log files	errorlog.txt • gamelog.txt
Other	arena.txt • embark_profiles.txt • world_gen.txt