- 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.
Interface.txt
| This article was migrated from DF2014:Interface.txt and may be inaccurate for the current version of DF (v50.14). See this page for more information. |
v50.14 · v0.47.05 This article is about the current version of DF.Note that some content may still need to be updated. |
Vanilla interface.txt
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. This is probably an issue in SDL.
The Command key is unrecognized in DF and doesn't have a modifier. Pressing Command-h displays the hauling menu, even though this keystroke should hide DF and is listed in the menu at the top of the screen.