Frictional Game Wiki


<h1>Script Reference document</h1>
<div class="level1">

<p>
This document is not perfectly structured, sometimes a certain script function is perhaps not in the most logical position and so forth. It's recommended you search with the browser for what you need. Almost all scripts are used in Penumbra/Penumbra: Overture so it's always a good idea to locate a script in an actual level .hps file to see how it is used.<br/>

<br/>

<br/>

<br/>

<br/>

<br/>

</p>

</div>

<h2>Engine scripts</h2>
<div class="level2">

</div>

<h3>General</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> Print<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asText<span class="br0">)</span>



</pre><p> </p>




<p>
Prints a string to the log.<br/>

</p>
<pre class="code c++">std<span class="sy0">::</span><span class="me2">string</span> FloatToString<span class="br0">(</span><span class="kw4">float</span> afX<span class="br0">)</span>



</pre><p> </p>




<p>
Converts a float to string<br/>

</p>
<pre class="code c++">std<span class="sy0">::</span><span class="me2">string</span> IntToString<span class="br0">(</span><span class="kw4">int</span> alX<span class="br0">)</span>



</pre><p> </p>




<p>
Converts an integer to string,<br/>

</p>
<pre class="code c++"><span class="kw4">float</span> RandFloat<span class="br0">(</span><span class="kw4">float</span> afMin<span class="sy0">,</span> <span class="kw4">float</span> afMax<span class="br0">)</span>



</pre><p> </p>




<p>
Generates a random float.<br/>

</p>
<pre class="code c++"><span class="kw4">int</span> RandInt<span class="br0">(</span><span class="kw4">int</span> alMin<span class="sy0">,</span> <span class="kw4">int</span> alMax<span class="br0">)</span>



</pre><p> </p>




<p>
Generates a random int.<br/>

</p>
<pre class="code c++">StringContains<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asString<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asSubString<span class="br0">)</span>



</pre><p> </p>




<p>
Checks what a string contains.<br/>

asString what string to check<br/>

asSubString what to check the string against<br/>

<br/>

</p>

</div>

<h3>Resources</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">static</span> std<span class="sy0">::</span><span class="me2">string</span> stdcall Translate<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asCat<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span>



</pre><p> </p>




<p>
Gets a string in the current language.<br/>

asCat The translation category<br/>

asName The name of the category entry.<br/>

</p>
<pre class="code c++"><span class="kw4">static</span> <span class="kw4">void</span> stdcall PreloadSound<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asFile<span class="br0">)</span>



</pre><p> </p>




<p>
Preloads the data for a sound.<br/>

asFile This can be a wav, ogg, mp3 or snt file.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> ResetLogicTimer<span class="br0">(</span><span class="br0">)</span>



</pre><p> </p>




<p>
Resync screen frames to logic timer.<br/>

<br/>

</p>

</div>

<h3>Particle Systems</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> SetParticleSystemActive<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> bool abActive<span class="br0">)</span>



</pre><p> </p>




<p>
Set if a particle system should be active or not.<br/>

asName The name of the particle system.<br/>

abActive If it should be active or not.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> CreateParticleSystem<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asType<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asArea<span class="sy0">,</span>
                                                     <span class="kw4">float</span> afX<span class="sy0">,</span> <span class="kw4">float</span> afY<span class="sy0">,</span> <span class="kw4">float</span> afZ<span class="br0">)</span>



</pre><p> </p>




<p>
Create a particle system at the position of an area<br/>

asName The name of the particle system.<br/>

asType The type of aprticle system<br/>

asArea The name of the area<br/>

X Y and Z the variables of the particle system.<br/>

</p>
<pre class="code c++">CreateParticleSystemOnCamera<span class="br0">(</span>string asName <span class="sy0">,</span>string asFile<span class="br0">)</span>



</pre><p> </p>




<p>
Create an particle on the position of the camera(player).<br/>

asName the name of the particle system ingame.<br/>

asFile the name of the file for the particle system.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> KillParticleSystem<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span>



</pre><p> </p>




<p>
Kill a particle system<br/>

asName The name of the particle system.<br/>

<br/>

</p>

</div>

<h3>Beams</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> CreateBeam<span class="br0">(</span>string asName<span class="sy0">,</span> string asFile<span class="sy0">,</span> string asStartArea<span class="sy0">,</span> string asEndArea<span class="br0">)</span>



</pre><p> </p>




<p>
Creates a beam between 2 areas<br/>

asName the name of the beam<br/>

asFile the name of the .beam file<br/>

asStartArea name of the area to start the beam<br/>

asEndArea name of the area to end the beam<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> DestroyBeam<span class="br0">(</span>string asName<span class="br0">)</span>



</pre><p> </p>




<p>
Destroy a beam<br/>

asName name of the beam to destory<br/>

<br/>

</p>

</div>

<h3>Lights</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> FadeLight3D<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>
                    <span class="kw4">float</span> afR<span class="sy0">,</span><span class="kw4">float</span> afG<span class="sy0">,</span> <span class="kw4">float</span> afB<span class="sy0">,</span> <span class="kw4">float</span> afA<span class="sy0">,</span> <span class="kw4">float</span> afRadius<span class="sy0">,</span> <span class="kw4">float</span> afTime<span class="br0">)</span>



</pre><p> </p>




<p>
Fades a sound to a color and a radius<br/>

asName The name of the light<br/>

afR The red channel to fade to.<br/>

afG The green channel to fade to.<br/>

afB The blue channel to fade to.<br/>

afA The alpha channel to fade to.<br/>

afRadius The radius to fade to.<br/>

afTime The amount of seconds the fade should last.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AttachBillboardToLight3D<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asBillboardName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asLightName<span class="sy0">,</span>bool abX<span class="br0">)</span>



</pre><p> </p>




<p>
Attaches a billboard to a light<br/>

asBillboardName The billbaord name<br/>

asLightName The light name<br/>

abX True if it should be attached, false if you want to remove.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetLight3DVisible<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> bool abX<span class="br0">)</span>



</pre><p> </p>




<p>
Sets on/off a light<br/>

asName The light name<br/>

abX if the light should be on or off.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetLight3DFlickerActive<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> bool abX<span class="br0">)</span>



</pre><p> </p>




<p>
Sets flickering on/off a light<br/>

asName The light name<br/>

abX if the light flicker should be on or off.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetLight3DFlicker<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>
                          <span class="kw4">float</span> afR<span class="sy0">,</span><span class="kw4">float</span> afG<span class="sy0">,</span> <span class="kw4">float</span> afB<span class="sy0">,</span> <span class="kw4">float</span> afA<span class="sy0">,</span>
                          <span class="kw4">float</span> afRadius<span class="sy0">,</span>
                          <span class="kw4">float</span> afOnMinLength<span class="sy0">,</span> <span class="kw4">float</span> afOnMaxLength<span class="sy0">,</span>
                          std<span class="sy0">::</span><span class="me2">string</span> asOnSound<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asOnPS<span class="sy0">,</span>
                          <span class="kw4">float</span> afOffMinLength<span class="sy0">,</span> <span class="kw4">float</span> afOffMaxLength<span class="sy0">,</span>
                          std<span class="sy0">::</span><span class="me2">string</span> asOffSound<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asOffPS<span class="sy0">,</span>
                          bool abFade<span class="sy0">,</span>
                          <span class="kw4">float</span> afOnFadeLength<span class="sy0">,</span> <span class="kw4">float</span> afOffFadeLength<span class="br0">)</span>



</pre><p> </p>




<p>
Sets flickering parameters<br/>

asName The light name<br/>

abR, afG, afB, afA The color of the light when off<br/>

afRadius The radius of the light when off.<br/>

afOnMinLength Minimum time before going from off to on.<br/>

afOnMaxLength Maximum time before going from off to on.<br/>

asOnSound Name of the sound played when going from off to on. “” means no sound.<br/>

asOnPS Name of the particle system played when going from off to on. “” means none.<br/>

afOffMinLength Minimum time before going from on to off.<br/>

afOffMaxLength Maximum time before going from on to off.<br/>

asOffSound Name of the sound played when going from on to off. “” means no sound.<br/>

