Merge pull request #2442 from Lignium/feature/previous-game-mode

Add Keys#PREVIOUS_GAME_MODE

Author: Faithcaio

src/main/java/org/spongepowered/api/data/Keys.java

@@ -934,7 +934,7 @@ public final class Keys {
     public static final Key<Value<Ticks>> FUSE_DURATION = Keys.key(ResourceKey.sponge("fuse_duration"), Ticks.class);
 
     /**
-     * The {@link GameMode} a {@link Humanoid} has.
+     * The {@link GameMode} a {@link ServerPlayer} has.
      */
     public static final Key<Value<GameMode>> GAME_MODE = Keys.key(ResourceKey.sponge("game_mode"), GameMode.class);
 
@@ -2181,6 +2181,11 @@ public final class Keys {
      */
     public static final Key<Value<Integer>> POWER = Keys.key(ResourceKey.sponge("power"), Integer.class);
 
+    /**
+     * The previous {@link GameMode} of a {@link ServerPlayer}. Readonly.
+     */
+    public static final Key<Value<GameMode>> PREVIOUS_GAME_MODE = Keys.key(ResourceKey.sponge("previous_game_mode"), GameMode.class);
+
     /**
      * A {@link Beacon}'s primary effect.
      */

src/main/java/org/spongepowered/api/entity/living/player/server/ServerPlayer.java

@@ -344,6 +344,15 @@ default Value.Mutable<GameMode> gameMode() {
         return this.requireValue(Keys.GAME_MODE).asMutable();
     }
 
+    /**
+     * {@link Keys#PREVIOUS_GAME_MODE}
+     *
+     * @return The previous game mode of the player
+     */
+    default Value<GameMode> previousGameMode() {
+        return this.requireValue(Keys.PREVIOUS_GAME_MODE);
+    }
+
     /**
      * {@link Keys#STATISTICS}
      *