From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001 From: by77er <by77er@gmail.com> Date: Sat, 10 Jun 2023 19:06:24 -0400 Subject: [PATCH] Add event for player editing sign diff --git a/src/main/java/io/papermc/paper/event/player/PlayerOpenSignEvent.java b/src/main/java/io/papermc/paper/event/player/PlayerOpenSignEvent.java new file mode 100644 index 0000000000000000000000000000000000000000..0b905aafe5b228993944af1850c93c797f6eaf47 --- /dev/null +++ b/src/main/java/io/papermc/paper/event/player/PlayerOpenSignEvent.java @@ -0,0 +1,105 @@ +package io.papermc.paper.event.player; + +import org.bukkit.block.Sign; +import org.bukkit.block.sign.Side; +import org.bukkit.entity.HumanEntity; +import org.bukkit.entity.Player; +import org.bukkit.event.Cancellable; +import org.bukkit.event.HandlerList; +import org.bukkit.event.player.PlayerEvent; +import org.jetbrains.annotations.ApiStatus; +import org.jspecify.annotations.NullMarked; + +/** + * Called when a player begins editing a sign's text. + * <p> + * Cancelling this event stops the sign editing menu from opening. + */ +@NullMarked +public class PlayerOpenSignEvent extends PlayerEvent implements Cancellable { + + private static final HandlerList HANDLER_LIST = new HandlerList(); + + private final Sign sign; + private final Side side; + private final Cause cause; + + private boolean cancelled; + + @ApiStatus.Internal + public PlayerOpenSignEvent(final Player editor, final Sign sign, final Side side, final Cause cause) { + super(editor); + this.sign = sign; + this.side = side; + this.cause = cause; + } + + /** + * Gets the sign that was clicked. + * + * @return {@link Sign} that was clicked + */ + public Sign getSign() { + return this.sign; + } + + /** + * Gets which side of the sign was clicked. + * + * @return {@link Side} that was clicked + * @see Sign#getSide(Side) + */ + public Side getSide() { + return this.side; + } + + /** + * The cause of this sign open. + * + * @return the cause + */ + public Cause getCause() { + return this.cause; + } + + @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; + } + + /** + * The cause of the {@link PlayerOpenSignEvent}. + */ + public enum Cause { + /** + * The event was triggered by the placement of a sign. + */ + PLACE, + /** + * The event was triggered by an interaction with a sign. + */ + INTERACT, + /** + * The event was triggered via a plugin with {@link HumanEntity#openSign(Sign, Side)} + */ + PLUGIN, + /** + * Fallback cause for any unknown cause. + */ + UNKNOWN, + } +} diff --git a/src/main/java/org/bukkit/event/player/PlayerSignOpenEvent.java b/src/main/java/org/bukkit/event/player/PlayerSignOpenEvent.java index cf935d9c8d8f9a9684024507846a9754f0207986..72fe69c3830f07dd264cfd89e92410dc107034a4 100644 --- a/src/main/java/org/bukkit/event/player/PlayerSignOpenEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerSignOpenEvent.java @@ -9,7 +9,10 @@ import org.jetbrains.annotations.NotNull; /** * This event is fired when a sign is opened by the player. + * @deprecated use {@link io.papermc.paper.event.player.PlayerOpenSignEvent} */ +@Deprecated(forRemoval = true) // Paper +@org.bukkit.Warning(false) // Paper public class PlayerSignOpenEvent extends PlayerEvent implements Cancellable { private static final HandlerList handlers = new HandlerList();