mirror of
https://github.com/PaperMC/Paper.git
synced 2024-12-22 22:45:31 +01:00
52a05907c7
Upstream has released updates that appear to apply and compile correctly. This update has not been tested by PaperMC and as with ANY update, please do your own testing Bukkit Changes: 97c59261 PR-1073: Make Biome an interface a38581aa Fix further javadoc errors 8271c490 Fix javadoc error 8a9ecf29 PR-1072: Fix bad naming for Vault State methods 6dd58108 PR-1071: Make Fluid an interface and add missing entry ed2cdfc3 PR-1070: Make Attribute an interface and align names with the new minecraft ones 63472efb PR-1069: Add missing winter drop experimental annotation to pale boats CraftBukkit Changes: 7235ad7b0 PR-1501: Make Biome an interface 602904003 PR-1500: Rename implementation for Vault State methods 75f26f79f PR-1499: Make Fluid an interface and add missing entry 4cfd87adc PR-1498: Make Attribute an interface and align names with the new minecraft ones 6bb0db5cb SPIGOT-7928: ExactChoice acts as MaterialChoice 3eaf3a13c SPIGOT-7929: Error when setting EquippableComponent abbf57bac SPIGOT-7930: Fix spawning entities with SummonEntityEffect 92d6ab6cf PR-1497: Move boat field rename entries to below key renaming, so that keys are also renamed abfe292aa PR-1496: Use correct Fluid class on Tags type check c7aab7fa7 SPIGOT-7923: Fix Dispenser logic to avoid firing empty projectiles
220 lines
10 KiB
Diff
220 lines
10 KiB
Diff
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
From: Owen1212055 <23108066+Owen1212055@users.noreply.github.com>
|
|
Date: Sun, 3 Mar 2024 19:45:52 +0100
|
|
Subject: [PATCH] Suspicious Effect Entry API
|
|
|
|
Exposes a new suspicious effect entry type that properly represents
|
|
storable effects in the context of suspicious effects as they only
|
|
define the potion effect type and duration.
|
|
|
|
This differentiates them from the existing PotionEffect API found in
|
|
bukkit and hence clarifies that storable values in the parts of the API
|
|
in which it replaces PotionEffect.
|
|
|
|
Co-authored-by: Yannick Lamprecht <yannicklamprecht@live.de>
|
|
|
|
diff --git a/src/main/java/io/papermc/paper/potion/SuspiciousEffectEntry.java b/src/main/java/io/papermc/paper/potion/SuspiciousEffectEntry.java
|
|
new file mode 100644
|
|
index 0000000000000000000000000000000000000000..6311ede3e3812da2ccdbcb19522facd7b2e3bd5c
|
|
--- /dev/null
|
|
+++ b/src/main/java/io/papermc/paper/potion/SuspiciousEffectEntry.java
|
|
@@ -0,0 +1,39 @@
|
|
+package io.papermc.paper.potion;
|
|
+
|
|
+import org.bukkit.potion.PotionEffect;
|
|
+import org.bukkit.potion.PotionEffectType;
|
|
+import org.jetbrains.annotations.Contract;
|
|
+import org.jspecify.annotations.NullMarked;
|
|
+
|
|
+/**
|
|
+ * Represents a {@link PotionEffectType} paired with a duration.
|
|
+ */
|
|
+@NullMarked
|
|
+public sealed interface SuspiciousEffectEntry permits SuspiciousEffectEntryImpl {
|
|
+
|
|
+ /**
|
|
+ * Gets the effect type.
|
|
+ *
|
|
+ * @return effect type
|
|
+ */
|
|
+ PotionEffectType effect();
|
|
+
|
|
+ /**
|
|
+ * Gets the duration for this effect instance.
|
|
+ *
|
|
+ * @return duration (in ticks) or {@link PotionEffect#INFINITE_DURATION}
|
|
+ */
|
|
+ int duration();
|
|
+
|
|
+ /**
|
|
+ * Creates a new instance of SuspiciousEffectEntry.
|
|
+ *
|
|
+ * @param effectType effect type
|
|
+ * @param duration duration (in ticks) or {@link PotionEffect#INFINITE_DURATION}
|
|
+ * @return new instance of an entry
|
|
+ */
|
|
+ @Contract(value = "_, _ -> new", pure = true)
|
|
+ static SuspiciousEffectEntry create(final PotionEffectType effectType, final int duration) {
|
|
+ return new SuspiciousEffectEntryImpl(effectType, duration);
|
|
+ }
|
|
+}
|
|
diff --git a/src/main/java/io/papermc/paper/potion/SuspiciousEffectEntryImpl.java b/src/main/java/io/papermc/paper/potion/SuspiciousEffectEntryImpl.java
|
|
new file mode 100644
|
|
index 0000000000000000000000000000000000000000..a91d37ee450944ea779bd6b61d416467948bb55f
|
|
--- /dev/null
|
|
+++ b/src/main/java/io/papermc/paper/potion/SuspiciousEffectEntryImpl.java
|
|
@@ -0,0 +1,10 @@
|
|
+package io.papermc.paper.potion;
|
|
+
|
|
+import org.bukkit.potion.PotionEffectType;
|
|
+import org.jetbrains.annotations.ApiStatus;
|
|
+import org.jspecify.annotations.NullMarked;
|
|
+
|
|
+@ApiStatus.Internal
|
|
+@NullMarked
|
|
+record SuspiciousEffectEntryImpl(PotionEffectType effect, int duration) implements SuspiciousEffectEntry {
|
|
+}
|
|
diff --git a/src/main/java/org/bukkit/entity/MushroomCow.java b/src/main/java/org/bukkit/entity/MushroomCow.java
|
|
index 86c0043ef4e1288b6fe2f68a9b6d01c3de2c3454..3677f19ef1c05b76d946b1b2b491a6c3cec76140 100644
|
|
--- a/src/main/java/org/bukkit/entity/MushroomCow.java
|
|
+++ b/src/main/java/org/bukkit/entity/MushroomCow.java
|
|
@@ -34,14 +34,30 @@ public interface MushroomCow extends Cow, io.papermc.paper.entity.Shearable { //
|
|
* Adds a custom potion effect to be applied to the next suspicious stew
|
|
* received from milking this {@link MushroomCow}.
|
|
*
|
|
+ * @deprecated use {@link #addEffectToNextStew(io.papermc.paper.potion.SuspiciousEffectEntry, boolean)} as PotionEffect suggests that all attributes are used. In fact, only the PotionEffectType and the duration are used.
|
|
* @param effect the potion effect to add
|
|
* @param overwrite true if any existing effect of the same type should be
|
|
* overwritten
|
|
* @return true if the effects to be applied to the suspicious stew changed
|
|
* as a result of this call
|
|
*/
|
|
+ @Deprecated(forRemoval = true, since = "1.20.2") // Paper - add overloads to use suspicious effect entry to mushroom cow and suspicious stew meta
|
|
boolean addEffectToNextStew(@NotNull PotionEffect effect, boolean overwrite);
|
|
|
|
+ // Paper start - add overloads to use suspicious effect entry to mushroom cow and suspicious stew meta
|
|
+ /**
|
|
+ * Adds a suspicious effect entry to be applied to the next suspicious stew
|
|
+ * received from milking this {@link MushroomCow}.
|
|
+ *
|
|
+ * @param suspiciousEffectEntry the suspicious effect entry to add
|
|
+ * @param overwrite true if any existing effect of the same type should be
|
|
+ * overwritten
|
|
+ * @return true if the effects to be applied to the suspicious stew changed
|
|
+ * as a result of this call
|
|
+ */
|
|
+ boolean addEffectToNextStew(@NotNull io.papermc.paper.potion.SuspiciousEffectEntry suspiciousEffectEntry, boolean overwrite);
|
|
+ // Paper end - add overloads to use suspicious effect entry to mushroom cow and suspicious stew meta
|
|
+
|
|
/**
|
|
* Removes a custom potion effect from being applied to the next suspicious
|
|
* stew received from milking this {@link MushroomCow}.
|
|
@@ -95,4 +111,75 @@ public interface MushroomCow extends Cow, io.papermc.paper.entity.Shearable { //
|
|
*/
|
|
BROWN;
|
|
}
|
|
+ // Paper start
|
|
+ /**
|
|
+ * Gets how long the effect applied to stew
|
|
+ * from this mushroom cow is.
|
|
+ *
|
|
+ * @return duration of the effect (in ticks)
|
|
+ * @deprecated Mushroom cows can now hold multiple effects, use {@link #getStewEffects()}
|
|
+ */
|
|
+ @Deprecated(forRemoval = true, since = "1.20.2")
|
|
+ @org.jetbrains.annotations.Contract("-> fail")
|
|
+ default int getStewEffectDuration() {
|
|
+ throw new UnsupportedOperationException("Mushroom cows can now hold multiple effects. Use #getStewEffects");
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Sets how long the effect applied to stew
|
|
+ * from this mushroom cow is.
|
|
+ *
|
|
+ * @param duration duration of the effect (in ticks)
|
|
+ * @deprecated Mushroom cows can now hold multiple effects, use {@link #setStewEffects(java.util.List)}
|
|
+ */
|
|
+ @Deprecated(forRemoval = true, since = "1.20.2")
|
|
+ @org.jetbrains.annotations.Contract("_ -> fail")
|
|
+ default void setStewEffectDuration(int duration) {
|
|
+ throw new UnsupportedOperationException("Mushroom cows can now hold multiple effects. Use #setStewEffects");
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Gets the type of effect applied to stew
|
|
+ * from this mushroom cow is.
|
|
+ *
|
|
+ * @return effect type, or null if an effect is currently not set
|
|
+ * @deprecated Mushroom cows can now hold multiple effects, use {@link #getStewEffects()}
|
|
+ * @throws UnsupportedOperationException
|
|
+ */
|
|
+ @Deprecated(forRemoval = true, since = "1.20.2")
|
|
+ @org.jetbrains.annotations.Contract("-> fail")
|
|
+ default org.bukkit.potion.PotionEffectType getStewEffectType() {
|
|
+ throw new UnsupportedOperationException("Mushroom cows can now hold multiple effects. Use #getStewEffects");
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Sets the type of effect applied to stew
|
|
+ * from this mushroom cow is.
|
|
+ *
|
|
+ * @param type new effect type
|
|
+ * or null if this cow does not give effects
|
|
+ * @deprecated Mushroom cows can now hold multiple effects, use {@link #setStewEffects(java.util.List)}
|
|
+ * @throws UnsupportedOperationException
|
|
+ */
|
|
+ @Deprecated(forRemoval = true, since = "1.20.2")
|
|
+ @org.jetbrains.annotations.Contract("_ -> fail")
|
|
+ default void setStewEffect(@org.jetbrains.annotations.Nullable org.bukkit.potion.PotionEffectType type) {
|
|
+ throw new UnsupportedOperationException("Mushroom cows can now hold multiple effects. Use #setStewEffects");
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Returns an immutable collection of the effects applied to stew
|
|
+ * items for this mushroom cow.
|
|
+ *
|
|
+ * @return immutable effect entry collection
|
|
+ */
|
|
+ java.util.@NotNull @org.jetbrains.annotations.Unmodifiable List<io.papermc.paper.potion.SuspiciousEffectEntry> getStewEffects();
|
|
+
|
|
+ /**
|
|
+ * Sets effects applied to stew items for this mushroom cow.
|
|
+ *
|
|
+ * @param effects effect entry list
|
|
+ */
|
|
+ void setStewEffects(java.util.@NotNull List<io.papermc.paper.potion.SuspiciousEffectEntry> effects);
|
|
+ // Paper end
|
|
}
|
|
diff --git a/src/main/java/org/bukkit/inventory/meta/SuspiciousStewMeta.java b/src/main/java/org/bukkit/inventory/meta/SuspiciousStewMeta.java
|
|
index c2f4282c188e7d8041459cb3acaad674443ba147..c5bfc062fcca56495f44039d83356fc1fd7568d0 100644
|
|
--- a/src/main/java/org/bukkit/inventory/meta/SuspiciousStewMeta.java
|
|
+++ b/src/main/java/org/bukkit/inventory/meta/SuspiciousStewMeta.java
|
|
@@ -32,13 +32,28 @@ public interface SuspiciousStewMeta extends ItemMeta {
|
|
/**
|
|
* Adds a custom potion effect to this suspicious stew.
|
|
*
|
|
+ * @deprecated use {@link #addCustomEffect(io.papermc.paper.potion.SuspiciousEffectEntry, boolean)} as PotionEffect suggests that all attributes are used. In fact, only the PotionEffectType and the duration are used.
|
|
* @param effect the potion effect to add
|
|
* @param overwrite true if any existing effect of the same type should be
|
|
* overwritten
|
|
* @return true if the suspicious stew meta changed as a result of this call
|
|
*/
|
|
+ @Deprecated // Paper - add overloads to use suspicious effect entry to mushroom cow and suspicious stew meta
|
|
boolean addCustomEffect(@NotNull PotionEffect effect, boolean overwrite);
|
|
|
|
+ // Paper start - add overloads to use suspicious effect entry to mushroom cow and suspicious stew meta
|
|
+ /**
|
|
+ * Adds a custom potion effect to this suspicious stew.
|
|
+ *
|
|
+ * @param suspiciousEffectEntry the suspicious effect entry to add
|
|
+ * @param overwrite true if any existing effect of the same type should be
|
|
+ * overwritten
|
|
+ * @return true if the suspicious stew meta changed as a result of this call
|
|
+ * as a result of this call
|
|
+ */
|
|
+ boolean addCustomEffect(@NotNull io.papermc.paper.potion.SuspiciousEffectEntry suspiciousEffectEntry, boolean overwrite);
|
|
+ // Paper end - add overloads to use suspicious effect entry to mushroom cow and suspicious stew meta
|
|
+
|
|
/**
|
|
* Removes a custom potion effect from this suspicious stew.
|
|
*
|