Has a problem or error come up since you started creating your mod? This section will be your basic troubleshooting page for the editors. As more errors are found and corrected, the page will be updated with new tips and tricks to fix them up!
This particular section is for troubleshooting modifications and addons. If you are having problems with the core, uneditted game of SOMA, it is recommended you ask in the Technical Support section of the Frictional Games Forum, since your problem has probably been covered before in more depth there by a developer or another forum member.
If your map is not loading, and you have since editted scripts for the mod, chances are that there is an error in your script. Most of the time, you will be prompted by a window with information about where the potential error is located in your script. It should look similar to this:
Some of the errors which come up include:
<TO-DO: A list of errors. Template: errorTypeDescription. How to fix
Example: No matching signatures to <Function>(Syntax); An error usually meaning that the function syntax has been written incorrectly. To fix, make sure that the data types (string, bool, int, float) are correctly written, there are enough commas (,) and there are not too many quotation marks “”.>
When testing your mod, either on start or in game, you may get an error similar to the original poster of this forum thread.
This error comes up when your modification cannot locate a particular map (or .hpm) file. This error will likely be caused when loading or changing map. In the case of:
Loading a map from Start: There is likely a directory or naming error in your main_init.cfg. The lines you want to be looking for are within the StartMap group, specifically the File and Folder attributes. Check for any naming errors or directory problems. Personally, mine say: File=“base_map.hpm” Folder=“mods /<modfolder>/maps/”.
Changing from one map to next: In your script, check your map transition script to make sure there are no errors in spelling. Be sure to check your modification's resources.cfg as well, you may not have declared your maps folder as a resource.
Check your modification's resources.cfg file and add appropriate directories to your assets, sounds, music, etc. Furthermore, make sure any custom assets are included in your modification when you release it and test it.
The best way to address this problem is you to have others test your map on their computer and ask for the hpl.log file which is generated to suit your modification each time they finish playing. If you can read the log file, you can determine what errors have come up on the other person's computer.
This will generically be caused by one of two things:
This is a problem caused by the meshes of some Amnesia: A Machine For Pigs models. I do not know if these problems will persist in HPL3, but if it does, the simplest way is to delete the .msh and the .anm files if there are any included with that particular model. That will generate a new .msh file which HPL3 can recognise.
<No errors yet. Found one? Add it here!>
This error occurs because steam_appid.txt is not in SOMA's steam folder. To fix it, navigate to SOMA's Steam folder, which by default, is located here: C:\Program Files (x86)\Steam\steamapps\common\SOMA and simply create a text file with Notepad, named steam_appid.txt. Within this text file, simply write 282140 and save the text file. Therefore, you should have something like this:
This is not required if you are loading your modifications from the mods folder and are not using Steam to publish your work on the Steam Workshop.
This feature is not quite available yet. This will be updated when it is possible.
<No errors yet. Found one? Add it here!>
<No errors yet. Found one? Add it here!>
<No errors yet. Found one? Add it here!>
See Mod Launcher - Steam API failed to initialize! for information on how to fix.
In general, 3rd Party Applications are not handled by Frictional Games troubleshooting if it is an error on the 3rd Party Application's part. However, there are times where some of the setting up of applications may require some additional assistance.
You are using an outdated version of CodeLite. Download the latest version and follow the new steps as found in CodeLite or CodeLite: With Pictures. (Forum Thread)
Make sure your installation of CodeLite is located on the same drive as what SOMA is. ( Forum Thread )
If you have a bug to report about the Level Editor post it in our dedicated forum post.
If you have a bug about the other editors, please make a post in the User Content Technical Support subforum. Describe to us how to replicate the problem and attach the appropriate log file, located at
C:/Users/<user>/Documents/HPL3/
If you have a bug about SOMA, in terms of modding or the core game, please post it in the Technical Support subforum and: