#1055: Expand riptiding API

By: ShreyasAyyengar <shreyas.ayyengar@gmail.com>

paper-api/src/main/java/org/bukkit/entity/HumanEntity.java

@@ -286,6 +286,15 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, InventoryHolder
      */
     public void wakeup(boolean setSpawnLocation);
 
+    /**
+     * Make the player start a riptide spin attack.
+     *
+     * @param duration spin attack duration in ticks.
+     * @param attackStrength damage value inflicted upon entities hit by spin attack.
+     * @param attackItem item used to attack.
+     */
+    public void startRiptideAttack(int duration, float attackStrength, @Nullable ItemStack attackItem);
+
     /**
      * Gets the location of the bed the player is currently sleeping in
      *

paper-api/src/main/java/org/bukkit/entity/LivingEntity.java

@@ -510,12 +510,22 @@ public interface LivingEntity extends Attributable, Damageable, ProjectileSource
     public void setSwimming(boolean swimming);
 
     /**
-     * Checks to see if an entity is currently using the Riptide enchantment.
+     * Checks to see if an entity is currently riptiding.
      *
      * @return True if this entity is currently riptiding.
      */
     public boolean isRiptiding();
 
+    /**
+     * Makes entity start or stop riptiding.
+     * <p>
+     * Note: This does not damage attackable entities.
+     *
+     * @param riptiding whether the entity should start riptiding.
+     * @see HumanEntity#startRiptideAttack(int, float, ItemStack)
+     */
+    public void setRiptiding(boolean riptiding);
+
     /**
      * Returns whether this entity is slumbering.
      *