Frictional Game Wiki

<h1>Entities</h1> <div class="level1"> </div> <h2>General</h2> <div class="level2"> </div> <h2>Updating</h2> <div class="level2"> </div> <h3>Overview</h3> <div class="level3"> <p> The update functions can be used to make the entity run custom code at an interval. This can be used to give the entity custom behavior that is independent of the player. </p> <p> HPL3 uses two different kind of update types. <b>OnUpdate </b> and <b>OnPostUpdate </b> runs at a fixed speed (60 times per second). Code that need to work the same regardless of the hardware and framerate of the user should be placed here. This would mainly be physics and gameplay related code. <b>OnUpdate </b> is called at the begining of a frame and <b>OnPostUpdate </b> is called at the end of it. It is not possible to know in which order the entities will be called, but <b>OnPostUpdate </b> will always be called after <b>OnUpdate </b> has been called for all entities in the scene. </p> <p> The second update type is <b>OnVariableUpdate</b>. This will be called at a variable framerate and is not garanteed to work the same on all hardware. <b>OnVariableUpdate </b> is called right before the game is rendered. If the game is lagging <b>OnVariableUpdate </b> will be called less often than <b>OnUpdate </b> and <b>OnPostUpdate </b> that are forced to run at 60 FPS. Code that dont affect gameplay or that are purely aesthetic should be using the variable update function. <b>SetVariableUpdateRate </b> can be used to limit how often <b>OnVariableUpdate </b> is called, this should be used to stop performance heavy code from being run to often. </p> <p> Code that is critical to the gameplay and that needs to work the same on all hardware should be using the fixed updates. All other code should be placed in the variable update since it gives better performance if the game is lagging. </p> </div> <h2>Sleeping</h2> <div class="level2"> </div> <h3>Overview</h3> <div class="level3"> <p> When an entity no longer needs to be updated it should be put to sleep. This disables <b>OnUpdate</b>, <b>OnPostUpdate </b> and <b>OnVariableUpdate </b> from being called and saves performance. Entities that are asleep are still rendered and can be interacted with. An entity wakes up automatically if it is interacted with, collides with something, has an effect enabled (like Animation, MeshScale, BaseColorFade..) or if any of its bodies or attachments are woken up. </p> <p> <b>IMPORTANT</b> <br/> Props with active physics are currently set to be asleep when you enter a level. This means you can't put an object in mid-air and expect it to 'fall' to the correct ground position on startup of the level; you need to put it in the right place to start with. This is because otherwise there's a big performance hit at level startup while all the physics are sorted out, and a collection of physics-triggered sounds.<br/> <br/> To override this behaviour for a specific object, call <b>Entity_WakeUp() </b> on the entity. </p> </div> <h3>Auto Sleep</h3> <div class="level3"> <p> Entities also have a setting for automatic sleep which is true as default. This automatically sleeps entities that have no effects enabled and if all of its bodies and attachments are asleep. AutoSleep should be disabled in the script class when it needs to ensure that Update/PostUpdate is called. AI entities do not sleep automatically (but can still be put to sleep manually). </p> </div> <h3>Methods</h3> <div class="level3"> <p> These methods can be called in the Entity: </p> <p> <b>void Sleep()<br/> void WakeUp()<br/> bool IsSleeping()<br/> void SetAutoSleep(bool)<br/> bool GetAutoSleep(</b>) </p> </div> <h2>Entity Type</h2> <div class="level2"> </div> <h3>Player</h3> <div class="level3"> <p> This is a dummy object that's automatically created when the level starts. It's named "Player" and is useful for whenever you need to use the player as an entity, for instance to use it as a group for critters or attach something to it. </p> </div> <h3>Camera</h3> <div class="level3"> <p> Like Player, this is a dummy object automatically created when the level starts. It's called "Camera" and is useful for, for example, attaching objects to the player's view (such as particle systems). </p> </div> <h3>Prop</h3> <div class="level3"> </div> <h4>Overview</h4> <div class="level4"> <p> Props are used for any dynamic objects that do not any sophisticated AI. Boxes, closets, levers, etc all fit in here. </p> </div> <h4>Creation notes</h4> <div class="level4"> <p> Must always have a mesh in the entity file. Apart from that pretty much anything goes. </p> </div> <h4>Callback Methods</h4> <div class="level4"> <p> These are methods that are called from the prop: </p> <p> <b>void SetupAfterLoad(cWorld @apWorld, cResourceVarsObject @apVars, cResourceVarsObject @apInstanceVars)</b> <br/> <b>void OnAfterWorldLoad()</b> <br/> <b>void BeforeEntityDestruction()</b> <br/> <b>void ResetProperties()</b> <br/> <b>void OnSetActive(bool abX)</b> <br/> <b>void GiveDamage(float afAmount, int alStrength, const tString&in asType, const tString&in asSource)</b> <br/> <b>void OnUpdate(float afTimeStep)</b> <br/> <b>void OnPostUpdate(float afTimeStep)</b> <br/> <b>void OnVariableUpdate(float afTimeStep)</b> <br/> <b>void OnStartMove()</b> <br/> <b>void OnHealthChange()</b> <br/> <b>bool CanInteract(int alType, iPhysicsBody@ apBody)</b> <br/> <b>bool OnInteract(int alType, iPhysicsBody@ apBody, const cVector3f &in avFocusPos, const tString&in asData)</b> <br/> <b>void OnConnectionStateChange(iLuxEntity@ apEntity,int alState)</b> <br/> <b>void OnPhysicsCollision(iPhysicsBody @apBody, iPhysicsBody @apCollideBody, cPhysicsContactData&in apContactData)</b> <br/> <b>float DrawDebugOutput(cGuiSet @apSet,iFontData @apFont,float afStartY)</b> <br/> <b>void OnAttachmentUpdate(const cMatrixf&in a_mtxTransformAdd)</b> </p> </div> <h3>Agent</h3> <div class="level3"> </div> <h4>General</h4> <div class="level4"> <p> Agent is the building block for making anything needed more complex AI, like enemies or NPCs </p> </div> <h4>Creation notes</h4> <div class="level4"> <p> Shall not have any bodies or joints in the entity file. Attach any effects either to nodes, sockets. If you skip attaching them to anything they will be attached to the mesh. </p> </div> <h4>Callback Methods</h4> <div class="level4"> <p> These are methods that are called from the Agent </p> <p> <b>void SetupAfterLoad(cWorld @apWorld, cResourceVarsObject @apVars, cResourceVarsObject @apInstanceVars)</b> <br/> <b>void OnAfterWorldLoad()</b> <br/> <b>void BeforeEntityDestruction()</b> <br/> <b>void ResetProperties()</b> <br/> <b>void OnSetActive(bool abX)</b> <br/> <b>void GiveDamage(float afAmount, int alStrength, const tString&in asType, const tString&in asSource)</b> <br/> <b>void OnUpdate(float afTimeStep)</b> <br/> <b>void OnPostUpdate(float afTimeStep)</b> <br/> <b>void OnVariableUpdate(float afDeltaTime)</b> <br/> <b>void OnHealthChange()</b> <br/> <b>bool CanInteract(int alType, iPhysicsBody@ apBody)</b> <br/> <b>bool OnInteract(int alType, iPhysicsBody@ apBody, const cVector3f &in avFocusPos, const tString&in asData)</b> <br/> <b>void OnConnectionStateChange(iLuxEntity@ apEntity,int alState)</b> <br/> <b>float DrawDebugOutput(cGuiSet @apSet,iFontData @apFont,float afStartY)</b> <br/> <b>void SetupCharBody()</b> <br/> <b>void GiveDamage(float afAmount, int alStrength, const tString&in asType, const tString&in asSource)</b> <br/> <b>void HitByProp(float afAmount, float afMass, iPhysicsBody @apBody, cLuxProp @apProp)</b> </p> </div> <h3>Critter</h3> <div class="level3"> </div> <h4>Overview</h4> <div class="level4"> <p> Critters are meant to be smaller creatures that do not require advanced AI or behaviors. They are built up by boids and are controlled by having a lot of functions that add force to them. </p> </div> <h4>Creation notes</h4> <div class="level4"> <p> A critter must have at least one body in the entity file. The mesh (or any other entities) may NOT be attached to this body. The shape of the body should almost always be a sphere. It does not need to cover the entire mesh and for long creatures it is probably best if it only covers the head. Do testing and see what works best. </p> </div> <h4>Callback Methods</h4> <div class="level4"> <p> These are methods that are called from the Agent </p> <p> <b>void SetupAfterLoad(cWorld @apWorld, cResourceVarsObject @apVars, cResourceVarsObject @apInstanceVars)</b> <br/> <b>void OnAfterWorldLoad()</b> <br/> <b>void BeforeEntityDestruction()</b> <br/> <b>void ResetProperties()</b> <br/> <b>void OnSetActive(bool abX)</b> <br/> <b>void GiveDamage(float afAmount, int alStrength, const tString&in asType, const tString&in asSource)</b> <br/> <b>void OnUpdate(float afTimeStep)</b> <br/> <b>void OnPostUpdate(float afTimeStep)<br/> </b><b>void OnVariableUpdate(float afDeltaTime)</b> <br/> <b>void OnHealthChange()</b> <br/> <b>bool CanInteract(int alType, iPhysicsBody@ apBody)</b> <br/> <b>bool OnInteract(int alType, iPhysicsBody@ apBody, const cVector3f &in avFocusPos, const tString&in asData)</b> <br/> <b>void OnConnectionStateChange(iLuxEntity@ apEntity,int alState)</b> <br/> <b>float DrawDebugOutput(cGuiSet @apSet,iFontData @apFont,float afStartY)</b> <br/> <b>void GiveDamage(float afAmount, int alStrength, const tString&in asType, const tString&in asSource)</b> </p> </div> <h3>Area</h3> <div class="level3"> </div> <h4>Overview</h4> <div class="level4"> <p> Used for various types of trigger areas </p> </div> <h4>Callback Methods</h4> <div class="level4"> <p> These are methods that are called from the area: </p> <p> <b>void SetupAfterLoad(cWorld @apWorld, cResourceVarsObject @apVars)</b> <br/> <b>void BeforeEntityDestruction()</b> <br/> <b>void ResetProperties()</b> <br/> <b>void OnSetActive(bool abX)</b> <br/> <b>void OnUpdate(float afTimeStep)</b> <br/> <b>void OnPostUpdate(float afTimeStep)<br/> </b><b>void OnVariableUpdate(float afDeltaTime)</b> <br/> <b>bool CanInteract(int alType, iPhysicsBody@ apBody)</b> <br/> <b>bool OnInteract(int alType, iPhysicsBody@ apBody, const cVector3f &in avFocusPos, const tString&in asData)</b> <br/> <b>void OnConnectionStateChange(iLuxEntity@ apEntity,int alState)</b> <br/> <b>float DrawDebugOutput(cGuiSet @apSet,iFontData @apFont,float afStartY)</b> <br/> <b>bool OnStartCheckCollision(float afTimeStep, float afTimeSinceCheck)</b> <br/> Return true if collision should be check. Only available if SetCheckCollision has been set true.<br/> <b>bool OnCheckCollision(iPhysicsBody@ apBody, iLuxEntity@ apEntity)</b> <br/> Called for each body colliding. Only available if SetCheckCollision has been set true.<br/> <b>void OnEndCheckCollision(float afTimeStep</b> <br/> When all colliding bodies have been check. Only available if SetCheckCollision has been set true.<br/> <b>void GiveDamage(float afAmount, int alStrength, const tString&in asType, const tString&in asSource)</b> </p> </div> <h3>Liquid Area</h3> <div class="level3"> </div> <h4>Overview</h4> <div class="level4"> <p> A special kind of area hardcoded to make it extra fast. It basically gives anything in the area buoyancy. Normally the default should work, but you can use this to implement special types or add all kinds of effects easily. </p> </div> <h4>Callback Methods</h4> <div class="level4"> <p> These are methods that are called from the liquid area: </p> <p> <b>void SetupAfterLoad(cWorld @apWorld, cResourceVarsObject @apVars)</b> <br/> <b>void BeforeEntityDestruction()</b> <br/> <b>void ResetProperties()</b> <br/> <b>void OnSetActive(bool abX)</b> <br/> <b>void OnUpdate(float afTimeStep)</b> <br/> <b>void OnPostUpdate(float afTimeStep)<br/> v</b><b>oid OnVariableUpdate(float afDeltaTime)</b> <br/> <b>bool CanInteract(int alType, iPhysicsBody@ apBody)</b> <br/> <b>bool OnInteract(int alType, iPhysicsBody@ apBody, const cVector3f &in avFocusPos, const tString&in asData)</b> <br/> <b>void OnConnectionStateChange(iLuxEntity@ apEntity,int alState)</b> <br/> <b>void OnBodyEnterLiquid(iPhysicsBody @apBody)</b> <br/> <b>void OnBodyExitLiquid(iPhysicsBody @apBody)</b> <br/> <b>void OnCharBodyEnterLiquid(iCharacterBody @apBody)</b> <br/> <b>void OnCharBodyExitLiquid(iCharacterBody @apBody)</b> <br/> <b>void OnAttachmentUpdate()</b> <br/> <b>float DrawDebugOutput(cGuiSet @apSet,iFontData @apFont,float afStartY)</b> <br/> <b>void GiveDamage(float afAmount, int alStrength, const tString&in asType, const tString&in asSource)</b> </p> </div>