Difference between revisions of "HPL2/AMFP"

From Frictional Wiki
Jump to navigation Jump to search
m (→‎Documentation: removed construction notice)
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Amnesia: A Machine For Pigs==
+
{| class="wikitable" style="margin:auto;"
 +
|+<p style="margin:1em auto 0; text-align:center; width:400px;">[[File:Mfp-header.jpg|250px|link=|Amnesia: A Machine for Pigs]]</p><p style="margin:1em auto 0; text-align:center; width:400px;"></p>
 +
|-
 +
|'''[[HPL2/AMFP/Introduction|<center>Introduction</center>]]'''
 +
|Information to get started and how to set up the tools
 +
|-
 +
|'''[[HPL2/AMFP/DebugBar|<center>Developer environment</center>]]'''
 +
|About the debug set-up.
 +
|-
 +
|'''[[HPL2/AMFP/NewAreas|<center>Areas</center>]]'''
 +
|MFP features new area types.
 +
|-
 +
|'''[[HPL2/AMFP/NewEntities|<center>Entities</center>]]'''
 +
|MFP features new entity types.
 +
|-
 +
|'''[[HPL2/AMFP/ScriptFunctions|<center>Scripting</center>]]'''
 +
|MFP uses a majority of TDD functions. There are some new ones, however. Some of the old ones are removed or replaced.
 +
|-
 +
|'''[[HPL2/AMFP/Infection|<center>Infection</center>]]'''
 +
|Infection was a mechanic which was removed from the final product. However, some of the functionality remained.
 +
|-
 +
|'''[[HPL2/AMFP/ColorGr|<center>Color grade texture tutorial</center>]]'''
 +
|Instructions for creating custom color grade textures. In-game color grading usage is documented in the Areas article.
 +
|}
  
[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-egineered 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.
+
[[Category:Entry pages]]
 +
__NOTOC__
  
==Documentation==
+
<br />
===Developer environment===
 
 
 
The dev set-up is the same as in TDD. You can read the tutorial [[HPL2/Development_Environment|here]].
 
 
 
However, there are some missing features. F1 still brings up the debug menu, but it doesn't contain some of the previously present features. Unfortunately, the game can't be sped up with F3 and the map can't be reloaded with F2 anymore. F8 still takes screenshots, though.
 
 
 
More information about the debug toolbar can be found [[HPL2/AMFP/DebugBar|here]].
 
 
 
===Script Functions===
 
 
 
MFP uses a majority of TDD functions. There are some new ones, however. Some of the old ones are removed or replaced. You can see the documentation [[HPL2/AMFP/ScriptFunctions|here]].
 
 
 
===New Area Types===
 
 
 
MFP features new area types. You can read about them [[HPL2/AMFP/NewAreas|here]].
 
 
 
===New Entity Types===
 
 
 
MFP features new entity types. You can read about them [[HPL2/AMFP/NewEntities|here]].
 
 
 
===Infection===
 
 
 
Infection was a mechanic which was removed from the final product. Some of the functionality remained, however, and can be read about [[HPL2/AMFP/Infection|here]].
 
 
 
===Color grade textures===
 
 
 
MFP added support for color grading. The main documentation is in the New Areas article. Instructions for creating custom color grade textures can be read [[HPL2/AMFP/ColorGr|here]].
 
 
 
===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.''
 
 
 
==Tools==
 
 
 
There are no officially available tools for MFP. However, MFP files can be viewed and edited using modded TDD tools.
 
 
 
===Installation===
 
The original TDD tools are available [[HPL2/Tools|here]]. Install the 1.3 version or newer as described on the page, but in the MFP directory.
 
 
 
The TDD editors, however, will have issues with loading certain 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]. These files fill in the missing new features, and allow for all files to be loaded without errors. Simply drag the new files into your MFP folder and replace all files when prompted.
 
 
 
You might be also missing the SDL.dll file; 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|'''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.}}
 
 
 
===Known issues / solutions===
 
 
 
{{bug|LevelEditor crashing when the /enemies entity folder is picked.}}
 
'''Solution:''' Find the folder and delete all .msh files.
 
 
 
==Modding MFP==
 
 
 
The only way of modding MFP which doesn't alter the base files is a Full Conversion. There are no Custom Stories in MFP. You can download the FC mod template [https://www.frictionalgames.com/forum/thread-56724.html here]. It is recommended to have modding experience with TDD before modding 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. 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 might cause issues.}}
 
 
 
 
 
{{tip|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:Amnesia:full_conv|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 20:21, 23 August 2020

Amnesia: A Machine for Pigs

Introduction
Information to get started and how to set up the tools
Developer environment
About the debug set-up.
Areas
MFP features new area types.
Entities
MFP features new entity types.
Scripting
MFP uses a majority of TDD functions. There are some new ones, however. Some of the old ones are removed or replaced.
Infection
Infection was a mechanic which was removed from the final product. However, some of the functionality remained.
Color grade texture tutorial
Instructions for creating custom color grade textures. In-game color grading usage is documented in the Areas article.