TiMan: Created page with "{{Hpl3SomaGettingStarted|step=5}} Every map can have a map script. For the sample map, it is `sample_map.hps` beside `sample_map.hpm`. == Add a visible..."

2026-07-30T10:49:57Z

Created page with "{{Hpl3SomaGettingStarted|step=5}} Every map can have a map script. For the sample map, it is <code>sample_map.hps</code> beside <code>sample_map.hpm</code>. == Add a visible..."

New page

{{Hpl3SomaGettingStarted|step=5}}

Every map can have a map script. For the sample map, it is <code>sample_map.hps</code> beside <code>sample_map.hpm</code>.

== Add a visible script change ==

# Open <code>MyFirstMod/maps/sample_map/sample_map.hps</code> in your text editor.
# Find <code>void OnStart()</code> inside the <code>cScrMap</code> class.
# Add the debug-message call between its braces:

<syntaxhighlight lang="cpp">
void OnStart()
{
cLux_AddDebugMessage("Hello World!");
}
</syntaxhighlight>

# Save the script.
# Launch the mod. If the map was already running in development mode, press <code>F5</code> to reload it.

The text <code>Hello World!</code> should appear at the lower-left of the screen when the map starts.

{{note|Keep the generated includes, the <code>cScrMap : iScrMap</code> declaration, and the surrounding callback structure. This tutorial changes only the body of <code>OnStart()</code>.}}

== Checkpoint ==

Continue when the message appears in-game after a fresh map start.

== If it does not work ==

* Confirm the script has the same base name and folder as the map: <code>sample_map.hpm</code> and <code>sample_map.hps</code>.
* Confirm the line ends with a semicolon and uses straight quotation marks.
* Confirm you edited the script inside your copied mod.
* Press <code>F1</code> in development mode, then use '''Show Error List''' or '''Show HPL Log'''.

Read [[HPL3/Scripting/Scripting Guide/Scripting Workflow and Structure|Scripting Workflow and Structure]] for the generated map-script layout and [[HPL3/Scripting/Scripting Guide/Hello World|Hello World]] for the focused scripting lesson.

HPL3/SOMA/Getting Started/Add Your First Script - Revision history

TiMan: Created page with "{{Hpl3SomaGettingStarted|step=5}} Every map can have a map script. For the sample map, it is sample_map.hps beside sample_map.hpm. == Add a visible..."

TiMan: Created page with "{{Hpl3SomaGettingStarted|step=5}} Every map can have a map script. For the sample map, it is `sample_map.hps` beside `sample_map.hpm`. == Add a visible..."