TiMan at 10:52, 30 July 2026

2026-07-30T10:52:02Z

TiMan: Created page with "{{Hpl3SomaGettingStarted|step=1}} This step confirms that the game and the two tools needed for the first mod are available. == Before you begin == You need: * a working i..."

2026-07-30T10:46:43Z

Created page with "{{Hpl3SomaGettingStarted|step=1}} This step confirms that the game and the two tools needed for the first mod are available. == Before you begin == You need: * a working i..."

New page

{{Hpl3SomaGettingStarted|step=1}}

This step confirms that the game and the two tools needed for the first mod are available.

== Before you begin ==

You need:

* a working installation of ''SOMA'';
* the SOMA Level Editor, named <code>LevelEditor.exe</code>;
* the SOMA Mod Launcher, named <code>ModLauncher.exe</code> or <code>ModLauncher_NoSteam.exe</code>; and
* a plain-text or code editor for editing <code>.cfg</code>, <code>.hpc</code>, and <code>.hps</code> files.

The SOMA executables are normally in the game's installation folder. Launch ''SOMA'' and <code>LevelEditor.exe</code> once before continuing. This creates any per-user folders the tools require and confirms that both programs can start.

{{note|You do not need to install a separate map editor. The HPL3 editors are included with SOMA.}}

== Checkpoint ==

You are ready for Step 2 when:

* ''SOMA'' reaches its main menu;
* <code>LevelEditor.exe</code> opens; and
* you can locate the game's <code>mods</code> folder.

== If it does not work ==

If an executable is missing or does not start, repair or verify the ''SOMA'' installation through the store from which you installed it. Do this before copying mods or changing configuration files.

For an overview of the available documentation, see [[HPL3/SOMA/Modding|SOMA Modding]] and [[HPL3/SOMA/Level Design|SOMA Level Design]].

@@ Line 10: / Line 10: @@
 * the SOMA Level Editor, named <code>LevelEditor.exe</code>;
 * the SOMA Mod Launcher, named <code>ModLauncher.exe</code> or <code>ModLauncher_NoSteam.exe</code>; and
-* a plain-text or code editor for editing <code>.cfg</code>, <code>.hpc</code>, and <code>.hps</code> files.
+* a plain-text or code editor for editing <code>.cfg</code>, <code>.hpc</code>, and <code>.hps</code> files. Recommendtaion: Use '''Visual Studio Code''' with the '''HPL3 Language Tools''' extension.
 The SOMA executables are normally in the game's installation folder. Launch ''SOMA'' and <code>LevelEditor.exe</code> once before continuing. This creates any per-user folders the tools require and confirms that both programs can start.

HPL3/SOMA/Getting Started/Prepare Your Tools - Revision history

TiMan at 10:52, 30 July 2026

TiMan: Created page with "{{Hpl3SomaGettingStarted|step=1}} This step confirms that the game and the two tools needed for the first mod are available. == Before you begin == You need: * a working i..."