Class "Entity"

PreviousClass "Vector"NextClass "ItemConfig::Config"

Last updated 4 years ago

Was this helpful?

Class "Entity"

Functions

AddBurn () {: aria-label='Functions' }

{: .abp .tooltip .badge }

void AddBurn ( Source, int Duration, float Damage ) {: .copyable aria-label='Functions' }

Adds a burn-effect to an enemy. Duration is in Number of Frames. Damage is the Damage taken per frame.

???- example "Example Code" This code damages every entity in the room for 1 second with the damagesource set to the player. The total damage dealt is 30.

    local player =Isaac.GetPlayer(0)
    for i, entity in ipairs(Isaac.GetRoomEntities()) do
        entity:AddBurn(player,30,1)
    end

AddCharmed () {: aria-label='Functions' }

{: .abp .tooltip .badge }

void AddCharmed ( int Duration ) {: .copyable aria-label='Functions' }

Adds a charmed-effect to an enemy. Duration is in Number of Frames. Charmed enemies are friendly towards isaac and attack other enemies.

:::lua AddCharmed(-1) makes the effect permanent and the enemy will follow you even to different rooms.

???- example "Example Code" This code charms every entity in the room for 1 second.

    for i, entity in ipairs(Isaac.GetRoomEntities()) do
        entity:AddCharmed(30)
    end

AddConfusion () {: aria-label='Functions' }

Adds a confusion effect to an entity.

???- example "Example Code" This code confuses every entity in the room for 1 second while ignoring bosses.

    local player =Isaac.GetPlayer(0) 
    for i, entity in ipairs(Isaac.GetRoomEntities()) do
        entity:AddConfusion(player,30,true)
    end

AddEntityFlags () {: aria-label='Functions' }

void AddEntityFlags ( int Flags ) {: .copyable aria-label='Functions' }

???- example "Example Code" This code adds slowing and confusion to the enetity.

    local player =Isaac.GetPlayer(0) 
    for i, entity in ipairs(Isaac.GetRoomEntities()) do
        entity:AddEntityFlags(EntityFlag.FLAG_SLOW | EntityFlag.FLAG_CONFUSION)
    end

AddFear () {: aria-label='Functions' }

Adds a fear-effect to an entity.

???- example "Example Code" This code frightens every entity in the room for 1 second.

    local player =Isaac.GetPlayer(0) 
    for i, entity in ipairs(Isaac.GetRoomEntities()) do
        entity:AddFear(player, 30)
    end

AddFreeze () {: aria-label='Functions' }

Freezes an entity, making it unable to move and attack.

???- example "Example Code" This code freezes every entity in the room for half a second.

    local player =Isaac.GetPlayer(0) 
    for i, entity in ipairs(Isaac.GetRoomEntities()) do
        entity:AddFreeze(player, 30)
    end

AddHealth () {: aria-label='Functions' }

void AddHealth ( float HitPoints ) {: .copyable aria-label='Functions' }

Heals an entity.

AddMidasFreeze () {: aria-label='Functions' }

Turns the entity into a gold statue (can't move, can't attack, drops coins when killed)

AddPoison () {: aria-label='Functions' }

Adds a poison effect to the entity.

AddShrink () {: aria-label='Functions' }

Adds a shrink effect to the entity.

AddSlowing () {: aria-label='Functions' }

Makes the friction higher.

AddVelocity () {: aria-label='Functions' }

Adds velocity to the entity. This can be used to move him in a certain direktion (for example as a result of collision)

BloodExplode () {: aria-label='Functions' }

void BloodExplode ( ) {: .copyable aria-label='Functions' }

Explodes with gibs and blood.

CanShutDoors () {: aria-label='Functions' }

boolean CanShutDoors ( ) {: .copyable aria-label='Functions' }

enemies keep the doors shut.

ClearEntityFlags () {: aria-label='Functions' }

void ClearEntityFlags ( int Flags ) {: .copyable aria-label='Functions' }

CollidesWithGrid () {: aria-label='Functions' }

boolean CollidesWithGrid ( ) {: .copyable aria-label='Functions' }

Returns true, if the entity is able to collide with the grid.

Die () {: aria-label='Functions' }

void Die ( ) {: .copyable aria-label='Functions' }

Kills the entity and trigger its death animation.

Exists () {: aria-label='Functions' }

boolean Exists ( ) {: .copyable aria-label='Functions' }

