Frictional Game Wiki

<h1>Entities</h1> <div class="level1"> </div> <h2>General</h2> <div class="level2"> </div> <h2>Entity Type</h2> <div class="level2"> </div> <h3>Player</h3> <div class="level3"> <p> This is a dummy object that there only exist one of and it is automatically created by the player. It is named "Player" and is helpful 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>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 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> <br/> <b>void GiveDamage(float afAmount, int alStrength, const tString&in asType, const tString&in asSource)</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 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)</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)</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)</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> <h3>Reverb Area</h3> <div class="level3"> </div> <h4>Overview</h4> <div class="level4"> <p> A special kind of area that is only used to set reverb properties for an area of the map. Does not allow variants to be created using script (like LiquidArea does). </p> </div>