Entity Effects

Entity effects (SpellFieldEntityEffect) are applied to every valid entity captured within the spell field's evaluated volume.

The strength, duration, or probability of these effects is automatically scaled by the Volume Scalar—the topological multiplier (0.0 to 1.0) calculated based on the entity's specific distance from the epicenter.

Common Parameters

• entity_filter (Optional): A standard vanilla ContextAwarePredicate. Only entities matching this loot condition will be affected.
• Volume Scalar Application: Most absolute values (like damage or duration) are directly multiplied by the volume scalar before application.

Combat & Status

• damage_entity: Inflicts absolute damage points utilizing a specific DamageType registry key. (Damage is multiplied by the volume scalar).
• heal: Restores raw health points to LivingEntity targets. (Heal amount is multiplied by the volume scalar).
• apply_potion: Afflicts the entity with a list of mob effects (PotionPayload). Both the duration and amplifier are evaluated dynamically.
• clear_effects: Subtracts ticks from the duration of all active mob effects on the target. If the duration drops to zero, the effect is removed.
• ignite: Sets the entity on fire for a specific duration in seconds.
• extinguish: Subtracts ticks from the entity's active fire timer, putting them out.
• air_supply: Directly adds or subtracts oxygen ticks, useful for drowning or underwater breathing fields.
• disarm: Forces the entity to drop currently equipped gear from specified EquipmentSlots based on a drop_chance.

Physics & Movement

• impulse: Applies a sudden burst of kinetic velocity to the entity.
  • strength: The magnitude of the velocity.
  • direction: A FieldAxis (e.g., radial, vertical) determining the push direction.
• orbit: Locks the entity into a structured gravitational orbit around the epicenter.
  • attraction_strength: The gravitational pull toward the orbital ring.
  • orbital_radius: The distance the entity attempts to maintain from the center.
  • orbit_velocity: The tangential speed at which the entity revolves.
  • drag_multiplier: Dampens existing momentum to stabilize the orbit.
  • axis: The geometric plane of the orbit. (If omitted, a chaotic spherical orbit is used).
• absolute_stasis: Nullifies all delta movement and suspends fall damage accumulation. Freezes the entity in mid-air.
• random_teleport: Blindly relocates the entity to a random safe coordinate within a specified range (Chorus Fruit style teleportation).

Utility & Spawning

• summon_entity: Spawns a secondary entity (e.g., Zombies, Arrows) exactly at the victim's coordinates. The count parameter supports fractional probabilities (e.g., 1.5 spawns 1 entity guaranteed, with a 50% chance for a second).
• summon_lingering_potion: Spawns an AreaEffectCloud (lingering potion cloud) centered on the victim.
• reset_lifetime: Resets the despawn timers (age) of targeted ItemEntity or ExperienceOrb targets back to 0.

Audio & Visual

• play_sound_entity: Triggers a localized sound event attached to the moving entity.
• burst_entity: Emits a burst of particles directly from the entity's center point.