HPL3/SOMA/Getting Started/Configure the Level Editor

From Frictional Wiki
Jump to navigation Jump to search

The Level Editor must know which mod you are working on. This lets it resolve your mod's resources and save work in the correct context.

Select the work-in-progress mod

  1. Launch LevelEditor.exe at least once, then close it.
  2. Open the HPL3 user folder inside your Documents folder.
  3. Create or edit WIPMod.cfg.
  4. Point it to the copied mod's entry.hpc using its full path:
<WIPmod Path="C:/full/path/to/SOMA/mods/MyFirstMod/entry.hpc" />
  1. Save the file and reopen LevelEditor.exe.

The exact path depends on where SOMA is installed. Forward slashes keep the XML path easy to read.

Note icon.png The SOMA Mod Manager can perform this synchronization for you. Manual setup is shown here so you know which file controls it.

Checkpoint

The Level Editor title bar should include (Working on mod).

If it does not work

  • Confirm the path ends at your copied entry.hpc, not merely the mod folder.
  • Confirm the file is named exactly WIPMod.cfg, not WIPMod.cfg.txt.
  • Confirm entry.hpc is still valid XML.
  • Re-read Setup Modding Environment for custom-asset lookup directories. The bundled sample does not require you to add custom lookup directories yet.