mirrors/papermc
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

Add missing Entity + Projectile API (#7632)

Browse source
This commit is contained in:
Owen1212055 2022-10-11 17:04:26 -04:00
parent 9ff21585db
commit e7535118d9
6 changed files with 1113 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

424
patches/api/Missing-Entity-Behavior-API.patch
View file

@ -5,12 +5,30 @@ Subject: [PATCH] Missing Entity Behavior API
Co-authored-by: Nassim Jahnke <nassim@njahnke.dev>
Co-authored-by: Jake Potrebic <jake.m.potrebic@gmail.com>
Co-authored-by: William Blake Galbreath <blake.galbreath@gmail.com>
diff --git a/src/main/java/org/bukkit/entity/AbstractHorse.java b/src/main/java/org/bukkit/entity/AbstractHorse.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/AbstractHorse.java
+++ b/src/main/java/org/bukkit/entity/AbstractHorse.java
@@ -0,0 +0,0 @@ public interface AbstractHorse extends Vehicle, InventoryHolder, Tameable {
* Gets whether the horse is currently grazing hay.
*
* @return true if eating hay
+ * @deprecated use {@link #isEatingGrass()}, this name is incorrect
*/
+ @Deprecated // Paper - Horse API
boolean isEatingHaystack();
/**
* Sets whether the horse is grazing hay.
*
* @param eatingHaystack new hay grazing status
+ * @deprecated use {@link #setEatingGrass(boolean)}, this name is incorrect
*/
+ @Deprecated // Paper - Horse API
void setEatingHaystack(boolean eatingHaystack);
@NotNull
@Override
public AbstractHorseInventory getInventory();
@ -20,9 +38,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ * Gets if a horse is in their eating grass animation.
+ *
+ * @return eating grass animation is active
+ * @deprecated use {@link #isEatingHaystack()}
+ */
+ @Deprecated
+ public boolean isEatingGrass();
+
+ /**
@ -33,7 +49,6 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ * @param eating eating grass animation is active
+ * @deprecated use {@link #setEatingHaystack(boolean)}
+ */
+ @Deprecated
+ public void setEatingGrass(boolean eating);
+
+ /**
@ -69,6 +84,34 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ public void setEating(boolean eating);
+ // Paper end - Horse API
}
diff --git a/src/main/java/org/bukkit/entity/Bat.java b/src/main/java/org/bukkit/entity/Bat.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Bat.java
+++ b/src/main/java/org/bukkit/entity/Bat.java
@@ -0,0 +0,0 @@ public interface Bat extends Ambient {
* @param state the new state
*/
void setAwake(boolean state);
+
+ // Paper start
+ /**
+ * Gets the location that this bat is currently trying to move towards.
+ *
+ * @return target location, or null if it's going to find a new location
+ */
+ @org.jetbrains.annotations.Nullable
+ org.bukkit.Location getTargetLocation();
+
+ /**
+ * Sets the location that this bat is currently trying to move towards.
+ * <p>
+ * This can be set to null to cause the bat to recalculate its target location
+ *
+ * @param location location to move towards (world is ignored, will always use the entity's world)
+ */
+ void setTargetLocation(@org.jetbrains.annotations.Nullable org.bukkit.Location location);
+ // Paper end
}
diff --git a/src/main/java/org/bukkit/entity/Bee.java b/src/main/java/org/bukkit/entity/Bee.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Bee.java
@ -100,6 +143,34 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ * @return is rolling
+ */
+ boolean isRolling();
+
+ /**
+ * Sets how many crops this bee has grown since it last
+ * pollinated.
+ * @param crops number of crops
+ */
+ void setCropsGrownSincePollination(int crops);
+
+ /**
+ * Gets how many crops this bee has grown since it last
+ * pollinated.
+ * @return number of crops
+ */
+ int getCropsGrownSincePollination();
+
+ /**
+ * Sets how many ticks this bee has gone without pollinating.
+ *
+ * @param ticks number of ticks
+ */
+ void setTicksSincePollination(int ticks);
+
+ /**
+ * Gets how many ticks this bee has gone without pollinating
+ *
+ * @return number of ticks
+ */
+ int getTicksSincePollination();
+ // Paper end
}
diff --git a/src/main/java/org/bukkit/entity/Cat.java b/src/main/java/org/bukkit/entity/Cat.java
@ -143,6 +214,47 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ public boolean isHeadUp();
+ // Paper End - More cat api
}
diff --git a/src/main/java/org/bukkit/entity/Chicken.java b/src/main/java/org/bukkit/entity/Chicken.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Chicken.java
+++ b/src/main/java/org/bukkit/entity/Chicken.java
@@ -0,0 +0,0 @@ package org.bukkit.entity;
/**
* Represents a Chicken.
*/
-public interface Chicken extends Animals {}
+// Paper start
+public interface Chicken extends Animals {
+
+ /**
+ * Gets if this chicken was spawned as a chicken jockey.
+ *
+ * @return is chicken jockey
+ */
+ boolean isChickenJockey();
+
+ /**
+ * Sets if this chicken was spawned as a chicken jockey.
+ *
+ * @param isChickenJockey is chicken jockey
+ */
+ void setIsChickenJockey(boolean isChickenJockey);
+
+ /**
+ * Gets the number of ticks till this chicken lays an egg.
+ *
+ * @return ticks till the chicken lays an egg
+ */
+ int getEggLayTime();
+
+ /**
+ * Sets the number of ticks till this chicken lays an egg.
+ *
+ * @param eggLayTime ticks till the chicken lays an egg
+ */
+ void setEggLayTime(int eggLayTime);
+}
+// Paper end
diff --git a/src/main/java/org/bukkit/entity/Enderman.java b/src/main/java/org/bukkit/entity/Enderman.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Enderman.java
@ -182,6 +294,33 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ * @param hasBeenStaredAt whether the enderman has been stared at
+ */
+ void setHasBeenStaredAt(boolean hasBeenStaredAt);
+ // Paper end
}
diff --git a/src/main/java/org/bukkit/entity/Endermite.java b/src/main/java/org/bukkit/entity/Endermite.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Endermite.java
+++ b/src/main/java/org/bukkit/entity/Endermite.java
@@ -0,0 +0,0 @@ public interface Endermite extends Monster {
*/
@Deprecated
void setPlayerSpawned(boolean playerSpawned);
+ // Paper start
+ /**
+ * Sets how many ticks this endermite has been living for.
+ * If this value is greater than 2400, this endermite will despawn.
+ *
+ * @param ticks lifetime ticks
+ */
+ void setLifetimeTicks(int ticks);
+
+ /**
+ * Gets how long this endermite has been living for.
+ * This value will tick up while {@link LivingEntity#getRemoveWhenFarAway()} is false.
+ * If this value is greater than 2400, this endermite will despawn.
+ *
+ * @return lifetime ticks
+ */
+ int getLifetimeTicks();
+ // Paper end
}
diff --git a/src/main/java/org/bukkit/entity/Fox.java b/src/main/java/org/bukkit/entity/Fox.java
@ -268,6 +407,112 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ * @throws IllegalArgumentException if the explosion power is less than 0 or greater than 127
+ */
+ void setExplosionPower(int explosionPower);
+ // Paper end
}
diff --git a/src/main/java/org/bukkit/entity/Llama.java b/src/main/java/org/bukkit/entity/Llama.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Llama.java
+++ b/src/main/java/org/bukkit/entity/Llama.java
@@ -0,0 +0,0 @@ public interface Llama extends ChestedHorse, RangedEntity { // Paper
@NotNull
@Override
LlamaInventory getInventory();
+
+ // Paper start
+ /**
+ * Checks if this llama is in a caravan.
+ * This means that this llama is currently following
+ * another llama.
+ *
+ * @return is in caravan
+ */
+ boolean inCaravan();
+
+ /**
+ * Joins a caravan, with the provided llama being the leader
+ * of the caravan.
+ * This llama will then follow the provided llama.
+ *
+ * @param llama head of caravan to join
+ */
+ void joinCaravan(@NotNull Llama llama);
+
+ /**
+ * Leaves the current caravan that they are in.
+ */
+ void leaveCaravan();
+
+ /**
+ * Get the llama that this llama is following.
+ * <p>
+ * Does not necessarily mean the leader of the entire caravan.
+ *
+ * @return the llama currently being followed
+ */
+ @org.jetbrains.annotations.Nullable
+ Llama getCaravanHead();
+
+ /**
+ * Checks if another llama is currently following behind
+ * this llama.
+ *
+ * @return true if being followed in the caravan
+ */
+ boolean hasCaravanTail();
+
+ /**
+ * Gets the llama that is currently following behind
+ * this llama.
+ *
+ * @return the llama following this llama, or null if none is following them
+ */
+ @org.jetbrains.annotations.Nullable
+ Llama getCaravanTail();
+ // Paper end
}
diff --git a/src/main/java/org/bukkit/entity/MushroomCow.java b/src/main/java/org/bukkit/entity/MushroomCow.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/MushroomCow.java
+++ b/src/main/java/org/bukkit/entity/MushroomCow.java
@@ -0,0 +0,0 @@ public interface MushroomCow extends Cow {
*/
BROWN;
}
+ // Paper start
+
+ /**
+ * Gets how long the effect applied to stew
+ * from this mushroom cow is.
+ *
+ * @return duration of the effect (in ticks)
+ */
+ int getStewEffectDuration();
+
+ /**
+ * Sets how long the effect applied to stew
+ * from this mushroom cow is.
+ *
+ * @param duration duration of the effect (in ticks)
+ */
+ void setStewEffectDuration(int duration);
+
+ /**
+ * 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
+ */
+ @org.jetbrains.annotations.Nullable
+ org.bukkit.potion.PotionEffectType getStewEffectType();
+
+ /**
+ * 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
+ */
+ void setStewEffect(@org.jetbrains.annotations.Nullable org.bukkit.potion.PotionEffectType type);
+ // Paper end
}
diff --git a/src/main/java/org/bukkit/entity/Panda.java b/src/main/java/org/bukkit/entity/Panda.java
@ -362,6 +607,32 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
public enum Gene {
NORMAL(false),
diff --git a/src/main/java/org/bukkit/entity/Phantom.java b/src/main/java/org/bukkit/entity/Phantom.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Phantom.java
+++ b/src/main/java/org/bukkit/entity/Phantom.java
@@ -0,0 +0,0 @@ public interface Phantom extends Flying {
* @param shouldBurnInDay True to burn in sunlight
*/
public void setShouldBurnInDay(boolean shouldBurnInDay);
+
+ /**
+ * Gets the location that this phantom circles around when not attacking a player
+ * This will be changed after attacking a player.
+ *
+ * @return circling location
+ */
+ @org.jetbrains.annotations.NotNull
+ org.bukkit.Location getAnchorLocation();
+
+ /**
+ * Sets the location that this phantom circles around when not attacking a player
+ *
+ * @param location circling location (world is ignored, will always use the entity's world)
+ */
+ void setAnchorLocation(@org.jetbrains.annotations.NotNull org.bukkit.Location location);
// Paper end
}
diff --git a/src/main/java/org/bukkit/entity/Piglin.java b/src/main/java/org/bukkit/entity/Piglin.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Piglin.java
@ -417,6 +688,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ * @param standing whether the polar bear should be standing
+ */
+ void setStanding(boolean standing);
+
+}
+// Paper end
diff --git a/src/main/java/org/bukkit/entity/Raider.java b/src/main/java/org/bukkit/entity/Raider.java
@ -444,6 +716,73 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ void setCelebrating(boolean celebrating);
+ // Paper end
}
diff --git a/src/main/java/org/bukkit/entity/Ravager.java b/src/main/java/org/bukkit/entity/Ravager.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Ravager.java
+++ b/src/main/java/org/bukkit/entity/Ravager.java
@@ -0,0 +0,0 @@ package org.bukkit.entity;
/**
* Illager beast.
*/
-public interface Ravager extends Raider { }
+// Paper start - Missing Entity Behavior
+public interface Ravager extends Raider {
+
+ /**
+ * Gets how many ticks this ravager is attacking for.
+ * When attacking, the ravager cannot move.
+ *
+ * @return ticks attacking or -1 if they are currently not attacking
+ */
+ int getAttackTicks();
+
+ /**
+ * Sets how many ticks this ravager is attacking for.
+ * When attacking, the ravager cannot move.
+ * This will tick down till it gets to -1, where this ravager will no longer be attacking.
+ *
+ * @param ticks ticks attacking or -1 if they should no longer be attacking
+ */
+ void setAttackTicks(int ticks);
+
+ /**
+ * Gets how many ticks the ravager is stunned for.
+ * The ravager cannot move or attack while stunned.
+ * At 0, this will cause the ravager to roar.
+ *
+ * @return ticks stunned or -1 if they are currently not stunned
+ */
+ int getStunnedTicks();
+
+ /**
+ * Sets how many ticks the ravager is stunned for.
+ * The ravager cannot move or attack while stunned.
+ * At 0, this will cause the ravager to roar.
+ *
+ * @param ticks ticks stunned or -1 if they should no longer be stunned
+ */
+ void setStunnedTicks(int ticks);
+
+ /**
+ * Gets how many ticks the ravager is roaring for.
+ * While roaring, the ravager cannot move
+ *
+ * @return ticks roaring or -1 if they are currently not roaring
+ */
+ int getRoarTicks();
+
+ /**
+ * Sets how many ticks the ravager is roaring for.
+ * While roaring, the ravager cannot move
+ * This will tick down till it gets to -1, where it is no longer active.
+ * If set to 11, this will play a sound and hurt nearby players.
+ *
+ * @param ticks ticks roaring or -1 if they should no longer be roaring
+ */
+ void setRoarTicks(int ticks);
+
+}
+// Paper end
diff --git a/src/main/java/org/bukkit/entity/Trident.java b/src/main/java/org/bukkit/entity/Trident.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Trident.java
@ -563,6 +902,37 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ void setLimitedLifetimeTicks(int ticks);
// Paper end
}
diff --git a/src/main/java/org/bukkit/entity/WanderingTrader.java b/src/main/java/org/bukkit/entity/WanderingTrader.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/WanderingTrader.java
+++ b/src/main/java/org/bukkit/entity/WanderingTrader.java
@@ -0,0 +0,0 @@ public interface WanderingTrader extends AbstractVillager {
* @return whether the mob will drink
*/
public boolean canDrinkMilk();
+
+ /**
+ * Gets the location that this wandering trader is currently
+ * wandering towards.
+ * <p>
+ * This will return null if the wandering trader has finished
+ * wandering towards the given location.
+ *
+ * @return the location currently wandering towards, or null if not wandering
+ */
+ @org.jetbrains.annotations.Nullable
+ org.bukkit.Location getWanderingTowards();
+
+ /**
+ * Sets the location that this wandering trader is currently wandering towards.
+ * <p>
+ * This can be set to null to prevent the wandering trader from wandering further.
+ *
+ * @param location location to wander towards (world is ignored, will always use the entity's world)
+ */
+ void setWanderingTowards(@org.jetbrains.annotations.Nullable org.bukkit.Location location);
// Paper end
}
diff --git a/src/main/java/org/bukkit/entity/Warden.java b/src/main/java/org/bukkit/entity/Warden.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/Warden.java
@ -653,3 +1023,51 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
+ void setConversionTime(int time, boolean broadcastEntityEvent);
+ // Paper stop - missing entity behaviour api - converting without entity event
}
diff --git a/src/main/java/org/bukkit/entity/minecart/ExplosiveMinecart.java b/src/main/java/org/bukkit/entity/minecart/ExplosiveMinecart.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/minecart/ExplosiveMinecart.java
+++ b/src/main/java/org/bukkit/entity/minecart/ExplosiveMinecart.java
@@ -0,0 +0,0 @@ import org.bukkit.entity.Minecart;
* Represents a Minecart with TNT inside it that can explode when triggered.
*/
public interface ExplosiveMinecart extends Minecart {
+ // Paper start - Entity API
+ /**
+ * Set the number of ticks until the minecart explodes after being primed.
+ *
+ * @param fuseTicks fuse ticks or -1 if the fuse isn't primed
+ */
+ void setFuseTicks(int fuseTicks);
+
+ /**
+ * Retrieve the number of ticks until the explosive minecart explodes
+ *
+ * @return number of ticks or -1 if the fuse isn't primed
+ */
+ int getFuseTicks();
+ // Paper end
}
diff --git a/src/main/java/org/bukkit/entity/minecart/HopperMinecart.java b/src/main/java/org/bukkit/entity/minecart/HopperMinecart.java
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
--- a/src/main/java/org/bukkit/entity/minecart/HopperMinecart.java
+++ b/src/main/java/org/bukkit/entity/minecart/HopperMinecart.java
@@ -0,0 +0,0 @@ public interface HopperMinecart extends Minecart, InventoryHolder, LootableEntit
* @param enabled new enabled state
*/
void setEnabled(boolean enabled);
+ // Paper start
+ /**
+ * Gets the number of ticks that this hopper minecart cannot pickup items up for.
+ *
+ * @return ticks left on cooldown
+ */
+ int getPickupCooldown();
+
+ /**
+ * Sets the number of ticks that this hopper minecart cannot pickup items for.
+ *
+ * @param cooldown cooldown length in ticks
+ */
+ void setPickupCooldown(int cooldown);
+ // Paper end
}