Lua: onHitHandlers can't force attacks to strike true

I and a handful of other users expected that setting the attack.successful field to be true would force the attack to always hit.

For now, I imagine the best/easiest fix here is purely documentation.