asOffPS Name of the particle system played when going from on to off. “” means none.<br/>

abFade If there should be a fade between off and on.<br/>

afOnFadeLength Fade length from off to on.<br/>

afOffFadeLength Fade length from on to off.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> CreateLightFlashAtArea<span class="br0">(</span>    std<span class="sy0">::</span><span class="me2">string</span> asArea<span class="sy0">,</span> <span class="kw4">float</span> afRadius<span class="sy0">,</span>
                    <span class="kw4">float</span> afR<span class="sy0">,</span><span class="kw4">float</span> afG<span class="sy0">,</span> <span class="kw4">float</span> afB<span class="sy0">,</span> <span class="kw4">float</span> afA<span class="sy0">,</span>
                    <span class="kw4">float</span> afAddTime<span class="sy0">,</span> <span class="kw4">float</span> afNegTime<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Creates a flash of light at an area.<br/>

asArea Name of the area to create the flash in<br/>

afRadius Radius of the flash<br/>

afR, afG, afB, afA Red, Green, Blue and alpha of the flash..<br/>

afAddTime Time it will take to reach full strenght.<br/>

afNegTime Time it will take to end flash, turning black.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetLight3DOnlyAffectInSector<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> bool abX<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
If a light should cast its light and shadow, affecting the surroundings in its sector(_room grouping) or in all sectors it reaches. By default static lights added in the editor to a level is true, the same goes for lights that are part of an Lamp entity.<br/>

asName The light name<br/>

abX if it should only affect the sector or not.<br/>

<br/>

</p>

</div>

<h3>Audio</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> CreateSoundEntity<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asFile<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asArea<span class="br0">)</span>



</pre><p> </p>




<p>
Creates a sound entity at the postion of an area.<br/>

asName Name of the created sound entity.<br/>

asFile The snt file to load.<br/>

asArea The area to create at.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> CreateSoundEntityAt<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asType<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asDestName<span class="sy0">,</span>
                   std<span class="sy0">::</span><span class="me2">string</span> asSoundName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asSoundFile<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Creates a sound entity at the position of an entity.<br/>

asType The type of entity. This can be: “Joint”,“Body” or “Entity”.<br/>

asDestName The entity/body/joint name<br/>

asSoundName The name of created sound entity.<br/>

asSoundFile The name of the snt file.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> PlaySoundEntity<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> bool abPlayStart<span class="br0">)</span>



</pre><p> </p>




<p>
Play a sound entity<br/>

asName The entity name<br/>

abPlayStart If the start sound should be played.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> StopSoundEntity<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> bool abPlayEnd<span class="br0">)</span>



</pre><p> </p>




<p>
Stop a sound entity<br/>

asName The entity name<br/>

abPlayEnd If the end sound should be played.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> FadeInSoundEntity<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">float</span> afSpeed<span class="br0">)</span>



</pre><p> </p>




<p>
Play a sound entity fading it<br/>

asName The entity name<br/>

afSpeed Volume increase per second.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> FadeOutSoundEntity<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">float</span> afSpeed<span class="br0">)</span>



</pre><p> </p>




<p>
Stop a sound entity fading it<br/>

asName The entity name<br/>

afSpeed Volume decrease per second.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> PlayMusic<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">float</span> afVol<span class="sy0">,</span> <span class="kw4">float</span> afStepSize<span class="sy0">,</span> bool abLoop<span class="br0">)</span>



</pre><p> </p>




<p>
Play music track.<br/>

asName Name of the music file.<br/>

afVol Volume of the music<br/>

afStepSize The increase in volume per second when fading in.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> StopMusic<span class="br0">(</span><span class="kw4">float</span> afStepSize<span class="br0">)</span>



</pre><p> </p>




<p>
Stop music track.<br/>

afStepSize The decrease in volume per second when fading out.<br/>

</p>
<pre class="code c++">PlayGameMusic<span class="br0">(</span>string asFile<span class="sy0">,</span> <span class="kw4">float</span> afVolume<span class="sy0">,</span><span class="kw4">float</span> afFadeStep<span class="sy0">,</span>bool abLoop<span class="sy0">,</span> <span class="kw4">int</span> alPrio<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Play music track with prio, added to episode 1 to be able to play different tracks that mix in and out depending on prio.<br/>

asFile The name of the music file.<br/>

afVolume The volume to play the music at 0 to 1.<br/>

afFadeStep The decrease in volume per second when fading out.<br/>

abLoop If the music should loop.<br/>

alPrio The priority of the track, 0 to 10. A higher numbers fades a lower number out, if you have an ambient music track using prio 0 it will fade out if you add a music track to an enemy entity with prio 1 and the enemy attacks the player. When the attack is over the ambient track will fade back in.<br/>

</p>
<pre class="code c++">StopGameMusic<span class="br0">(</span><span class="kw4">float</span> afFadeStep<span class="sy0">,</span> <span class="kw4">int</span> alPrio<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Stop game music track with prio.<br/>

afFadeStepThe decrease in volume per second when fading out.<br/>

alPrio priority of the music track.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> PlayGuiSound<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">float</span> afVol<span class="br0">)</span>



</pre><p> </p>




<p>
Play a sound gui sound, with out any position.<br/>

asName The sound name<br/>

afVol Volume of the sound<br/>

<br/>

</p>

</div>

<h3>Physics</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> SetJointCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asJointName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asType<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asFunc<span class="br0">)</span>



</pre><p> </p>




<p>
Sets a callback for a joint.<br/>

The syntax for the function is: void MyFunction(string asJointName)<br/>

asJointName The joint name<br/>

asType The type, can be: “OnMax” or “OnMin”.<br/>

asFunc The script function to be called. Must be in the current script file. “” = disabled.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> BreakJoint<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asJointName<span class="br0">)</span>



</pre><p> </p>




<p>
Breaks a joint.<br/>

asJointName The joint name<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetJointControllerActive<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asJointName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asCtrlName<span class="sy0">,</span> bool abActive<span class="br0">)</span>



</pre><p> </p>




<p>
Sets if a joint controller is active or not.<br/>

asJointName The joint name<br/>

asCtrlName The controller name<br/>

abActive If the controller is to be active or not.<br/>

</p>
<pre class="code c++">SetJointControllerPropertyFloat<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asJointName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asCtrlName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asProperty<span class="sy0">,</span> <span class="kw4">float</span> afValue<span class="br0">)</span>



</pre><p> </p>




<p>
Sets if a joint controller is active or not.<br/>

asJointName The joint name<br/>

asCtrlName The controller name<br/>

asProperty The property to change.<br/>

afValue The value of the property to change.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> ChangeJointController<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asJointName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asCtrlName<span class="br0">)</span>



</pre><p> </p>




<p>
Change the active controller. All other controllers are set to false.<br/>

asJointName The joint name<br/>

asCtrlName The controller name<br/>

</p>
<pre class="code c++"><span class="kw4">float</span> GetJointProperty<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asJointName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asProp<span class="br0">)</span>



</pre><p> </p>




<p>
Gets a property from the joint.<br/>

Valid properties are:<br/>

“Angle” The angle between the bodies (in degrees) (Not working for ball joint)<br/>

“Distance” The distance between the bodies (in meter)<br/>

“LinearSpeed” The relative linear speed between the bodies (in m/s)<br/>

“AngularSpeed” The relative angular speed between the bodies (in m/s)<br/>

“Force” The size of the force (in newton, kg*m/s^2).<br/>

“MinLimit” The minimum limit of the joint.<br/>

“MaxLimit” The maximum limit of the joint.<br/>

asJointName The joint name<br/>

asProp The property to get<br/>

</p>
<pre class="code c++">SetJointProperty<span class="br0">(</span>string asJoint<span class="sy0">,</span> string asProp<span class="sy0">,</span> <span class="kw4">float</span> afVal<span class="br0">)</span>



</pre><p> </p>




<p>
Sets a property to the joint.<br/>

asJoint the joint to change property for<br/>

asProp what property to change:<br/>

“MinLimit” the min limit on joint, does not work on ball joint.<br/>

“MaxLimit” the max limit on joint, does not work on ball joint.<br/>

afVal the value in float to set.<br/>

