From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001 From: SoSeDiK Date: Tue, 11 Oct 2022 22:35:56 +0300 Subject: [PATCH] Add LivingEntity#swingHand(EquipmentSlot) convenience method diff --git a/src/main/java/org/bukkit/entity/LivingEntity.java b/src/main/java/org/bukkit/entity/LivingEntity.java index 6f7483a86b713b7b85e595f55b167e1547bc4b8e..475fdef28596cf8454da58d04d4c4153719a4a68 100644 --- a/src/main/java/org/bukkit/entity/LivingEntity.java +++ b/src/main/java/org/bukkit/entity/LivingEntity.java @@ -1033,5 +1033,23 @@ public interface LivingEntity extends Attributable, Damageable, ProjectileSource * @param hurtDirection hurt direction */ void setHurtDirection(float hurtDirection); + + /** + * Makes this entity swing their hand. + * + *

This method does nothing if this entity does not + * have an animation for swinging their hand. + * + * @param hand hand to be swung, either {@link org.bukkit.inventory.EquipmentSlot#HAND} or {@link org.bukkit.inventory.EquipmentSlot#OFF_HAND} + * @throws IllegalArgumentException if invalid hand is passed + */ + default void swingHand(@NotNull org.bukkit.inventory.EquipmentSlot hand) { + com.google.common.base.Preconditions.checkArgument(hand != null && hand.isHand(), String.format("Expected a valid hand, got \"%s\" instead!", hand)); + if (hand == org.bukkit.inventory.EquipmentSlot.HAND) { + this.swingMainHand(); + } else { + this.swingOffHand(); + } + } // Paper end }