diff --git a/paper-api/src/main/java/io/papermc/paper/event/player/PlayerSignCommandPreprocessEvent.java b/paper-api/src/main/java/io/papermc/paper/event/player/PlayerSignCommandPreprocessEvent.java new file mode 100644 index 0000000000..220f950ab8 --- /dev/null +++ b/paper-api/src/main/java/io/papermc/paper/event/player/PlayerSignCommandPreprocessEvent.java @@ -0,0 +1,47 @@ +package io.papermc.paper.event.player; + +import java.util.Set; +import org.bukkit.block.Sign; +import org.bukkit.block.sign.Side; +import org.bukkit.entity.Player; +import org.bukkit.event.player.PlayerCommandPreprocessEvent; +import org.jetbrains.annotations.ApiStatus; +import org.jspecify.annotations.NullMarked; + +/** + * Called when a {@link Player} clicks a side on a sign that causes a command to run. + *

+ * This command is run with elevated permissions which allows players to access commands on signs they wouldn't + * normally be able to run. + */ +@NullMarked +public class PlayerSignCommandPreprocessEvent extends PlayerCommandPreprocessEvent { + + private final Sign sign; + private final Side side; + + @ApiStatus.Internal + public PlayerSignCommandPreprocessEvent(final Player player, final String message, final Set recipients, final Sign sign, final Side side) { + super(player, message, recipients); + this.sign = sign; + this.side = side; + } + + /** + * Gets the sign that the command originated from. + * + * @return the sign + */ + public Sign getSign() { + return this.sign; + } + + /** + * Gets the side of the sign that the command originated from. + * + * @return the sign side + */ + public Side getSide() { + return this.side; + } +}