HPL2/AMFP/Introduction - Revision history

AwesomeDirt307: Improved clarity in tools and full conversion section. Removed mention of brightness for lights since it's irrelevant.

2025-06-28T13:38:51Z

Improved clarity in tools and full conversion section. Removed mention of brightness for lights since it's irrelevant.

AwesomeDirt307: Added more clarification regarding the tools.

2023-06-19T20:02:52Z

Added more clarification regarding the tools.

AwesomeDirt307: /* Installation */

2023-03-28T13:24:32Z

Installation

AwesomeDirt307: /* Installation */

2023-03-21T19:49:27Z

Installation

AwesomeDirt307: /* Full Conversion */

2023-03-21T19:47:50Z

Full Conversion

AwesomeDirt307: Restructuring and additional information

2023-03-21T19:45:33Z

Restructuring and additional information

AwesomeDirt307: /* Full Conversion */

2023-03-20T18:56:28Z

Full Conversion

AwesomeDirt307: /* Modding MFP */

2023-03-20T17:18:20Z

Modding MFP

AwesomeDirt307: /* Tools */

2023-03-20T15:59:54Z

Tools

Darkfire: Some rewrites for better readability

2021-10-14T11:29:43Z

Some rewrites for better readability

@@ Line 12: / Line 12: @@
 ==Tools==
-MFP can be modded with the same editors used with TDD. However, those editors have trouble displaying lights correctly since lights in MFP have a brightness and a falloff value. Falloff controls how much the light fades and setting it to 0 will make the light cut off instantly. The editors configuration files also lack some of the features available in MFP. For this reason it is recommended to use the games official tools instead together with modded configuration files.
+MFP can be modded with the same editors used with TDD. However, these editors have trouble displaying lights correctly, since lights in MFP use a falloff value which controls how smooth the light appears. The editors configuration files also lack some of the features available in MFP. For this reason, it is recommended to use the game's official tools together with modded configuration files.
 ===Installation===
@@ Line 33: / Line 33: @@
 ===Full Conversion===
