diff --git a/patches/api/0098-Expand-World.spawnParticle-API-and-add-Builder.patch b/patches/api/0098-Expand-World.spawnParticle-API-and-add-Builder.patch index a35e975da3..1ba1794b5d 100644 --- a/patches/api/0098-Expand-World.spawnParticle-API-and-add-Builder.patch +++ b/patches/api/0098-Expand-World.spawnParticle-API-and-add-Builder.patch @@ -10,10 +10,10 @@ This adds a new Builder API which is much friendlier to use. diff --git a/src/main/java/com/destroystokyo/paper/ParticleBuilder.java b/src/main/java/com/destroystokyo/paper/ParticleBuilder.java new file mode 100644 -index 0000000000000000000000000000000000000000..52f639b838e8b49952c560f20bacbad0337f279c +index 0000000000000000000000000000000000000000..970084a788ab5547d16a5e08d4e9d9c769aca67e --- /dev/null +++ b/src/main/java/com/destroystokyo/paper/ParticleBuilder.java -@@ -0,0 +1,583 @@ +@@ -0,0 +1,609 @@ +package com.destroystokyo.paper; + +import com.google.common.base.Preconditions; @@ -455,19 +455,22 @@ index 0000000000000000000000000000000000000000..52f639b838e8b49952c560f20bacbad0 + + /** + * Sets the particle Color. -+ * Only valid for {@link Particle#DUST}. ++ * Only valid for particles with a data type of {@link Color} or {@link Particle.DustOptions}. + * + * @param color the new particle color + * @return a reference to this object. + */ + @NotNull + public ParticleBuilder color(@Nullable Color color) { ++ if (particle.getDataType() == Color.class) { ++ return data(color); ++ } + return color(color, 1); + } + + /** + * Sets the particle Color and size. -+ * Only valid for {@link Particle#DUST}. ++ * Only valid for particles with a data type of {@link Particle.DustOptions}. + * + * @param color the new particle color + * @param size the size of the particle @@ -475,8 +478,8 @@ index 0000000000000000000000000000000000000000..52f639b838e8b49952c560f20bacbad0 + */ + @NotNull + public ParticleBuilder color(@Nullable Color color, float size) { -+ if (particle != Particle.DUST && color != null) { -+ throw new IllegalStateException("Color may only be set on particle DUST."); ++ if (particle.getDataType() != Particle.DustOptions.class && color != null) { ++ throw new IllegalStateException("The combination of Color and size cannot be set on this particle type."); + } + + // We don't officially support reusing these objects, but here we go @@ -493,7 +496,7 @@ index 0000000000000000000000000000000000000000..52f639b838e8b49952c560f20bacbad0 + + /** + * Sets the particle Color. -+ * Only valid for {@link Particle#DUST}. ++ * Only valid for particles with a data type of {@link Color} or {@link Particle.DustOptions}. + * + * @param r red color component + * @param g green color component @@ -507,14 +510,37 @@ index 0000000000000000000000000000000000000000..52f639b838e8b49952c560f20bacbad0 + + /** + * Sets the particle Color. -+ * Only valid for {@link Particle#DUST}. ++ * Only valid for particles with a data type of {@link Color} or {@link Particle.DustOptions}. ++ *

++ * This method detects if the provided color integer is in RGB or ARGB format. ++ * If the alpha channel is zero, it treats the color as RGB. Otherwise, it treats it as ARGB. + * -+ * @param rgb an integer representing the red, green, and blue color components ++ * @param color an integer representing the color components. If the highest byte (alpha channel) is zero, ++ * the color is treated as RGB. Otherwise, it is treated as ARGB. + * @return a reference to this object. + */ + @NotNull -+ public ParticleBuilder color(final int rgb) { -+ return color(Color.fromRGB(rgb)); ++ public ParticleBuilder color(final int color) { ++ int alpha = (color >> 24) & 0xFF; ++ if (alpha == 0) { ++ return color(Color.fromRGB(color)); ++ } ++ return color(Color.fromARGB(color)); ++ } ++ ++ /** ++ * Sets the particle Color. ++ * Only valid for particles with a data type of {@link Color} or {@link Particle.DustOptions}. ++ * ++ * @param a alpha color component ++ * @param r red color component ++ * @param g green color component ++ * @param b blue color component ++ * @return a reference to this object. ++ */ ++ @NotNull ++ public ParticleBuilder color(final int a, final int r, final int g, final int b) { ++ return color(Color.fromARGB(a, r, g, b)); + } + + /**