aboutsummaryrefslogtreecommitdiffhomepage
path: root/patches/api/0247-Add-missing-effects.patch
diff options
context:
space:
mode:
Diffstat (limited to 'patches/api/0247-Add-missing-effects.patch')
-rw-r--r--patches/api/0247-Add-missing-effects.patch253
1 files changed, 253 insertions, 0 deletions
diff --git a/patches/api/0247-Add-missing-effects.patch b/patches/api/0247-Add-missing-effects.patch
new file mode 100644
index 0000000000..0e0f224064
--- /dev/null
+++ b/patches/api/0247-Add-missing-effects.patch
@@ -0,0 +1,253 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Ivan Pekov <[email protected]>
+Date: Tue, 5 Jan 2021 10:19:11 +0200
+Subject: [PATCH] Add missing effects
+
+Co-authored-by: Jake Potrebic <[email protected]>
+
+diff --git a/src/main/java/org/bukkit/Effect.java b/src/main/java/org/bukkit/Effect.java
+index fd9cf25f2fdef5ee3b7143f27e5f43dfe3f21a38..f0e595c754afbbf2729ff093262459ac8010ce85 100644
+--- a/src/main/java/org/bukkit/Effect.java
++++ b/src/main/java/org/bukkit/Effect.java
+@@ -131,9 +131,9 @@ public enum Effect {
+ /**
+ * Sound of a block breaking. Needs block ID as additional info.
+ */
+- STEP_SOUND(2001, Type.SOUND, Material.class),
++ STEP_SOUND(2001, Type.SOUND, org.bukkit.block.data.BlockData.class, Material.class), // Paper - block data is more correct, but the impl of the mtehods will still work with Material
+ /**
+- * Visual effect of a splash potion breaking. Needs potion data value as
++ * Visual effect of a splash potion breaking. Needs color data value as
+ * additional info.
+ */
+ POTION_BREAK(2002, Type.VISUAL, Color.class),
+@@ -168,7 +168,9 @@ public enum Effect {
+ PORTAL_TRAVEL(1032, Type.SOUND),
+ /**
+ * The sound played when launching an endereye
++ * @deprecated No longer exists
+ */
++ @Deprecated(forRemoval = true, since = "1.21") // Paper
+ ENDEREYE_LAUNCH(1003, Type.SOUND),
+ /**
+ * The sound played when launching a firework
+@@ -177,7 +179,9 @@ public enum Effect {
+ /**
+ * Particles displayed when a villager grows a plant, data
+ * is the number of particles
++ * @deprecated partially replaced by {@link #BEE_GROWTH}
+ */
++ @Deprecated(forRemoval = true, since = "1.20.5") // Paper
+ VILLAGER_PLANT_GROW(2005, Type.VISUAL, Integer.class),
+ /**
+ * The sound/particles used by the enderdragon's breath
+@@ -336,21 +340,121 @@ public enum Effect {
+ * block.
+ */
+ OXIDISED_COPPER_SCRAPE(3005, Type.VISUAL),
++ // Paper start - add missing effects
++ /**
++ * The sound of a wither spawning
++ */
++ WITHER_SPAWNED(1023, Type.SOUND),
++ /**
++ * The sound of an ender dragon dying
++ */
++ ENDER_DRAGON_DEATH(1028, Type.SOUND),
++ /**
++ * The sound of an ender portal being created in the overworld
++ */
++ END_PORTAL_CREATED_IN_OVERWORLD(1038, Type.SOUND),
++
++ SOUND_STOP_JUKEBOX_SONG(1011, Type.SOUND),
++
++ CRAFTER_CRAFT(1049, Type.SOUND),
++
++ CRAFTER_FAIL(1050, Type.SOUND),
++
++ /**
++ * {@link BlockFace} param is the direction to shoot
++ */
++ SHOOT_WHITE_SMOKE(2010, Type.VISUAL, BlockFace.class),
++
++ /**
++ * {@link Integer} param is the number of particles
++ */
++ BEE_GROWTH(2011, Type.VISUAL, Integer.class),
++
++ /**
++ * {@link Integer} param is the number of particles
++ */
++ TURTLE_EGG_PLACEMENT(2012, Type.VISUAL, Integer.class),
++
++ /**
++ * {@link Integer} param is relative to the number of particles
++ */
++ SMASH_ATTACK(2013, Type.VISUAL, Integer.class),
++
++ PARTICLES_SCULK_CHARGE(3006, Type.VISUAL, Integer.class),
++
++ PARTICLES_SCULK_SHRIEK(3007, Type.SOUND),
++
++ PARTICLES_AND_SOUND_BRUSH_BLOCK_COMPLETE(3008, Type.VISUAL, org.bukkit.block.data.BlockData.class),
++
++ PARTICLES_EGG_CRACK(3009, Type.VISUAL),
++
++ @Deprecated(forRemoval = true, since = "1.20.5")
++ GUST_DUST(3010, Type.VISUAL),
++
++ /**
++ * {@link Boolean} param is true for "ominous" vaults
++ */
++ TRIAL_SPAWNER_SPAWN(3011, Type.VISUAL, Boolean.class),
++
++ /**
++ * {@link Boolean} param is true for "ominous" vaults
++ */
++ TRIAL_SPAWNER_SPAWN_MOB_AT(3012, Type.VISUAL, Boolean.class),
++
++ /**
++ * {@link Integer} param is the number of players
++ */
++ TRIAL_SPAWNER_DETECT_PLAYER(3013, Type.VISUAL, Integer.class),
++
++ TRIAL_SPAWNER_EJECT_ITEM(3014, Type.VISUAL),
++
++ /**
++ * {@link Boolean} param is true for "ominous" vaults
++ */
++ VAULT_ACTIVATE(3015, Type.VISUAL, Boolean.class),
++
++ /**
++ * {@link Boolean} param is true for "ominous" vaults
++ */
++ VAULT_DEACTIVATE(3016, Type.VISUAL, Boolean.class),
++
++ VAULT_EJECT_ITEM(3017, Type.VISUAL),
++
++ SPAWN_COBWEB(3018, Type.VISUAL),
++
++ /**
++ * {@link Integer} param is the number of players
++ */
++ TRIAL_SPAWNER_DETECT_PLAYER_OMINOUS(3019, Type.VISUAL, Integer.class),
++
++ /**
++ * {@link Boolean} param is true for changing to "ominous"
++ */
++ TRIAL_SPAWNER_BECOME_OMINOUS(3020, Type.VISUAL, Boolean.class),
++
++ /**
++ * {@link Boolean} param is true for "ominous" vaults
++ */
++ TRIAL_SPAWNER_SPAWN_ITEM(3021, Type.VISUAL, Boolean.class),
++
++ SOUND_WITH_CHARGE_SHOT(1051, Type.SOUND),
+ ;
++ private static final org.apache.logging.log4j.Logger LOGGER = org.apache.logging.log4j.LogManager.getLogger();
++ // Paper end
+
+ private final int id;
+ private final Type type;
+- private final Class<?> data;
++ private final java.util.List<Class<?>> data; // Paper - support multiple data types
+ private static final Map<Integer, Effect> BY_ID = Maps.newHashMap();
+
+ Effect(int id, /*@NotNull*/ Type type) {
+- this(id, type, null);
++ this(id, type, (Class<?>[]) null); // Paper - support multiple data types
+ }
+
+- Effect(int id, /*@NotNull*/ Type type, /*@Nullable*/ Class<?> data) {
++ Effect(int id, /*@NotNull*/ Type type, /*@Nullable*/ Class<?>...data) { // Paper - support multiple data types
+ this.id = id;
+ this.type = type;
+- this.data = data;
++ this.data = data != null ? java.util.List.of(data) : null; // Paper - support multiple data types
+ }
+
+ /**
+@@ -366,8 +470,10 @@ public enum Effect {
+
+ /**
+ * @return The type of the effect.
++ * @deprecated some effects can be both or neither
+ */
+ @NotNull
++ @Deprecated // Paper - both
+ public Type getType() {
+ return this.type;
+ }
+@@ -378,8 +484,15 @@ public enum Effect {
+ */
+ @Nullable
+ public Class<?> getData() {
+- return this.data;
++ return this.data == null ? null : this.data.get(0); // Paper
++ }
++
++ // Paper start - support deprecated data types
++ @org.jetbrains.annotations.ApiStatus.Internal
++ public boolean isApplicable(Object obj) {
++ return this.data != null && com.google.common.collect.Iterables.any(this.data, aClass -> aClass.isAssignableFrom(obj.getClass()));
+ }
++ // Paper end - support deprecated data types
+
+ /**
+ * Gets the Effect associated with the given ID.
+@@ -396,12 +509,26 @@ public enum Effect {
+
+ static {
+ for (Effect effect : values()) {
++ if (!isDeprecated(effect)) // Paper
+ BY_ID.put(effect.id, effect);
+ }
+ }
+
++ // Paper start
++ private static boolean isDeprecated(Effect effect) {
++ try {
++ return Effect.class.getDeclaredField(effect.name()).isAnnotationPresent(Deprecated.class);
++ } catch (NoSuchFieldException e) {
++ LOGGER.error("Error getting effect enum field {}", effect.name(), e);
++ return false;
++ }
++ }
++ // Paper end
++
+ /**
+ * Represents the type of an effect.
++ * @deprecated not representative of what Effect does
+ */
++ @Deprecated // Paper
+ public enum Type { SOUND, VISUAL }
+ }
+diff --git a/src/test/java/org/bukkit/EffectTest.java b/src/test/java/org/bukkit/EffectTest.java
+index 4344512fa84a2f97a750e06761d8e160c0959f6a..615a4583ef8e70a7c86c28e648d0b57e8e6b9674 100644
+--- a/src/test/java/org/bukkit/EffectTest.java
++++ b/src/test/java/org/bukkit/EffectTest.java
+@@ -5,10 +5,24 @@ import static org.hamcrest.CoreMatchers.*;
+ import org.junit.jupiter.api.Test;
+
+ public class EffectTest {
++ private static final org.apache.logging.log4j.Logger LOGGER = org.apache.logging.log4j.LogManager.getLogger(); // Paper
++
+ @Test
+ public void getById() {
+ for (Effect effect : Effect.values()) {
++ if (!isDeprecated(effect)) // Paper
+ assertThat(Effect.getById(effect.getId()), is(effect));
+ }
+ }
++
++ // Paper start
++ private static boolean isDeprecated(Effect effect) {
++ try {
++ return Effect.class.getDeclaredField(effect.name()).isAnnotationPresent(Deprecated.class);
++ } catch (NoSuchFieldException e) {
++ LOGGER.error("Error getting effect enum field {}", effect.name(), e);
++ return false;
++ }
++ }
++ // Paper end
+ }