Returns true, if this entity still exists.

GetBossID () {: aria-label='Functions' }

BossId GetBossID ( ) {: .copyable aria-label='Functions' }

If the entity is a boss, it returns its specific boss id. If it isnt a boss it will return 0.

GetColor () {: aria-label='Functions' }

Returns the Color object assosiated to this entity.

GetData () {: aria-label='Functions' }

table GetData ( ) {: .copyable aria-label='Functions' }

Returns a table that contains all data assosiated with the entity. This can be used to add custom data as well.

???- note "Notes" Data associated with an entity does only persists in between rooms, when the entity is a player, familiar or the entity has the "EntityFlag.FLAG_PERSISTENT" Flag active. Data does not persists in between exiting the game to a menu, or when restarting/finishing a run.

???- example "Example Code" This code adds custom data to an entity or prints it in the console if it exists.

    if type(entity:GetData()["MyValue"]) == type(nil) then -- checks, if the Data does exist already
    entity:GetData()["MyValue"] = "Cool" -- assign a value to the data
    else 
    print(entity:GetData()["MyValue"])  -- this will print "Cool" in the console
    end

GetDropRNG () {: aria-label='Functions' }

Returns the assigned RNG object for the entity. This RNG is used to determine the items that are dropped on the entities death.

GetEntityFlags () {: aria-label='Functions' }

int GetEntityFlags ( ) {: .copyable aria-label='Functions' }

    if entity:GetEntityFlags() &amp; EntityFlag.FLAG_CONFUSION == EntityFlag.FLAG_CONFUSION then
    print("This entity is confused!")
    end

GetLastChild () {: aria-label='Functions' }

Returns the last entity spawned by this entity.

GetLastParent () {: aria-label='Functions' }

Returns the last parent of this entity.

GetSprite () {: aria-label='Functions' }

Return the sprite object of the entity.

HasCommonParentWithEntity () {: aria-label='Functions' }

HasEntityFlags () {: aria-label='Functions' }

boolean HasEntityFlags ( int Flags ) {: .copyable aria-label='Functions' }

    if entity:HasEntityFlags(EntityFlag.FLAG_CONFUSION) then
    print("This entity is confused!")
    end

HasFullHealth () {: aria-label='Functions' }

boolean HasFullHealth ( ) {: .copyable aria-label='Functions' }

HasMortalDamage () {: aria-label='Functions' }

boolean HasMortalDamage ( ) {: .copyable aria-label='Functions' }

???- note "Notes" The game adds taken damage to a damage buffer, which gets applied in the next frame. HasMortalDamage() returns true if the buffered damage is enough to kill the entity. HasMortalDamage() will be updated additionally after TakeDamage() is called.

IsActiveEnemy () {: aria-label='Functions' }

boolean IsActiveEnemy ( boolean includeDead ) {: .copyable aria-label='Functions' }

return true for non background NPCs (ex: every enemy except fire and shopkeepers)

IsBoss () {: aria-label='Functions' }

boolean IsBoss ( ) {: .copyable aria-label='Functions' }

bosses display health bar

IsDead () {: aria-label='Functions' }

boolean IsDead ( ) {: .copyable aria-label='Functions' }

IsEnemy () {: aria-label='Functions' }

boolean IsEnemy ( ) {: .copyable aria-label='Functions' }

return true for NPCs that are not controlled by the player

IsFlying () {: aria-label='Functions' }

boolean IsFlying ( ) {: .copyable aria-label='Functions' }

IsFrame () {: aria-label='Functions' }

boolean IsFrame ( int Frame, int Offset ) {: .copyable aria-label='Functions' }

true every X frames

IsInvincible () {: aria-label='Functions' }

boolean IsInvincible ( ) {: .copyable aria-label='Functions' }

IsVisible () {: aria-label='Functions' }

boolean IsVisible ( ) {: .copyable aria-label='Functions' }

IsVulnerableEnemy () {: aria-label='Functions' }

boolean IsVulnerableEnemy ( ) {: .copyable aria-label='Functions' }

return true for enemies that can be damaged

Kill () {: aria-label='Functions' }

void Kill ( ) {: .copyable aria-label='Functions' }

Kills the entity and makes a blood splat or gibs.

MultiplyFriction () {: aria-label='Functions' }

void MultiplyFriction ( float Value ) {: .copyable aria-label='Functions' }

PostRender () {: aria-label='Functions' }

