status effects - magemonkeystudio/fabled GitHub Wiki

📖 Status Effects

Status Effects are temporary states that can be applied to players or mobs, altering their abilities and actions. These effects are managed by Fabled's internal flag system and can be applied through skills and mechanics.

This page also covers the Purge and Cleanse mechanics, which are used to remove these effects.


Positive Statuses

Positive statuses generally benefit the entity they are applied to, often providing defensive advantages.

Invincible

  • Effect: Prevents all incoming damage. Any damage that would have been taken is completely cancelled.
  • Flag Key: invincible

Absorb

  • Effect: Prevents all incoming damage and instead heals the entity for the amount of damage that would have been dealt.
  • Flag Key: absorb

Invulnerable

  • Effect: Sets the entity's underlying Minecraft invulnerability state to true, preventing most forms of damage. This is different from the invincible flag.
  • Flag Key: invulnerable

Negative Statuses

Negative statuses hinder an entity's ability to perform actions, such as moving, attacking, or casting skills.

Stun

  • Effect: A powerful crowd-control effect that prevents the afflicted entity from performing most actions.
    • Prevents movement.
    • Prevents dealing physical damage.
    • Prevents launching projectiles.
    • Prevents casting skills.
    • Interrupts any active channeling.
    • Applies a high-level slow effect to non-player entities.
  • Flag Key: stun

Root

  • Effect: Prevents the entity from moving. Unlike a stun, rooted entities can still attack and cast skills.
    • Applies a high-level slow effect to non-player entities.
  • Flag Key: root

Disarm

  • Effect: Prevents the entity from dealing physical damage or launching projectiles.
  • Flag Key: disarm

Silence

  • Effect: Prevents the entity from casting skills.
    • Interrupts any active channeling.
  • Flag Key: silence

Neutral / Special Statuses

These statuses have unique mechanics related to skill casting.

Channel & Channeling

  • Effect: These flags indicate that a player is actively channeling a skill.
    • Prevents movement.
    • Prevents other skills from being cast.
    • Prevents dealing physical damage.
    • Prevents launching projectiles.
    • This status is removed if the entity is stunned or silenced.
  • Flag Keys: channel, channeling

Removing Status Effects

Fabled provides two primary mechanics for removing status and potion effects from a target: Cleanse and Purge.

Cleanse

The cleanse mechanic is used to remove negative effects from a target. [cite: 1]

  • Removable Statuses: By default, it can remove all negative StatusFlag effects, which include Stun, Root, Disarm, and Silence. [cite: 1] You can also configure it to remove only specific statuses. [cite: 1]
  • Removable Potions: It can remove a wide variety of negative potion effects, such as Blindness, Confusion (Nausea), Poison, Slowness, Weakness, and Wither. [cite: 1] You can configure it to remove all default negative potions or only specific ones. [cite: 1]

Purge

The purge mechanic is used to remove positive effects from a target.

  • Removable Statuses: By default, it can remove all positive StatusFlag effects, which include Invincible and Absorb. You can also configure it to remove only specific statuses.
  • Removable Potions: It can remove a wide variety of positive potion effects, including Absorption, Resistance, Haste, Fire Resistance, Regeneration, Speed, and Strength. You can configure it to remove all default positive potions or only specific ones.