</p>
<pre class="code c++"><span class="kw4">float</span> GetBodyProperty<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asBodyName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asProp<span class="br0">)</span>



</pre><p> </p>




<p>
Gets a property from the body.<br/>

Valid properties are:<br/>

“Mass” The mass of the body (in kg)<br/>

“LinearSpeed” The linear speed the body has (in m/s)<br/>

“AngularSpeed” The angular speed the body has (in m/s)<br/>

asBodyName The body name<br/>

asProp The property to get<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetBodyProperty<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asBodyName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asProp<span class="sy0">,</span> <span class="kw4">float</span> afVal<span class="br0">)</span>



</pre><p> </p>




<p>
Sets a property to the body.<br/>

Valid properties are:<br/>

“Mass” The mass of the body (in kg)<br/>

“CollideCharacter” If the body should collide with the character or not, 0=false 1=true.<br/>

“HasGravity” If a body is affected by gravity. 0=false 1=true.<br/>

asBodyName The body name<br/>

asProp The property to get<br/>

afVal The new value of the property<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddBodyForce<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asBodyName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asCoordType<span class="sy0">,</span> <span class="kw4">float</span> afX<span class="sy0">,</span> <span class="kw4">float</span> afY<span class="sy0">,</span> <span class="kw4">float</span> afZ<span class="br0">)</span>



</pre><p> </p>




<p>
Adds a force to the body. This can either be in the bodies local coord system or the world's.<br/>

asBodyName The body name<br/>

asCoordType The coordinate system type. “World” or “Local”.<br/>

afX force in the x direction. (in newton, kg*m/s^2)<br/>

afY force in the y direction. (in newton, kg*m/s^2)<br/>

afZ force in the z direction. (in newton, kg*m/s^2)<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddBodyImpulse<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asBodyName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asCoordType<span class="sy0">,</span>
                                    <span class="kw4">float</span> afX<span class="sy0">,</span> <span class="kw4">float</span> afY<span class="sy0">,</span> <span class="kw4">float</span> afZ<span class="br0">)</span>



</pre><p> </p>




<p>
Adds an impule (a change in velocity) to the body. This can either be in the bodies local coord system or the world's.<br/>

asBodyName The body name<br/>

asCoordType The coordinate system type. “World” or “Local”.<br/>

afX velocity in the x direction. (in m/s)<br/>

afY velocity in the y direction. (in m/s)<br/>

afZ velocity in the z direction. (in m/s)<br/>

<br/>

</p>

</div>

<h3>Local Variables</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> CreateLocalVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">int</span> alVal<span class="br0">)</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">void</span> SetLocalVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">int</span> alVal<span class="br0">)</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">void</span> AddLocalVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">int</span> alVal<span class="br0">)</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">int</span> GetLocalVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span>



</pre><p> </p>




<p>
<br/>

</p>

</div>

<h3>Global Variables</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span>  CreateGlobalVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">int</span> alVal<span class="br0">)</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">void</span> SetGlobalVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">int</span> alVal<span class="br0">)</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">void</span> AddGlobalVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">int</span> alVal<span class="br0">)</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">int</span> GetGlobalVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span>



</pre><p> </p>




<p>
<br/>

<br/>

</p>

</div>

<h2>Game scripts</h2>
<div class="level2">

</div>

<h3>General</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> ResetGame<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Resets the game and returns to main menu<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> StartCredits<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Starts the end credits screen, uses .lang Category “MainMenu” and .lang Entry “CreditsText” as well as music file “penumbra_music_E1_E.ogg”<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> StartDemoEndText<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Starts the end images that are used in the demo of episode 1, images are named “demo_end01.jpg” increase the number for each image you want to use.<br/>

</p>
<pre class="code c++">string GetActionKeyString<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asAction<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Gets the key for a certain action, for example can be used in tutorials to create text that uses the user configured key for “Interact”.<br/>

asAction The name of the action<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddMessageTrans<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asTransCat<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asTransName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds on on screen game message.<br/>

TransCat The translation category<br/>

TransName The translation name<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddMessage<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asMessage<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds on on screen game message.<br/>

asMessage The text to be shown.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetMessagesOverCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asFunction<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets a callback that is called (and removed) when the last message as been shown.<br/>

asFunction The function to be called, syntax “MyFunc()“<br/>

</p>
<pre class="code c++">AddSubTitleTrans<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asTransCat<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asTransName<span class="sy0">,</span> <span class="kw4">float</span> afTime<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds a onscreen message at the bottom, that does not interrupt the gameplay.<br/>

asTransCat The translation files category.<br/>

asTransName The translation files name of the entry to be displayed.<br/>

afTime the length of time it should be displayed.<br/>

</p>
<pre class="code c++">AddSubTitle<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asMessage<span class="sy0">,</span> <span class="kw4">float</span> afTime<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds a onscreen message at the bottom, that does not interrupt the gameplay.<br/>

asMessage the text you want to appear on screen.<br/>

afTime the length of time it should be displayed.<br/>

</p>
<pre class="code c++">SetMessageBlackText<span class="br0">(</span>bool abX<span class="br0">)</span>



</pre><p> </p>




<p>
Makes the onscreen text invert colours to be easier to read on bright backgrounds.<br/>

