Frictional Game Wiki

<h1>Entities</h1> <div class="level1"> <p> Work in progress page. </p> <p> &lt;nowiki>&#42;&lt;/nowiki>&lt;nowiki>&#42;&lt;/nowiki>Please add more information about missing subjects&lt;nowiki>&#42;&lt;/nowiki>&lt;nowiki>&#42;&lt;/nowiki> </p> <p> This page talks about the different types of entities found within the HPL2 engine. The type determines how the entity will be set up, what kind it is, what it does under different circumstances etc. Using the Model Editor you can identify and specify which type an entity has. In the Level Editor, the different types have different settings applicable for them. For instance a MoveObject type will have the OffsetArea box available in the Level Editor, and an Item (Note) type will have a NoteText box available. </p> <p> Here's a list of all the available entity types and their subtypes: </p> <ul> <li class="level1"> StaticProp</li> <li class="level2"> CommentaryIcon</li> <li class="level2 node"> Object<ul> <li class="level3"> Static</li> <li class="level3"> Grab</li> <li class="level3"> Push</li> <li class="level3"> Slide</li> </ul> </li> <li class="level2"> SwingDoor</li> <li class="level2"> Lever</li> <li class="level2"> Wheel</li> <li class="level2"> MultiSlider</li> <li class="level2"> Lamp</li> <li class="level2"> Button</li> <li class="level2"> Photocell</li> <li class="level2"> MoveObject</li> <li class="level2 node"> Item<ul> <li class="level3"> Puzzle</li> <li class="level3"> Coins</li> <li class="level3"> Note</li> <li class="level3"> Diary</li> <li class="level3"> Lantern</li> <li class="level3"> Health</li> <li class="level3"> Sanity</li> <li class="level3"> LampOil</li> <li class="level3"> Tinderbox</li> <li class="level3"> HandObject</li> </ul> </li> <li class="level2"> Chest</li> <li class="level2"> OilBarrel</li> <li class="level2"> EmotionStone</li> <li class="level2"> NPC</li> <li class="level2"> LevelDoor</li> <li class="level2"> CritterBug</li> <li class="level2"> Enemy_Grunt</li> <li class="level2"> Enemy_Waterlurker</li> <li class="level2"> PlayerHands</li> <li class="level2"> HandObject</li> </ul> </div> <h3>StaticProp</h3> <div class="level3"> <p> A StaticProp entity resembles a static object. They have no available type properties, but they can still use a collision box and have mass/gravity. Note that they cannot be interacted with in the game, and cannot be disabled. If you need this feature, use Object (Static) instead. </p> </div> <h3>CommentaryIcon</h3> <div class="level3"> <p> A CommentaryIcon entity is simply an object that can execute commentary sound files, as it was done in the main game. These only appear if the player has "Commentary" enabled in their settings. </p> </div> <h3>Object</h3> <div class="level3"> </div> <h4>Static</h4> <div class="level4"> <p> Not to be confused with an actual static object, the Object type is a general object with common properties. The static subtype simply disables any additional properties from the other subtypes. An Object (Static) is similar in concept to a StaticProp type entity, however the Object (Static) can be disabled in the game and interacted with by the player. </p> </div> <h4>Grab</h4> <div class="level4"> <p> A Grab subtype is a normal Object entity with the ability to be grabbed by the player in the game. In order for this to work, the object must have a mass above 0. </p> </div> <h4>Push</h4> <div class="level4"> <p> Similar to the Grab subtype, the Push subtype allows the player to push the object by taking hold of it and walking or right clicking. Example of this is the prison bed. </p> </div> <h4>Slide</h4> <div class="level4"> <p> A Slide Object is similar to the Grab subtype, except it can only be slid in a single direction for a certain amount. An existing entity that uses this is the secret floor carpet you can slide to the side. </p> </div> <h3>SwingDoor</h3> <div class="level3"> <p> A SwingDoor entity is just that; a swing door. Any door you can grab and swing open is considered a SwingDoor. The other option would be LevelDoor, which goes under its own category. To use a SwingDoor, you need to attach joints to where you want the door to swing around. These are usually place by the hinges of the door. On the joint you can set the min and max values to limit how much the door can be opened. These are usually approximately 90 degrees apart in either positive or negative directions. </p> </div> <h3>Lever</h3> <div class="level3"> <p> A Lever entity is an entity that can be swung between states to trigger callbacks. A lever requires a joint to swing around. </p> </div> <h3>Wheel</h3> <div class="level3"> <p> A Wheel entity is a wheel that can be turned. They use states like the levers. Some wheels can be turned unlimited and some (mostly valves) can be turned for a fixed amount in order to trigger an event. Wheels require a joint. </p> </div> <h3>MultiSlider</h3> <div class="level3"> <p> Add info. </p> </div> <h3>Lamp</h3> <div class="level3"> <p> A Lamp entity is a light source. If they are unlit, they can be lit by the player, consuming a tinderbox. Examples are torches and candles. </p> </div> <h3>Button</h3> <div class="level3"> <p> A Button entity acts like a lever, except it does not use a joint. It simply calls a callback when interacted with. </p> </div> <h3>Photocell</h3> <div class="level3"> <p> Add info. </p> </div> <h3>MoveObject</h3> <div class="level3"> <p> A MoveObject entity is an entity that can be specifically moved on a single axis through the use of scripting. It can be set to either Angular or Linear. Angular rotates the object around its own center point, unless otherwise specified by the use of an OffsetArea. Linear moves the object in a direction for a specified amount. Note that a linear move object can only move on one axis. You can pick X, Y or Z in the entity and this cannot be changed mid-game. If you want the same object to move on more than 1 axis (for example left then forward) you can switch out the entity with an identical one that uses another axis. The script to move a MoveObject is SetMoveObjectState and SetMoveObjectStateExt, found on the engine scripts page. </p> </div> <h3>Item</h3> <div class="level3"> </div> <h4>Puzzle</h4> <div class="level4"> <p> A Puzzle subtype item is a general item with no extra properties. Use this if you only need an inventory item to be used to trigger a scripted action. Other subtypes have special properties, but Puzzle only has the ability to be collected and used from the inventory. When used, it's loaded onto the crosshair so the player can use it on objects. </p> </div> <h4>Coins</h4> <div class="level4"> <p> Add info. </p> </div> <h4>Note</h4> <div class="level4"> <p> A Note item is an item that adds text to the player's journal. It displays itself when picked up. The note can be narrated, in which case it will automatically close once it's finished. If it isn't voiced, the player must close it. Use this if you want to make a Note item using a custom model / custom properties that differ from the main notes. </p> </div> <h4>Diary</h4> <div class="level4"> <p> A Diary item is nearly identical to the Note item. Instead, it adds itself to the Diary section of the player's journal, whereas the Note adds itself to the Notes section. Diaries are also always voice enabled. Notes have the option for it. </p> </div> <h4>Lantern</h4> <div class="level4"> <p> A Lantern item can be picked up like a normal item, but is added as a lantern to the inventory. While having this item, the player can press F to enable/diable it, or click it in the inventory. Note: This is NOT the lantern model, only the item that gives it to the player. If you want a custom lantern model, you can follow <a href="https://www.frictionalgames.com/forum/thread-12391.html" class="urlextern" title="https://www.frictionalgames.com/forum/thread-12391.html" rel="nofollow">this guide</a>. </p> </div> <h4>Health</h4> <div class="level4"> <p> A Health item acts like a health potion (Laudanum). It acts like a normal item, except when used it is consumed while increasing the player's health by a specified amount. </p> </div> <h4>Sanity</h4> <div class="level4"> <p> A Sanity item acts like a sanity potion. While used, they increase the player's sanity by a fixed amount, and then consumed from the inventory. </p> </div> <h4>LampOil</h4> <div class="level4"> <p> A LampOil item acts like an oil potion. When used, it increases the amount of oil for the lantern, and then consumed. </p> </div> <h4>Tinderbox</h4> <div class="level4"> <p> A Tinderbox item adds itself to the player's tinderbox counter in the inventory. Tinderboxes can be used once to light a light source. </p> </div> <h4>HandObject</h4> <div class="level4"> <p> Add info. </p> </div> <h4>Chest</h4> <div class="level4"> <p> Add info. </p> </div> <h3>OilBarrel</h3> <div class="level3"> <p> Add info. </p> </div> <h3>EmotionStone</h3> <div class="level3"> <p> Add info. </p> </div> <h3>NPC</h3> <div class="level3"> <p> Add info. </p> </div> <h3>LevelDoor</h3> <div class="level3"> <p> A LevelDoor entity is in concept similar to a SwingDoor, but they function very differently. A LevelDoor instantly transports the player to the specified level when they click it. The sounds, text and destination can be entered in the Level Editor itself. </p> </div> <h3>CritterBug</h3> <div class="level3"> <p> Add info. </p> </div> <h3>Enemy_Grunt</h3> <div class="level3"> <p> Add info. </p> </div> <h3>Enemy_Waterlurker</h3> <div class="level3"> <p> Add info. </p> </div> <h3>PlayerHands</h3> <div class="level3"> <p> Add info. </p> </div> <h3>HandObject</h3> <div class="level3"> <p> Add info. </p> </div>