Refactor flag capture and turn-in notifications.

Extracted and separated notification logic for flag capture and turn-in events into distinct methods to improve clarity and maintainability. Updated messaging to better align with game events and streamlined title displays for players.

src/main/java/com/alttd/ctf/flag/Flag.java

@@ -81,15 +81,9 @@ public class Flag implements Runnable {
         //TODO add de-buffs and enable buffs for others?
         player.getInventory().setItem(EquipmentSlot.HEAD, flagItem);
         Bukkit.getScheduler().runTask(main, () -> flagLocation.getBlock().setType(Material.AIR));
-        Bukkit.broadcast(MiniMessage.miniMessage().deserialize("<green><player> from <team> captured the flag!", TagResolver.resolver(
-                Placeholder.component("player", player.displayName()),
-                Placeholder.component("team", teamPlayer.getTeam().getName())
-        )));
+        notifyAboutCapture();
         flagCarrier = player;
-        teamFlagPointCount.clear();
-        winningTeam = null;
-        lastWinningTeamId = -1;
-        bossBar.setProgress(0);
+        resetFlag();
     }
 
     public void spawnFlag() {
@@ -146,24 +140,38 @@ public class Flag implements Runnable {
             updateDisplay();
         } else {
             winningTeam = optionalTeam.get();
-            bossBar.setVisible(false);
-            bossBar.setProgress(0);
+            resetFlag();
             //TODO stop capture and let ppl know they can now capture the flag
         }
     }
 
