Added IslandNewIslandEvent

Gets fired when a player is teleported to their new island for the first
time.

src/main/java/world/bentobox/bentobox/api/events/island/IslandEvent.java

@@ -105,6 +105,11 @@ public class IslandEvent extends IslandBaseEvent {
          * To read the rank value, check the {@link Flags#LOCK} flag.
          */
         LOCK,
+        /**
+         * Called when a player goes to their new island for the first time
+         * @since 1.16.1
+         */
+        NEW_ISLAND,
         /**
          * Called before an island is going to be cleared of island members.
          * This event occurs before resets or other island clearing activities.
@@ -889,6 +894,8 @@ public class IslandEvent extends IslandBaseEvent {
                 return new world.bentobox.bentobox.api.events.island.IslandReservedEvent(island, player, admin, location);
             case RANK_CHANGE:
                 return new world.bentobox.bentobox.api.events.island.IslandRankChangeEvent(island, player, admin, location, oldRank, newRank);
+            case NEW_ISLAND:
+                return new IslandNewIslandEvent(island, player, admin, location);
             default:
                 return new world.bentobox.bentobox.api.events.island.IslandGeneralEvent(island, player, admin, location);
             }

src/main/java/world/bentobox/bentobox/api/events/island/IslandNewIslandEvent.java

@@ -0,0 +1,33 @@
+package world.bentobox.bentobox.api.events.island;
+
+import java.util.UUID;
+
+import org.bukkit.Location;
+import org.bukkit.event.HandlerList;
+
+import world.bentobox.bentobox.api.events.IslandBaseEvent;
+import world.bentobox.bentobox.database.objects.Island;
+
+/**
+ * Fired when an a player enters a new island for the first time.
+ * Called before join commands are run, money reset, etc.
+ */
+public class IslandNewIslandEvent extends IslandBaseEvent {
+
+    private static final HandlerList handlers = new HandlerList();
+
+    @Override
+    public HandlerList getHandlers() {
+        return getHandlerList();
+    }
+
+    public static HandlerList getHandlerList() {
+        return handlers;
+    }
+
+    IslandNewIslandEvent(Island island, UUID player, boolean admin, Location location) {
+        // Final variables have to be declared in the constructor
+        super(island, player, admin, location);
+    }
+
+}

src/main/java/world/bentobox/bentobox/managers/IslandsManager.java

@@ -542,7 +542,7 @@ public class IslandsManager {
     public void setMaxMembers(@NonNull Island island, int rank, Integer maxMembers) {
         island.setMaxMembers(rank, maxMembers);
     }
-    
+
     /**
      * Get the maximum number of homes allowed on this island. Will be updated with the owner's permission settings if
      * they exist and the owner is online
@@ -562,7 +562,7 @@ public class IslandsManager {
         this.save(island);
         return islandMax;
     }
-    
+
     /**
      * Set the maximum numbber of homes allowed on this island
      * @param island - island
@@ -873,7 +873,7 @@ public class IslandsManager {
             plugin.getPlayers().clearHomeLocations(world, uuid);
         }
     }
-    
+
     private String getHomeName(Entry<Location, Integer> e) {
         // Home 1 has an empty name
         if (e.getValue() == 1) {
@@ -1091,7 +1091,7 @@ public class IslandsManager {
                 .entity(player)
                 .island(island)
                 .homeName(name)
-                .thenRun(() -> teleported(world, user, name, newIsland))
+                .thenRun(() -> teleported(world, user, name, newIsland, island))
                 .buildFuture()
                 .thenAccept(result::complete);
                 return;
@@ -1103,7 +1103,7 @@ public class IslandsManager {
             PaperLib.teleportAsync(player, home).thenAccept(b -> {
                 // Only run the commands if the player is successfully teleported
                 if (Boolean.TRUE.equals(b)) {
-                    teleported(world, user, name, newIsland);
+                    teleported(world, user, name, newIsland, island);
                     result.complete(true);
                 } else {
                     result.complete(false);
@@ -1114,12 +1114,30 @@ public class IslandsManager {
         return result;
     }
 
-    private void teleported(World world, User user, String name, boolean newIsland) {
+    /**
+     * Called when a player is teleported to their island
+     * @param world - world
+     * @param user - user
+     * @param name - name of home
+     * @param newIsland - true if this is a new island
+     * @param island - island
+     */
+    private void teleported(World world, User user, String name, boolean newIsland, Island island) {
         if (!name.isEmpty()) {
             user.sendMessage("commands.island.go.teleported", TextVariables.NUMBER, name);
         }
         // If this is a new island, then run commands and do resets
         if (newIsland) {
+            // Fire event
+            if (IslandEvent.builder()
+                    .involvedPlayer(user.getUniqueId())
+                    .reason(Reason.NEW_ISLAND)
+                    .island(island)
+                    .location(island.getCenter())
+                    .build().isCancelled()) {
+                // Do nothing
+                return;
+            }
             // Execute commands
             Util.runCommands(user, plugin.getIWM().getOnJoinCommands(world), "join");