void PostRender ( ) {: .copyable aria-label='Functions' }

Remove () {: aria-label='Functions' }

void Remove ( ) {: .copyable aria-label='Functions' }

Remove the entity from the game instantly, without doing any additional effects/animations.

RemoveStatusEffects () {: aria-label='Functions' }

void RemoveStatusEffects ( ) {: .copyable aria-label='Functions' }

Removes all Status Effects from the entity.

Render () {: aria-label='Functions' }

Render the current sprite of the Entity at the current entity position + offset.

RenderShadowLayer () {: aria-label='Functions' }

Render the shadow / shadow layer again.

SetColor () {: aria-label='Functions' }

Set the colormask for the entity. This can be used to tint the sprites in different colors.

???- example "Example Code" This code changes the color of the sprite to a fully white sprite for 15 frames.

    entity:SetColor(Color(1,1,1,1,255,255,255),15,1,false,false)

SetSize () {: aria-label='Functions' }

Set the size ofthe entity.

SetSpriteFrame () {: aria-label='Functions' }

void SetSpriteFrame ( string AnimationName, int FrameNum ) {: .copyable aria-label='Functions' }

SetSpriteOverlayFrame () {: aria-label='Functions' }

void SetSpriteOverlayFrame ( string AnimationName, int FrameNum ) {: .copyable aria-label='Functions' }

TakeDamage () {: aria-label='Functions' }

???- note "Notes" The game adds taken damage to a damage buffer, which gets applied in the next frame. Therefore, TakeDamage() will not decremented the entities HP immediately upon calling the function. Rather, it is only updated on the frame afterwards.

ToBomb () {: aria-label='Functions' }

ToEffect () {: aria-label='Functions' }

ToFamiliar () {: aria-label='Functions' }

ToKnife () {: aria-label='Functions' }

ToLaser () {: aria-label='Functions' }

ToNPC () {: aria-label='Functions' }

ToPickup () {: aria-label='Functions' }

ToPlayer () {: aria-label='Functions' }

ToProjectile () {: aria-label='Functions' }

ToTear () {: aria-label='Functions' }

Update () {: aria-label='Functions' }

void Update ( ) {: .copyable aria-label='Functions' }

Child () {: aria-label='Functions' }

Variables

CollisionDamage {: aria-label='Variables' }

float CollisionDamage {: .copyable aria-label='Variables' }

DepthOffset {: aria-label='Variables' }

float DepthOffset {: .copyable aria-label='Variables' }

Get/Set the depth-offset of the entity. This value is added to the Y Position of the entity, which is then used to determine the rendering order of each entity. Default value is 0 for all entities.

???- example "Example Code" This code explains how this variable works.

    entity1.Position.Y -- =&gt; 50
    entity2.Position.Y -- =&gt; 45
    -- Entity1 is rendered in front of Entity2

    entity1.DepthOffset = -10
    -- new Entity1 renderYPosition =&gt; 40
    -- Entity2 is rendered in front of Entity1

DropSeed {: aria-label='Variables' }

int DropSeed {: .copyable aria-label='Variables' }

Get/set the Seed of the Drop RNG.

FlipX {: aria-label='Variables' }

boolean FlipX {: .copyable aria-label='Variables' }

FrameCount {: aria-label='Variables' }

int FrameCount {: .copyable aria-label='Variables' }

Friction {: aria-label='Variables' }

float Friction {: .copyable aria-label='Variables' }

loaded from entity config

HitPoints {: aria-label='Variables' }

float HitPoints {: .copyable aria-label='Variables' }

???- note "Notes" The HitPoints value is not decremented immediately upon taking damage like you would expect. Rather, it is only updated on the frame after the entity takes damage.

Index {: aria-label='Variables' }

int Index {: .copyable aria-label='Variables' }

InitSeed {: aria-label='Variables' }

int InitSeed {: .copyable aria-label='Variables' }

Mass {: aria-label='Variables' }

float Mass {: .copyable aria-label='Variables' }

MaxHitPoints {: aria-label='Variables' }

float MaxHitPoints {: .copyable aria-label='Variables' }

Parent {: aria-label='Variables' }

Position {: aria-label='Variables' }

PositionOffset {: aria-label='Variables' }

RenderZOffset {: aria-label='Variables' }

int RenderZOffset {: .copyable aria-label='Variables' }

???+ bug "Bugs" This variable doesnt seem to do anything useful. Use DepthOffset instead.