+    private void notifyAboutCapture() {
+        Bukkit.broadcast(miniMessage.deserialize("<player> is carrying the flag for <team>!",
+                Placeholder.component("player", flagCarrier.displayName()),
+                Placeholder.component("team", winningTeam.getName())));
+        Title capturingTeamTitle = Title.title(miniMessage.deserialize("<green><team> obtained the flag!</green>",
+                        Placeholder.component("team", winningTeam.getName())),
+                miniMessage.deserialize("<green>protect <player> while they bring it to your base.</green>",
+                        Placeholder.component("player", flagCarrier.displayName())));
+        Title huntingTeamTitle = Title.title(miniMessage.deserialize("<red><team> obtained the flag!</red>",
+                        Placeholder.component("team", winningTeam.getName())),
+                miniMessage.deserialize("<red>kill <player> before they bring it to their base.</red>",
+                        Placeholder.component("player", flagCarrier.displayName())));
+        Bukkit.getOnlinePlayers().forEach(player ->
+                gameManager.getTeam(player.getUniqueId()).ifPresent(team ->
+                        player.showTitle(team.getId() == winningTeam.getId() ? capturingTeamTitle : huntingTeamTitle)));
+    }
+
     private void spawnParticlesOnSquareBorder(Location center, double size) {
         double step = 0.2;
         World world = center.getWorld();
         Location finalCenter = center.clone().add(0, 0.5, 0);
         Bukkit.getScheduler().runTask(main, () -> {
-            // Top and Bottom (Z varies, X constant)
             for (double z = -size; z <= size; z += step) {
                 world.spawnParticle(Particle.FLAME, finalCenter.getX() + size, finalCenter.getY(), finalCenter.getZ() + z, 1, 0, 0, 0, 0);
                 world.spawnParticle(Particle.FLAME, finalCenter.getX() - size, finalCenter.getY(), finalCenter.getZ() + z, 1, 0, 0, 0, 0);
             }
 
-            // Left and Right (X varies, Z constant)
             for (double x = -size; x <= size; x += step) {
                 world.spawnParticle(Particle.FLAME, finalCenter.getX() + x, finalCenter.getY(), finalCenter.getZ() + size, 1, 0, 0, 0, 0);
                 world.spawnParticle(Particle.FLAME, finalCenter.getX() + x, finalCenter.getY(), finalCenter.getZ() - size, 1, 0, 0, 0, 0);
@@ -184,8 +192,7 @@ public class Flag implements Runnable {
 
     private void checkFlagCarrier() {
         if (flagCarrier.isDead() || !flagCarrier.isOnline()) {
-            flagCarrier = null;
-            particleTrail.clear();
+            resetFlagCarrier();
             spawnFlag();
             return;
         }
@@ -198,7 +205,7 @@ public class Flag implements Runnable {
             spawnParticlesOnSquareBorder(winningTeam.getFlagTurnInLocation(), GameConfig.FLAG.TURN_IN_RADIUS);
             return;
         }
-        notifyAboutCapture();
+        notifyAboutTurnIn();
         spawnFlag();
         wins.merge(winningTeam.getId(), 1, Integer::sum);
         winningTeam = null;
@@ -210,25 +217,18 @@ public class Flag implements Runnable {
             teamPlayer.getGameClass().setArmor(flagCarrier, teamPlayer);
             flagCarrier.getInventory().setItem(EquipmentSlot.HEAD, null);
         }
-        flagCarrier = null;
-        particleTrail.clear();
+        resetFlagCarrier();
     }
 
-    private void notifyAboutCapture() {
+    private void notifyAboutTurnIn() {
         Bukkit.broadcast(miniMessage.deserialize("<player> captured the flag for <team>!",
                 Placeholder.component("player", flagCarrier.displayName()),
                 Placeholder.component("team", winningTeam.getName())));
-        Title capturingTeamTitle = Title.title(miniMessage.deserialize("<green><team> captured the flag!</green>",
+        Title title = Title.title(miniMessage.deserialize("<green><player> captured the flag for team <team>!</green>",
                         Placeholder.component("team", winningTeam.getName())),
                 miniMessage.deserialize("<green>protect <player> while they bring it to your base.</green>",
                         Placeholder.component("player", flagCarrier.displayName())));
-        Title huntingTeamTitle = Title.title(miniMessage.deserialize("<red><team> captured the flag!</red>",
-                        Placeholder.component("team", winningTeam.getName())),
-                miniMessage.deserialize("<red>kill <player> before they bring it to their base.</red>",
-                        Placeholder.component("player", flagCarrier.displayName())));
-        Bukkit.getOnlinePlayers().forEach(player ->
-                gameManager.getTeam(player.getUniqueId()).ifPresent(team ->
-                        player.showTitle(team.getId() == winningTeam.getId() ? capturingTeamTitle : huntingTeamTitle)));
+        Bukkit.getOnlinePlayers().forEach(player -> player.showTitle(title));
     }
 
     private Optional<Team> winnerExists() {
@@ -349,17 +349,25 @@ public class Flag implements Runnable {
         return winsByTeam;
     }
 
-    public void reset() {
+    public void resetFlagCarrier() {
+        flagCarrier = null;
+        winningTeam = null;
+        particleTrail.clear();
+    }
+
+    public void resetFlag() {
         bossBar.setVisible(false);
         teamFlagPointCount.clear();
         bossBar.setProgress(0);
-        winningTeam = null;
-        flagCarrier = null;
-        particleTrail.clear();
-        wins.clear();
         lastWinningTeamId = -1;
     }
 
+    public void resetAll() {
+        resetFlagCarrier();
+        resetFlag();
+        wins.clear();
+    }
+
     public void handleCarrierDeathOrDisconnect(Player player) {
         if (flagCarrier == null) {
             return;
@@ -367,8 +375,7 @@ public class Flag implements Runnable {
         if (!flagCarrier.getUniqueId().equals(player.getUniqueId())) {
             return;
         }
-        flagCarrier = null;
-        particleTrail.clear();
+        resetFlagCarrier();
         spawnFlag();
         gameManager.getTeam(player.getUniqueId())
                 .ifPresentOrElse(team -> Bukkit.broadcast(MiniMessage.miniMessage()

src/main/java/com/alttd/ctf/game/phases/EndedPhase.java

@@ -50,7 +50,7 @@ public class EndedPhase implements GamePhaseExecutor {
                 maxHealthAttribute.setBaseValue(20);
                 player.setHealth(20);
             });
-            flag.reset();
+            flag.resetAll();
         }).start();
         // TODO reset world (coreprotect) to prep for next round
     }

version.properties

@@ -1,3 +1,3 @@
-#Tue Feb 11 21:46:26 CET 2025
-buildNumber=39
+#Tue Feb 11 22:04:16 CET 2025
+buildNumber=42
 version=0.1