refactor: remove shared/phase module and migrate to Xerus (#171)

Closes #166

- Delete shared/phase module (net.elytrarace.api.phase.*) entirely
- server: platform layer (MinestomPhaseScheduler, MinestomPhaseTask,
  MinestomEventRegistrar, MinestomEventListener) removed — Xerus phases
  handle scheduling internally without a separate PhaseScheduler
- server: remove project(":shared:phase") dependency
- plugins/game: delete old-style phase files (EndPhase, GamePhase,
  LobbyPhase, PreparationPhase, PhaseComponent, PhaseSystem,
  BukkitPhaseScheduler, BukkitEventRegistrar); strip phase references
  from ElytraRace, GameService, GameServiceImpl, DefaultListener
- plugins/setup: delete BukkitPhaseScheduler and BukkitEventRegistrar
  (setup does not need a phase system); remove xerus dependency
- settings.gradle.kts: remove include("shared:phase")
- ArchUnit: drop shared_phase_must_not_use_minestom rule
- CLAUDE.md: update module docs and Phase System section to reference Xerus

Author: TheMeinerLP

CLAUDE.md

@@ -38,11 +38,10 @@ Tests use JUnit 5 with MockBukkit (plugins) or Minestom Testing (server) for API
 
 ## Module Structure
 
-- **`server`** — Standalone Minestom game server. Handles gameplay, physics, scoring, cup flow, and UI. Entry point: `net.elytrarace.server.VoyagerServer` (own `main()`). Depends on `shared/common`, `shared/phase`, `shared/database`.
+- **`server`** — Standalone Minestom game server. Handles gameplay, physics, scoring, cup flow, and UI. Entry point: `net.elytrarace.server.VoyagerServer` (own `main()`). Depends on `shared/common`, `shared/database`.
 - **`plugins/game`** — Legacy Paper game plugin (`ElytraRace-Game`). Being replaced by `server`. Entry point: `net.elytrarace.game.ElytraRace`
 - **`plugins/setup`** — Setup plugin (`ElytraRace-Setup`) for map/cup/portal configuration via in-game conversations. Depends on FastAsyncWorldEdit. Entry point: `net.elytrarace.setup.ElytraRace`
 - **`shared/common`** — Shared utilities: ECS framework, map/cup services, file handling (Gson-based JSON), language/i18n, spline math, builders (Bukkit-frei)
-- **`shared/phase`** — Phase lifecycle framework (Phase -> TimedPhase/TickedPhase, with LinearPhaseSeries/CyclicPhaseSeries collections) (Bukkit-frei)
 - **`shared/conversation-api`** — Player conversation/prompt system, plattform-agnostisch (Bukkit-frei)
 - **`shared/database`** — Hibernate ORM + HikariCP + MariaDB persistence layer for player data
 
@@ -58,7 +57,7 @@ The game uses a custom ECS pattern in `shared/common` (`net.elytrarace.common.ec
 Game-specific components are in `plugins/game/src/.../components/` (GameState, Phase, Cup, Map, World, Spline, Session). Systems are in `.../system/` (CollisionSystem, PhaseSystem, CupSystem, etc.).
 
 ### Phase System
-Game phases (Lobby → Preparation → Game → End) are managed via `shared/phase`. Phases have start/finish lifecycle with callbacks. `LinearPhaseSeries` chains phases sequentially.
+Game phases (Lobby → Preparation → Game → End) are managed via [Xerus](https://github.com/OneLiteFeatherNET/Xerus) (`net.theevilreaper.xerus.api.phase.*`). Phases have start/finish lifecycle with callbacks. `LinearPhaseSeries` chains phases sequentially.
 
 ### Elytra velocity authority
 Normal elytra flight is client-authoritative, matching vanilla Minecraft. `ElytraPhysicsSystem` runs the vanilla formula every tick to keep a server-tracked velocity for ring collision and boost math, but it does NOT call `player.setVelocity()`. Velocity is only sent to the client for external forces: firework boost burns (`FireworkBoostSystem`), ring `BOOST`/`SLOW` effects (`RingEffectSystem`), and out-of-bounds resets (`OutOfBoundsSystem`). See [ADR-0002](docs/decisions/0002-elytra-flight-client-authority.md) and [docs/elytra-physics-reference.md](docs/elytra-physics-reference.md) §7.

plugins/game/build.gradle.kts

@@ -11,7 +11,6 @@ plugins {
 dependencies {
     compileOnly(libs.minecraft.paper)
     implementation(libs.minecraft.cloud.paper)
-    implementation(project(":shared:phase"))
     implementation(project(":shared:common"))
     implementation(project(":shared:database"))
     // Math

plugins/game/src/main/java/net/elytrarace/game/ElytraRace.java

@@ -4,14 +4,10 @@
 import net.elytrarace.common.ecs.EntityManager;
 import net.elytrarace.common.language.LanguageService;
 import net.elytrarace.game.components.GameStateComponent;
-import net.elytrarace.game.components.PhaseComponent;
-import net.elytrarace.game.platform.BukkitEventRegistrar;
-import net.elytrarace.game.platform.BukkitPhaseScheduler;
 import net.elytrarace.game.service.GameService;
 import net.elytrarace.game.system.CollisionSystem;
 import net.elytrarace.game.system.CupSystem;
 import net.elytrarace.game.system.GameStateSystem;
-import net.elytrarace.game.system.PhaseSystem;
 import net.elytrarace.game.system.PlayerUpdateSystem;
 import net.elytrarace.game.system.SplineSystem;
 import net.elytrarace.game.util.ElytraMarkers;
@@ -30,7 +26,6 @@ public class ElytraRace extends JavaPlugin {
 
     private EntityManager entityManager;
     private PlayerUpdateSystem playerUpdateSystem;
-    private PhaseSystem phaseSystem;
     private CupSystem cupSystem;
     private SplineSystem splineSystem;
 
@@ -51,9 +46,6 @@ public void onEnable() {
         Entity gameStateEntity = new Entity();
         gameStateEntity.addComponent(GameStateComponent.create());
 
-        // Add phase component to game state entity
-        gameStateEntity.addComponent(PhaseComponent.create(new BukkitPhaseScheduler(this), new BukkitEventRegistrar(this)));
-
         // Add the entity to the entity manager
         entityManager.addEntity(gameStateEntity);
 
@@ -64,9 +56,6 @@ public void onEnable() {
         playerUpdateSystem = new PlayerUpdateSystem();
         entityManager.addSystem(playerUpdateSystem);
 
-        phaseSystem = new PhaseSystem();
-        entityManager.addSystem(phaseSystem);
-
         cupSystem = new CupSystem();
         entityManager.addSystem(cupSystem);
 

plugins/game/src/main/java/net/elytrarace/game/components/PhaseComponent.java

@@ -2,17 +2,9 @@
 
 import net.elytrarace.api.database.entity.ElytraPlayerEntity;
 import net.elytrarace.api.database.service.DatabaseService;
-import net.elytrarace.api.phase.LinearPhaseSeries;
-import net.elytrarace.api.phase.Phase;
 import net.elytrarace.common.cup.model.ResolvedCupDTO;
-import net.elytrarace.game.phase.EndPhase;
-import net.elytrarace.game.phase.GamePhase;
-import net.elytrarace.game.phase.LobbyPhase;
-import net.elytrarace.game.phase.PreparationPhase;
 import net.elytrarace.game.service.GameService;
-import net.elytrarace.game.util.ElytraMetadata;
 import net.kyori.adventure.text.Component;
-import org.apache.commons.geometry.euclidean.threed.Vector3D;
 import org.bukkit.block.Block;
 import org.bukkit.block.Chest;
 import org.bukkit.block.Container;
@@ -98,49 +90,15 @@ public void onPlayerMove(PlayerMoveEvent event) {
         }
         if (event.getTo().getY() > event.getTo().getWorld().getMaxHeight()) {
             event.getPlayer().teleportAsync(event.getPlayer().getWorld().getSpawnLocation());
-            return;
-        }
-        var player = event.getPlayer();
-        var elytraPhase = this.gameService.getElytraPhase();
-        if (elytraPhase == null) return;
-        var currentPhase = elytraPhase.getCurrentPhase();
-        if (currentPhase == null) return;
-        if (currentPhase instanceof GamePhase) {
-            if (player.hasMetadata(ElytraMetadata.LAST_POSITIONS)) {
-                var metdata = player.getMetadata(ElytraMetadata.LAST_POSITIONS);
-                var lastPositions = (Vector3D[]) metdata.getFirst().value();
-                if (lastPositions == null) return;
-                System.arraycopy(lastPositions, 0, lastPositions, 1, lastPositions.length - 1);
-                lastPositions[0] = Vector3D.of(player.getLocation().getX(), player.getLocation().getY(), player.getLocation().getZ());
-            }
         }
     }
 
     @EventHandler
     public void onPlayerJoin(PlayerJoinEvent event) {
-        LinearPhaseSeries<Phase> elytraPhase = this.gameService.getElytraPhase();
-        if (elytraPhase == null) return;
-        var currentPhase = elytraPhase.getCurrentPhase();
-        if (currentPhase == null) return;
-        if (currentPhase.isRunning() && currentPhase instanceof LobbyPhase lobbyPhase) {
-            event.getPlayer().teleportAsync(lobbyPhase.getLobbyLocation());
-            event.joinMessage(Component.translatable("phase.lobby.player.join", Component.translatable("plugin.prefix"), event.getPlayer().displayName(), Component.text(1)));
-        }
     }
 
     @EventHandler
     public void onPlayerLogin(PlayerLoginEvent event) {
-        LinearPhaseSeries<Phase> elytraPhase = this.gameService.getElytraPhase();
-        if (elytraPhase == null) return;
-        var currentPhase = elytraPhase.getCurrentPhase();
-        if (currentPhase == null) return;
-        if (currentPhase.isRunning() && (currentPhase instanceof GamePhase || currentPhase instanceof EndPhase || currentPhase instanceof PreparationPhase)){
-            event.disallow(PlayerLoginEvent.Result.KICK_OTHER, Component.empty());
-            return;
-        }
-        if (currentPhase.isRunning() && currentPhase instanceof LobbyPhase lobbyPhase) {
-            event.getPlayer().teleportAsync(lobbyPhase.getLobbyLocation());
-        }
         DatabaseService databaseService = this.gameService.getDatabaseService();
         if (databaseService == null) return;
         databaseService.getElytraPlayerRepository()
@@ -156,19 +114,9 @@ public void onPlayerLogin(PlayerLoginEvent event) {
 
     @EventHandler
     public void onServerListPing(ServerListPingEvent event) {
-        var elytraPhase = this.gameService.getElytraPhase();
-        if (elytraPhase == null) return;
-        var currentPhase = elytraPhase.getCurrentPhase();
-        if (currentPhase == null) return;
         var cup = this.gameService.getCurrentCup().filter(ResolvedCupDTO.class::isInstance).orElse(null);
         if (cup == null) return;
-        if (currentPhase instanceof LobbyPhase) {
-            event.motd(Component.translatable("game.motd.cup", Component.translatable("plugin.prefix"), cup.displayName()));
-            return;
-        }
-        if (currentPhase instanceof GamePhase) {
-            event.motd(Component.translatable("game.motd.ingame"));
-        }
+        event.motd(Component.translatable("game.motd.cup", Component.translatable("plugin.prefix"), cup.displayName()));
     }
 
     @EventHandler