aboutsummaryrefslogtreecommitdiffhomepage
path: root/patches/api/0284-additions-to-PlayerGameModeChangeEvent.patch
diff options
context:
space:
mode:
authorJake Potrebic <[email protected]>2023-11-22 20:56:28 -0800
committerGitHub <[email protected]>2023-11-22 20:56:28 -0800
commit96d5e6ca481591842f44d05ab2451f943be6a7c7 (patch)
treead35d855fa33f6feb8e365ce12aa312bd225ff3f /patches/api/0284-additions-to-PlayerGameModeChangeEvent.patch
parente1cd9e59e53aabd50e501cb01feee277a8f69902 (diff)
downloadPaper-96d5e6ca481591842f44d05ab2451f943be6a7c7.tar.gz
Paper-96d5e6ca481591842f44d05ab2451f943be6a7c7.zip
Code Generation for TypedKeys (#9233)
Currently includes generated key holder classes for types used in the Registry Modification API
Diffstat (limited to 'patches/api/0284-additions-to-PlayerGameModeChangeEvent.patch')
-rw-r--r--patches/api/0284-additions-to-PlayerGameModeChangeEvent.patch121
1 files changed, 121 insertions, 0 deletions
diff --git a/patches/api/0284-additions-to-PlayerGameModeChangeEvent.patch b/patches/api/0284-additions-to-PlayerGameModeChangeEvent.patch
new file mode 100644
index 0000000000..b2e65ae490
--- /dev/null
+++ b/patches/api/0284-additions-to-PlayerGameModeChangeEvent.patch
@@ -0,0 +1,121 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Jake Potrebic <[email protected]>
+Date: Sat, 15 May 2021 10:04:50 -0700
+Subject: [PATCH] additions to PlayerGameModeChangeEvent
+
+
+diff --git a/src/main/java/org/bukkit/event/player/PlayerGameModeChangeEvent.java b/src/main/java/org/bukkit/event/player/PlayerGameModeChangeEvent.java
+index 4b96e0573c7ce32ad8c41124ee9ecab8359318a5..aee4a8b52c0d4abb655a4778575f0122acf19049 100644
+--- a/src/main/java/org/bukkit/event/player/PlayerGameModeChangeEvent.java
++++ b/src/main/java/org/bukkit/event/player/PlayerGameModeChangeEvent.java
+@@ -8,15 +8,32 @@ import org.jetbrains.annotations.NotNull;
+
+ /**
+ * Called when the GameMode of the player is changed.
++ * <p>
++ * <b>NOTE:</b> When {@link #getCause()} is {@link Cause#DEFAULT_GAMEMODE},
++ * the Player from {@link #getPlayer()} might not be fully online at
++ * the time this event is fired. Plugins should use {@link Player#isOnline()}
++ * to check before changing player state.
+ */
+ public class PlayerGameModeChangeEvent extends PlayerEvent implements Cancellable {
+ private static final HandlerList handlers = new HandlerList();
+ private boolean cancelled;
+ private final GameMode newGameMode;
++ // Paper start
++ private final Cause cause;
++ private net.kyori.adventure.text.Component cancelMessage;
+
++ @Deprecated // Paper end
+ public PlayerGameModeChangeEvent(@NotNull final Player player, @NotNull final GameMode newGameMode) {
++ // Paper start
++ this(player, newGameMode, Cause.UNKNOWN, null);
++ }
++
++ public PlayerGameModeChangeEvent(@NotNull final Player player, @NotNull final GameMode newGameMode, @NotNull Cause cause, @org.jetbrains.annotations.Nullable net.kyori.adventure.text.Component cancelMessage) {
++ // Paper end
+ super(player);
+ this.newGameMode = newGameMode;
++ this.cause = cause; // Paper
++ this.cancelMessage = cancelMessage; // Paper
+ }
+
+ @Override
+@@ -49,4 +66,77 @@ public class PlayerGameModeChangeEvent extends PlayerEvent implements Cancellabl
+ public static HandlerList getHandlerList() {
+ return handlers;
+ }
++ // Paper start
++ /**
++ * Gets the cause of this gamemode change.
++ *
++ * @return the cause
++ */
++ @NotNull
++ public Cause getCause() {
++ return cause;
++ }
++
++ /**
++ * <b>Only valid if the cause of the gamemode change was directly due to a command.</b>.
++ * Gets the message shown to the command user if the event is cancelled
++ * as a notification that a player's gamemode was not changed.
++ * <p>
++ * This returns {@code null} if the gamemode change was due to a plugin, or a
++ * player joining the game with a gamemode not equal to the server default gamemode
++ * and {@code force-gamemode} is set to true.
++ *
++ * @return the error message shown to the command user, null if not directly caused by a command
++ */
++ @org.jetbrains.annotations.Nullable
++ public net.kyori.adventure.text.Component cancelMessage() {
++ return cancelMessage;
++ }
++
++ /**
++ * Sets the message shown to the command user if the event was cancelled.
++ * <b>The message is only shown to cancelled events that are directly called by a command
++ * not by a plugin or a player joining with the wrong gamemode.</b>
++ *
++ * @param message the error message shown to the command user, null to show no message.
++ */
++ public void cancelMessage(@org.jetbrains.annotations.Nullable net.kyori.adventure.text.Component message) {
++ this.cancelMessage = message;
++ }
++
++ public enum Cause {
++
++ /**
++ * A plugin changed the player's gamemode with
++ * {@link Player#setGameMode(GameMode)}.
++ */
++ PLUGIN,
++
++ /**
++ * The {@code /gamemode} command was used.
++ */
++ COMMAND,
++
++ /**
++ * A player had their gamemode changed as a result of
++ * the {@code /defaultgamemode} command, or they joined
++ * with a gamemode that was not the default gamemode and
++ * {@code force-gamemode} in {@code server.properties} is set to true.
++ */
++ DEFAULT_GAMEMODE,
++
++ /**
++ * When the player dies in a hardcore world and has their gamemode
++ * changed to {@link GameMode#SPECTATOR}.
++ */
++ HARDCORE_DEATH,
++
++ /**
++ * This cause is only used if a plugin fired their own
++ * {@link PlayerGameModeChangeEvent} and did not include a
++ * cause. Can usually be ignored.
++ */
++ UNKNOWN,
++ }
++ // Paper end
+ }