Upstream/Paper
1
0
Fork 0
mirror of https://github.com/PaperMC/Paper.git synced 2025-01-06 00:07:56 +01:00
Code Issues Projects Releases Wiki Activity

SPIGOT-5751: Clarify behaviour of block drop-related API methods

Browse Source 
By: Lars Dormans <lars.dormans@live.nl>
This commit is contained in:
Bukkit/Spigot 2020-06-03 19:25:33 +10:00
parent 036d0b41dd
commit f8ce884be6
1 changed files with 4 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
paper-api/src/main/java/org/bukkit/block/Block.java
View File

@ -376,7 +376,8 @@ public interface Block extends Metadatable {
PistonMoveReaction getPistonMoveReaction(); PistonMoveReaction getPistonMoveReaction();
/** /**
* Breaks the block and spawns items as if a player had digged it * Breaks the block and spawns items as if a player had digged it regardless
* of the tool.
* *
* @return true if the block was destroyed * @return true if the block was destroyed
*/ */
@ -389,7 +390,7 @@ public interface Block extends Metadatable {
* @param tool The tool or item in hand used for digging * @param tool The tool or item in hand used for digging
* @return true if the block was destroyed * @return true if the block was destroyed
*/ */
boolean breakNaturally(@NotNull ItemStack tool); boolean breakNaturally(@Nullable ItemStack tool);
/** /**
* Returns a list of items which would drop by destroying this block * Returns a list of items which would drop by destroying this block
@ -407,7 +408,7 @@ public interface Block extends Metadatable {
* @return a list of dropped items for this type of block * @return a list of dropped items for this type of block
*/ */
@NotNull @NotNull
Collection<ItemStack> getDrops(@NotNull ItemStack tool); Collection<ItemStack> getDrops(@Nullable ItemStack tool);
/** /**
* Returns a list of items which would drop by the entity destroying this * Returns a list of items which would drop by the entity destroying this