https://wiki.frictionalgames.com/page?action=history&feed=atom&title=HPL3%2FSOMA%2FScripting%2FInterfaces_OverviewHPL3/SOMA/Scripting/Interfaces Overview - Revision history2026-10-04T04:27:59ZRevision history for this page on the wikiMediaWiki 1.34.2https://wiki.frictionalgames.com/page?title=HPL3/SOMA/Scripting/Interfaces_Overview&diff=7250&oldid=prevTiMan: Add a sourced SOMA guide with explanations and stock-script examples.2026-10-02T12:19:38Z<p>Add a sourced SOMA guide with explanations and stock-script examples.</p>
<p><b>New page</b></p><div>{{shortPageTitle}}<br />
<br />
Script interfaces connect SOMA’s AngelScript classes to engine objects and callbacks. Start with a stock terminal to see how a base class differs from a callback interface.<br />
<br />
== Trace the terminal script ==<br />
# Open <code>script/props/Prop_Terminal.hps</code>. Its declaration is:<br />
<br />
<syntaxhighlight lang="cpp"><br />
class cScrPropTerminal : iScrProp, iScrProp_Interface<br />
</syntaxhighlight><br />
<br />
# Follow <code>iScrProp</code> to <code>script/interfaces/Prop_Interface.hps</code>. It stores a native <code>cLuxProp</code> handle in <code>mBaseObj</code>. <code>SetupBaseInterface</code> assigns it and <code>GetBase()</code> returns it.<br />
# Return to the terminal’s <code>SetupAfterLoad</code>. It reads resource variables and calls <code>mBaseObj.CreateAndSetupGui</code> to set up the terminal GUI. This is an example of using the engine object exposed by the base.<br />
<br />
The terminal also implements <code>iScrProp_Interface</code>. Its script defines callbacks such as <code>SetupAfterLoad</code>, <code>OnInteract</code> and <code>GetInteractIconId</code>; these are separate from the base’s handle-access functions.<br />
<br />
== Find the matching base ==<br />
The area, agent, critter, player, effect and user-module interface files use the same handle-wrapper pattern for their corresponding native object types. Use the base belonging to the script you are studying; the prop wrapper holds a <code>cLuxProp</code>, while the module wrapper holds a <code>cLuxUserModule</code>.<br />
<br />
== Continue with a working example ==<br />
* [[HPL3/SOMA/Scripting/Terminals Overview|Set up a terminal]]<br />
* [[HPL3/SOMA/Scripting/Module Interface|Trace a user module]]<br />
* [[HPL3/Scripting/Entity Components|Add behavior through entity components]]<br />
<br />
[[Category:English]]</div>TiMan