TiMan: Created page with "{{Hpl3SomaGettingStarted|step=4}} You will use the working sample as your first map and make one visible editor change. Starting from the sample avoids mixing basic editor le..."

2026-07-30T10:47:43Z

Created page with "{{Hpl3SomaGettingStarted|step=4}} You will use the working sample as your first map and make one visible editor change. Starting from the sample avoids mixing basic editor le..."

New page

{{Hpl3SomaGettingStarted|step=4}}

You will use the working sample as your first map and make one visible editor change. Starting from the sample avoids mixing basic editor learning with player-start and launch-configuration problems.

== Open the map ==

# In <code>LevelEditor.exe</code>, choose '''File → Open'''.
# Open <code>MyFirstMod/maps/sample_map/sample_map.hpm</code>.
# Move around the perspective viewport and inspect the existing room. See [[HPL3/SOMA/Level Design/Level Editor View|Level Editor View]] if the viewport controls are unfamiliar.

== Make one visible change ==

Select an existing object and move it a small, obvious distance with the translation tool. Save the map, close it, and reopen <code>sample_map.hpm</code>.

{{tip|For the first checkpoint, change only one existing object. Add new objects, lighting, and gameplay entities after the edit-save-launch loop is proven.}}

HPL3 stores different object categories in files beside the main map, such as <code>sample_map.hpm_Entity</code>, <code>sample_map.hpm_Light</code>, and <code>sample_map.hpm_StaticObject</code>. Keep these files together with <code>sample_map.hpm</code>.

== Test in-game ==

Launch your mod again and confirm that the object moved. If the old version appears, close the game and relaunch the mod to rule out cached state.

== Checkpoint ==

Continue when the changed object:

* remains moved after reopening the map in the editor; and
* appears in its new position in-game.

== If it does not work ==

* Confirm the editor title bar says <code>(Working on mod)</code>.
* Confirm you opened the map inside your copied mod, not the bundled example.
* Confirm the complete set of <code>.hpm</code> and <code>.hpm_*</code> files is writable and remains in the same folder.
* If the editor view is the problem, use [[HPL3/SOMA/Level Design/Level Editor View|Level Editor View]]. For individual object types, use the relevant section of [[HPL3/SOMA/Level Design|SOMA Level Design]].

HPL3/SOMA/Getting Started/Edit Your First Map - Revision history

TiMan: Created page with "{{Hpl3SomaGettingStarted|step=4}} You will use the working sample as your first map and make one visible editor change. Starting from the sample avoids mixing basic editor le..."