This tutorial assumes you have the Justine patch installed for your Amnesia installation. Also, i'll only help others solve issues caused by this process only
for the things i provided (exact) directions for. Note, also, this article should be considered a work-in-progress and may be updated if any issues arise.
Although i provide this tutorial, i do not intend it to imply that everyone should consider making a full conversion simply because they can and have the resources. Changing entities and objects is not a proper justification for choosing to go with a full conversion. Proper justification would be for the sake of changing game mechanics, like night vision, sanity drain, oil drain, etc.
Due to the fact that a lot of full conversion mods out there have a complicated installation, making it difficult to keep your Amnesia installation clean, i have decided to teach people how to create a fully isolated full conversion mod where the user would only need to delete one folder to completely uninstall the full conversion mod. I find complicated installations for full conversions unacceptable for community-based full conversions, and wouldn't you prefer to have a fully isolated full conversion too?
Create a folder called test_mod
under the redist
folder (for retail edition) or the amnesia the dark descent
folder (for Steam edition). This folder will contain everything our full conversion mod needs.
Inside the test_mod
folder, create the following folders:
Go into the config
folder of Amnesia and copy over the following files to test_mod/config
- game.cfg (use ptest_game.cfg for female voice)
, rename the files so that they don't
have the prefix "ptest_". Under test_mod/config/lang
create the file english.lang
or simply copy the one located at config/lang_ptest
Be sure to also copy the resources.cfg
file into the test_mod
Open the test_mod/config/main_init.cfg
file for editing. Every attribute shown in there must remain there, or else the game may crash for failing to parse the configuration. All attributes should have a value, or else the game may crash.
Make sure that the values for the following attributes have a prefix of "test_mod/":
Make sure none
of the attributes have "ptest_" or "_ptest" in their values. Be sure to also modify Variables::GameName
to match your story.
Make sure Main::BGScene
has a value like "test_mod/main_menu/menu_bg.map". Make sure Main::MenuLogo
points to something like "test_mod/graphics/menu_logo.png". Change the values if you choose to change the file names. The rest i'll leave up to you to modify (if you're courageous enough
to the Main
element. Change FullScreen
to "false", LimitFPS
to "false" and VSync
Prefix the /main_menu
directories with "/test_mod".
Make sure to add
the following directories to the list:
For any new directories just add them to the list as you go. Don't worry if the directories listed do not exist, as you can create them later.
This is the map used for the main menu (as you could guess). For the camera, just make sure to have a PlayerStart area with the name "CameraPos". The direction of the camera is towards the -Z of the local coordinates of the area (i.e. the small arrows of the area).
StartMap::File and StartMap::Folder
Obviously, the starting map when the player starts a new game. It should be obvious how to set this up for those who are used to creating custom stories.
Batch file (Windows)
(can be named differently, but must end with .bat). Needs to be placed in your full conversion's folder.
Bash file (Linux)
cd /d ..
(can be named differently; doesn't need to end with .sh). Needs to be placed in your full conversion's folder.
AppleScript (Mac OS)
# 64-bit operating systems
if [ "$(uname -m)" = "x86_64" ]; then
# 32-bit operating systems
(can be named differently but should end with .scpt). Could probably be placed anywhere; however, i have no idea (i don't own a Mac).
do shell script "open /Applications/Amnesia.app --args test_mod/config/main_init.cfg"
Everything else i'm going to leave up to you.
If you don't have Steam or a redist folder, simply assume the directory where all the important files and folders of Amnesia are located in.