Skip to main content

HitProps

See spell:set_hit_props()

HitProps.new(damage, flags, element, secondary_element, context?, drag?)​

Returns a new HitProps instance.

HitProps.new(damage, flags, element, context?, drag?)​

Returns a new HitProps instance.

HitProps.from_card(card_properties, context?, drag?)​

Returns a new HitProps instance.

hit_props.damage​

A number, used to calculate how much health to take away from entities hit by the attack.

hit_props.flags​

Any of the values below, or combined using bitwise or (|)

  • Hit.None
  • Hit.RetainIntangible prevents intangibility from being lost if the attack pierces.
  • Hit.NoCounter prevents the attack from countering.
  • Hit.Drag Allows the drag property to drag the entity.
  • Hit.Drain disables the hit flash and countering, most defense rules should check for Drain to ignore hits.
  • Hit.Flinch read by the hit entity to cancel attacks and play a flinch animation.
  • Hit.Flash applies the default intangible rule to the hit entity and flickers the entity's sprite.
  • Hit.PierceInvis read by defense rules to pierce defenses.
  • Hit.PierceGuard read by defense rules to pierce defenses.
  • Hit.PierceGround read by defense rules to pierce defenses.
  • Hit.Freeze applies freeze status on hit.
  • Hit.Paralyze applies paralyze status on hit.
  • Hit.Root applies root status on hit.
  • Hit.Blind applies blindness status on hit.
  • Hit.Confuse applies confusion status on hit.
  • Hit.[flag_name]

hit_props.status_durations​

A table that maps frame durations for status hit flags.

See Hit.duration_for()

hit_props.element​

An Element. If element or secondary_element is super effective against an entity's element, this attack will deal 2x damage.

hit_props.secondary_element​

An Element. If element or secondary_element is super effective against an entity's element, this attack will deal 2x damage.

hit_props.drag​

Drag

hit_props.context​

The AttackContext obtained by entity:context()

Hit​

Hit.duration_for(hit_flag, level)​

-level: Starts at level 1, clamps to valid (defined) duration levels. Durations are specified in Status Packages

Returns the duration in frames for a status effect at a specific level, or 1 if no durations are specified.

Hit.mutual_exclusions_for(hit_flag)​

Returns a number, representing all of the mutually exclusive hit flags for bit manipulation.

Element​

  • Element.None
  • Element.Fire
  • Element.Aqua
  • Element.Elec
  • Element.Wood
  • Element.Sword
  • Element.Wind
  • Element.Cursor
  • Element.Summon
  • Element.Plus
  • Element.Break

Element.is_weak_to(element_a, element_b)​

Returns true if element_a is weak to element_b.

Drag​

Drag.new(direction?, distance?)​

Returns a new Drag instance.

Drag.None​

Returns a new Drag instance.

Same as Drag.new()

drag.direction​

Direction, the direction to move the entity.

drag.distance​

Number, the amount of tiles to drag the entity.

AttackContext​

Data tracking the attacker and HitProps overrides. Obtained by entity:context() and passed through HitProps. Updates when a player or character starts an attack, or when HitProps are set on an entity. By default, the context is used by the engine to pass flags related to countering, see living:set_counterable().

context.aggressor​

The EntityId of the attacking entity.

context.flags​

See HitProps.flags

context.status_durations​

A table that maps frame durations for status hit flags.

See Hit.duration_for()

context.drag​

Drag