coll1234567 / Bukkit / e938d62afac

Commits

Parker Hawke authored and md_5 committed e938d62afac 02 Apr 2023

#819: Allow Player#sendBlockDamage() to specify a source entity

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

Modified

-535
+     * responsibility of the caller to ensure that the client is within range
-536
+     * of the changed blocks or to handle any side effects caused as a result.
-537
+     *
-538
+     * @param blocks the block states to send to the player
-539
+     * @param suppressLightUpdates whether or not light updates should be
-540
+     * suppressed when updating the blocks on the client
-541
+     */
-542
+    public void sendBlockChanges(@NotNull Collection<BlockState> blocks, boolean suppressLightUpdates);
-543
-544
+    /**
--
+     * Send block damage. This fakes block break progress for a user at a
--
+     * certain location. This will not actually change the block's break
-+
+     * Send block damage. This fakes block break progress at a certain location
-+
+     * sourced by this player. This will not actually change the block's break
-547
+     * progress in any way.
-548
+     *
-549
+     * @param loc the location of the damaged block
-550
+     * @param progress the progress from 0.0 - 1.0 where 0 is no damage and
-551
+     * 1.0 is the most damaged
-552
+     */
-553
+    public void sendBlockDamage(@NotNull Location loc, float progress);
-554
-+
+    /**
-+
+     * Send block damage. This fakes block break progress at a certain location
-+
+     * sourced by the provided entity. This will not actually change the block's
-+
+     * break progress in any way.
-+
+     * <p>
-+
+     * At the same location for each unique damage source sent to the player, a
-+
+     * separate damage overlay will be displayed with the given progress. This allows
-+
+     * for block damage at different progress from multiple entities at once.
-+
+     *
-+
+     * @param loc the location of the damaged block
-+
+     * @param progress the progress from 0.0 - 1.0 where 0 is no damage and
-+
+     * 1.0 is the most damaged
-+
+     * @param source the entity to which the damage belongs
-+
+     */
-+
+    public void sendBlockDamage(@NotNull Location loc, float progress, @NotNull Entity source);
-+
-+
+    /**
-+
+     * Send block damage. This fakes block break progress at a certain location
-+
+     * sourced by the provided entity id. This will not actually change the block's
-+
+     * break progress in any way.
-+
+     * <p>
-+
+     * At the same location for each unique damage source sent to the player, a
-+
+     * separate damage overlay will be displayed with the given progress. This allows
-+
+     * for block damage at different progress from multiple entities at once.
-+
+     *
-+
+     * @param loc the location of the damaged block
-+
+     * @param progress the progress from 0.0 - 1.0 where 0 is no damage and
-+
+     * 1.0 is the most damaged
-+
+     * @param sourceId the entity id of the entity to which the damage belongs.
-+
+     * Can be an id that does not associate directly with an existing or loaded entity.
-+
+     */
-+
+    public void sendBlockDamage(@NotNull Location loc, float progress, int sourceId);
-+
-588
+    /**
-589
+     * Send an equipment change for the target entity. This will not
-590
+     * actually change the entity's equipment in any way.
-591
+     *
-592
+     * @param entity the entity whose equipment to change
-593
+     * @param slot the slot to change
-594
+     * @param item the item to which the slot should be changed, or null to set
-595
+     * it to air
-596
+     */
-597
+    public void sendEquipmentChange(@NotNull LivingEntity entity, @NotNull EquipmentSlot slot, @Nullable ItemStack item);

Bukkit

Commits

Jira Issues

Add shortcut