mirror of
https://github.com/PaperMC/Paper.git
synced 2024-12-11 11:50:06 +01:00
96d5e6ca48
Currently includes generated key holder classes for types used in the Registry Modification API
243 lines
8.4 KiB
Diff
243 lines
8.4 KiB
Diff
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
From: Jake Potrebic <jake.m.potrebic@gmail.com>
|
|
Date: Sat, 21 May 2022 20:59:56 -0700
|
|
Subject: [PATCH] Add BlockLockCheckEvent
|
|
|
|
|
|
diff --git a/src/main/java/io/papermc/paper/block/LockableTileState.java b/src/main/java/io/papermc/paper/block/LockableTileState.java
|
|
new file mode 100644
|
|
index 0000000000000000000000000000000000000000..f309961e0e96b6baacc4fe6d80dabd6c7c5d2e1d
|
|
--- /dev/null
|
|
+++ b/src/main/java/io/papermc/paper/block/LockableTileState.java
|
|
@@ -0,0 +1,11 @@
|
|
+package io.papermc.paper.block;
|
|
+
|
|
+import org.bukkit.Nameable;
|
|
+import org.bukkit.block.Lockable;
|
|
+import org.bukkit.block.TileState;
|
|
+
|
|
+/**
|
|
+ * Interface for tile entities that are lockable.
|
|
+ */
|
|
+public interface LockableTileState extends TileState, Lockable, Nameable {
|
|
+}
|
|
diff --git a/src/main/java/io/papermc/paper/event/block/BlockLockCheckEvent.java b/src/main/java/io/papermc/paper/event/block/BlockLockCheckEvent.java
|
|
new file mode 100644
|
|
index 0000000000000000000000000000000000000000..d298ebecaa6e0a4cdc273e326d1976d27efe0e32
|
|
--- /dev/null
|
|
+++ b/src/main/java/io/papermc/paper/event/block/BlockLockCheckEvent.java
|
|
@@ -0,0 +1,187 @@
|
|
+package io.papermc.paper.event.block;
|
|
+
|
|
+import com.google.common.base.Preconditions;
|
|
+import io.papermc.paper.block.LockableTileState;
|
|
+import net.kyori.adventure.sound.Sound;
|
|
+import net.kyori.adventure.text.Component;
|
|
+import org.bukkit.Nameable;
|
|
+import org.bukkit.block.Block;
|
|
+import org.bukkit.block.BlockState;
|
|
+import org.bukkit.block.Lockable;
|
|
+import org.bukkit.block.TileState;
|
|
+import org.bukkit.entity.Player;
|
|
+import org.bukkit.event.HandlerList;
|
|
+import org.bukkit.event.block.BlockEvent;
|
|
+import org.bukkit.inventory.ItemStack;
|
|
+import org.jetbrains.annotations.NotNull;
|
|
+import org.jetbrains.annotations.Nullable;
|
|
+
|
|
+import java.util.Objects;
|
|
+
|
|
+/**
|
|
+ * Called when the server tries to check the lock on a lockable tile entity.
|
|
+ * @see #setResult(Result) to change behavior
|
|
+ */
|
|
+public class BlockLockCheckEvent extends BlockEvent {
|
|
+
|
|
+ private static final HandlerList HANDLER_LIST = new HandlerList();
|
|
+
|
|
+ private final LockableTileState state;
|
|
+ private final Player player;
|
|
+ private ItemStack itemStack;
|
|
+ private Result result = Result.DEFAULT;
|
|
+ private Component lockedMessage;
|
|
+ private Sound lockedSound;
|
|
+
|
|
+ public BlockLockCheckEvent(final @NotNull Block block, final @NotNull LockableTileState state, final @NotNull Player player, final @NotNull Component lockedMessage, final @NotNull Sound lockedSound) {
|
|
+ super(block);
|
|
+ this.state = state;
|
|
+ this.player = player;
|
|
+ this.lockedMessage = lockedMessage;
|
|
+ this.lockedSound = lockedSound;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Gets the snapshot {@link LockableTileState} of the tile entity
|
|
+ * whose lock is being checked.
|
|
+ *
|
|
+ * @return the snapshot block state.
|
|
+ */
|
|
+ public @NotNull LockableTileState getBlockState() {
|
|
+ return this.state;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Get the player involved this lock check.
|
|
+ *
|
|
+ * @return the player
|
|
+ */
|
|
+ public @NotNull Player getPlayer() {
|
|
+ return this.player;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Gets the itemstack that will be used as the key itemstack. Initially
|
|
+ * this will be the item in the player's main hand but an override can be set
|
|
+ * with {@link #setKeyItem(ItemStack)}. Use {@link #isUsingCustomKeyItemStack()}
|
|
+ * to check if a custom key stack has been set.
|
|
+ *
|
|
+ * @return the item being used as the key item
|
|
+ * @see #isUsingCustomKeyItemStack()
|
|
+ */
|
|
+ public @NotNull ItemStack getKeyItem() {
|
|
+ return Objects.requireNonNullElseGet(this.itemStack, this.player.getInventory()::getItemInMainHand);
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Sets the itemstack that will be used as the key item.
|
|
+ *
|
|
+ * @param stack the stack to use as a key (or null to fall back to the player's main hand item)
|
|
+ * @see #resetKeyItem() to clear a custom key item
|
|
+ */
|
|
+ public void setKeyItem(@NotNull ItemStack stack) {
|
|
+ Preconditions.checkNotNull(stack, "stack is null");
|
|
+ this.itemStack = stack;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Reset the key stack to the default (the player's main hand).
|
|
+ */
|
|
+ public void resetKeyItem() {
|
|
+ this.itemStack = null;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Checks if a custom key stack has been set.
|
|
+ *
|
|
+ * @return true if a custom key itemstack has been set
|
|
+ */
|
|
+ public boolean isUsingCustomKeyItemStack() {
|
|
+ return this.itemStack != null;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Gets the result of this event.
|
|
+ *
|
|
+ * @return the result
|
|
+ * @see #setResult(Result)
|
|
+ */
|
|
+ public @NotNull Result getResult() {
|
|
+ return this.result;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Gets the result of this event. {@link org.bukkit.event.Event.Result#DEFAULT} is the default
|
|
+ * allowing the vanilla logic to check the lock of this block. Set to {@link org.bukkit.event.Event.Result#ALLOW}
|
|
+ * or {@link org.bukkit.event.Event.Result#DENY} to override that behavior.
|
|
+ * <p>
|
|
+ * Setting this to {@link org.bukkit.event.Event.Result#ALLOW} bypasses the spectator check.
|
|
+ *
|
|
+ * @param result the result of this event
|
|
+ */
|
|
+ public void setResult(@NotNull Result result) {
|
|
+ this.result = result;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Shorthand method to set the {@link #getResult()} to {@link org.bukkit.event.Event.Result#DENY},
|
|
+ * the locked message and locked sound.
|
|
+ *
|
|
+ * @param lockedMessage the message to show if locked (or null for none)
|
|
+ * @param lockedSound the sound to play if locked (or null for none)
|
|
+ */
|
|
+ public void denyWithMessageAndSound(@Nullable Component lockedMessage, @Nullable Sound lockedSound) {
|
|
+ this.result = Result.DENY;
|
|
+ this.lockedMessage = lockedMessage;
|
|
+ this.lockedSound = lockedSound;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Gets the locked message that will be sent if the
|
|
+ * player cannot open the block.
|
|
+ *
|
|
+ * @return the locked message (or null if none)
|
|
+ */
|
|
+ public @Nullable Component getLockedMessage() {
|
|
+ return this.lockedMessage;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Sets the locked message that will be sent if the
|
|
+ * player cannot open the block.
|
|
+ *
|
|
+ * @param lockedMessage the locked message (or null for none)
|
|
+ */
|
|
+ public void setLockedMessage(@Nullable Component lockedMessage) {
|
|
+ this.lockedMessage = lockedMessage;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Gets the locked sound that will play if the
|
|
+ * player cannot open the block.
|
|
+ *
|
|
+ * @return the locked sound (or null if none)
|
|
+ */
|
|
+ public @Nullable Sound getLockedSound() {
|
|
+ return this.lockedSound;
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Sets the locked sound that will play if the
|
|
+ * player cannot open the block.
|
|
+ *
|
|
+ * @param lockedSound the locked sound (or null for none)
|
|
+ */
|
|
+ public void setLockedSound(@Nullable Sound lockedSound) {
|
|
+ this.lockedSound = lockedSound;
|
|
+ }
|
|
+
|
|
+ @Override
|
|
+ public @NotNull HandlerList getHandlers() {
|
|
+ return HANDLER_LIST;
|
|
+ }
|
|
+
|
|
+ public static @NotNull HandlerList getHandlerList() {
|
|
+ return HANDLER_LIST;
|
|
+ }
|
|
+}
|
|
diff --git a/src/main/java/org/bukkit/block/Beacon.java b/src/main/java/org/bukkit/block/Beacon.java
|
|
index 7d212c409035ccb8b22d4ffc322b4a1aea367627..79c04b840adb768f7a38e95a82f79287f42681f5 100644
|
|
--- a/src/main/java/org/bukkit/block/Beacon.java
|
|
+++ b/src/main/java/org/bukkit/block/Beacon.java
|
|
@@ -11,7 +11,7 @@ import org.jetbrains.annotations.Nullable;
|
|
/**
|
|
* Represents a captured state of a beacon.
|
|
*/
|
|
-public interface Beacon extends TileState, Lockable, Nameable {
|
|
+public interface Beacon extends io.papermc.paper.block.LockableTileState { // Paper
|
|
|
|
/**
|
|
* Returns the list of players within the beacon's range of effect.
|
|
diff --git a/src/main/java/org/bukkit/block/Container.java b/src/main/java/org/bukkit/block/Container.java
|
|
index bc06199f0a1cc43e0bdfd5b11fa170badd46e180..a67ee0cb0cd2cbab8dab375e2fe44168c250bcb7 100644
|
|
--- a/src/main/java/org/bukkit/block/Container.java
|
|
+++ b/src/main/java/org/bukkit/block/Container.java
|
|
@@ -8,7 +8,7 @@ import org.jetbrains.annotations.NotNull;
|
|
/**
|
|
* Represents a captured state of a container block.
|
|
*/
|
|
-public interface Container extends TileState, BlockInventoryHolder, Lockable, Nameable {
|
|
+public interface Container extends io.papermc.paper.block.LockableTileState, BlockInventoryHolder { // Paper
|
|
|
|
/**
|
|
* Gets the inventory of the block represented by this block state.
|