Frictional Wiki - User contributions [en]

HPL2/AMFP/Introduction

2025-06-28T13:38:51Z

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

HPL2/AMFP/Introduction

2023-06-19T20:02:52Z

AwesomeDirt307: Added more clarification regarding the tools.

HPL2/AMFP/NewAreas

2023-06-04T17:48:25Z

AwesomeDirt307: Changed 4 variables to say 5 variables

= New Area Types =

MFP features two new area types which weren't present in TDD.

== Color grading area ==

This is an area which applies color correction when entered. It will show up as yellow in the Level Editor.

The area has 2 variables:

* LookUpTable - determines the color grading texture. Ready ones are located in <code>/textures/gradingmaps</code>.
* FadeTime - how fast the color changes (or goes back to normal) when the area is entered or left.

For information about creating custom grading textures, take a look at [[HPL2/AMFP/ColorGr|this guide]].

== Infection area ==

This is a remnant of the unused infection system. It fills up the infection meter or lowers it when the player is inside the area. The area will show up as lime green in the Level Editor.

This area has 5 variables:

* IncrementSpeed - How fast the meter fills up or lowers. Seems to be in units per second. The area will heal the player if negative value is used.
* InfectionLevelLowerBound - If the area is used for healing, the lower bound specifies the minimum infection level the area can heal to.
* InfectionLevelUpperBound - Binds the maximum infection level; the player won't be able to get a higher infection level while standing in the area. Values 1-4. 4 and above lets the player die from infection. Infection drain is disabled when the bound has been hit and the player is still in the area.
* TotalIncrementBound - If a value other then 0 is used, it will limit the amount the area can increment the infection. If the areas increment total reaches this bound than the area is disabled.
* DisableOnLevelBoundHit - Disables the area if the upper or lower bound is hit.

For more information about the infection mechanic, see [[HPL2/AMFP/Infection| the Infection article]].

HPL2/AMFP/Introduction

2023-03-28T13:24:32Z

AwesomeDirt307: /* Installation */

HPL2/AMFP/Introduction

2023-03-21T19:49:27Z

AwesomeDirt307: /* Installation */

HPL2/AMFP/Introduction

2023-03-21T19:47:50Z

AwesomeDirt307: /* Full Conversion */

HPL2/AMFP/Introduction

2023-03-21T19:45:33Z

AwesomeDirt307: Restructuring and additional information

HPL2/AMFP/Introduction

2023-03-20T18:56:28Z

AwesomeDirt307: /* Full Conversion */

[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.

Being technically almost identical to TDD, MFP only requires documenting the changes between it and its predecessor. This page lists all found differences.

{{note|Due to the above reasons, majority of the documentation written for TDD also applies to MFP.}}

===Contributing===

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==

MFP can be modded using custom tools available [https://www.mediafire.com/file/ug8no5u7bo9mait/MFP_Editor_Suite.rar/file here].

===Installation===
The original TDD tools are available [[HPL2/Tools|here]]. Install them in the same way, but in the MFP directory.

It is recommended to download the community version tools because these include the fixes described in the "Patching the original editors" section.

{{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].}}

===Patching the original editors===

If you decide to use the original editors:

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.

'''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 <code>/enemies</code> entity folder is picked.

*'''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:''' Level Editor displays lights in a weird way.

*'''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==

===Custom Stories===

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).

{{note|This is the recommended way of modding MFP at the moment.}}

===Full Conversion===

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.

HPL2/AMFP/NewAreas

2023-03-20T18:49:51Z

AwesomeDirt307:

= New Area Types =

MFP features two new area types which weren't present in TDD.

== Color grading area ==

This is an area which applies color correction when entered. It will show up as yellow in the Level Editor.

The area has 2 variables:

* LookUpTable - determines the color grading texture. Ready ones are located in <code>/textures/gradingmaps</code>.
* FadeTime - how fast the color changes (or goes back to normal) when the area is entered or left.

For information about creating custom grading textures, take a look at [[HPL2/AMFP/ColorGr|this guide]].

== Infection area ==

This is a remnant of the unused infection system. It fills up the infection meter or lowers it when the player is inside the area. The area will show up as lime green in the Level Editor.

This area has 4 variables:

* IncrementSpeed - How fast the meter fills up or lowers. Seems to be in units per second. The area will heal the player if negative value is used.
* InfectionLevelLowerBound - If the area is used for healing, the lower bound specifies the minimum infection level the area can heal to.
* InfectionLevelUpperBound - Binds the maximum infection level; the player won't be able to get a higher infection level while standing in the area. Values 1-4. 4 and above lets the player die from infection. Infection drain is disabled when the bound has been hit and the player is still in the area.
* TotalIncrementBound - If a value other then 0 is used, it will limit the amount the area can increment the infection. If the areas increment total reaches this bound than the area is disabled.
* DisableOnLevelBoundHit - Disables the area if the upper or lower bound is hit.

For more information about the infection mechanic, see [[HPL2/AMFP/Infection| the Infection article]].

HPL2/AMFP/NewAreas

2023-03-20T18:45:03Z

AwesomeDirt307: /* Infection area */

= New Area Types =

MFP features two new area types which weren't present in TDD.

== Color grading area ==

This is an area which applies color correction when entered. It will show up as yellow in the Level Editor.

The area has 2 variables:

* LookUpTable - determines the color grading texture. Ready ones are located in <code>/textures/gradingmaps</code>.
* FadeTime - how fast the color changes (or goes back to normal) when the area is entered or left.

For information about creating custom grading textures, take a look at [[HPL2/AMFP/ColorGr|this guide]].

== Infection area ==

This is a remnant of the unused infection system. It fills up the infection meter or lowers it when the player is inside the area. The area will show up as lime green in the Level Editor.

This area has 4 variables:

* IncrementSpeed - How fast the meter fills up or lowers. Seems to be in units per second. The area will heal the player if negative value is used.
* InfectionLevelLowerBound - If the area is used for healing, the lower bound specifies the minimum infection level the area can heal to.
* InfectionLevelUpperBound - Binds the maximum infection level; the player won't be able to get a higher infection level while standing in the area. Values 1-4. 4 and above lets the player die from infection. Infection drain is disabled when the bound has been hit and the player is still in the area.
* TotalIncrementBound - If a value other then 0 is used, it will limit the amount the area can increment the infection. If the areas increment total reaches this bound than the area is disabled.
* DisableOnLevelBoundHit - Disables the area if the upper bound is hit.

For more information about the infection mechanic, see [[HPL2/AMFP/Infection| the Infection article]].

HPL2/AMFP/Introduction

2023-03-20T17:18:20Z

AwesomeDirt307: /* Modding MFP */

[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.

Being technically almost identical to TDD, MFP only requires documenting the changes between it and its predecessor. This page lists all found differences.

{{note|Due to the above reasons, majority of the documentation written for TDD also applies to MFP.}}

===Contributing===

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==

MFP can be modded using custom tools available [https://www.mediafire.com/file/ug8no5u7bo9mait/MFP_Editor_Suite.rar/file here].

===Installation===
The original TDD tools are available [[HPL2/Tools|here]]. Install them in the same way, but in the MFP directory.

It is recommended to download the community version tools because these include the fixes described in the "Patching the original editors" section.

{{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].}}

===Patching the original editors===

If you decide to use the original editors:

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.

'''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 <code>/enemies</code> entity folder is picked.

*'''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:''' Level Editor displays lights in a weird way.

*'''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==

===Custom Stories===

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).

{{note|This is the recommended way of modding MFP at the moment.}}

===Full Conversion===

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.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.

HPL2/AMFP/Introduction

2023-03-20T15:59:54Z

AwesomeDirt307: /* Tools */

[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.

Being technically almost identical to TDD, MFP only requires documenting the changes between it and its predecessor. This page lists all found differences.

{{note|Due to the above reasons, majority of the documentation written for TDD also applies to MFP.}}

===Contributing===

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==

MFP can be modded using custom tools available [https://www.mediafire.com/file/ug8no5u7bo9mait/MFP_Editor_Suite.rar/file here].

===Installation===
The original TDD tools are available [[HPL2/Tools|here]]. Install them in the same way, but in the MFP directory.

It is recommended to download the community version tools because these include the fixes described in the "Patching the original editors" section.

{{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].}}

===Patching the original editors===

If you decide to use the original editors:

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.

'''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 <code>/enemies</code> entity folder is picked.

*'''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:''' Level Editor displays lights in a weird way.

*'''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==

===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.

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.}}

===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.

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.

The download only features a Windows start script, but it can be remade for other operating systems. The rest of the template stays the same for all systems.

Since MFP doesn't support passing a custom config file as an argument to the executable file, the script does something else. When the mod is ran, the script renames the original folder into "config_original" and the specified folder (e.g. "config_YourMod") to "config". When the game gets closed, these changes are reverted.

{{warning|Do not alter the main config files when the game is running! This will cause issues.}}

If the game crashes, you might need to rename the folders manually. Including this information with your user manual for the mod might be a good idea.

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.