From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001 From: dawon Date: Sat, 15 Oct 2022 00:46:32 +0200 Subject: [PATCH] Add Player Warden Warning API diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java index ad61c664af66a15e214c5db14a5c9e172f5309ae..537ebbad48191741f666aa2a30c8584562dfcb83 100644 --- a/src/main/java/org/bukkit/entity/Player.java +++ b/src/main/java/org/bukkit/entity/Player.java @@ -3548,6 +3548,59 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @param silent whether sound should be silenced */ void showElderGuardian(boolean silent); + + /** + * Returns the player's cooldown in ticks until the next Warden warning can occur. + * + * @return ticks until next Warden warning can occur. 0 means there is no cooldown left. + */ + int getWardenWarningCooldown(); + + /** + * Sets the player's cooldown in ticks until next Warden warning can occur. + * + * @param cooldown ticks until next Warden warning can occur. 0 means there is no cooldown left. Values less than 0 are set to 0. + */ + void setWardenWarningCooldown(int cooldown); + + /** + * Returns time since last Warden warning in ticks. + * + * @return ticks since last Warden warning + */ + int getWardenTimeSinceLastWarning(); + + /** + * Sets time since last Warden warning in ticks. + * + * @param time ticks since last Warden warning + */ + void setWardenTimeSinceLastWarning(int time); + + /** + * Returns the player's current Warden warning level. + * + * @return current Warden warning level + */ + int getWardenWarningLevel(); + + /** + * Sets the player's Warden warning level. + *

+ * Note: This will not actually spawn the Warden. + * Even if the warning level is over threshold, the player still needs to activate a Shrieker in order to summon the Warden. + * + * @param warningLevel player's Warden warning level. The warning level is internally limited to valid values. + */ + void setWardenWarningLevel(int warningLevel); + + /** + * Increases the player's Warden warning level if possible and not on cooldown. + *

+ * Note: This will not actually spawn the Warden. + * Even if the warning level is over threshold, the player still needs to activate a Shrieker in order to summon the Warden. + */ + void increaseWardenWarningLevel(); // Paper end @NotNull