Skip to content

Entity Events

entityDamage

FieldTypeDescription
entitystring (UUID)The damaged entity
damagenumberThe damage amount (writable: mods.damage overrides the damage amount)
causestringThe damage cause (ENTITY_ATTACK, FALL, LAVA, etc.)
entityTypestringThe entity type (Minecraft registry key, e.g. minecraft:zombie)

entityDeath

FieldTypeDescription
entitystring (UUID)The entity that died
entityTypestringThe entity type (Minecraft registry key, e.g. minecraft:zombie)
entityNamestringThe entity name

entitySpawn

FieldTypeDescription
entitystring (UUID)The spawned entity
entityTypestringThe entity type (Minecraft registry key, e.g. minecraft:zombie)
xnumberX coordinate
ynumberY coordinate
znumberZ coordinate
worldstringWorld name

entityExplode

FieldTypeDescription
entitystring (UUID)The exploding entity
entityTypestringThe entity type (Minecraft registry key, e.g. minecraft:zombie)
xnumberX coordinate
ynumberY coordinate
znumberZ coordinate
blockCountnumberThe estimated number of blocks to be destroyed

entityRegainHealth

FieldTypeDescription
entitystring (UUID)The entity that regained health
amountnumberThe amount of health regained (writable: mods.amount overrides the regained amount)
reasonstringThe reason for regaining health (SATIATED, REGEN, EATING, etc.)

entityTarget

FieldTypeDescription
entitystring (UUID)The entity that changed target
targetstring | nullThe target entity UUID (writable: mods.target is the target UUID or null (clears the target); null means cancel the target)

Projectile Events

projectileLaunch

FieldTypeDescription
entitystring (UUID)The projectile entity
projectileTypestringThe projectile type (Minecraft registry key, e.g. minecraft:arrow, minecraft:snowball)
shooterstring | undefinedThe shooter's UUID (only present when launched by a living entity)

projectileHit

FieldTypeDescription
entitystring (UUID)The projectile entity
projectileTypestringThe projectile type (Minecraft registry key)
hitEntitystring | nullThe UUID of the hit entity
hitBlockobject | null{ "x": <int>, "y": <int>, "z": <int>, "type": "<key>" }