Added an event for when a player's rank gets changed. (#11406)

* Added an event for when a player's rank gets changed.

* Reverted whole file formatting and only formatted own changes

* Added old rank and new rank to the event

* Changed newRank to be nullable

Author: SvennosDinnos

src/main/java/com/minecolonies/api/eventbus/events/colony/ColonyPlayerRankChangedModEvent.java

@@ -0,0 +1,70 @@
+package com.minecolonies.api.eventbus.events.colony;
+
+import com.minecolonies.api.colony.IColony;
+import com.minecolonies.api.colony.permissions.ColonyPlayer;
+import com.minecolonies.api.colony.permissions.Rank;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Colony player rank change event.
+ */
+public final class ColonyPlayerRankChangedModEvent extends AbstractColonyModEvent
+{
+    /**
+     * The colony player whose rank got modified.
+     */
+    @NotNull
+    private final ColonyPlayer player;
+
+    /**
+     * The colony player's new rank.
+     */
+    private final Rank newRank;
+
+    /**
+     * The colony player's old rank.
+     */
+    private final Rank oldRank;
+
+    /**
+     * Constructs a colony player rank change event.
+     *
+     * @param colony  the colony related to the event.
+     * @param player  the colony player related to the event.
+     * @param newRank the colony player's new rank.
+     * @param oldRank the colony player's old rank.
+     */
+    public ColonyPlayerRankChangedModEvent(
+        @NotNull final IColony colony, @NotNull final ColonyPlayer player, final Rank newRank, final Rank oldRank)
+    {
+        super(colony);
+        this.player = player;
+        this.newRank = newRank;
+        this.oldRank = oldRank;
+    }
+
+    /**
+     * Gets the colony player related to the event.
+     */
+    @NotNull
+    public ColonyPlayer getPlayer()
+    {
+        return player;
+    }
+
+    /**
+     * Gets the colony player's new rank.
+     */
+    public Rank getNewRank()
+    {
+        return newRank;
+    }
+
+    /**
+     * Gets the colony player's old rank.
+     */
+    public Rank getOldRank()
+    {
+        return oldRank;
+    }
+}

src/main/java/com/minecolonies/core/colony/permissions/Permissions.java

@@ -2,6 +2,7 @@
 
 import com.minecolonies.api.IMinecoloniesAPI;
 import com.minecolonies.api.colony.permissions.*;
+import com.minecolonies.api.eventbus.events.colony.ColonyPlayerRankChangedModEvent;
 import com.minecolonies.api.network.PacketUtils;
 import com.minecolonies.api.util.ColonyUtils;
 import com.minecolonies.api.util.Log;
@@ -734,6 +735,7 @@ public boolean setPlayerRank(final UUID id, final Rank rank, final Level world)
 
         if (player != null)
         {
+            Rank oldRank = player.getRank();
             player.setRank(rank);
 
             if (rank.isColonyManager())
@@ -746,6 +748,7 @@ public boolean setPlayerRank(final UUID id, final Rank rank, final Level world)
             }
 
             markDirty();
+            IMinecoloniesAPI.getInstance().getEventBus().post(new ColonyPlayerRankChangedModEvent(colony, player, rank, oldRank));
         }
         else
         {