Setup Modding Environment
In order to have a smooth modding development experience, SOMA is needed to be configured into proper development environment.

Contents
Setting up the Editors
Your mod might have custom assets. In order to make the editors (Level Editor, Model Editor, etc) to load your mod's assets, it needs to be configured into a special mode called "WIP Mod".

WIP Mod - Manual Configuration
- Navigate to
My Documents/HPL3
. You need to open one of the editors at least once in order to see the HPL3 folder inside your document folder. - Inside that folder, create a file called
WIPMod.cfg
. - Paste the following into the file, and save:
<WIPmod Path="Full_Path_To_Mod/entry.hpc" />
(Of course, you will have to change the path in order to suit your own location of the mod).
WIP Mod - Automatic Configuration
You can use the SOMA Mod Manager in order to perform an automatic sync of the editors to your mod, which pretty much does the manual step for you.
Final Step

If your mod indeed has custom assets, you need to make sure the editors can add them to their look up list. You need to add a folder named editor
in your mod directory, and a lookupdirs.cfg
file inside. The content of the file should point out the relative paths to the directories which contain custom assets. For example:
<Directories>
<Dir Category="StaticObjects" Path="assets/static_objects" />
<Dir Category="Entities" Path="assets/entities" />
<Dir Category="Billboards" Path="assets/billboards" />
<Dir Category="Particles" Path="assets/particles" />
<Dir Category="Sounds" Path="assets/sounds" />
</Directories>
If all the above is done correctly, a (Working on mod)
text should appear on the title bar of HPL3 editors when run.