abX enable or disabled the function.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddRadioMessage<span class="br0">(</span>    std<span class="sy0">::</span><span class="me2">string</span> asTransCat<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asTransName<span class="sy0">,</span>
                std<span class="sy0">::</span><span class="me2">string</span> asSound<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Plays an audio file and displays subtitles for it.<br/>

asTransCat the Category in the translations file<br/>

asTransName the name of the entry in the translations file<br/>

asSound the sound file to play for the text.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetRadioOnEndCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asFunc<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Callback that activates when a Radio message is over<br/>

asFunc The name of the callback to activate<br/>

VARIOUS TEMP STRINGS
</p>
<pre class="code c++"><span class="kw4">void</span> AddToTempString<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asString<span class="br0">)</span><span class="sy0">;</span> <span class="co1">//A piece of text to add to a string</span>
<span class="kw4">void</span> AddToTempStringTrans<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asCat<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asEntry<span class="br0">)</span><span class="sy0">;</span> <span class="co1">//A text from the translations file in Category from Entry</span>
<span class="kw4">void</span> AddToTempStringAction<span class="br0">(</span>string<span class="br0">)</span><span class="sy0">;</span> <span class="co1">//Get user configured key for a certain action</span>
<span class="kw4">void</span> AddMessageTempString<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">//Add the strings to one temporary string to print as a Message on screen</span>
<span class="kw4">void</span> AddSubTitleTempString<span class="br0">(</span><span class="kw4">float</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">//Add the strings to one temporary string to print as a Subtitle on screen</span>



</pre><p> </p>




<p>
Used to create a flow of text that uses various sources, as an example from episode 1:
</p>
<pre class="code c++">AddToTempStringTrans<span class="br0">(</span>"00_01_boat_cabin"<span class="sy0">,</span> "PadLock01"<span class="br0">)</span><span class="sy0">;</span>
AddToTempStringAction<span class="br0">(</span>"Inventory"<span class="br0">)</span><span class="sy0">;</span>
AddToTempStringTrans<span class="br0">(</span>"Misc"<span class="sy0">,</span> "ParentDot"<span class="br0">)</span><span class="sy0">;</span>
AddMessageTempString<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Wrote the message “Always travel with a padlock. And a key, preferably. Mine's in the inventory (TAB).” as a message.<br/>

</p>
<pre class="code c++"><span class="kw4">static</span> <span class="kw4">void</span> __stdcall ChangeMap<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asMapFile<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asMapPos<span class="sy0">,</span>
                    std<span class="sy0">::</span><span class="me2">string</span> asStartSound<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asStopSound<span class="sy0">,</span>
                    <span class="kw4">float</span> afFadeOutTime<span class="sy0">,</span> <span class="kw4">float</span> afFadeInTime<span class="sy0">,</span>
                    std<span class="sy0">::</span><span class="me2">string</span> asLoadTextCat<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asLoadTextEntry<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Changes the map.<br/>

asMapFile The file to be loaded<br/>

asMapPos The position on the map to be spawned on.<br/>

asStartSound The sound that is played when the change starts.<br/>

asStopsSound The sound that is played when the new map is loaded<br/>

afFadeOutTime Time in seconds it takes for the fade out.<br/>

afFadeInTime Time in seconds it takes for the fade in.<br/>

asLoadTextCat Category in .lang file to use<br/>

asLoadTextEntry Entry in .lang file to use<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddNotebookTask<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asTransCat<span class="sy0">,</span>
                                       std<span class="sy0">::</span><span class="me2">string</span> asTransEntry<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds a new task note in the notebook<br/>

asName Name of the task<br/>

asTransCat Translation category of text.<br/>

asTransEntry Translation entry of text.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddNotebookTaskText<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asText<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds a new task note in the notebook without using the lang file.<br/>

asName Name of the task<br/>

asText The text for the task<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddNotebookNote<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asNameCat<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asNameEntry<span class="sy0">,</span>
                     std<span class="sy0">::</span><span class="me2">string</span> asTextCat<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asTextEntry<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds a note to the note book<br/>

asNameCat<br/>

asNameEntry Name of the note<br/>

asTextCat<br/>

asTextEntry The note text.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> RemoveNotebookTask<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Removes a task note in the notebook.<br/>

asName Name of the task<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> StartNumericalPanel<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span><span class="kw4">int</span> alCode1<span class="sy0">,</span><span class="kw4">int</span> alCode2<span class="sy0">,</span><span class="kw4">int</span> alCode3<span class="sy0">,</span>
                       <span class="kw4">int</span>  alCode4<span class="sy0">,</span> <span class="kw4">float</span> afDifficulty<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asCallback<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Starts the numerical panel<br/>

asName Name of the panel<br/>

alCode1 1st code digit.<br/>

alCode2 2nd code digit.<br/>

alCode3 3rd code digit.<br/>

alCode4 4th code digit.<br/>

afDifficulty How difficult it is to hack.<br/>

asCallback Called when the code as been entered. Syntax: <b>MyCallback(string asName, bool abCodeWasCorrect)</b> <br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetInventoryActive<span class="br0">(</span>bool abX<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set if the inventory should be active.<br/>

abX If it is active or not.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> FadeIn<span class="br0">(</span><span class="kw4">float</span> afTime<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Fades the screen to full color.<br/>

afTime Time the fade will take in seconds.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> FadeOut<span class="br0">(</span><span class="kw4">float</span> afTime<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Fades the screen to black.<br/>

afTime Time the fade will take in seconds.<br/>

</p>
<pre class="code c++">bool IsFading<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Check if a fade is going on.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetWideScreenActive<span class="br0">(</span>bool abActive<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets wide screen mode on or off.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AutoSave<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Save the game to the auto save.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> ClearSavedMaps<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Clears the “history” of the save, useful to do when you know the player will not be able to go back anymore. Makes the next save much smaller in size. It's a must to clear the save history a couple of times during the length of a game, in Penumbra: Overture we do it 5-7 times during the whole game.<br/>

</p>
<pre class="code c++">SetDepthOfFieldActive<span class="br0">(</span>bool abX<span class="sy0">,</span> <span class="kw4">float</span> afFadeTime<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets depth of field on/off<br/>

abX if true/false<br/>

afFadeTime how long for it to focus.<br/>

</p>
<pre class="code c++">SetupDepthOfField<span class="br0">(</span><span class="kw4">float</span> afNearPlane<span class="sy0">,</span> <span class="kw4">float</span> afFocalPlane<span class="sy0">,</span> <span class="kw4">float</span> afFarPlane<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
How the depth of field should appear<br/>

afNearPlane where the focus should begin<br/>

afFocalPlane how large area that is in focus<br/>

afFarPlane where the focus should end<br/>

</p>
<pre class="code c++">FocusOnEntity<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEntity<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set focus on a particular entity.<br/>

asEntity name of the entity<br/>

</p>
<pre class="code c++">SetConstantFocusOnEntity<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEntity<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set focus on a particular entity and keep focus on it if it moves or the player moves.<br/>

asEntity name of the entity<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> StartFlash<span class="br0">(</span><span class="kw4">float</span> afFadeIn<span class="sy0">,</span> <span class="kw4">float</span> afWhite<span class="sy0">,</span> <span class="kw4">float</span> afFadeOut<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Creates a white flash on screen.<br/>

afFadeIn The time the fade in takes.<br/>

afWhite The time it stays white.<br/>

afFadeOut The time the fade out takes.<br/>

</p>
<pre class="code c++">StartScreenShake<span class="br0">(</span><span class="kw4">float</span> afAmount<span class="sy0">,</span> <span class="kw4">float</span> afTime<span class="sy0">,</span><span class="kw4">float</span> afFadeInTime<span class="sy0">,</span><span class="kw4">float</span> afFadeOutTime<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Makes the screen shake.<br/>

afAmount The ammount of shaking.<br/>

afTime How long the shake should be.<br/>

afFadeInTime How fast the shake should fade in.<br/>

afFadeOutTime How fast the shake should fade out.<br/>

</p>
<pre class="code c++">SetupSaveArea<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asMessageCat<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asMessageEntry<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asSound<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Properties for an area to type “save”, eg “_area_save_gamename”. asName the name of the area<br/>

asMessageCat The message category in lang file<br/>

asMessageEntry The message entry in lang file<br/>

asSound The sound to play during the save<br/>

<br/>

</p>

</div>

<h3>Attacks</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> CreateSplashDamage<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asAreaName<span class="sy0">,</span> <span class="kw4">float</span> afRadius<span class="sy0">,</span> <span class="kw4">float</span> afMinDamage<span class="sy0">,</span> <span class="kw4">float</span> afMaxDamge<span class="sy0">,</span>
                                             <span class="kw4">float</span> afMinForce<span class="sy0">,</span> <span class="kw4">float</span> afMaxForce<span class="sy0">,</span> <span class="kw4">float</span> afMaxImpulse<span class="sy0">,</span> <span class="kw4">int</span> alStrength<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Creates a ball shaped splash damage at the center of an area.<br/>

asAreaName Name of the area.<br/>

afRadius Radius of the slash damage in meters.<br/>

afMinDamage The minimum damage if in side radius<br/>

afMaxDamge The maximum damage, this is when you are at center.<br/>

afMinForce The minimum force if you are inside the radius.<br/>

afMaxForce The maximum force, this is when you are at center.<br/>

afMaxImpulse Impulse is ForceSize / Mass and this is the max value for that. This is useful to insure that samll objects to no gain very high speed.<br/>

alStrength The strength of the the damage.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetupDamageArea<span class="br0">(</span> string asName<span class="sy0">,</span> <span class="kw4">float</span> afDamage<span class="sy0">,</span>
             <span class="kw4">float</span> afUpdatesPerSec<span class="sy0">,</span> <span class="kw4">int</span> alStrength<span class="sy0">,</span>
             bool abDisableObjects<span class="sy0">,</span> bool abDisableEnemies<span class="sy0">,</span>
             string asDamageType<span class="sy0">,</span> string asDamageSound<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Properties for an area of type “damage”, eg “_area_damage_gamename”. Will inflict damage on player and entites while in it.<br/>

asName The name of the area<br/>

afDamage Damage to do for each update<br/>

afUpdatesPerSec How many updates per second<br/>

alStrength The strength of each update<br/>

abDisableObjects If objects should be disabled on destruction<br/>

abDisableEnemies If enemies should be disabled on destruction<br/>

asDamageType What sort of damage graphics to use. “BloodSplash”, “Ice”, “Poison”.<br/>

asDamageSound What sound to play at each damage.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> DamageEntity<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">float</span> afDamage<span class="sy0">,</span> <span class="kw4">int</span> alStrength<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Gives damage to an entity<br/>

asName the name of the entity<br/>

afDamage the amount of damage to do<br/>

alStrength the strength of the damage<br/>

<br/>

</p>

</div>

<h3>Game Timer</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> CreateTimer<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">float</span> afTime<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asCallback<span class="sy0">,</span> bool abGlobal<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Creates a new timer which calls a callback function when the time is out.<br/>

Syntax: <b>MyCallback(string asTimerName)</b>, the prefix ”@” (ie “@Func()”) shows that the function is in the global script<br/>

asName Name of the timer<br/>

afTime The time til time out in seconds.<br/>

asCallback The callback fucntion<br/>

abGlobal If the timer is global. Global timers are not deleted at map change.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> DestroyTimer<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">void</span> SetTimerPaused<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> bool abPaused<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">void</span> SetTimerTime<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">float</span> afTime<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">void</span> AddTimerTime<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">float</span> afTime<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">float</span> GetTimerTime<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
<br/>

</p>

</div>

<h3>Player</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">static</span> <span class="kw4">void</span> GivePlayerDamage<span class="br0">(</span><span class="kw4">float</span> afAmount<span class="sy0">,</span>  std<span class="sy0">::</span><span class="me2">string</span> asType<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Gives the player a hit + damage<br/>

afAmount The amount of health taken.<br/>

asType what sort of damage effect<br/>

“BloodSplash”<br/>

“Ice”<br/>

“Poison”<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetPlayerHealth<span class="br0">(</span><span class="kw4">float</span> afHealth<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets the health of the player.<br/>

afHealth The amount the health should be set to.<br/>

</p>
<pre class="code c++"><span class="kw4">float</span> GetPlayerHealth<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Gets the current health of the player.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetPlayerPose<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asPose<span class="sy0">,</span>bool abChangeDirectly<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets the pose of the player.<br/>

asPose The pose, can be “Stand” or “Crouch”<br/>

abChangeDirectly, if the pose should change instantly or in a movement<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetPlayerActive<span class="br0">(</span>bool abActive<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets if player can be moved or not.<br/>

abActive If the player is active or not.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> StartPlayerLookAt<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEntityName<span class="sy0">,</span> <span class="kw4">float</span> afSpeedMul<span class="sy0">,</span> <span class="kw4">float</span> afMaxSpeed<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
This turns the players head towards a specific entity.<br/>

asEntityName The entity name<br/>

afSpeedMul The speed of the head movement is determined by the angle length multiplied by this.<br/>

afMaxSpeed The maximum speed the head will turn.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> StopPlayerLookAt<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Stops the look at motion.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> StartPlayerFearFilter<span class="br0">(</span><span class="kw4">float</span> afStrength<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Starts a fear effect filter.<br/>

afStrength strength of the filter.<br/>

</p>
<pre class="code c++">SetFlashlightDisabled<span class="br0">(</span>bool abDisabled<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Disabled the flashlight.<br/>

abDisabled true/false for flashlight on/off.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> StopPlayerFearFilter<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Stops the fear filter.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> TeleportPlayerToArea<span class="br0">(</span>string asArea<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Teleports the player to an area, players feet is aligned to the center of the area.<br/>

asArea the name of the area to teleport to.<br/>

</p>
<pre class="code c++">bool GetPlayerHasGasMask<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Get if the player has gasmask or not.<br/>

<br/>

</p>

</div>

<h3>Inventory</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> AddPickupCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asItem<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asFunction<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Add a callback that is called when the player picks up an item.<br/>

The syntax for the callback function is:<br/>

<b>void MyFunction(string asItem)</b>, the prefix “@” (ie “@Func()”) shows that the function is in the global script<br/>

asItem The name of the item.<br/>

asFuntion The name of the function called.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddUseCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asItem<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asEntity<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asFunction<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Add a callback that is called when the player uses the item on en entity<br/>

The syntax for the callback function is:<br/>

<b>void MyFunction(string asItem, string asEntity)</b>, the prefix “@” (ie “@Func()”) shows that the function is in the global script.<br/>

asItem The name of the item.<br/>

asEntity The name of the entity.<br/>

asFuntion The name of the function called.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddCombineCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asItem1<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asItem2<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asFunction<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Add a callback that is called when the player combines two items<br/>

The syntax for the callback function is (alSlotIndex = slot at which combination occurd):<br/>

<b>void MyFunction(string asItem1, string asItem2, int alSlotIndex)</b>, the prefix “@” (ie “@Func()”) shows that the function is in the global script.<br/>

asItem1 The name of the first item.<br/>

asItem2 The name of the second item.<br/>

asFuntion The name of the function called.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> RemovePickupCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asFunction<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">void</span> RemoveUseCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asFunction<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>



<pre class="code c++"><span class="kw4">void</span> RemoveCombineCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asFunction<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Removes the callback.<br/>

asFuntion The name of the function used by the callback.<br/>

</p>
<pre class="code c++">bool HasItem<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Checks if the player has a certain item.<br/>

asName The name of the item.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> RemoveItem<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Removes an item from the inventory.<br/>

asName The name of the item.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> GiveItem<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asEntityFile<span class="sy0">,</span> <span class="kw4">int</span> alSlotIndex<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Give an item to the player.<br/>

asName The name of the entity<br/>

asEntityFile The file to load it from.<br/>

lSlotIndex The index of the slot to put the item in. -1 = first empty slot<br/>

</p>
<pre class="code c++">SetInventoryMessage<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asMessage<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Displays a message in the inventory.<br/>

asMessage The message to write in the inventory.<br/>

</p>
<pre class="code c++">SetInventoryMessageTrans<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asTransCat<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asTransName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Displays a message from the lang file in the inventory.<br/>

asTransCat The name of the category in the lang file.<br/>

asTransName The name of the entry in the lang file.<br/>

<br/>

</p>

</div>

<h3>Map / Level Properties</h3>
<div class="level3">
<pre class="code c++">SetAmbientColor<span class="br0">(</span><span class="kw4">float</span> r<span class="sy0">,</span> <span class="kw4">float</span> g<span class="sy0">,</span> <span class="kw4">float</span> b<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets the ambient color of the level, this should always be part of a level as it gives it a bit of light otherwise shadows will be pitch black.<br/>

</p>
<pre class="code c++">SetSectorProperties<span class="br0">(</span>string asSector<span class="sy0">,</span> <span class="kw4">float</span> afAmbR<span class="sy0">,</span><span class="kw4">float</span> afAmbG<span class="sy0">,</span> <span class="kw4">float</span> afAmbB<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets the ambient color of a sector(individual groups of _room.<br/>

asSector the name of the sector.<br/>

afAmbR red 0-1<br/>

afAmbG green 0-1<br/>

afAmbB blue 0-1<br/>

The values are multiplied with the SetAmbientColor(f,f,f); values. This script function will most likely be expanded to include specific ambient sounds etc for each sector.<br/>

</p>
<pre class="code c++">SetSkybox<span class="br0">(</span>string asTexture<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets a texture as a sky box.<br/>

</p>
<pre class="code c++">SetSkyboxActive<span class="br0">(</span>bool<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set the skybox active with true/False<br/>

</p>
<pre class="code c++">SetSkyboxColor<span class="br0">(</span><span class="kw4">float</span> R<span class="sy0">,</span> <span class="kw4">float</span> G<span class="sy0">,</span> <span class="kw4">float</span> B<span class="sy0">,</span> <span class="kw4">float</span> A<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
What color should the Skybox have<br/>

R, G, B and Alpha<br/>

</p>
<pre class="code c++">SetFogActive<span class="br0">(</span>bool abX<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
If a level should have fog or not.<br/>

bool abX, false/true<br/>

</p>
<pre class="code c++">SetFogProperties<span class="br0">(</span><span class="kw4">float</span> afStart<span class="sy0">,</span> <span class="kw4">float</span> afEnd<span class="sy0">,</span> <span class="kw4">float</span> r<span class="sy0">,</span><span class="kw4">float</span> g<span class="sy0">,</span> <span class="kw4">float</span> b<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
The properties of the fog.<br/>

afStart how many meters from the camera should the fog begin.<br/>

afEnd how many meters from the camera should the fog reach full thickness.<br/>

float r,float g, float b the color of the fog in RGB.<br/>

</p>
<pre class="code c++">SetFogCulling<span class="br0">(</span>bool<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Should the game stop rendering the level when the fog is full thickness<br/>

true/false<br/>

</p>
<pre class="code c++">SetWaveGravityActive<span class="br0">(</span>bool abX<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Enable a dynamic gravity that mimics waves, ture/false<br/>

</p>
<pre class="code c++">SetupWaveGravity<span class="br0">(</span><span class="kw4">float</span> afMaxAngle<span class="sy0">,</span> <span class="kw4">float</span> afSwingLength<span class="sy0">,</span> <span class="kw4">float</span> afGravitySize<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asAxis<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set the properties for the dynamic wave gravity<br/>

afMaxAngle The maximum angel of the wave<br/>

afSwingLength The length for going from top to bottom<br/>

afGravitySize The strength of the gravity<br/>

asAxis Along which axis should the wave “move”<br/>

</p>
<pre class="code c++">SetMapGameName<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set the name of the current map, is used for naming the saved games.<br/>

asName the name of the map<br/>

</p>
<pre class="code c++">SetMapGameNameTrans<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asTransCat<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asTransEntry<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set the name of the current map using the lang file, is used for naming the saved games.<br/>

asTransCat the category in the lang file<br/>

asTransEntry the entry in the lang file with the name of the map<br/>

<br/>

</p>

</div>

<h3>Game Entity Properties</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> SetGameEntityActive<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> bool abX<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set if a game entity is active.<br/>

asName The name of the game entity<br/>

abX If active or not.<br/>

</p>
<pre class="code c++">bool GetGameEntityActive<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Get if a game entity is active.<br/>

asName The name of the game entity<br/>

return if active or not.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> ReplaceEntity<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asBodyName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asNewName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asNewFile<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Replaces an ingame entity with another entity, the new entity will appear at the center of the old entities location<br/>

asName Name of the ingame entity<br/>

asBodyName The name of the body in the old entity that will be used as a center for the new entity, leave as “” if entity only has 1 body<br/>

asNewName The ingame name given to the new entity<br/>

asNewFile The .ent file to be used for the new entity<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> CreateGameEntityVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEntName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asVarName<span class="sy0">,</span> <span class="kw4">int</span> alVal<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Create a variable for a game entity. Nothing happens if it is already created.<br/>

asEntName The name of the game entity<br/>

asVarName The name of variable<br/>

alVal value to set the variable to.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetGameEntityVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEntName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asVarName<span class="sy0">,</span> <span class="kw4">int</span> alVal<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Change the value of a entity variable to a new value<br/>

asEntName The name of the game entity<br/>

asVarName The name of variable<br/>

alVal value to set the variable to.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddGameEntityVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEntName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asVarName<span class="sy0">,</span> <span class="kw4">int</span> alVal<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Change the value of an entity variable by adding to the previous value<br/>

asEntName The name of the game entity<br/>

asVarName The name of variable<br/>

alVal value to add to the existing variable.<br/>

</p>
<pre class="code c++"><span class="kw4">int</span> GetGameEntityVar<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEntName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asVarName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Get the value of a variable for a game entity.<br/>

asEntName The name of the game entity<br/>

asVarName The name of variable<br/>

alVal value to set the variable to.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetGameEntityMaxExamineDist<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span><span class="kw4">float</span> afDist<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set the maximum distance at which a game entity can be examined.<br/>

asName The name of the game entity<br/>

afDist The distance in meters<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetGameEntityMaxInteractDist<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span><span class="kw4">float</span> afDist<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set the maximum distance at which a game entity can be interacted with.<br/>

asName The name of the game entity<br/>

afDist The distance in meters<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetGameEntityDescriptionTrans<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asTransCat<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asTransName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set a description on a game entity.<br/>

asName The name of the game entity<br/>

asTransCat The translation category<br/>

asTransName The translation name<br/>

</p>
<pre class="code c++">SetGameEntityDescriptionOnceTrans<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asTransCat<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asTransName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set a description on a game entity BUT display the eye only 1 time, after that the you can still examine but the eye wont show unless in Interact mode.<br/>

asName The name of the game entity<br/>

asTransCat The translation category<br/>

asTransName The translation name<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetGameEntityDescription<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asMessage<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set a description on a game entity.<br/>

asName The name of the game entity<br/>

asMessage The message<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetGameEntityGameNameTrans<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asTransCat<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asTransName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set a game name on a game entity.<br/>

asName The name of the game entity<br/>

asTransCat The translation category<br/>

asTransName The translation name<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetDoorState<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asState<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets the state of a door with animation. This entity was only used in early test builds of HPL.<br/>

asName The name of the game entity<br/>

asState The state to set, thís can be “Open”,“Closed”, “Opening” or “Closing”.<br/>

</p>
<pre class="code c++">SetDoorLocked<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asDoor<span class="sy0">,</span> bool abLocked<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets a door locked or unlocked, only works with SwingDoor entities(set in the .ent file)<br/>

asDoor the name of the entity.<br/>

abLocked true or false if locked or not.<br/>

</p>
<pre class="code c++">SetDoorLockedProperties<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asDoor<span class="sy0">,</span>
                std<span class="sy0">::</span><span class="me2">string</span> asMessCat<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asMessEntry<span class="sy0">,</span>
                std<span class="sy0">::</span><span class="me2">string</span> asSound<span class="sy0">,</span>
                bool RepeatLockedMessage<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Gives properties to a locked door, how it should sound what message to show etc. Only works with SwingDoor entities(set in the .ent file)<br/>

asDoor the name of the entity.<br/>

asMessCat the name of the category in the translations file.<br/>

asMessEntry the name of the entry in the translations file to use.<br/>

asSound sound to play for the locked door when player interacts.<br/>

RepeatLockedMessage true or false if the event should be every time or only the first time.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetObjectInteractMode<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asMode<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets the interact mode of an game object.<br/>

asName The name of the game object<br/>

asState The mode to set, valid modes are “Static”, “Grab”, “Move” and “Push”.<br/>

</p>
<pre class="code c++"><span class="kw4">static</span> <span class="kw4">void</span> __stdcall SetupLink<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asMapFile<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asMapPos<span class="sy0">,</span>
                                              std<span class="sy0">::</span><span class="me2">string</span> asStartSound<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asStopSound<span class="sy0">,</span>
                                                        <span class="kw4">float</span> afFadeOutTime<span class="sy0">,</span> <span class="kw4">float</span> afFadeInTime<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets up the properties for a link.<br/>

asName The name of the link<br/>

asMapFile The file to be loaded<br/>

asMapPos The position on the map to be spawned on.<br/>

asStartSound The sound that is played when the change starts.<br/>

asStopsSound The sound that is played when the new map is loaded<br/>

afFadeOutTime Time in seconds it takes for the fade out.<br/>

afFadeInTime Time in seconds it takes for the fade in.<br/>

</p>
<pre class="code c++"><span class="kw4">static</span> <span class="kw4">void</span> __stdcall SetupLinkLoadText<span class="br0">(</span>string asName<span class="sy0">,</span>
            string asMapFile<span class="sy0">,</span> string asMapPos<span class="sy0">,</span>
            string asStartSound<span class="sy0">,</span> string asStopSound<span class="sy0">,</span>
            <span class="kw4">float</span> afFadeOutTime<span class="sy0">,</span> <span class="kw4">float</span> afFadeInTime<span class="sy0">,</span>
            string asTextCat<span class="sy0">,</span> string asTextEntry<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets up the properties for a link and displays a screen with text/picture while loading.<br/>

asName The name of the link<br/>

asMapFile The file to be loaded<br/>

asMapPos The position on the map to be spawned on.<br/>

asStartSound The sound that is played when the change starts.<br/>

asStopsSound The sound that is played when the new map is loaded<br/>

afFadeOutTime Time in seconds it takes for the fade out.<br/>

afFadeInTime Time in seconds it takes for the fade in.<br/>

asTextCat The text category in translations file .lang<br/>

asTextEntry The text entry in translations file .lang<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetupLinkLockedProp<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asLockedSound<span class="sy0">,</span>
             std<span class="sy0">::</span><span class="me2">string</span> asLockedDescCat<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asLockedDescEntry<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Properties for an area of type “link”, eg “_area_link_gamename”, to be used if the link is “locked”.<br/>

asName The name of the link<br/>

asLockedSound The “locked sound” to play<br/>

asLockedDescCat In what category the text to use is in the .lang file.<br/>

asLockedDescEntry In what entry the text is found in the .lang file.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetLinkLocked<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> bool abLocked<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Set an area of type “link” as locked or unlocked.<br/>

asName The name of the link<br/>

abLocked True/false for locked or not.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetAreaCustomIcon<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asIcon<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Makes the area show a custom icon on player focus.<br/>

asName The name of the area<br/>

asIcon The icon, can be: “Inactive”, “Active”, “Invalid”, “Grab”, “Examine”,, “PickUp”, “Pointer”, “Item”, “DoorLink” or “None”.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddEnemyPatrolNode<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEnemy<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asNode<span class="sy0">,</span><span class="kw4">float</span> afTime<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asAnimation<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds node that the enemy will have on his patrol path.<br/>

asEnemy Name of the enemy<br/>

asNode The Node to walk to.<br/>

afTime The time to stay at the node when reached.<br/>

asAnimation The animation to be played when at the node. “” = idle.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> ClearEnemyPatrolNodes<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEnemy<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Clears all the patrol nodes for the enemy<br/>

asEnemy The Name of the enemy.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetEntityHealth<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> <span class="kw4">float</span> afHealth<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets the health of an entity<br/>

asName Name of the entity<br/>

afHealth the amount to set the health to.<br/>

</p>
<pre class="code c++"><span class="kw4">float</span> GetEnemyHealth<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEnemy<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Gets the health of an enemy<br/>

asEnemyName Name of the enemy<br/>

return the health.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> ShowEnemyPlayer<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEnemy<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Show the enemy the position of the player and sets the enemy into hunt mode.<br/>

asEnemy The name of the Enemy.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetEnemyUseTriggers<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEnemy<span class="sy0">,</span> bool abUseTriggers<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
If an enemy should use triggers, for example if an enemy should react to sounds.<br/>

asEnemy The name of the Enemy.<br/>

abUseTriggers use triggers or not.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetEnemyAttackCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEnemy<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asFunction<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Activates a callback when an enemy attacks the player.<br/>

asEnemy The name of the Enemy.<br/>

asFunction The name of the callback to activate.<br/>

</p>
<pre class="code c++">SetLampLit<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>bool abLit<span class="sy0">,</span> bool abFade<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets a Lamp entity light on/off, requires the entity file to be a Type=“Lamp”.<br/>

asName The name of the lamp entity.<br/>

abLit if it should be lit or not.<br/>

abFade if it should fade on/off, properties are set in the entity file.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetLampFlicker<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>bool abFlicker<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets a Lamp entity lights flicker, requires the entity file to be a Type=“Lamp”.<br/>

asName The name of the lamp entity.<br/>

abFlicker starts/stops the flicker.<br/>

Flicker properties are set in the entity file.<br/>

</p>
<pre class="code c++">SetupStickArea<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asArea<span class="sy0">,</span> bool abCanDeatch<span class="sy0">,</span>
            bool abMoveBody<span class="sy0">,</span> bool abRotateBody<span class="sy0">,</span>
            bool abCheckCenterInArea<span class="sy0">,</span> <span class="kw4">float</span> afPoseTime<span class="sy0">,</span>
            std<span class="sy0">::</span><span class="me2">string</span> asAttachSound<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asDetachSound<span class="sy0">,</span>
            std<span class="sy0">::</span><span class="me2">string</span> asAttachPS<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asDetachPS<span class="sy0">,</span>
            std<span class="sy0">::</span><span class="me2">string</span> asAttachFunc<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asDetachFunc<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Give properties to an area of type “stick”. Used to make an object attach itself to another etc.<br/>

asArea The name of the stick area<br/>

abCanDeatch if the area will allow to detach and attached object<br/>

abMoveBody Should the attached object be moved into the center<br/>

abRotateBody should the attached object be rotated to attach in a certain direction(rotating the stick area in the level will decide this)<br/>

abCheckCenterInArea only attach if the object to be attached is in the center of the stick area<br/>

afPoseTime how long will the attach movement(move/rotate) take<br/>

asAttachSound what attach sound to play<br/>

asDetachSound what detach sound to play<br/>

asAttachPS what particle effect to use on attach<br/>

asDetachPS what particle effect to use on detach<br/>

asAttachFunc name of attach callback<br/>

asDetachFunc name of detach callback<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AllowAttachment<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Executes the attachment settings in SetupStickArea.<br/>

<br/>

<em>Example of an attach callback</em>
</p>
<pre class="code c++"><span class="kw4">void</span> MyAttach<span class="br0">(</span>string asArea<span class="sy0">,</span> string asBody<span class="br0">)</span>
<span class="br0">{</span>
    <span class="kw1">if</span><span class="br0">(</span>StringContains<span class="br0">(</span>asBody<span class="sy0">,</span> "entityname"<span class="br0">)</span><span class="br0">)</span>
    <span class="br0">{</span>
        AllowAttachment<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>
    <span class="br0">}</span>
<span class="br0">}</span>



</pre><p> </p>



<pre class="code c++">DetachBodyFromStickArea<span class="br0">(</span>string asArea<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Detach a body from a stick area.<br/>

asArea Name of the area.<br/>

</p>
<pre class="code c++">SetupLadder<span class="br0">(</span>string asName<span class="sy0">,</span>string asAttachSound<span class="sy0">,</span> string asClimbUpSound<span class="sy0">,</span> string asClimbDownSound<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets properties for an area of type “ladder”. eg “_area_ladder_gamename”<br/>

asName Name of the area.<br/>

asAttachSound Sound to be played as player grabs onto ladder<br/>

asClimbUpSound Sound to be played as player climbs up.<br/>

asClimbDownSound Sound to be played as player climbs down.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> ChangeEntityAnimation<span class="br0">(</span>string asName<span class="sy0">,</span>string asAnimation<span class="sy0">,</span>bool abLoop<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Change the animation of an entity.<br/>

asName Name of the entity.<br/>

asAnimation the animation that should be used<br/>

abLoop if it should loop or not.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetupForceArea<span class="br0">(</span>    string asName<span class="sy0">,</span>
            <span class="kw4">float</span> afMaxForce<span class="sy0">,</span> <span class="kw4">float</span> afConstant<span class="sy0">,</span>
            <span class="kw4">float</span> afDestSpeed<span class="sy0">,</span> <span class="kw4">float</span> afMaxMass<span class="sy0">,</span>
            bool abMulWithMass<span class="sy0">,</span> bool abForceAtPoint<span class="sy0">,</span>
            bool abAffectBodies<span class="sy0">,</span> bool abAffectCharacters<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Properties for an area of type “force”, eg “_area_force_gamename”.<br/>

asName Name of the entity.<br/>

afMaxForce the value for the maximum force to apply<br/>

afConstant Used in the formula. Force = Constant * DistanceToDestSpeed, meaning it determines the force based on how far from the dest speed the object is.<br/>

afDestSpeed the value of the speed an object will travel at when reached maximum<br/>

afMaxMass the maximum mass that will be affected by the force<br/>

abMulWithMass if the force should apply the same amount to all objects of different mass<br/>

abForceAtPoint if force is to be applied to the collison point with the area. False = just use center of object.<br/>

abAffectBodies affect dynamic objects/bodies<br/>

abAffectCharacters affect charaters(player/enemies/etc)<br/>

</p>
<pre class="code c++">SetupLiquidArea<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span><span class="kw4">float</span> afDensity<span class="sy0">,</span> <span class="kw4">float</span> afLinearViscosity<span class="sy0">,</span><span class="kw4">float</span> afAngularViscosity<span class="sy0">,</span>string asPhysicsMaterial.
            <span class="kw4">float</span> fR<span class="sy0">,</span> <span class="kw4">float</span> fG<span class="sy0">,</span> <span class="kw4">float</span> fB<span class="sy0">,</span> abHasWaves<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Properties for an area of type “liquid”, eg “_area_liquid_gamename”.<br/>

asName Name of the entity.<br/>

afDensity The density of the liquid<br/>

afLinearViscosity How much “friction” the liquid should have in linear direction.<br/>

afAngularViscosity How much “friction” the liquid should have in angular direction<br/>

asPhysicsMaterial What physics material to use<br/>

fR, fG, fB The color of the liquid in Red, Green, Blue<br/>

abHasWaves if objects should bob in the water.
</p>
<pre class="code c++"> <span class="kw4">void</span> SetupGameButton<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>string asCallback<span class="sy0">,</span>string asAffectedEntities<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Creates a callback for entity of type “button”, eg .ent says Type=“Button”.<br/>

asName Name of the entity.<br/>

asCallback the name of the callback to activate.<br/>

asAffectedEntities The names of the entities that should be activated, example “light01” or “light01, light02, light03”.
</p>

<p>
Callback syntax: <b>void OnStateChange(string asButton,bool asInOn);</b>
</p>
<pre class="code c++"><span class="kw4">void</span> SetGameButtonOn<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span> bool abOn<span class="sy0">,</span> bool abUseEffects<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets a button entity on/off.<br/>

asName Name of the entity.<br/>

abOn On or off, true/false<br/>

abUseEffects if various effects set in the entity files of the entities affected by the button switch should be used or not.<br/>

</p>
<pre class="code c++"><span class="kw4">int</span> GetLeverState<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Gets the current state of a Lever entity.<br/>

asName Name of the entity.<br/>

returns int as -1 = min, 0=middle, 1=max<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetLeverStuck<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span><span class="kw4">int</span> alState<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets a Lever entity stuck at a certain position.<br/>

asName Name of the entity.<br/>

alState What position to stick it in, state: -1 = min, 0=middle, 1=max<br/>

</p>
<pre class="code c++"><span class="kw4">int</span> GetWheelState<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Gets the current state of a Wheel entity.<br/>

asName Name of the entity.<br/>

returns int as -1 = min, 0=middle, 1=max<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetWheelStuck<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span><span class="kw4">int</span> alState <span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets a Wheel entity stuck at a certain position.<br/>

asName Name of the entity.<br/>

alState What position to stick it in, state: -1 = min, 0=turn off stuck, 1=max<br/>

</p>
<pre class="code c++"><span class="kw4">float</span> GetWheelAngle<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Gets the current angle of a Wheel entity.<br/>

asName Name of the entity.<br/>

returns the value as float.<br/>

</p>
<pre class="code c++"><span class="kw4">float</span> GetWheelSpeed<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Gets the current speed of a Wheel entity.<br/>

asName Name of the entity.<br/>

returns the value as float.<br/>

</p>
<pre class="code c++">ConnectWheelToController<span class="br0">(</span>string asWheelName<span class="sy0">,</span>string asEntName<span class="sy0">,</span>string asCtrlName<span class="sy0">,</span>
                 <span class="kw4">float</span> afMinDest<span class="sy0">,</span> <span class="kw4">float</span> afMaxDest<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Connects a controller in the .ent file to the wheel.<br/>

asWheelName Name of the wheel entity in level.<br/>

asEntName Name of the entity file to use.<br/>

asCtrlName Name of the controller.<br/>

afMinDest Value of the minimum destination.<br/>

afMaxDest Value of the maximum destination.<br/>

</p>
<pre class="code c++">MoveEntityToArea<span class="br0">(</span>string asEntityName<span class="sy0">,</span> string asAreaName<span class="sy0">,</span>
            <span class="kw4">float</span> afSpeed<span class="sy0">,</span> <span class="kw4">float</span> afAcceleration<span class="sy0">,</span>
              <span class="kw4">float</span> afSlowDownRange<span class="sy0">,</span> string asCallback<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Moves an entity to an area. This can be used to create moving platforms, elevators etc.<br/>

asEntityName Name of the entity.<br/>

asAreaName Name of the area to move the entity to.<br/>

afSpeed At what speed to move the entity.<br/>

afAcceleration Acceleration of the entity.<br/>

afSlowDownRange How far away from the area to begind deceleration.<br/>

asCallback name of the callback to trigger when entity reaches area.<br/>

<b>Callback syntax: MyFunc(string asEntityName)</b> <br/>

<br/>

</p>

</div>

<h3>Game Entity Callbacks</h3>
<div class="level3">
<pre class="code c++"><span class="kw4">void</span> AddEntityCollideCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asType<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asDestName<span class="sy0">,</span>
                        std<span class="sy0">::</span><span class="me2">string</span> asEntityName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asFuncName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Add a collide callback to an entity.<br/>

The syntax for the callback function is:<br/>

<b>void MyFunction(string asParent, string asChild)</b>, the prefix “@” (ie “@Func()”) shows that the function is in the global script.<br/>

asParent is the entity the function is attached to and asChild is the other entity in the collision.<br/>

asType The type of callback, this can be “Enter”, “During” or “Leave”<br/>

asDestName The entity that should have the callback. “Player” will add it to the player.<br/>

asEntityName The entity to check for collision with.<br/>

asFuncName The name of the script function to add. This must be in the level's script file and not the global.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> RemoveEntityCollideCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asType<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asDestName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asEntityName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Removes a collide callback on an entity.<br/>

asType The type of callback, this can be “Enter”, “During” or “Leave”<br/>

asDestName The entity that has the callback<br/>

asEntityName The entity to check for collision with.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> AddEntityCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asType<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asDestName<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asFuncName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Add a callback to an entity.<br/>

The syntax for the callback function is:<br/>

<b>void MyFunction(string asEntity)</b>, the prefix “@” (ie “@Func()”) shows that the function is in the global script.<br/>

The different types are the following<br/>

“PlayerInteract” The player interacts with the entity.<br/>

“PlayerExamine” The player examines the entity.<br/>

“PlayerLook” The player is looking at the entity (it is in “focus”).<br/>

“OnUpdate” When the entity is updated.<br/>

“OnBreak” When the entity breaks.<br/>

asType The type of callback<br/>

asDestName The entity that should have the callback<br/>

asFuncName The name of the script function to add. This must be in the level's script file and not the global.<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> RemoveEntityCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asType<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asDestName<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Removes a callback on an entity.<br/>

asType The type of callback. The same types as for AddEntityCallback applies.<br/>

asDestName The entity that has the callback<br/>

</p>
<pre class="code c++"><span class="kw4">void</span> SetEnemyDeathCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asEnemy<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asFunction<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Sets the function that is called when the enemy dies.<br/>

asEnemyName Name of the enemy<br/>

asFunction The function, syntax: <b>MyFunc(string asEnemyName)</b> <br/>

</p>
<pre class="code c++">SetLampLitChangeCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asCallback<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds a callback for a Lamp entity, Type=“Lamp” in .ent, as it changes from on to off or vice versa.<br/>

asName The name of the lamp entity.<br/>

asCallback The name of the callback, syntax: <b>MyFunc(bool abActive)</b> <br/>

</p>
<pre class="code c++">SetLeverCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asType<span class="sy0">,</span> std<span class="sy0">::</span><span class="me2">string</span> asCallback<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds a callback for a Lever entity, Type=“Lever” in .ent, as it changes states.<br/>

asName The name of the lever entity.<br/>

asType What type: “Enter”, “Leave” or “During”.<br/>

asCallback The name of the callback, syntax: <b>void MyFunc(string asName, int alType, int alState)</b> <br/>

type: 0=enter, 1=leave, 2=during<br/>

state: -1 = min, 0=middle, 1=max<br/>

</p>
<pre class="code c++">SetWheelCallback<span class="br0">(</span>std<span class="sy0">::</span><span class="me2">string</span> asName<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asType<span class="sy0">,</span>std<span class="sy0">::</span><span class="me2">string</span> asCallback<span class="br0">)</span><span class="sy0">;</span>



</pre><p> </p>




<p>
Adds a callback for a Wheel entity, Type=“Wheel” in .ent.<br/>

asName The name of the wheel entity.<br/>

asType What type: “Enter”, “Leave” or “During”.<br/>

asCallback The name of the callback, syntax: <b>void MyFunc(string asName, int alType, int alState)</b> <br/>

type: 0=enter, 1=leave, 2=during<br/>

state: -1 = min, 0=middle, 1=max
</p>

</div>
Frictional Game Wiki

User Tools

Site Tools

Page Tools
