Frictional Game Wiki

<h1>Areas</h1> <div class="level1"> <p> Areas are oblong-shaped collision zones which can trigger callbacks when the player or other objects enter them; they are also often used as position markers for things spawned in code such as sounds or particle effects. </p> <p> HPL3 ships with several different area types - here's a quick summary of them and of some of their properties. </p> </div> <h2>Trigger</h2> <div class="level2"> <p> The most commonly used type of area, used for all sorts of purposes. </p> </div> <h3>Important Properties</h3> <div class="level3"> </div> <h4>BlocksLineOfSight</h4> <div class="level4"> <p> If true, this area acts as a blocker for AI seeing the player. </p> </div> <h4>CC_Entities, CC_Funcs</h4> <div class="level4"> <p> Collision callbacks - for example, if you set CC_Entities to <code>player</code> and CC_Funcs to <code>TriggerHitArea</code> then TriggerHitArea will be called in your map script whenever the player enters or leaves the area. </p> </div> <h4>PlayerLookAtCallback</h4> <div class="level4"> <p> Called when the player has the area on-screen. Various other properties in the same section modify exactly when that happens. </p> </div> <h4>PlayerInteractCallback</h4> <div class="level4"> <p> Makes the area interactable, and triggers this callback when the player interacts with it. You can also set <code>CustomInteractIcon</code> etc. </p> </div> <h2>AmbientLight</h2> <div class="level2"> <p> The player, by default, casts a small point light around him so that you can see things even when the room is very dark. This area type changes that ambient light to fit the current area. </p> </div> <h3>Important Properties</h3> <div class="level3"> </div> <h4>Type</h4> <div class="level4"> <p> Indoors / Outdoors / None </p> </div> <h2>CameraAnimation</h2> <div class="level2"> <p> Used as a camera viewpoint in a camera animation. See <a href="/doku.php?id=hpl3:game:scripting:user_modules:camera_animation" class="wikilink1" title="hpl3:game:scripting:user_modules:camera_animation">Camera Animation</a>. </p> </div> <h2>Climb</h2> <div class="level2"> <p> This area becomes interactable; when you interact, you will climb up to a specified foot position. It's used for things like climbing into vent shafts or climbing up on to a nearby table or something; for higher climbs, you probably want a camera animation or a ladder instead. </p> </div> <h3>Important Properties</h3> <div class="level3"> </div> <h4>FeetPosition</h4> <div class="level4"> <p> Name of an entity (usually a trigger area) specifying where the feet should land after the climb. </p> </div> <h4>Crouch</h4> <div class="level4"> <p> Specify if the player should be automatically crouched after the climb (useful for vent shafts). </p> </div> <h2>Crawl</h2> <div class="level2"> <p> The player will be crawling on their belly while in this area, and can't run or stand up. Useful for vent shafts. </p> </div> <h2>Datamine</h2> <div class="level2"> <p> The player can interact with this area as if it were a datamine prop - see <a href="/doku.php?id=hpl3:game:scripting:user_modules:datamine" class="wikilink1" title="hpl3:game:scripting:user_modules:datamine">Datamine</a> </p> </div> <h2>DatamineAudioSource, DatamineAnimNode</h2> <div class="level2"> <p> Currently unused. </p> </div> <h2>Description</h2> <div class="level2"> <p> Used with the <a href="/doku.php?id=hpl3:game:scripting:user_modules:description" class="wikilink1" title="hpl3:game:scripting:user_modules:description">Description</a> module. Not used in SOMA. </p> </div> <h2>Distortion</h2> <div class="level2"> <p> This area will apply a <a href="/doku.php?id=hpl3:game:scripting:user_modules:distortion_effects" class="wikilink1" title="hpl3:game:scripting:user_modules:distortion_effects">Distortion Effect</a> to the player while they are in it. </p> </div> <h2>DoorwayTrigger</h2> <div class="level2"> <p> This area is really useful for telling you when the player has walked into a particular part of the map. You set up a doorway with the Z-axis pointing in to the 'inside' and away from the 'outside'. Now when the player walks in through the door, the DoorwayCallback is called with an <code>alState</code> parameter of 1. When the player walks out through the door, the callback is called with an <code>alState</code> of -1. </p> <p> You can also link sets of doorways, which is a great way to figure out if the player is inside an irregular space. If you specify the <code>DoorwayGroup</code> property, then you can use the function <code>Doorway_PlayerIsInGroup</code> to check if the player has crossed into the space delimited by these doorways. (Essentially, if you cross any of the doorways going 'inwards' so <code>alState</code>==1, then you are in the group; crossing any going 'outwards' so <code>alState</code>==-1 means you are outside the group). </p> </div> <h3>Important Properties</h3> <div class="level3"> </div> <h4>DoorwayEntity</h4> <div class="level4"> <p> This acts just like CC_Entities on an area - it just specifies which entity to check for collisions with. This is usually <code>player</code>. </p> </div> <h4>DoorwayCallback</h4> <div class="level4"> <p> Called when the <code>DoorwayEntity</code> goes in or out of the doorway. </p> </div>