HPL2/TDD/Config Files

From Frictional Wiki
< HPL2‎ | TDD
Revision as of 02:22, 2 August 2020 by Darkfire (talk | contribs) (Redux)
Jump to navigation Jump to search

Config Files

To do: Move this to a more appropriate link

What follows is a list of all the config files that are a part of HPL2. All of them can be used in a full conversion to alter the game.

Main configuration

The following config files are a part of the main config folder.

Main init
Handles all of the major settings for the game, like setting up the name of game, save directory and what config files to use.
Contains all game related settings.
All the settings related to the menu.
Contains all of the settings for the pre-menu (that pops up before the menu).
Demo specific settings. Only loaded if the demo version of the exe is used.


resources.cfg is a file which lists all of the folders that Amnesia.exe searches for assets. In case of file name collissions, they are prioritised in the order of this list.

Icon idea.png Idea: This file can be used to overwrite files during runtime without changing them. The files need to be copied into a new folder and altered there. Then, the folder has to be put on top of the list.


materials.cfg is a file which lists all physical materials available in the game and the editors. Each material in the file contains its physics parameters, the sounds it makes (steps, impact, scrape, sometimes also roll) and the particles produced when the material is hit.

Icon idea.png Idea: This file can be used to create custom surface materials (Machine For Pigs added a lot of them) or alter the step sounds (this was done in Justine).

Insanity events

misc/main_sanity_events.cfg contains the insanity events which can occur in the game. They can be organised into categories, and custom ones can be made.

Icon idea.png Idea: This can be used as a 2D overlay for displaying images in the game.


These files are generated in the documents folder of the OS user. They are generated in subfolders for each full conversion (including the main game).

  • main_settings.cfg - Stores graphical settings and other settings pertaining to the entire program.
  • user_keys.cfg - Stores control settings, per user profile
  • user_settings.cfg - Stores profile-specific things

See how to set up development environment for some additional information.


The editors come with their own set of config files. Asides from e.g. custom colors, altering these doesn't have much purpose, as doing so won't work in the game (e.g. Area types are hardcoded into the executable).


Default settings and a list of compatible graphics cards. Altering these is advised against.