Difference between revisions of "HPL2/custom story settings.cfg"

From Frictional Wiki
Jump to navigation Jump to search
(Created page with "{{DISPLAYTITLE:custom_story_settings.cfg}} This file is used to configure a custom story, and is found in the root of the custom story, residing inside a subfolder of <code>/c...")
 
(Added the new InitCfgFile field)
Line 1: Line 1:
 
{{DISPLAYTITLE:custom_story_settings.cfg}}
 
{{DISPLAYTITLE:custom_story_settings.cfg}}
 +
 
This file is used to configure a custom story, and is found in the root of the custom story, residing inside a subfolder of <code>/custom_stories</code> in the Amnesia folder. This file only applies to TDD, not AMFP. Below are all configurable fields for this file and what each does. All of the fields are XML attributes applied to an element named <code>Main</code>.
 
This file is used to configure a custom story, and is found in the root of the custom story, residing inside a subfolder of <code>/custom_stories</code> in the Amnesia folder. This file only applies to TDD, not AMFP. Below are all configurable fields for this file and what each does. All of the fields are XML attributes applied to an element named <code>Main</code>.
  
Line 29: Line 30:
 
|DefaultExtraLangFile
 
|DefaultExtraLangFile
 
|The default language file to load. This is appended to the above prefix, making the default language file "extra_english.lang".
 
|The default language file to load. This is appended to the above prefix, making the default language file "extra_english.lang".
 +
|-
 +
|InitCfgFile
 +
|A relative path to a main_init.cfg file. Specifying this field transforms the custom story into a full conversion mod. (Coming soon)
 
|}
 
|}

Revision as of 16:10, 24 July 2023


This file is used to configure a custom story, and is found in the root of the custom story, residing inside a subfolder of /custom_stories in the Amnesia folder. This file only applies to TDD, not AMFP. Below are all configurable fields for this file and what each does. All of the fields are XML attributes applied to an element named Main.

Field name Description
Name The name of your custom story as it will appear in the game menu.
Author Your name which appears under the title.
ImgFile The name of an image file to use as the background image in the game menu.
MapsFolder The folder where your levels are loaded from. Recommended to keep as "maps/".
StartMap The name of the first level that is loaded upon clicking "Start new game" in the main menu.
StartPos The internal name of a PlayerStart type area within the above level. If empty or not matching, the game will use the first alphabetical start area.
ExtraLangFilePrefix A prefix applied to all language files that this story uses. If unspecified, it falls back to the default "extra_". This field can include forward slashes to represent folders.
DefaultExtraLangFile The default language file to load. This is appended to the above prefix, making the default language file "extra_english.lang".
InitCfgFile A relative path to a main_init.cfg file. Specifying this field transforms the custom story into a full conversion mod. (Coming soon)