User Tools

Site Tools


Sidebar

hpl3:community:editors:troubleshooting

Troubleshooting

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!

SOMA

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.

My map will not load!

Could not load script file

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

Invalid Filepointer Returned!

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.

Some assets are missing/do not play?

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.

Level Editor

My Model is not appearing correctly. Why?

43cf656364.jpg

This will generically be caused by one of two things:

  1. The model cannot find all connected submeshes.
    This means that there is a model or .dae file missing. You will know this is the case if when you place down a model and it does not appear in the editor (see the image above), and upon clicking where it is placed, does not actually select the model. To fix this, you'll need to open the model in the HPL2 Model Editor and locate where the referenced models are located in The Dark Descent or in Machine For Pigs. Make sure you copy all of them over into your SOMA directory, and it would be a good idea to try and keep them as close to the original directory as possible.
  2. The model has all of its components but not its material (or all of its textures).
    This means you do not have the material or the textures (or even just the diffuse texture) in a recognisable location for your entity or static object. An example that comes to mind is the towels in A Machine For Pigs, as they base their texture off a carpet material file. To check what material it uses, you can open up the model in the HPL2 Model Editor and press the [+] button next to the mesh. It should show you the name of the .dds textures. Most of the time, all the materials and .dds files will appear there, but you can get all of them.

When testing my level, my model appears at XYZ = 0.

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.

Model Editor

<No errors yet. Found one? Add it here!>

Mod Launcher

Steam API failed to initialize!

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.

Official post from Frictional Games concerning this issue.

I cannot assign a Mod Picture

This feature is not quite available yet. This will be updated when it is possible.

Particle Editor

<No errors yet. Found one? Add it here!>

.snt Editor

<No errors yet. Found one? Add it here!>

Voice Handler

<No errors yet. Found one? Add it here!>

Workshop Uploader

Steam client must be running to be able to publish

See Mod Launcher - Steam API failed to initialize! for information on how to fix.

3rd Party Applications

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.

CodeLite

Cannot locate the "Tags Settings" in CodeLite

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)

I cannot open any of my scripts?

Make sure your installation of CodeLite is located on the same drive as what SOMA is. ( Forum Thread )

Got a bug to report?

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:

  • Describe the problem in detail. How can it be replicated?
  • What Operating System are you running?
  • Attach your hpl.log file after the bug has occurred. You can find it by following Problem X of the Troubleshooting Guide, it is pinned to the top of the subforum.
hpl3/community/editors/troubleshooting.1444387454.txt.gz · Last modified: 2015/10/09 10:44 by romulator