Frictional Game Wiki

<h2>Engine scripts</h2> <div class="level2"> <p> A list of script functions available in A Machine For Pigs (that are not present in The Dark Descent). Many of TDD's scripts are available in AMFP, but not all. Some are replaced by ones listed below, and others are removed. </p> <p> <span style = "color:#FF0000"><span style = "font-size:inherit"><span style = "font-family:inherit"><span style = "background-color:inherit">NOTE</span></span></span></span> : This page is partially incomplete. Some arguments for the functions listed here have unknown effects. If you wish to contribute, feel free to test them. </p> <hr /> </div> <h3>General</h3> <div class="level3"> <pre class="code c++"><span class="kw4">void</span> CheckPoint<span class="br0">(</span>string@<span class="sy0">&</span> asName<span class="sy0">,</span> string@<span class="sy0">&</span> asStartArea<span class="sy0">,</span> string@<span class="sy0">&</span> asFunction<span class="sy0">,</span> string@<span class="sy0">&</span> asTextCat<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry<span class="sy0">,</span> <span class="kw4">const</span> bool abPlayerLimbo<span class="br0">)</span> </pre><p> </p> <p> Creates a check point where the player will respawn if they die. <b>Callback syntax: </b><code>void MyFunc(string &in asName, int alCount)</code> <br/> This function replaces TDD's <code>CheckPoint</code>. </p> <ol> <li class="level1"> <em>asName</em> - The internal name of the callback</li> <li class="level1"> <em>asStartArea</em> - The name of the PlayerStartArea to respawn at</li> <li class="level1"> <em>asFunction</em> - The name of the callback function to run</li> <li class="level1"> <em>asTextCat</em> - The name of the .lang file category (SEEMS UNUSED)</li> <li class="level1"> <em>asTextEntry</em> - The name of the .lang file entry (SEEMS UNUSED)</li> <li class="level1"> <em>abPlayerLimbo</em> - Whether to put the player into a state of "limbo" upon death. In limbo, the death occurs normally, but once the screen fades to black, it remains so until <code>ReleasePlayerFromLimbo</code> is called. Player is still controllable during death.</li> </ol> <pre class="code c++"><span class="kw4">void</span> ReleasePlayerFromLimbo<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Respawns the player if stuck in "limbo". Limbo can be enabled with <code>CheckPoint</code>. Limbo is the state between life and death. The player enters limbo upon dying but won't respawn until this function is called. </p> <pre class="code c++"><span class="kw4">void</span> PlayScriptedAnimation<span class="br0">(</span>string@<span class="sy0">&</span> asEntity<span class="sy0">,</span> string@<span class="sy0">&</span> asAnimation<span class="sy0">,</span> <span class="kw4">const</span> bool abLoop<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Plays an animation that has been added to an entity through the Model Editor. Similar to <code>PlayEnemyAnimation</code>. </p> <ol> <li class="level1"> asEntity - Internal name of the entity</li> <li class="level1"> asAnimation - The animation name inside the entity</li> <li class="level1"> abLoop - Whether to loop the animation or play it only once</li> </ol> </div> <h3>Screen effects</h3> <div class="level3"> <pre class="code c++"><span class="kw4">void</span> ShowScreenImage<span class="br0">(</span>string@<span class="sy0">&</span> asImageFile<span class="sy0">,</span> <span class="kw4">int</span> alX<span class="sy0">,</span> <span class="kw4">int</span> alY<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afUnknown1<span class="sy0">,</span> <span class="kw4">const</span> bool abUnknown2<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afDuration<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afFadeInTime<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afFadeOutTime<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Shows a 2D image on the screen. Originally used for showing the intro logo during a sequence. </p> <ol> <li class="level1"> <em>asImageFile</em> - The image file to show. Does not have to be pow2 (although it gives a warning if not)</li> <li class="level1"> <em>alX -</em> The X position of the top left corner, starting from the center of the screen. Use negative half of the width of the image to center it.</li> <li class="level1"> <em>alY -</em> The Y position of the top left corner, starting from the center of the screen.</li> <li class="level1"> <em>afUnknown1</em> - Unsure what this is. Any value 0 or greater results in the image not showing up, so use -1</li> <li class="level1"> <em>abUnknown2</em> - Unsure what this is. If set to true, image does not display, so use false</li> <li class="level1"> <em>afDuration</em> - How long, in seconds, the image displays. This does not include fade times</li> <li class="level1"> <em>afFadeInTime</em> - How long, in seconds, the fade in spends</li> <li class="level1"> <em>afFadeOutTime</em> - How long, in seconds, the fade out spends</li> </ol> </div> <h3>Journal</h3> <div class="level3"> <pre class="code c++"><span class="kw4">void</span> AddHint<span class="br0">(</span>string<span class="sy0">&</span> asNameAndTextEntry<span class="sy0">,</span> string@<span class="sy0">&</span> asImage<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Adds a hint to the player's journal. <br/> This function replaces TDD's <code>AddDiary</code>. </p> <ol> <li class="level1"> <em>asNameAndTextEntry</em> - The .lang text entry of the hint. The entry must be in category "Journal" and begin with "Hint<u>ckgedit</u><u>> and end with _ckgedit</u><u></u><u>_QUOT</u>Name" for the title and end with "_Text" for the body.</li> <li class="level1"> <em>asImage</em> - This argument does not seem to be used. Presumed to be for displaying an image but possibly removed functionality. All existing occurrences are empty.</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetJournalDisabled<span class="br0">(</span><span class="kw4">const</span> bool abDisabled<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Disables the player's ability to open their journal. </p> <ol> <li class="level1"> <em>abDisabled</em> - True to disable, false to enable again</li> </ol> </div> <h3>Player</h3> <div class="level3"> <pre class="code c++"><span class="kw4">void</span> SetLanternFlickerActive<span class="br0">(</span><span class="kw4">const</span> bool abActive<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Enables/disables the flicker effect for the lantern's light. </p> <ol> <li class="level1"> <em>abActive</em> - True to flicker, false to not flicker</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetPlayerInfection<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">float</span> afAmount<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Sets the infection level for the player. Infection replaces sanity from TDD and acts similar, however it goes from 0-100 instead of 100-0. An infection level above approximately 20 will affect the player's ability to move. Infection level above 80 will kill the player. Infection slowly decreases over time, unless high enough. <br/> This function replaces TDD's <code>SetPlayerSanity</code>. </p> <ol> <li class="level1"> <em>afAmount</em> - The level of infection to set</li> </ol> <pre class="code c++"><span class="kw4">void</span> AddPlayerInfection<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">float</span> afAmount<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Adds an amount of infection to the player's current amount. <br/> This function replaces TDD's <code>AddPlayerSanity</code>. </p> <ol> <li class="level1"> afAmount - The amount to add</li> </ol> <pre class="code c00">float GetPlayerInfection(); </pre><p> </p> <p> Returns the amount of infection the player currently has. <br/> This function replaces TDD's <code>GetPlayerSanity</code>. </p> <pre class="code c++"><span class="kw4">void</span> FadePlayerPitchTo<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">float</span> afPitch<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afDeaccelleration<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afSpeed<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Moves the player's pitch (up and down rotation). </p> <ol> <li class="level1"> <em>afPitch</em> - The target pitch to move towards. 0 = straight forward. Clamped to range: -70 to +70.</li> <li class="level1"> <em>afDeaccelleration</em> - The deaccelleration when nearing the target pitch. A low value makes a slow change.</li> <li class="level1"> <em>afSpeed</em> - The speed of the movement. Speed is affected by deaccelleration.</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetPlayerUsesDragFootsteps<span class="br0">(</span><span class="kw4">const</span> bool abX<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Sets whether the player's footstep sounds are replaced with "drag" versions. Some surface materials do not have drag steps, and will therefore play no footstep sounds. </p> <ol> <li class="level1"> abX - Whether to use "drag" step sounds</li> </ol> </div> <h3>Entities</h3> <div class="level3"> <pre class="code c++"><span class="kw4">void</span> SetPhysicsAutoDisable<span class="br0">(</span>string@<span class="sy0">&</span> asEntity<span class="sy0">,</span> <span class="kw4">const</span> bool abDisabled<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Does… something. Not immediately apparent. Is only used on chandeliers in the campaign. </p> <ol> <li class="level1"> <em>asEntity</em> - The entity to affect</li> <li class="level1"> <em>abDisabled</em> - Whether this effect auto disables or not</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetLampFlickerActive<span class="br0">(</span>string@<span class="sy0">&</span> asLamp<span class="sy0">,</span> <span class="kw4">const</span> bool abActive<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Enables a flickering effect on a Lamp-type entity. </p> <ol> <li class="level1"> <em>asLamp</em> - The lamp entity</li> <li class="level1"> <em>abActive</em> - Whether to enable flicker</li> </ol> <pre class="code c++"><span class="kw4">void</span> StartPhoneRinging<span class="br0">(</span>string@<span class="sy0">&</span> asEntity<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Enables a PhoneBox-type entity to start ringing. A ringing phone box can be interacted with to play some audio files. After interacting, the phone will stop ringing. </p> <ol> <li class="level1"> <em>asEntity</em> - The PhoneBox entity</li> </ol> <pre class="code c++"><span class="kw4">void</span> StopPhoneRinging<span class="br0">(</span>string@<span class="sy0">&</span> asEntity<span class="br0">)</span> </pre><p> </p> <p> Stops a ringing PhoneBox-type entity. </p> <ol> <li class="level1"> <em>asEntity</em> - The PhoneBox entity</li> </ol> <pre class="code c++">bool GetEntityActive<span class="br0">(</span>string@<span class="sy0">&</span> asEntity<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Returns whether an entity in the level is active or not. </p> <ol> <li class="level1"> <em>asEntity</em> - The entity to check</li> </ol> <pre class="code c++"><span class="kw4">void</span> StopPropAnimation<span class="br0">(</span>string@<span class="sy0">&</span> asProp<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Stops the animation currently playing on a prop. Animations can be started with <code>PlayPropAnimation</code>. </p> <ol> <li class="level1"> <em>asProp</em> - The name of the entity/prop</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetPropAnimationPosition<span class="br0">(</span>string@<span class="sy0">&</span> asProp<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afPosition<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Jumps to a specifc point in an animation. Generally used in conjunction with <code>PlayPropAnimation</code>. </p> <ol> <li class="level1"> <em>asProp</em> - The entity that is being animated</li> <li class="level1"> <em>afPosition</em> - The time within the animation, in seconds, to jump to</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetSwingDoorOpenAmount<span class="br0">(</span>string@<span class="sy0">&</span> asEntity<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afOpenAmount<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afTime<span class="sy0">,</span> <span class="kw4">const</span> bool abUnknown<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Sets the open amount for a swing door. </p> <ol> <li class="level1"> <em>asEntity</em> - The SwingDoor entity</li> <li class="level1"> <em>afOpenAmount</em> - The new amount state to set. Range: 0 - 1</li> <li class="level1"> <em>afTime</em> - The time in seconds until the door has changed state</li> <li class="level1"> <em>abUnknown</em> - Unsure what this does. If set to true, nothing happens (?), so use false.</li> </ol> <pre class="code c++"><span class="kw4">void</span> FadeLampTo<span class="br0">(</span>string@<span class="sy0">&</span> asEntity<span class="sy0">,</span> <span class="kw4">const</span> uint alR<span class="sy0">,</span> <span class="kw4">const</span> uint alG<span class="sy0">,</span> <span class="kw4">const</span> uint alB<span class="sy0">,</span> <span class="kw4">const</span> uint alA<span class="sy0">,</span> <span class="kw4">int</span> alRadius<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">double</span> afTime<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Fades a Lamp-type entity's light to another color. This function uses integers for color values instead of floats, which is a little odd. Likewise, it uses a double floating point for the last argument instead of a regular one. </p> <ol> <li class="level1"> <em>asEntity</em> - The lamp to change</li> <li class="level1"> <em>alR</em> - Red value (appropriate values are 0 - 10)</li> <li class="level1"> <em>alG</em> - Green value (appropriate values are 0 - 10)</li> <li class="level1"> <em>alB</em> - Blue value (appropriate values are 0 - 10)</li> <li class="level1"> <em>alA</em> - Alpha value (has no effect?)</li> <li class="level1"> <em>alRadius</em> - The new radius to use (affects illumination strength)</li> <li class="level1"> <em>afTime</em> - Time in seconds until the light properties have changed</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetButtonCanBeSwitchedOn<span class="br0">(</span>string@<span class="sy0">&</span> asEntity<span class="sy0">,</span> <span class="kw4">const</span> bool abX<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Changes whether a Button-type entity can be toggled. </p> <ol> <li class="level1"> <em>asEntity</em> - The button entity</li> <li class="level1"> <em>abX</em> - Whether it can be switched on</li> </ol> <pre class="code c++"><span class="kw4">void</span> CreateEntityAtArea<span class="br0">(</span>string@<span class="sy0">&</span> asName<span class="sy0">,</span> string@<span class="sy0">&</span> asFile<span class="sy0">,</span> string@<span class="sy0">&</span> asArea<span class="sy0">,</span> <span class="kw4">const</span> bool abUnknown<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afOffsetX<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afOffsetY<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afOffsetZ<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afRotX<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afRotY<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afRotZ<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Creates an entity at an area with the specified offsets and rotation. <br/> This function replaces TDD's <code>CreateEntityAtArea</code>. </p> <ol> <li class="level1"> <em>asName</em> - The internal name of the created entity</li> <li class="level1"> <em>asFile</em> - The file for the entity (extension .ent)</li> <li class="level1"> <em>asArea</em> - The area to create entity at</li> <li class="level1"> <em>abUnknown</em> - Not sure. Only true is used in the campaign. Seemingly has no effect</li> <li class="level1"> <em>afOffsetX</em> - The offset along the X axis in units</li> <li class="level1"> <em>afOffsetY</em> - The offset along the Y axis in units</li> <li class="level1"> <em>afOffsetZ</em> - The offset along the Z axis in units</li> <li class="level1"> <em>afRotX</em> - The rotation on the X axis in degrees</li> <li class="level1"> <em>afRotY</em> - The rotation on the Y axis in degrees</li> <li class="level1"> <em>afRotZ</em> - The rotation on the Z axis in degrees</li> </ol> <pre class="code c++"><span class="kw4">void</span> AttachPropToBone<span class="br0">(</span>string@<span class="sy0">&</span> asProp<span class="sy0">,</span> string@<span class="sy0">&</span> asEntity<span class="sy0">,</span> string@<span class="sy0">&</span> asBone<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afOffsetX<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afOffsetY<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afOffsetZ<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afRotX<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afRotY<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afRotZ<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Attaches a prop to a specific bone within another entity. You can inspect bones in the Model Editor. Note: Offsets and rotations are local to the bone and relative to its rotation. </p> <ol> <li class="level1"> <em>asProp</em> - The prop to attach</li> <li class="level1"> <em>asEntity</em> - The entity that holds the bone to attach to</li> <li class="level1"> <em>asBone</em> - The bone within the entity to attach to</li> <li class="level1"> <em>afOffsetX</em> - Offset along the X axis</li> <li class="level1"> <em>afOffsetY</em> - Offset along the Y axis</li> <li class="level1"> <em>afOffsetZ</em> - Offset along the Z axis</li> <li class="level1"> <em>afRotX</em> - Rotation along the X axis</li> <li class="level1"> <em>afRotY</em> - Rotation along the Y axis</li> <li class="level1"> <em>afRotZ</em> - Rotation along the Z axis</li> </ol> <pre class="code c++"><span class="kw4">void</span> DetachPropFromBone<span class="br0">(</span>string@<span class="sy0">&</span> asProp<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Detaches an attached prop. Note: When detached, physics are not automatically enabled on the prop. </p> <ol> <li class="level1"> <em>asProp</em> - The attached prop</li> </ol> </div> <h3>Sounds</h3> <div class="level3"> <pre class="code c++"><span class="kw4">void</span> AddEffectVoice2<span class="br0">(</span>string@<span class="sy0">&</span> asVoiceFile<span class="sy0">,</span> string@<span class="sy0">&</span> asEffectFile<span class="sy0">,</span> string@<span class="sy0">&</span> asTextCat<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry1<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime1<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry2<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime2<span class="sy0">,</span> <span class="kw4">const</span> bool abUsePosition<span class="sy0">,</span> string@<span class="sy0">&</span> asPosEntity<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMinDistance<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMaxDistance<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Plays an audio file with 2 consecutive subtitles. </p> <ol> <li class="level1"> <em>asVoiceFile</em> - The entire voice file to play (intended to include 2 sections)</li> <li class="level1"> <em>asEffectFile</em> - The background effect file to play during voices. Leave empty for no extra effect</li> <li class="level1"> <em>asTextCat</em> - The .lang text category for the subtitles</li> <li class="level1"> <em>asTextEntry1</em> - The first .lang subtitle entry</li> <li class="level1"> <em>afStartTime1</em> - The time to wait until the first subtitle starts</li> <li class="level1"> <em>asTextEntry2</em> - The second .lang subtitle entry</li> <li class="level1"> <em>afStartTime2</em> - The time to wait until the second subtitle starts</li> <li class="level1"> <em>abUsePosition</em> - Whether to use 3D to play the sound from an entity</li> <li class="level1"> <em>asPosEntity</em> - The entity to play the sound from. If empty, plays from player</li> <li class="level1"> <em>afMinDistance</em> - The minimum distance required between the player and the entity in order to hear the audio</li> <li class="level1"> <em>afMaxDistance</em> - The maximum distance allowed between the player and the entity in order to hear the audio</li> </ol> <pre class="code c++"><span class="kw4">void</span> AddEffectVoice3<span class="br0">(</span>string@<span class="sy0">&</span> asVoiceFile<span class="sy0">,</span> string@<span class="sy0">&</span> asEffectFile<span class="sy0">,</span> string@<span class="sy0">&</span> asTextCat<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry1<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime1<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry2<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime2<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry3<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime3<span class="sy0">,</span> <span class="kw4">const</span> bool abUsePosition<span class="sy0">,</span> string@<span class="sy0">&</span> asPosEntity<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMinDistance<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMaxDistance<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Plays an audio file with 3 consecutive subtitles. </p> <ol> <li class="level1"> <em>asVoiceFile</em> - The entire voice file to play (intended to include 3 sections)</li> <li class="level1"> <em>asEffectFile</em> - The background effect file to play during voices. Leave empty for no extra effect</li> <li class="level1"> <em>asTextCat</em> - The .lang text category for the subtitles</li> <li class="level1"> <em>asTextEntry1</em> - The first .lang subtitle entry</li> <li class="level1"> <em>afStartTime1</em> - The time to wait until the first subtitle starts</li> <li class="level1"> <em>asTextEntry2</em> - The second .lang subtitle entry</li> <li class="level1"> <em>afStartTime2</em> - The time to wait until the second subtitle starts</li> <li class="level1"> <em>asTextEntry3</em> - The third .lang subtitle entry</li> <li class="level1"> <em>afStartTime3</em> - The time to wait until the third subtitle starts</li> <li class="level1"> <em>abUsePosition</em> - Whether to use 3D to play the sound from an entity</li> <li class="level1"> <em>asPosEntity</em> - The entity to play the sound from. If empty, plays from player</li> <li class="level1"> <em>afMinDistance</em> - The minimum distance required between the player and the entity in order to hear the audio</li> <li class="level1"> <em>afMaxDistance</em> - The maximum distance allowed between the player and the entity in order to hear the audio</li> </ol> <pre class="code c++"><span class="kw4">void</span> AddEffectVoice4<span class="br0">(</span>string@<span class="sy0">&</span> asVoiceFile<span class="sy0">,</span> string@<span class="sy0">&</span> asEffectFile<span class="sy0">,</span> string@<span class="sy0">&</span> asTextCat<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry1<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime1<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry2<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime2<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry3<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime3<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry4<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime4<span class="sy0">,</span> <span class="kw4">const</span> bool abUsePosition<span class="sy0">,</span> string@<span class="sy0">&</span> asPosEntity<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMinDistance<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMaxDistance<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Plays an audio file with 4 consecutive subtitles. </p> <ol> <li class="level1"> <em>asVoiceFile</em> - The entire voice file to play (intended to include 4 sections)</li> <li class="level1"> <em>asEffectFile</em> - The background effect file to play during voices. Leave empty for no extra effect</li> <li class="level1"> <em>asTextCat</em> - The .lang text category for the subtitles</li> <li class="level1"> <em>asTextEntry1</em> - The first .lang subtitle entry</li> <li class="level1"> <em>afStartTime1</em> - The time to wait until the first subtitle starts</li> <li class="level1"> <em>asTextEntry2</em> - The second .lang subtitle entry</li> <li class="level1"> <em>afStartTime2</em> - The time to wait until the second subtitle starts</li> <li class="level1"> <em>asTextEntry3</em> - The third .lang subtitle entry</li> <li class="level1"> <em>afStartTime3</em> - The time to wait until the third subtitle starts</li> <li class="level1"> <em>asTextEntry4</em> - The fourth .lang subtitle entry</li> <li class="level1"> <em>afStartTime4</em> - The time to wait until the fourth subtitle starts</li> <li class="level1"> <em>abUsePosition</em> - Whether to use 3D to play the sound from an entity</li> <li class="level1"> <em>asPosEntity</em> - The entity to play the sound from. If empty, plays from player</li> <li class="level1"> <em>afMinDistance</em> - The minimum distance required between the player and the entity in order to hear the audio</li> <li class="level1"> <em>afMaxDistance</em> - The maximum distance allowed between the player and the entity in order to hear the audio</li> </ol> <pre class="code c++"><span class="kw4">void</span> AddEffectVoice5<span class="br0">(</span>string@<span class="sy0">&</span> asVoiceFile<span class="sy0">,</span> string@<span class="sy0">&</span> asEffectFile<span class="sy0">,</span> string@<span class="sy0">&</span> asTextCat<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry1<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime1<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry2<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime2<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry3<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime3<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry4<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime4<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry5<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime5<span class="sy0">,</span> <span class="kw4">const</span> bool abUsePosition<span class="sy0">,</span> string@<span class="sy0">&</span> asPosEntity<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMinDistance<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMaxDistance<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Plays an audio file with 5 consecutive subtitles. </p> <ol> <li class="level1"> <em>asVoiceFile</em> - The entire voice file to play (intended to include 5 sections)</li> <li class="level1"> <em>asEffectFile</em> - The background effect file to play during voices. Leave empty for no extra effect</li> <li class="level1"> <em>asTextCat</em> - The .lang text category for the subtitles</li> <li class="level1"> <em>asTextEntry1</em> - The first .lang subtitle entry</li> <li class="level1"> <em>afStartTime1</em> - The time to wait until the first subtitle starts</li> <li class="level1"> <em>asTextEntry2</em> - The second .lang subtitle entry</li> <li class="level1"> <em>afStartTime2</em> - The time to wait until the second subtitle starts</li> <li class="level1"> <em>asTextEntry3</em> - The third .lang subtitle entry</li> <li class="level1"> <em>afStartTime3</em> - The time to wait until the third subtitle starts</li> <li class="level1"> <em>asTextEntry4</em> - The fourth .lang subtitle entry</li> <li class="level1"> <em>afStartTime4</em> - The time to wait until the fourth subtitle starts</li> <li class="level1"> <em>asTextEntry5</em> - The fifth .lang subtitle entry</li> <li class="level1"> <em>afStartTime5</em> - The time to wait until the fifth subtitle starts</li> <li class="level1"> <em>abUsePosition</em> - Whether to use 3D to play the sound from an entity</li> <li class="level1"> <em>asPosEntity</em> - The entity to play the sound from. If empty, plays from player</li> <li class="level1"> <em>afMinDistance</em> - The minimum distance required between the player and the entity in order to hear the audio</li> <li class="level1"> <em>afMaxDistance</em> - The maximum distance allowed between the player and the entity in order to hear the audio</li> </ol> <pre class="code c++"><span class="kw4">void</span> AddEffectVoice6<span class="br0">(</span>string@<span class="sy0">&</span> asVoiceFile<span class="sy0">,</span> string@<span class="sy0">&</span> asEffectFile<span class="sy0">,</span> string@<span class="sy0">&</span> asTextCat<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry1<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime1<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry2<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime2<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry3<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime3<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry4<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime4<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry5<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime5<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry6<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime6<span class="sy0">,</span> <span class="kw4">const</span> bool abUsePosition<span class="sy0">,</span> string@<span class="sy0">&</span> asPosEntity<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMinDistance<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMaxDistance<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Plays an audio file with 6 consecutive subtitles. </p> <ol> <li class="level1"> <em>asVoiceFile</em> - The entire voice file to play (intended to include 6 sections)</li> <li class="level1"> <em>asEffectFile</em> - The background effect file to play during voices. Leave empty for no extra effect</li> <li class="level1"> <em>asTextCat</em> - The .lang text category for the subtitles</li> <li class="level1"> <em>asTextEntry1</em> - The first .lang subtitle entry</li> <li class="level1"> <em>afStartTime1</em> - The time to wait until the first subtitle starts</li> <li class="level1"> <em>asTextEntry2</em> - The second .lang subtitle entry</li> <li class="level1"> <em>afStartTime2</em> - The time to wait until the second subtitle starts</li> <li class="level1"> <em>asTextEntry3</em> - The third .lang subtitle entry</li> <li class="level1"> <em>afStartTime3</em> - The time to wait until the third subtitle starts</li> <li class="level1"> <em>asTextEntry4</em> - The fourth .lang subtitle entry</li> <li class="level1"> <em>afStartTime4</em> - The time to wait until the fourth subtitle starts</li> <li class="level1"> <em>asTextEntry5</em> - The fifth .lang subtitle entry</li> <li class="level1"> <em>afStartTime5</em> - The time to wait until the fifth subtitle starts</li> <li class="level1"> <em>asTextEntry6</em> - The sixth .lang subtitle entry</li> <li class="level1"> <em>afStartTime6</em> - The time to wait until the sixth subtitle starts</li> <li class="level1"> <em>abUsePosition</em> - Whether to use 3D to play the sound from an entity</li> <li class="level1"> <em>asPosEntity</em> - The entity to play the sound from. If empty, plays from player</li> <li class="level1"> <em>afMinDistance</em> - The minimum distance required between the player and the entity in order to hear the audio</li> <li class="level1"> <em>afMaxDistance</em> - The maximum distance allowed between the player and the entity in order to hear the audio</li> </ol> <pre class="code c++"><span class="kw4">void</span> AddEffectVoice7<span class="br0">(</span>string@<span class="sy0">&</span> asVoiceFile<span class="sy0">,</span> string@<span class="sy0">&</span> asEffectFile<span class="sy0">,</span> string@<span class="sy0">&</span> asTextCat<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry1<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime1<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry2<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime2<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry3<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime3<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry4<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime4<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry5<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime5<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry6<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime6<span class="sy0">,</span> string@<span class="sy0">&</span> asTextEntry7<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afStartTime7<span class="sy0">,</span> <span class="kw4">const</span> bool abUsePosition<span class="sy0">,</span> string@<span class="sy0">&</span> asPosEntity<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMinDistance<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afMaxDistance<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Plays an audio file with 7 consecutive subtitles. </p> <ol> <li class="level1"> <em>asVoiceFile</em> - The entire voice file to play (intended to include 7 sections)</li> <li class="level1"> <em>asEffectFile</em> - The background effect file to play during voices. Leave empty for no extra effect</li> <li class="level1"> <em>asTextCat</em> - The .lang text category for the subtitles</li> <li class="level1"> <em>asTextEntry1</em> - The first .lang subtitle entry</li> <li class="level1"> <em>afStartTime1</em> - The time to wait until the first subtitle starts</li> <li class="level1"> <em>asTextEntry2</em> - The second .lang subtitle entry</li> <li class="level1"> <em>afStartTime2</em> - The time to wait until the second subtitle starts</li> <li class="level1"> <em>asTextEntry3</em> - The third .lang subtitle entry</li> <li class="level1"> <em>afStartTime3</em> - The time to wait until the third subtitle starts</li> <li class="level1"> <em>asTextEntry4</em> - The fourth .lang subtitle entry</li> <li class="level1"> <em>afStartTime4</em> - The time to wait until the fourth subtitle starts</li> <li class="level1"> <em>asTextEntry5</em> - The fifth .lang subtitle entry</li> <li class="level1"> <em>afStartTime5</em> - The time to wait until the fifth subtitle starts</li> <li class="level1"> <em>asTextEntry6</em> - The sixth .lang subtitle entry</li> <li class="level1"> <em>afStartTime6</em> - The time to wait until the sixth subtitle starts</li> <li class="level1"> <em>asTextEntry7</em> - The seventh .lang subtitle entry</li> <li class="level1"> <em>afStartTime7 </em>- The time to wait until the seventh subtitle starts</li> <li class="level1"> <em>abUsePosition</em> - Whether to use 3D to play the sound from an entity</li> <li class="level1"> <em>asPosEntity</em> - The entity to play the sound from. If empty, plays from player</li> <li class="level1"> <em>afMinDistance</em> - The minimum distance required between the player and the entity in order to hear the audio</li> <li class="level1"> <em>afMaxDistance</em> - The maximum distance allowed between the player and the entity in order to hear the audio</li> </ol> </div> <h3>Enemies</h3> <div class="level3"> <pre class="code c++"><span class="kw4">void</span> AddEnemyPatrolNode<span class="br0">(</span>string@<span class="sy0">&</span> asEnemy<span class="sy0">,</span> string@<span class="sy0">&</span> asPathNode<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afWaitTime<span class="sy0">,</span> string@<span class="sy0">&</span> asAnimation<span class="sy0">,</span> <span class="kw4">const</span> bool abUnknown<span class="br0">)</span> </pre><p> </p> <p> Adds a patrol node to the enemy's walking path. A path is restarted from the beginning when the final node is reached. Note: Inputting an invalid animation in asAnimation at the final node will make the enemy wait there indefinitely. <br/> This function replaces TDD's AddEnemyPatrolNode. </p> <ol> <li class="level1"> <em>asEnemy</em> - The name of the enemy</li> <li class="level1"> <em>asPathNode</em> - Internal name of path node</li> <li class="level1"> <em>afWaitTime</em> - The time, in seconds, the enemy waits at this node before continuing. Note: A time of 0.0f does not seem to skip waiting, use 0.01f instead if you want the enemy to immediately continue to the next node.</li> <li class="level1"> <em>asAnimation</em> - The animation to play on the enemy when they arrive at this path node. Animations can be found in the Model Editor. Leave empty to play no special animation (uses default Idle animation). Note: If the animation lasts longer than afWaitTime, the enemy waits until the animation is complete before continuing the path.</li> <li class="level1"> <em>abUnknown</em> - Unknown variable. Only false is ever used in the campaign. If set to true, seems to affect how animations are played, however they seem to just stutter or loop.</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetEnemyMoveType<span class="br0">(</span>string@<span class="sy0">&</span> asEnemy<span class="sy0">,</span> string@<span class="sy0">&</span> asMoveType<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Changes how an enemy moves. </p> <ol> <li class="level1"> <em>asEnemy</em> - The name of the enemy</li> <li class="level1"> <em>asMoveType</em> - The type to change to. Type can be "WalkBiped", "RunBiped", "ChargeBiped", "Idle"</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetManPigType<span class="br0">(</span>string@<span class="sy0">&</span> asEnemy<span class="sy0">,</span> string@<span class="sy0">&</span> asType<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Sets the type for a ManPig enemy. It is unknown whether this function does anything or if it's just left over from an earlier state of the game. Only "Freddy" is used as the type, but supposedly it should also accept "Rod" and "Jane". </p> <ol> <li class="level1"> <em>asEnemy</em> - The ManPig enemy.</li> <li class="level1"> <em>asType</em> - The type to set. Type can be "Freddy", "Rod", "Jane"</li> </ol> <p> The three types allegedly describe three different personality types for the AI, according to Peter Howell in <a href="https://researchportal.port.ac.uk/portal/files/3364888/PeterHowell_PhD.pdf" class="urlextern" title="https://researchportal.port.ac.uk/portal/files/3364888/PeterHowell_PhD.pdf" rel="nofollow">his PhD, section 7.4.4</a>. </p> <p> Extract: </p> <p> <em>The initial design of the game’s enemy artificial intelligence system contained three unique sets of behavioural controls. There was only one visual enemy style, however every enemy agent in the game would be assigned one of three possible ‘personalities’, referred to in the game’s code as the ‘Rod’, ‘Jane’ and ‘Freddy’ personality types. These personalities each had a different set of behavioural rules, thus allowing enemy agents that may otherwise appear identical to behave very differently to one another.</em> </p> <span class='np_break'> </span> <div class="table"><table class="inline"> <thead> <tr class="row0"> <th class="col0">Enemy Agent Personality Type </th><th class="col1">Primary Behavioural Traits </th> </tr> </thead> <tr class="row1"> <td class="col0">Rod </td><td class="col1">– Will maintain a 'safe' distance to the player-character. <br/> – unable to do so, will approach player character, investigate them (by getting close and smelling them), before continuing its patrol. </td> </tr> <tr class="row2"> <td class="col0">Jane </td><td class="col1">– Will maintain a ‘safe’ distance from player-character, whilst observing the player-character’s movements. <br/> – If unable to maintain ‘safe’ distance, will panic and flee. <br/> – If cornered and unable to flee, will attack and knock player-character to floor, then flee. <br/> – Will only attack and kill player-character as a last resort. </td> </tr> <tr class="row3"> <td class="col0">Freddy </td><td class="col1">– Will actively hunt the player-character. <br/> – Will attack and kill them if given the opportunity. </td> </tr> </table> <span class='np_break'> </span> </div><pre class="code c++"><span class="kw4">void</span> PlayEnemyAnimation<span class="br0">(</span>string@<span class="sy0">&</span> asEnemy<span class="sy0">,</span> string@<span class="sy0">&</span> asAnimation<span class="sy0">,</span> <span class="kw4">const</span> bool abLoop<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">float</span> afDelay<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Plays a specific animation for an enemy. </p> <ol> <li class="level1"> <em>asEnemy</em> - Internal name of the enemy (asterisk is allowed)</li> <li class="level1"> <em>asAnimation</em> - The name of an animation registered to the enemy</li> <li class="level1"> <em>abLoop</em> - Whether the animation loops</li> <li class="level1"> <em>afDelay</em> - Seems to affect how the animation plays out. A higher value makes the animation slower, although it seems to also skip some keyframes or perhaps merge them, making the animation look incorrect. Experiment to see what works based on the animation.</li> </ol> <pre class="code c++"><span class="kw4">void</span> ChangeEnemyPose<span class="br0">(</span>string@<span class="sy0">&</span> asEnemy<span class="sy0">,</span> string@<span class="sy0">&</span> asPose<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Changes the pose for an enemy. Can be either "Biped" or "Quadruped". </p> <ol> <li class="level1"> <em>asEnemy</em> - Internal name of the enemy</li> <li class="level1"> <em>asPose</em> - The pose to change to</li> </ol> <pre class="code c++"><span class="kw4">void</span> ForceEnemyWaitState<span class="br0">(</span>string@<span class="sy0">&</span> asEnemy<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Forces the enemy's AI to change the state to "Wait" which makes the enemy wait for a short while before continuing its' normal actions. An enemy without patrol nodes defaults to the "Wait" state. Otherwise, if patrol nodes are added, the enemy will continue the path after waiting is done. </p> <ol> <li class="level1"> <em>asEnemy</em> - Internal name of the enemy</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetEnemyBlind<span class="br0">(</span>string@<span class="sy0">&</span> asEnemy<span class="sy0">,</span> <span class="kw4">const</span> bool abX<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Sets whether the enemy can see the player if they are within visible range. </p> <ol> <li class="level1"> <em>asEnemy</em> - Internal name of the enemy</li> <li class="level1"> <em>abX</em> - Whether enemy is blind</li> </ol> <pre class="code c++"><span class="kw4">void</span> SetEnemyDeaf<span class="br0">(</span>string@<span class="sy0">&</span> asEnemy<span class="sy0">,</span> <span class="kw4">const</span> bool abX<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Sets whether the enemy can hear the player make sound if they are within audible range. </p> <ol> <li class="level1"> <em>asEnemy</em> - Internal name of the enemy</li> <li class="level1"> <em>abX</em> - Whether enemy is deaf</li> </ol> <pre class="code c++">bool GetPlayerCanSeeEnemy<span class="br0">(</span>string@<span class="sy0">&</span> asEnemy<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Returns whether the enemy is within visible range of the player. </p> <ol> <li class="level1"> <em>asEnemy</em> - Internal name of the enemy</li> </ol> <pre class="code c++"><span class="kw4">float</span> GetEnemyPlayerDistance<span class="br0">(</span>string@<span class="sy0">&</span> asEnemy<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Returns the distance (in HPL units) between the enemy and the player. </p> <ol> <li class="level1"> asEnemy - Internal name of the enemy</li> </ol> </div> <h3>Particles</h3> <div class="level3"> <pre class="code c++"><span class="kw4">void</span> SetParticleSystemActive<span class="br0">(</span>string@<span class="sy0">&</span> asParticleSystem<span class="sy0">,</span> <span class="kw4">const</span> bool abActive<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Pauses a particle system in its current frame. The paused particle system remains frozen at this frame until reactivated or destroyed. </p> <ol> <li class="level1"> <em>asParticleSystem</em> - The name of the particle system</li> <li class="level1"> <em>abActive</em> - False to pause, true to unpause</li> </ol> <pre class="code c++"><span class="kw4">void</span> DestroyParticleSystemInstantly<span class="br0">(</span>string@<span class="sy0">&</span> asParticleSystem<span class="br0">)</span><span class="sy0">;</span> </pre><p> </p> <p> Destroys a particle system and any existing particles already emitted from it. Similar to <code>DestroyParticleSystem</code>, except that one will not destroy the existing particles and rather let them live out their lives. This function will cut all particles' lives short. </p> <ol> <li class="level1"> <em>asParticleSystem</em> - The PS to destroy</li> </ol> <p> <br/> </p> </div>