Misleading behavior of `EntityDamageByEntityEvent`

[zavdav]

One would expect EntityDamageByEntityEvent to fire when an entity inflicts damage on another entity.
However, I've found out that EntityDamageByEntityEvent is fired everytime a player left-clicks an entity, regardless if the hit would not be effective due to invincibility frames. The damage field in EntityDamageByEntityEvent also does not represent the actual damage the entity took, but rather the weapon damage of the attacking entity.

[Garsooon]

For whatever reason this event just seems to be bugged completely, it doesn't seem to fire off for any reason when it should be.

[adrianvic]

I had the same problem, it doesn't help that it was not documented at the time.

For people wanting to catch this event, listen to EntityDamageEvent and check if it's an instance of EntityDamageByEntityEvent.

The event seems to work flawlessly in later versions of Bukkit, maybe one should use that as reference for a fix?