Code Patterns

Copy-paste examples for common plugin tasks. Commands, events, ECS, GUI, and more.

All 225 Command 60 Damage 2 Ecs 27 Entity 5 Gui 75 Interaction 2 Inventory 4 Moderation 3 Permission 2 Player 9 Plugin 4 Storage 2 Teleport 3 Ui 22 Util 5
← Back to Patterns
damage

Handle Damage Event

Listen for and modify damage events.

Example Code

java 
// Register damage handler in ECS system
// The Damage class is a CancellableEcsEvent

public void onDamage(Damage damage) {
    // Get damage info
    float amount = damage.getAmount();
    Damage.Source source = damage.getSource();
    DamageCause cause = damage.getCause();

    // Modify damage
    damage.setAmount(amount * 0.5f); // Half damage

    // Or cancel completely
    damage.setCancelled(true);
}

Thread Safety

Damage events run on world thread as ECS events.

Common Mistakes

Not checking damage source type before casting. Modifying damage after event completes.