71 lines
2.5 KiB
Diff
71 lines
2.5 KiB
Diff
|
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
||
|
From: dawon <dawon@dawon.eu>
|
||
|
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 ecb8b4cf48c7d6151ffec92bc6855d1fc57a2b51..1e27b9de47f111b9c000243214e22890e323f7fc 100644
|
||
|
--- a/src/main/java/org/bukkit/entity/Player.java
|
||
|
+++ b/src/main/java/org/bukkit/entity/Player.java
|
||
|
@@ -2844,6 +2844,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.
|
||
|
+ * <p>
|
||
|
+ * <b>Note:</b> 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.
|
||
|
+ * <p>
|
||
|
+ * <b>Note:</b> 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
|