https://wiki.frictionalgames.com/page?action=history&feed=atom&title=HPL3%2FSOMA%2FGetting_Started%2FCreate_and_Launch_Your_ModHPL3/SOMA/Getting Started/Create and Launch Your Mod - Revision history2026-08-04T04:44:38ZRevision history for this page on the wikiMediaWiki 1.34.2https://wiki.frictionalgames.com/page?title=HPL3/SOMA/Getting_Started/Create_and_Launch_Your_Mod&diff=7115&oldid=prevTiMan: Created page with "{{Hpl3SomaGettingStarted|step=2}} In this step, you will copy SOMA's known-working example mod and launch the copy before changing it. == Make your own copy == # Open <code..."2026-07-30T10:47:04Z<p>Created page with "{{Hpl3SomaGettingStarted|step=2}} In this step, you will copy SOMA's known-working example mod and launch the copy before changing it. == Make your own copy == # Open <code..."</p>
<p><b>New page</b></p><div>{{Hpl3SomaGettingStarted|step=2}}<br />
<br />
In this step, you will copy SOMA's known-working example mod and launch the copy before changing it.<br />
<br />
== Make your own copy ==<br />
<br />
# Open <code>SOMA/mods/</code>.<br />
# Copy the entire <code>MinimalCustomMapMod</code> folder.<br />
# Rename the copy to a short project name, such as <code>MyFirstMod</code>.<br />
# Open the copied <code>entry.hpc</code> in a text editor.<br />
# Change at least <code>Title</code>, <code>Author</code>, and <code>Description</code>. Leave <code>Type="StandAlone"</code> and <code>InitCfg="config/main_init.cfg"</code> unchanged for this tutorial.<br />
<br />
{{warning|Do not rename or edit the original <code>MinimalCustomMapMod</code>. Keeping a clean copy gives you a working comparison if your configuration later breaks.}}<br />
<br />
Your copied folder should contain at least:<br />
<br />
<pre><br />
MyFirstMod/<br />
├── config/<br />
│ ├── lang/<br />
│ │ └── english.lang<br />
│ └── main_init.cfg<br />
├── maps/<br />
│ └── sample_map/<br />
│ ├── sample_map.hpm<br />
│ ├── sample_map.hpm_*<br />
│ └── sample_map.hps<br />
├── entry.hpc<br />
├── LauncherPic.png<br />
└── resources.cfg<br />
</pre><br />
<br />
The <code>.hpm_*</code> entries above represent the map's split data files. They are part of the map and must remain beside <code>sample_map.hpm</code>.<br />
<br />
== Launch the untouched copy ==<br />
<br />
# Run <code>ModLauncher.exe</code>, or <code>ModLauncher_NoSteam.exe</code> for a non-Steam installation.<br />
# Choose '''Play Custom Content'''.<br />
# Select the title you placed in <code>entry.hpc</code>.<br />
# Launch the mod.<br />
<br />
The included <code>config/main_init.cfg</code> starts <code>sample_map.hpm</code> from the <code>maps/</code> folder at <code>PlayerStartArea_1</code>.<br />
<br />
== Checkpoint ==<br />
<br />
Continue only when your copied mod appears in the launcher and loads its sample map.<br />
<br />
== If it does not work ==<br />
<br />
* '''The mod is absent from the launcher:''' confirm the copy is inside <code>SOMA/mods/</code> and has <code>entry.hpc</code> at its root.<br />
* '''The game starts but the map does not:''' restore <code>config/main_init.cfg</code>, <code>resources.cfg</code>, and the complete <code>maps/sample_map/</code> folder from the clean example.<br />
* '''You want to understand the files:''' read [[HPL3/SOMA/Modding/Creating a Mod|Creating a Mod]], [[HPL3/Resources Configuration|Resources Configuration]], and [[HPL3/Launch Configuration|Launch Configuration]].</div>TiMan