aboutsummaryrefslogtreecommitdiffhomepage
path: root/patches/api/0491-Add-PlayerInsertLecternBookEvent.patch
diff options
context:
space:
mode:
Diffstat (limited to 'patches/api/0491-Add-PlayerInsertLecternBookEvent.patch')
-rw-r--r--patches/api/0491-Add-PlayerInsertLecternBookEvent.patch108
1 files changed, 108 insertions, 0 deletions
diff --git a/patches/api/0491-Add-PlayerInsertLecternBookEvent.patch b/patches/api/0491-Add-PlayerInsertLecternBookEvent.patch
new file mode 100644
index 0000000000..55cbd91d4a
--- /dev/null
+++ b/patches/api/0491-Add-PlayerInsertLecternBookEvent.patch
@@ -0,0 +1,108 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Mariell Hoversholm <[email protected]>
+Date: Sat, 29 Aug 2020 21:55:41 +0200
+Subject: [PATCH] Add PlayerInsertLecternBookEvent
+
+
+diff --git a/src/main/java/io/papermc/paper/event/player/PlayerInsertLecternBookEvent.java b/src/main/java/io/papermc/paper/event/player/PlayerInsertLecternBookEvent.java
+new file mode 100644
+index 0000000000000000000000000000000000000000..6d31e0c30f0389eeaf44335bd842ca3e1d0212eb
+--- /dev/null
++++ b/src/main/java/io/papermc/paper/event/player/PlayerInsertLecternBookEvent.java
+@@ -0,0 +1,96 @@
++package io.papermc.paper.event.player;
++
++import com.google.common.base.Preconditions;
++import org.bukkit.block.Block;
++import org.bukkit.block.BlockState;
++import org.bukkit.block.Lectern;
++import org.bukkit.entity.Player;
++import org.bukkit.event.Cancellable;
++import org.bukkit.event.HandlerList;
++import org.bukkit.event.player.PlayerEvent;
++import org.bukkit.inventory.ItemStack;
++import org.jetbrains.annotations.ApiStatus;
++import org.jspecify.annotations.NullMarked;
++
++/**
++ * This event is called when a player clicks on a lectern to insert a book.
++ * If this event is cancelled the player will keep the book and the lectern will remain empty.
++ */
++@NullMarked
++public class PlayerInsertLecternBookEvent extends PlayerEvent implements Cancellable {
++
++ private static final HandlerList HANDLER_LIST = new HandlerList();
++ private boolean cancelled = false;
++ private final Block block;
++ private ItemStack book;
++
++ @ApiStatus.Internal
++ public PlayerInsertLecternBookEvent(final Player player, final Block block, final ItemStack book) {
++ super(player);
++ this.block = block;
++ this.book = book;
++ }
++
++ /**
++ * Gets the block of the lectern involved in this event.
++ *
++ * @return the block of the lectern
++ */
++ public Block getBlock() {
++ return this.block;
++ }
++
++ /**
++ * Fetches the lectern block state that was part of this event.
++ * This method constructs a new snapshot {@link org.bukkit.block.BlockState}.
++ *
++ * @return a new lectern state snapshot of the involved lectern
++ * @throws IllegalStateException if the block at {@link #getBlock()} is no longer a lectern
++ */
++ public Lectern getLectern() {
++ final BlockState state = this.getBlock().getState();
++ Preconditions.checkState(state instanceof Lectern, "Block state of lectern block is no longer a lectern tile state!");
++ return (Lectern) state;
++ }
++
++ /**
++ * Returns the itemstack the player tried to insert. This is a copy of the item,
++ * changes made to this itemstack will not affect the book that is being placed in the lectern.
++ * If you want to mutate the item stack that ends up in the lectern, use {@link #setBook(ItemStack)}.
++ *
++ * @return the book that is being placed
++ */
++ public ItemStack getBook() {
++ return this.book.clone();
++ }
++
++ /**
++ * Sets the itemstack to insert into the lectern.
++ *
++ * @param book the book to insert (non book items will leave the lectern in a locked
++ * state as the menu cannot be opened, preventing item extraction)
++ */
++ public void setBook(final ItemStack book) {
++ Preconditions.checkArgument(book != null, "Cannot set book to null");
++ this.book = book.clone();
++ }
++
++ @Override
++ public boolean isCancelled() {
++ return this.cancelled;
++ }
++
++ @Override
++ public void setCancelled(final boolean cancel) {
++ this.cancelled = cancel;
++ }
++
++ @Override
++ public HandlerList getHandlers() {
++ return HANDLER_LIST;
++ }
++
++ public static HandlerList getHandlerList() {
++ return HANDLER_LIST;
++ }
++}