com.hypixel.hytale.server.core.modules.entity.damage

Package: com.hypixel.hytale.server.core.modules.entity.damage

The damage package implements the server’s damage pipeline, death handling, and respawn systems. It defines the Damage event that flows through a three-phase processing chain (gather, filter, inspect), the DamageCause asset system for damage types, and the DeathComponent that triggers death and respawn behavior. All systems are registered by DamageModule.

API Surface Types

Type	Kind	Description
Damage	class	Cancellable ECS damage event with metadata store.
Damage.Source	interface	Identifies the origin of damage and generates death messages.
Damage.EntitySource	class	Damage from another entity.
Damage.ProjectileSource	class	Damage from a projectile with a shooter.
Damage.CommandSource	class	Damage from a server command.
Damage.EnvironmentSource	class	Damage from an environmental hazard.
Damage.Particles	class	Impact particle configuration.
Damage.SoundEffect	class	Impact sound effect wrapper.
Damage.CameraEffect	record	Camera effect on hit.
DamageCause	class	JSON asset defining a damage type.

Internal Types — Module

Type	Kind	Description
DamageModule	class	Core plugin that registers all damage systems.
DamageModule.OrderGatherFilter	class	Deprecated ordering system.
DamageEventSystem	abstract class	Base class for damage event handler systems.

Internal Types — Damage Systems

Type	Kind	Description
DamageSystems	class	Container for all damage processing systems.
DamageSystems.ApplyDamage	class	Subtracts health and triggers death.
DamageSystems.CanBreathe	class	Drowning and suffocation damage.
DamageSystems.OutOfWorldDamage	class	Damage below the world boundary.
DamageSystems.FallDamagePlayers	class	Fall damage for players.
DamageSystems.FallDamageNPCs	class	Fall damage for NPCs.
DamageSystems.FilterPlayerWorldConfig	class	Cancels player damage when disabled.
DamageSystems.FilterNPCWorldConfig	class	Cancels NPC damage when disabled.
DamageSystems.FilterUnkillable	class	Cancels damage on unkillable entities.
DamageSystems.PlayerDamageFilterSystem	class	Spawn protection and PvP checks.
DamageSystems.ArmorDamageReduction	class	Armor damage resistance.
DamageSystems.ArmorDamageReduction.ArmorResistanceModifiers	class	Resistance modifier accumulator.
DamageSystems.ArmorKnockbackReduction	class	Armor knockback resistance.
DamageSystems.WieldingDamageReduction	class	Shield/blocking damage reduction.
DamageSystems.WieldingKnockbackReduction	class	Shield/blocking knockback reduction.
DamageSystems.HackKnockbackValues	class	Deprecated knockback velocity scaler.
DamageSystems.ApplyParticles	class	Spawns impact particles.
DamageSystems.ApplySoundEffects	class	Plays impact sounds.
DamageSystems.HitAnimation	class	Plays hurt animations.
DamageSystems.DamageArmor	class	Reduces armor durability.
DamageSystems.DamageAttackerTool	class	Reduces weapon durability.
DamageSystems.DamageStamina	class	Drains stamina on block.
DamageSystems.RecordLastCombat	class	Records combat timestamps.
DamageSystems.TrackLastDamage	class	Records last damage time.
DamageSystems.PlayerHitIndicators	class	Sends hit indicator packets.
DamageSystems.ReticleEvents	class	Sends reticle hit/kill events.
DamageSystems.EntityUIEvents	class	Sends combat text updates.

Internal Types — Damage Calculator

Type	Kind	Description
DamageCalculatorSystems	class	Sequential hit damage calculation.
DamageCalculatorSystems.DamageSequence	class	Sequential hit state tracker.
DamageCalculatorSystems.Sequence	class	Serializable hit counter.
DamageCalculatorSystems.SequenceModifier	class	Sequential damage scaling system.

Internal Types — Death

Type	Kind	Description
DeathComponent	class	ECS component marking an entity as dead.
DeathItemLoss	class	Item loss configuration snapshot.
DeferredCorpseRemoval	class	Timer component for delayed corpse removal.
DeathSystems	class	Container for death processing systems.
DeathSystems.OnDeathSystem	abstract class	Base class for death component-change systems.
DeathSystems.ClearHealth	class	Sets health to 0.
DeathSystems.ClearInteractions	class	Clears interaction manager.
DeathSystems.ClearEntityEffects	class	Removes active effects.
DeathSystems.PlayerKilledPlayer	class	Notifies killer of PvP kill.
DeathSystems.DropPlayerDeathItems	class	Drops items on death.
DeathSystems.PlayerDropItemsConfig	class	Configures item loss from world.
DeathSystems.RunDeathInteractions	class	Executes death interaction chain.
DeathSystems.KillFeed	class	Broadcasts kill feed messages.
DeathSystems.PlayerDeathScreen	class	Shows respawn screen.
DeathSystems.PlayerDeathMarker	class	Adds death marker to map.
DeathSystems.CorpseRemoval	class	Removes NPC corpses.
DeathSystems.DeathAnimation	class	Plays death animation.
DeathSystems.SpawnedDeathAnimation	class	Death animation on spawn.

Internal Types — Respawn

Type	Kind	Description
RespawnSystems	class	Container for respawn systems.
RespawnSystems.OnRespawnSystem	abstract class	Base class for respawn systems.
RespawnSystems.ResetStatsRespawnSystem	class	Resets all stats.
RespawnSystems.ResetPlayerRespawnSystem	class	Records spawn time.
RespawnSystems.ClearEntityEffectsRespawnSystem	class	Clears effects on respawn.
RespawnSystems.ClearInteractionsRespawnSystem	class	Clears interactions on respawn.
RespawnSystems.CheckBrokenItemsRespawnSystem	class	Warns about broken items.
RespawnSystems.ClearRespawnUI	class	Closes respawn page.

Internal Types — Events

Type	Kind	Description
KillFeedEvent	class	Kill feed event container.
KillFeedEvent.KillerMessage	class	Killer name event.
KillFeedEvent.DecedentMessage	class	Victim name event.
KillFeedEvent.Display	class	Final display event.

Internal Types — Commands

Type	Kind	Description
DesyncDamageCommand	class	Debug command to toggle damage desync.