aboutsummaryrefslogtreecommitdiffhomepage
path: root/patches/api/0491-Add-PlayerInsertLecternBookEvent.patch
blob: 55cbd91d4a6bb1cfd2b628aec7dbc48ae936cc06 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
From: Mariell Hoversholm <proximyst@proximyst.com>
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;
+    }
+}