Package net.fabricmc.fabric.api.entity.event.v1

Class ServerLivingEntityEvents

java.lang.Object

net.fabricmc.fabric.api.entity.event.v1.ServerLivingEntityEvents

public final class ServerLivingEntityEvents
extends Object

Various server-side only events related to living entities.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ServerLivingEntityEvents.AfterDamage
static interface	ServerLivingEntityEvents.AfterDeath
static interface	ServerLivingEntityEvents.AllowDamage
static interface	ServerLivingEntityEvents.AllowDeath
static interface	ServerLivingEntityEvents.MobConversion

Field Summary

Fields

Modifier and Type	Field	Description
static final Event<ServerLivingEntityEvents.AfterDamage>	AFTER_DAMAGE	An event that is called after an entity is damaged.
static final Event<ServerLivingEntityEvents.AfterDeath>	AFTER_DEATH	An event that is called when a living entity dies.
static final Event<ServerLivingEntityEvents.AllowDamage>	ALLOW_DAMAGE	An event that is called when a living entity is going to take damage.
static final Event<ServerLivingEntityEvents.AllowDeath>	ALLOW_DEATH	An event that is called when an entity takes fatal damage.
static final Event<ServerLivingEntityEvents.MobConversion>	MOB_CONVERSION	An event that is called when a mob has been converted to another type.

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

ALLOW_DAMAGE

public static final Event<ServerLivingEntityEvents.AllowDamage> ALLOW_DAMAGE

An event that is called when a living entity is going to take damage. This is fired from LivingEntity.damage(net.minecraft.server.world.ServerWorld, net.minecraft.entity.damage.DamageSource, float), before armor or any other mitigation are applied. Mods can cancel this to prevent the damage entirely.

AFTER_DAMAGE

public static final Event<ServerLivingEntityEvents.AfterDamage> AFTER_DAMAGE

An event that is called after an entity is damaged. This is fired from LivingEntity.damage(net.minecraft.server.world.ServerWorld, net.minecraft.entity.damage.DamageSource, float) after damage is applied, or after that damage was blocked by a shield.

The base damage taken is the damage initially applied to the entity. Damage taken is the amount of damage the entity actually took, after effects such as shields and extra freezing damage are applied. Damage taken does NOT include damage reduction from armor and enchantments.

This event is not fired if the entity was killed by the damage.

ALLOW_DEATH

public static final Event<ServerLivingEntityEvents.AllowDeath> ALLOW_DEATH

An event that is called when an entity takes fatal damage.

Mods can cancel this to keep the entity alive.

Vanilla checks for entity health <= 0 each tick (with LivingEntity.isDead()), and kills if true - so the entity will still die next tick if this event is cancelled. It's assumed that the listener will do something to prevent this, for example, if the entity is a player:

• a minigame mod teleporting the player into a 'respawn room' and setting their health to 20.0
• a mod that changes death mechanics switching the player over to the mod's play-mode, where death doesn't apply

AFTER_DEATH

public static final Event<ServerLivingEntityEvents.AfterDeath> AFTER_DEATH

An event that is called when a living entity dies.

MOB_CONVERSION

public static final Event<ServerLivingEntityEvents.MobConversion> MOB_CONVERSION

An event that is called when a mob has been converted to another type.

When this event is called, the old instance has not yet been discarded, and the new one has not yet been spawned. Mods may use this event to copy some of the old entity's data to the converted one.

This event only handles cases where the entity type changes, requiring a new instance. Notably it does not cover mooshrooms changing color from lightning, creepers getting charged, or wolves being tamed.