TiMan: Add a sourced SOMA guide with explanations and stock-script examples.

2026-10-02T12:21:16Z

Add a sourced SOMA guide with explanations and stock-script examples.

New page

{{shortPageTitle}}

The SOMA script declarations for this interface reference are in <code>script/interfaces/InputHandler_Interface.hps</code>.

The Input Handler creates named input actions and their bindings. Its CreateActions includes movement, Jump, Crouch, Run, Interact, Flashlight, menu actions and analog gamepad actions. Stock modules receive action IDs and a pressed/released flag through OnAction when configured to receive input callbacks.

== Trace an action from registration to callback ==
# Open <code>script/base/InputHandler.hps</code> and find <code>CreateActions</code>.
# Compare the action name with its enum ID in the registration call below.
# Open <code>script/modules/InventoryHandler.hps</code> and find <code>OnAction</code>; then check the module’s <code>UseInputCallbacks</code> entry in <code>config/Modules.cfg</code>.

Follow the stock registration in <code>CreateActions</code>: <code>CreateAction("Jump", eAction_Jump, true, "Movement")</code> creates the Jump action. A receiving module uses the enum ID rather than comparing the action’s text name. The inventory module demonstrates this with <code>if(alAction == eAction_OpenInventory && abPressed)</code>. In <code>Modules.cfg</code>, that module has <code>UseInputCallbacks="true"</code>.

== See also ==
* [[HPL3/SOMA/Scripting|SOMA scripting]]

[[Category:English]]

HPL3/SOMA/Scripting/Input Handler - Revision history

TiMan: Add a sourced SOMA guide with explanations and stock-script examples.