Spigot / Bukkit / 08f86d1ce25

Commits

coll1234567 authored and md_5 committed 08f86d1ce25 03 Feb 2024

#971: Add Player methods for client-side potion effects

src/main/java/org/bukkit/entity/Player.java

Modified

-36
+import org.bukkit.conversations.Conversable;
-37
+import org.bukkit.event.block.BlockBreakEvent;
-38
+import org.bukkit.event.block.BlockDropItemEvent;
-39
+import org.bukkit.event.player.PlayerExpCooldownChangeEvent;
-40
+import org.bukkit.event.player.PlayerResourcePackStatusEvent;
-41
+import org.bukkit.inventory.EquipmentSlot;
-42
+import org.bukkit.inventory.ItemStack;
-43
+import org.bukkit.map.MapView;
-44
+import org.bukkit.plugin.Plugin;
-45
+import org.bukkit.plugin.messaging.PluginMessageRecipient;
-+
+import org.bukkit.potion.PotionEffect;
-+
+import org.bukkit.potion.PotionEffectType;
-48
+import org.bukkit.profile.PlayerProfile;
-49
+import org.bukkit.scoreboard.Scoreboard;
-50
+import org.jetbrains.annotations.ApiStatus;
-51
+import org.jetbrains.annotations.NotNull;
-52
+import org.jetbrains.annotations.Nullable;
-53
-54
+/**
-55
+ * Represents a player, connected or not
-56
+ */
-57
+public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginMessageRecipient {
-920
+     * {@link BlockData#createBlockState()} can be used to create a {@link BlockState}.
-921
+     *
-922
+     * @param loc the location of the sign
-923
+     * @param tileState the tile state
-924
+     * @throws IllegalArgumentException if location is null
-925
+     * @throws IllegalArgumentException if tileState is null
-926
+     */
-927
+    @ApiStatus.Experimental
-928
+    public void sendBlockUpdate(@NotNull Location loc, @NotNull TileState tileState) throws IllegalArgumentException;
-929
-+
+    /**
-+
+     * Change a potion effect for the target entity. This will not actually
-+
+     * change the entity's potion effects in any way.
-+
+     * <p>
-+
+     * <b>Note:</b> Sending an effect change to a player for themselves may
-+
+     * cause unexpected behavior on the client. Effects sent this way will also
-+
+     * not be removed when their timer reaches 0, they can be removed with
-+
+     * {@link #sendPotionEffectChangeRemove(LivingEntity, PotionEffectType)}
-+
+     *
-+
+     * @param entity the entity whose potion effects to change
-+
+     * @param effect the effect to change
-+
+     */
-+
+    public void sendPotionEffectChange(@NotNull LivingEntity entity, @NotNull PotionEffect effect);
-+
-+
+    /**
-+
+     * Remove a potion effect for the target entity. This will not actually
-+
+     * change the entity's potion effects in any way.
-+
+     * <p>
-+
+     * <b>Note:</b> Sending an effect change to a player for themselves may
-+
+     * cause unexpected behavior on the client.
-+
+     *
-+
+     * @param entity the entity whose potion effects to change
-+
+     * @param type the effect type to remove
-+
+     */
-+
+    public void sendPotionEffectChangeRemove(@NotNull LivingEntity entity, @NotNull PotionEffectType type);
-+
-956
+    /**
-957
+     * Render a map and send it to the player in its entirety. This may be
-958
+     * used when streaming the map in the normal manner is not desirable.
-959
+     *
-960
+     * @param map The map to be sent
-961
+     */
-962
+    public void sendMap(@NotNull MapView map);
-963
-964
+    /**
-965
+     * Send a hurt animation. This fakes incoming damage towards the player from

Bukkit

Commits

Jira Issues

Add shortcut