mirror of
https://github.com/PaperMC/Paper.git
synced 2024-11-25 03:55:14 +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
149 lines
6.2 KiB
Diff
149 lines
6.2 KiB
Diff
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
From: Jake Potrebic <jake.m.potrebic@gmail.com>
|
|
Date: Fri, 27 Sep 2024 17:12:50 -0700
|
|
Subject: [PATCH] Improve entity effect API
|
|
|
|
|
|
diff --git a/src/main/java/org/bukkit/EntityEffect.java b/src/main/java/org/bukkit/EntityEffect.java
|
|
index 5341957b10cccd7bce5a7595699b1d90412a01d0..ef0acab253db878f1edee51b585fd1b20ef9161d 100644
|
|
--- a/src/main/java/org/bukkit/EntityEffect.java
|
|
+++ b/src/main/java/org/bukkit/EntityEffect.java
|
|
@@ -112,11 +112,25 @@ public enum EntityEffect {
|
|
// 5 - unused
|
|
/**
|
|
* The smoke when taming an entity fails.
|
|
+ * @deprecated use {@link EntityEffect#TAMING_FAILED}
|
|
*/
|
|
+ @Deprecated(since = "1.21") // Paper
|
|
WOLF_SMOKE(6, Tameable.class),
|
|
+ // Paper start - rename "wolf" effects
|
|
+ /**
|
|
+ * The smoke when taming an entity fails.
|
|
+ */
|
|
+ TAMING_FAILED(6, Tameable.class),
|
|
+ /**
|
|
+ * The hearts when taming an entity succeeds.
|
|
+ */
|
|
+ TAMING_SUCCEEDED(7, Tameable.class),
|
|
+ // Paper end - rename "wolf" effects
|
|
/**
|
|
* The hearts when taming an entity succeeds.
|
|
+ * @deprecated use {@link EntityEffect#TAMING_SUCCEEDED}
|
|
*/
|
|
+ @Deprecated(since = "1.21") // Paper
|
|
WOLF_HEARTS(7, Tameable.class),
|
|
/**
|
|
* When a wolf shakes (after being wet).
|
|
@@ -204,7 +218,9 @@ public enum EntityEffect {
|
|
ARMOR_STAND_HIT(32, ArmorStand.class),
|
|
/**
|
|
* Entity hurt by thorns attack.
|
|
+ * @deprecated in favor of {@link LivingEntity#playHurtAnimation(float)} or {@link Entity#broadcastHurtAnimation(java.util.Collection)}
|
|
*/
|
|
+ @Deprecated(since = "1.19.4", forRemoval = true) // Paper
|
|
THORNS_HURT(33, LivingEntity.class),
|
|
/**
|
|
* Iron golem puts away rose.
|
|
@@ -216,11 +232,15 @@ public enum EntityEffect {
|
|
TOTEM_RESURRECT(35, LivingEntity.class),
|
|
/**
|
|
* Entity hurt due to drowning damage.
|
|
+ * @deprecated in favor of {@link LivingEntity#playHurtAnimation(float)} or {@link Entity#broadcastHurtAnimation(java.util.Collection)}
|
|
*/
|
|
+ @Deprecated(since = "1.19.4", forRemoval = true)
|
|
HURT_DROWN(36, LivingEntity.class),
|
|
/**
|
|
* Entity hurt due to explosion damage.
|
|
+ * @deprecated in favor of {@link LivingEntity#playHurtAnimation(float)} or {@link Entity#broadcastHurtAnimation(java.util.Collection)}
|
|
*/
|
|
+ @Deprecated(since = "1.19.4", forRemoval = true)
|
|
HURT_EXPLOSION(37, LivingEntity.class),
|
|
/**
|
|
* Dolphin has been fed and is locating a structure.
|
|
@@ -244,11 +264,15 @@ public enum EntityEffect {
|
|
VILLAGER_SPLASH(42, Villager.class),
|
|
/**
|
|
* Player's bad omen effect removed to start or increase raid difficult.
|
|
+ * @deprecated raid system was overhauled in 1.20.5
|
|
*/
|
|
+ @Deprecated(since = "1.20.5", forRemoval = true)
|
|
PLAYER_BAD_OMEN_RAID(43, Player.class),
|
|
/**
|
|
* Entity hurt due to berry bush. Prickly!
|
|
+ * @deprecated in favor of {@link LivingEntity#playHurtAnimation(float)} or {@link Entity#broadcastHurtAnimation(java.util.Collection)}
|
|
*/
|
|
+ @Deprecated(since = "1.19.4", forRemoval = true)
|
|
HURT_BERRY_BUSH(44, LivingEntity.class),
|
|
/**
|
|
* Fox chews the food in its mouth
|
|
@@ -331,7 +355,25 @@ public enum EntityEffect {
|
|
* Sniffer must have a target and be in {@link Sniffer.State#SEARCHING} or
|
|
* {@link Sniffer.State#DIGGING}
|
|
*/
|
|
- SNIFFER_DIG(63, Sniffer.class);
|
|
+ SNIFFER_DIG(63, Sniffer.class),
|
|
+ // Paper start - add missing EntityEffect
|
|
+ /**
|
|
+ * Armadillo peeks out of its shell
|
|
+ */
|
|
+ ARMADILLO_PEEK(64, org.bukkit.entity.Armadillo.class),
|
|
+ /**
|
|
+ * {@link org.bukkit.inventory.EquipmentSlot#BODY} armor piece breaks
|
|
+ */
|
|
+ BODY_BREAK(65, LivingEntity.class),
|
|
+ /**
|
|
+ * A creaking transient shaking when being hit.
|
|
+ * Does not apply to plain creaking entities as they are not invulnerable like the transient ones spawned by the
|
|
+ * creaking heart.
|
|
+ */
|
|
+ @MinecraftExperimental(MinecraftExperimental.Requires.WINTER_DROP)
|
|
+ @org.jetbrains.annotations.ApiStatus.Experimental
|
|
+ SHAKE(66, org.bukkit.entity.CreakingTransient.class);
|
|
+ // Paper end - add missing EntityEffect
|
|
|
|
private final byte data;
|
|
private final Class<? extends Entity> applicable;
|
|
diff --git a/src/main/java/org/bukkit/entity/Entity.java b/src/main/java/org/bukkit/entity/Entity.java
|
|
index 725ef320f929d5e3d141c1ed3246d73a7d741f31..d0ae8a94db20281d3664d74718c65234eb2e5f83 100644
|
|
--- a/src/main/java/org/bukkit/entity/Entity.java
|
|
+++ b/src/main/java/org/bukkit/entity/Entity.java
|
|
@@ -1159,4 +1159,17 @@ public interface Entity extends Metadatable, CommandSender, Nameable, Persistent
|
|
*/
|
|
@NotNull String getScoreboardEntryName();
|
|
// Paper end - entity scoreboard name
|
|
+
|
|
+ // Paper start - broadcast hurt animation
|
|
+ /**
|
|
+ * Broadcasts a hurt animation. This fakes incoming damage towards the target entity.
|
|
+ * <p>
|
|
+ * The target players cannot include {@code this} player. For self-damage, use
|
|
+ * {@link Player#sendHurtAnimation(float)}.
|
|
+ *
|
|
+ * @param players the players to broadcast to (cannot include {@code this}
|
|
+ * @throws IllegalArgumentException if {@code this} is contained in {@code players}
|
|
+ */
|
|
+ void broadcastHurtAnimation(@NotNull java.util.Collection<Player> players);
|
|
+ // Paper end - broadcast hurt animation
|
|
}
|
|
diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java
|
|
index 82e92579f899ab3b86c748ba01860262b8ffa17f..95f0b3186e313c7fbd5c8531d52b82a69e525f94 100644
|
|
--- a/src/main/java/org/bukkit/entity/Player.java
|
|
+++ b/src/main/java/org/bukkit/entity/Player.java
|
|
@@ -3899,4 +3899,16 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM
|
|
@Override
|
|
Spigot spigot();
|
|
// Spigot end
|
|
+
|
|
+ // Paper start - entity effect API
|
|
+ /**
|
|
+ * Plays an entity effect to this player for the target entity
|
|
+ * <p>
|
|
+ * If the effect is not applicable to this class of entity, it will not play.
|
|
+ *
|
|
+ * @param effect the entity effect
|
|
+ * @param target the target entity
|
|
+ */
|
|
+ void sendEntityEffect(org.bukkit.@NotNull EntityEffect effect, @NotNull Entity target);
|
|
+ // Paper end - entity effect API
|
|
}
|