-MFP normally does not support loading a custom main init file from another directory, so you have to use the modded version of the game to do that.
+MFP normally does not support loading the main init file from a different directory than the default one, so you have to use the modded version of the game to do that.
 You can download the FC mod template [https://www.mediafire.com/file/995cuekkr9k4pcb/your_mod.rar/file here]. It is crucial to have experience with TDD full conversions before trying it with MFP.
 Almost all information about [[HPL2/TDD/Full Conversion Mod|TDD Full Conversions]] applies to MFP FCs. It is recommended to use the same asset folder names as the base game (e.g. "sounds"), as some assets might not work otherwise. Keep in mind that adding new assets while the game is running might not take effect until rebooting it.

@@ Line 12: / Line 12: @@
 ==Tools==
-MFP doesn't have any offically available tools but it can be modded using custom made tools.
+MFP can be modded with the same editors used with TDD. However, those editors have trouble displaying lights correctly since lights in MFP have a brightness and a falloff value. Falloff controls how much the light fades and setting it to 0 will make the light cut off instantly. The editors configuration files also lack some of the features available in MFP. For this reason it is recommended to use the games official tools instead together with modded configuration files.
 ===Installation===
 The MFP tools are available [https://www.mediafire.com/file/ug8no5u7bo9mait/MFP_Editor_Suite.rar/file here]. Install them in the same way, but in the MFP directory.
 ===Known issues / solutions===
@@ Line 34: / Line 30: @@
 If you use this method, Custom Stories in MFP work exactly the same as in TDD. The same limitations still apply (e.g. no custom lantern). Additionally, remember that MFP is missing some features when compared to TDD (e.g. allowing the player to access the inventory).
 ===Full Conversion===
-In order to create full conversion mods the same way as in TDD, you need to download the file linked above.
+MFP normally does not support loading a custom main init file from another directory, so you have to use the modded version of the game to do that.
 You can download the FC mod template [https://www.mediafire.com/file/995cuekkr9k4pcb/your_mod.rar/file here]. It is crucial to have experience with TDD full conversions before trying it with MFP.
 Almost all information about [[HPL2/TDD/Full Conversion Mod|TDD Full Conversions]] applies to MFP FCs. It is recommended to use the same asset folder names as the base game (e.g. "sounds"), as some assets might not work otherwise. Keep in mind that adding new assets while the game is running might not take effect until rebooting it.

@@ Line 19: / Line 19: @@
 The downloaded file contains modified editor configuration files, as well as editor executables compiled from MFP's source code.
-The editors are made to work with MFP's engine, so it's important you use these instead of the regular TDD tools.
+The editors are made to work with MFP's engine, so it's recommended you use these instead of the regular TDD tools.
 ===Known issues / solutions===

@@ Line 17: / Line 17: @@
 The MFP tools are available [https://www.mediafire.com/file/ug8no5u7bo9mait/MFP_Editor_Suite.rar/file here]. Install them in the same way, but in the MFP directory.
-The downloaded file contains modified editor configuration files as well as editor executables compiled from MFP's source code.
+The downloaded file contains modified editor configuration files, as well as editor executables compiled from MFP's source code.
-The editors are made to work with MFP's engine so it's important you use these instead of the regular TDD tools.
+The editors are made to work with MFP's engine, so it's important you use these instead of the regular TDD tools.
 ===Known issues / solutions===

@@ Line 39: / Line 39: @@
 ===Full Conversion===
-In order to create full conversion mods the same way as in TDD you need to download the file linked above.
+In order to create full conversion mods the same way as in TDD, you need to download the file linked above.
 You can download the FC mod template [https://www.mediafire.com/file/995cuekkr9k4pcb/your_mod.rar/file here]. It is crucial to have experience with TDD full conversions before trying it with MFP.
 Almost all information about [[HPL2/TDD/Full Conversion Mod|TDD Full Conversions]] applies to MFP FCs. It is recommended to use the same asset folder names as the base game (e.g. "sounds"), as some assets might not work otherwise. Keep in mind that adding new assets while the game is running might not take effect until rebooting it.

@@ Line 43: / Line 43: @@
 ===Custom Stories===
-You can use [http://www.mediafire.com/file/d3bp2k67fqbrf2l/mfp-with-custom-stories.zip/file the version of MFP which enables Custom Stories]. As per the license of the source code it was compiled from, you need to copy the license file if you redistribute the <code>.exe</code> file. Alternatively, you can just link that file for your players to download on their own.
+You can use [https://www.mediafire.com/file/fsjaxuvy38mkhdu/mfp_with_custom_stories.rar/file the version of MFP which enables Custom Stories]. As per the license of the source code it was compiled from, you need to copy the license file if you redistribute the <code>.exe</code> file. Alternatively, you can just link that file for your players to download on their own.
 If you use this method, Custom Stories in MFP work exactly the same as in TDD. The same limitations still apply (e.g. no custom lantern). Additionally, remember that MFP is missing some features when compared to TDD (e.g. allowing the player to access the inventory).
@@ Line 51: / Line 51: @@
 ===Full Conversion===
-MFP doesn't support passing a custom config file as an argument to the executable file, so until someone ports that feature, you can use this little hack to create FC mods.
+In order to create full conversions with custom config files you need to download the file linked above.
-You can download the FC mod template [https://www.frictionalgames.com/forum/thread-56724.html here]. It is crucial to have experience with TDD full conversions before trying it with MFP.
+You can download the FC mod template [https://www.mediafire.com/file/995cuekkr9k4pcb/your_mod.rar/file here]. It is crucial to have experience with TDD full conversions before trying it with MFP.
 Almost all information about [[HPL2/TDD/Full Conversion Mod|TDD Full Conversions]] applies to MFP FCs. It is recommended to use the same asset folder names as the base game (e.g. "sounds"), as some assets might not work otherwise. Keep in mind that adding new assets while the game is running might not take effect until rebooting it.

@@ Line 1: / Line 1: @@
-[https://en.wikipedia.org/wiki/Amnesia:_A_Machine_for_Pigs Amnesia: A Machine for Pigs] was developed by [https://en.wikipedia.org/wiki/The_Chinese_Room The Chinese Room], and as such has no official documentation. However, since it works like a Full Conversion mod for TDD (but redistributed with an altered .exe and shaders), it has been reverse-engineered by the community. Being technically almost identical to TDD, MFP only requires documenting the changes between it and its predecessor. This page lists the documentation of all found changes. Due to these reasons, most of the documents written for TDD still apply.
+[https://en.wikipedia.org/wiki/Amnesia:_A_Machine_for_Pigs Amnesia: A Machine for Pigs], developed by [https://en.wikipedia.org/wiki/The_Chinese_Room The Chinese Room], has no official documentation.
 ===Contributing===
-''Almost all the information about MFP was reverse engineered by examining the existing map files (via text editors) and existing scripts files. If you wish to contribute, you can look for undocumented things in the same vein.''
+Almost all of the information about MFP was reverse engineered by examining the existing map, entity and script files in text editors. If you wish to contribute, you can look for undocumented things in the same vein.
 ==Tools==
@@ Line 12: / Line 17: @@
 The original TDD tools are available [[HPL2/Tools|here]]. Install them in the same way, but in the MFP directory.
-'''If you install the community version, no further steps are required. This is the recommended method.'''
+It is recommended to download the community version tools because these include the fixes described in the "Patching the original editors" section.
 If you decide to use the original editors:
-'''Note:''' the custom config files include hints made by the community. These are not official and lack parts which couldn't be deducted from the files.
+The TDD editors can't load certain MFP assets. To make the TDD tools load MFP files properly, you will need to mod them with [https://www.frictionalgames.com/forum/thread-56724.html custom config files]. Simply drag the new files into your MFP folder and replace all files when prompted.
-{{warning| MFP is missing the SDL.dll file which the editors use. If you have TDD, just copy it from there to the main MFP folder. Otherwise, download the 32 bit version from [https://www.libsdl.org/download-1.2.php the official website].}}
+'''Note:''' the custom config files include hints made by the community. These are not official and lack information which couldn't be deducted from the files.
 ===Known issues / solutions===
-'''Issue:''' LevelEditor crashing when the /enemies entity folder is picked.
+'''Issue:''' LevelEditor crashing when the <code>/enemies</code> entity folder is picked.
-*'''Solution:''' Find the folder and delete all .msh files. These files are cache, and as such, don't hold anything important. They will be regenerated by the game.
+*'''Solution:''' Find the folder and delete all <code>.msh</code> files. These files are cache, and as such, don't hold anything important. They will be regenerated by the game.
-'''Issue:''' LevelEditor displays lights in a weird way.
+'''Issue:''' Level Editor displays lights in a weird way.
-*'''Solution:''' None. Unfortunately, the LevelEditor seems to have a portion of the TDD shaders hardcoded into it. This means that they cannot be fixed.
+*'''Solution:''' None. Unfortunately, the Level Editor seems to have a portion of the TDD shaders hardcoded into it. This still needs to be fixed in the community tools.
 ==Modding MFP==
@@ Line 35: / Line 43: @@
 ===Custom Stories===
-You can use [http://www.mediafire.com/file/d3bp2k67fqbrf2l/mfp-with-custom-stories.zip/file the CS version of MFP]. As per the license of the source code it was compiled from, you need to copy the license file if you redistribute the .exe file. Alternatively, you can link that download for your players to download separately.
+You can use [http://www.mediafire.com/file/d3bp2k67fqbrf2l/mfp-with-custom-stories.zip/file the version of MFP which enables Custom Stories]. As per the license of the source code it was compiled from, you need to copy the license file if you redistribute the <code>.exe</code> file. Alternatively, you can just link that file for your players to download on their own.
-If you use it, Custom Stories in MFP work exactly the same as in TDD. Same restrictions apply, however remember that MFP is missing some features when compared to TDD (e.g. allowing the player to access the inventory).
+If you use this method, Custom Stories in MFP work exactly the same as in TDD. The same limitations still apply (e.g. no custom lantern). Additionally, remember that MFP is missing some features when compared to TDD (e.g. allowing the player to access the inventory).
 {{note|This is the recommended way of modding MFP at the moment.}}