Difference between revisions of "HPL2/AMFP/Introduction"

From Frictional Wiki
< HPL2‎ | AMFP
Jump to navigation Jump to search
(Added more clarification regarding the tools.)
 
(2 intermediate revisions by the same user not shown)
Line 12: Line 12:
 
==Tools==
 
==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===
 
===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.
 
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 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===
 
===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).
 
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===
 
===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.
 
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.
 
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.

Latest revision as of 21:02, 19 June 2023

Amnesia: A Machine for Pigs, developed by 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 icon.png 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 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 here. Install them in the same way, but in the MFP directory.

Known issues / solutions

Issue: LevelEditor crashing when the /enemies and /character 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.

Modding MFP

Custom Stories

You can use 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 .exe 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).

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.

You can download the FC mod template here. It is crucial to have experience with TDD full conversions before trying it with MFP.

Almost all information about 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.