feat: test flows

Took 2 hours 57 minutes

Author: Swofty-Developments

commons/src/main/java/net/swofty/commons/CustomWorlds.java

@@ -3,6 +3,7 @@
 public enum CustomWorlds {
     ISLANDS_TEMPLATE("hypixel_island_template"),
     HUB("hypixel_hub"),
+    DUNGEON_HUB("hypixel_dungeon_hub"),
     ;
 
     private final String folderName;

commons/src/main/java/net/swofty/commons/ServerType.java

@@ -5,6 +5,7 @@
 public enum ServerType {
     ISLAND,
     HUB,
+    DUNGEON_HUB,
     THE_FARMING_ISLANDS;
 
     public static boolean isServerType(String type) {

commons/src/main/java/net/swofty/commons/TestFlow.java

@@ -0,0 +1,83 @@
+package net.swofty.commons;
+
+import lombok.Getter;
+import lombok.Setter;
+
+import java.util.List;
+
+public class TestFlow {
+    @Getter
+    @Setter
+    private static String currentTestFlow;
+
+    @Getter
+    @Setter
+    private static List<String> currentTestPlayers;
+
+    /**
+     * Checks if any test flow is currently active on this server
+     * @return true if a test flow is active
+     */
+    public static boolean isTestFlowActive() {
+        return currentTestFlow != null;
+    }
+
+    /**
+     * Checks if a specific test flow is active
+     * @param testFlowName the name of the test flow
+     * @return true if the specified test flow is active
+     */
+    public static boolean isTestFlowActive(String testFlowName) {
+        return currentTestFlow != null && currentTestFlow.equals(testFlowName);
+    }
+
+    /**
+     * Gets the current test flow instance
+     * @return a simple TestFlowInstance or null if no test flow is active
+     */
+    public static TestFlowInstance getTestFlowInstance() {
+        if (currentTestFlow == null) return null;
+        return new TestFlowInstance(currentTestFlow, currentTestPlayers);
+    }
+
+    /**
+     * Sets the current test flow for this server
+     * @param testFlowName the name of the test flow
+     * @param players the list of test flow players
+     */
+    public static void setCurrentTestFlow(String testFlowName, List<String> players) {
+        currentTestFlow = testFlowName;
+        currentTestPlayers = players;
+    }
+
+    /**
+     * Clears the current test flow
+     */
+    public static void clearTestFlow() {
+        currentTestFlow = null;
+        currentTestPlayers = null;
+    }
+
+    /**
+     * Simple test flow instance for server-side usage
+     */
+    @Getter
+    public static class TestFlowInstance {
+        private final String name;
+        private final List<String> players;
+
+        public TestFlowInstance(String name, List<String> players) {
+            this.name = name;
+            this.players = players;
+        }
+
+        /**
+         * Checks if a player is part of this test flow
+         * @param playerName the player name to check
+         * @return true if the player is in this test flow
+         */
+        public boolean hasPlayer(String playerName) {
+            return players != null && players.contains(playerName);
+        }
+    }
+}

commons/src/main/java/net/swofty/commons/proxy/ToProxyChannels.java

@@ -13,6 +13,8 @@ public enum ToProxyChannels {
     REGISTER_SERVER("register-server", new RegisterServerRequirements()),
     FINISHED_WITH_PLAYER("finished-with-player", new FinishedWithPlayerRequirements()),
     REQUEST_SERVERS("servers", new ServersRequirement()),
+    REGISTER_TEST_FLOW("register-test-flow", new RegisterTestFlowRequirements()),
+    TEST_FLOW_SERVER_READY("test-flow-server-ready", new TestFlowServerReadyRequirements()),
     ;
 
     @Getter
@@ -48,4 +50,4 @@ public static ToProxyChannels getChannelName(String channel) {
         }
         throw new IllegalArgumentException("Unknown channelName: " + channel);
     }
-}
+}

commons/src/main/java/net/swofty/commons/proxy/requirements/to/RegisterTestFlowRequirements.java

@@ -0,0 +1,27 @@
+package net.swofty.commons.proxy.requirements.to;
+
+import net.swofty.commons.proxy.ProxyChannelRequirements;
+
+import java.util.List;
+
+public class RegisterTestFlowRequirements extends ProxyChannelRequirements {
+    @Override
+    public List<RequiredKey> getRequiredKeysForProxy() {
+        return List.of(
+                new RequiredKey("test_flow_name"),
+                new RequiredKey("handler"),
+                new RequiredKey("players"),
+                new RequiredKey("server_configs")
+        );
+    }
+
+    @Override
+    public List<RequiredKey> getRequiredKeysForServer() {
+        return List.of(
+                new RequiredKey("test_flow_name"),
+                new RequiredKey("handler"),
+                new RequiredKey("players"),
+                new RequiredKey("server_configs")
+        );
+    }
+}

commons/src/main/java/net/swofty/commons/proxy/requirements/to/TestFlowServerReadyRequirements.java

@@ -0,0 +1,25 @@
+package net.swofty.commons.proxy.requirements.to;
+
+import net.swofty.commons.proxy.ProxyChannelRequirements;
+
+import java.util.List;
+
+public class TestFlowServerReadyRequirements extends ProxyChannelRequirements {
+    @Override
+    public List<RequiredKey> getRequiredKeysForProxy() {
+        return List.of(
+                new RequiredKey("test_flow_name"),
+                new RequiredKey("server_type"),
+                new RequiredKey("server_index")
+        );
+    }
+
+    @Override
+    public List<RequiredKey> getRequiredKeysForServer() {
+        return List.of(
+                new RequiredKey("test_flow_name"),
+                new RequiredKey("server_type"),
+                new RequiredKey("server_index")
+        );
+    }
+}