feat: moderation tools

README.md

@@ -13,6 +13,7 @@ A Spigot 26.2 plugin providing a high-difficulty survival experience inspired by
 
 - **`bedrock`**: Core framework module handling UI menus, action bars, announcements, scheduling, and utility systems.
 - **`blighted-smp`**: Primary SMP plugin module containing custom items, mobs, abilities, recipes, and gameplay mechanics.
+- **`blighted-mod`**: Moderation plugin attaching to the SMP server.
 
 ## Requirements
 

bedrock/pom.xml

@@ -28,6 +28,16 @@
       <groupId>org.projectlombok</groupId>
       <artifactId>lombok</artifactId>
     </dependency>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-api</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
   </dependencies>
 
   <build>

bedrock/src/main/java/fr/moussax/bedrock/commands/PlayerCommand.java

@@ -63,11 +63,11 @@ protected abstract boolean execute(
      *
      * <p>If no matching player is found, a warning is sent to the command sender.
      *
-     * @param sender the player requesting the lookup
+     * @param sender the command sender requesting the lookup
      * @param name   the exact username to resolve
      * @return the matching online player, or {@code null} if no player exists
      */
-    protected final @Nullable Player requireTarget(Player sender, String name) {
+    protected final @Nullable Player requireTarget(CommandSender sender, String name) {
         Player target = Bukkit.getPlayerExact(name);
 
         if (target == null) {
@@ -76,4 +76,17 @@ protected abstract boolean execute(
 
         return target;
     }
+
+    /**
+     * Resolves an online player by their exact username.
+     *
+     * <p>If no matching player is found, a warning is sent to the command sender.
+     *
+     * @param sender the player requesting the lookup
+     * @param name   the exact username to resolve
+     * @return the matching online player, or {@code null} if no player exists
+     */
+    protected final @Nullable Player requireTarget(Player sender, String name) {
+        return requireTarget((CommandSender) sender, name);
+    }
 }

bedrock/src/main/java/fr/moussax/bedrock/ui/actionbar/ActionbarComposer.java

@@ -5,12 +5,12 @@
 import org.jspecify.annotations.NonNull;
 
 import java.time.Duration;
+import java.util.ArrayList;
 import java.util.Comparator;
+import java.util.List;
 import java.util.Map;
-import java.util.Objects;
 import java.util.PriorityQueue;
 import java.util.concurrent.ConcurrentHashMap;
-import java.util.stream.Collectors;
 
 /**
  * Assembles and formats per-player action bar text from active sections and temporary alerts.
@@ -91,8 +91,10 @@ public void clearAlerts() {
     /**
      * Compiles the formatted action bar message string for a given player.
      *
-     * <p>If an active modal alert exists, its message is returned immediately. Otherwise,
-     * visible sections are sorted by priority and joined with the configured separator.</p>
+     * <p>If an active modal alert exists, its message is returned immediately. Otherwise, if any
+     * visible exclusive sections produce non-empty text, the exclusive section with the highest priority
+     * is returned. If no exclusive section produces content, visible normal sections are sorted by
+     * rendering priority (lowest first) and joined with the configured separator.</p>
      *
      * @param player player for whom to compile action bar content
      * @return compiled action bar text, or an empty string if no content is visible
@@ -106,21 +108,47 @@ public String compile(@NonNull Player player) {
             }
         }
 
-        return sections.values().stream()
+        List<ActionbarSection> visibleSections = sections.values().stream()
                 .filter(section -> section.visibility().test(player))
+                .toList();
+
+        List<ActionbarSection> exclusiveSections = visibleSections.stream()
+                .filter(ActionbarSection::exclusive)
+                .sorted(Comparator.comparingInt(ActionbarSection::priority).reversed()
+                        .thenComparing(ActionbarSection::id))
+                .toList();
+
+        for (ActionbarSection exclusiveSection : exclusiveSections) {
+            String text = evaluateSection(exclusiveSection, player);
+            if (text != null && !text.isEmpty()) {
+                return text;
+            }
+        }
+
+        List<ActionbarSection> normalSections = visibleSections.stream()
+                .filter(section -> !section.exclusive())
                 .sorted(Comparator.comparingInt(ActionbarSection::priority))
-                .map(section -> {
-                    TimedAlert alert = slotAlerts.get(section.id());
-                    if (alert != null) {
-                        if (!alert.isExpired()) {
-                            return alert.message();
-                        }
-                        slotAlerts.remove(section.id());
-                    }
-                    return section.textSupplier().apply(player);
-                })
-                .filter(Objects::nonNull)
-                .filter(sectionText -> !sectionText.isEmpty())
-                .collect(Collectors.joining(separator));
+                .toList();
+
+        List<String> evaluatedTexts = new ArrayList<>(normalSections.size());
+        for (ActionbarSection section : normalSections) {
+            String text = evaluateSection(section, player);
+            if (text != null && !text.isEmpty()) {
+                evaluatedTexts.add(text);
+            }
+        }
+
+        return String.join(separator, evaluatedTexts);
+    }
+
+    private String evaluateSection(ActionbarSection section, Player player) {
+        TimedAlert alert = slotAlerts.get(section.id());
+        if (alert != null) {
+            if (!alert.isExpired()) {
+                return alert.message();
+            }
+            slotAlerts.remove(section.id());
+        }
+        return section.textSupplier().apply(player);
     }
 }

bedrock/src/main/java/fr/moussax/bedrock/ui/actionbar/ActionbarSection.java

@@ -10,17 +10,31 @@
 /**
  * Represents a modular content section rendered within a player's action bar.
  *
+ * <p>For normal (non-exclusive) sections, priority determines left-to-right rendering position
+ * (lower values render further to the left). For exclusive sections, priority defines override precedence
+ * (higher values take precedence over lower priority exclusive sections when multiple exclusive sections produce non-empty text).</p>
+ *
  * @param id           unique identifier for this section
- * @param priority     rendering priority; lower values render further to the left
+ * @param priority     rendering priority for normal sections or precedence for exclusive sections
  * @param textSupplier function producing the display text for a player, or {@code null} if empty
  * @param visibility   predicate determining whether this section should render for a player
+ * @param exclusive    whether this section overrides non-exclusive sections when visible with non-empty text
  */
 public record ActionbarSection(
         @NonNull String id,
         int priority,
         @NonNull Function<Player, @Nullable String> textSupplier,
-        @NonNull Predicate<Player> visibility
+        @NonNull Predicate<Player> visibility,
+        boolean exclusive
 ) {
+    public ActionbarSection(
+            @NonNull String id,
+            int priority,
+            @NonNull Function<Player, @Nullable String> textSupplier,
+            @NonNull Predicate<Player> visibility
+    ) {
+        this(id, priority, textSupplier, visibility, false);
+    }
     /**
      * Creates an action bar section that is always visible for all players.
      *
@@ -30,7 +44,7 @@ public record ActionbarSection(
      * @return created action bar section
      */
     public static ActionbarSection of(String id, int priority, Function<Player, @Nullable String> textSupplier) {
-        return new ActionbarSection(id, priority, textSupplier, player -> true);
+        return new ActionbarSection(id, priority, textSupplier, player -> true, false);
     }
 
     /**
@@ -43,6 +57,19 @@ public static ActionbarSection of(String id, int priority, Function<Player, @Nul
      * @return created action bar section
      */
     public static ActionbarSection of(String id, int priority, Function<Player, @Nullable String> textSupplier, Predicate<Player> visibility) {
-        return new ActionbarSection(id, priority, textSupplier, visibility);
+        return new ActionbarSection(id, priority, textSupplier, visibility, false);
+    }
+
+    /**
+     * Creates an exclusive action bar section that overrides non-exclusive sections when visible.
+     *
+     * @param id           unique section identifier
+     * @param priority     rendering priority
+     * @param textSupplier text supplier function
+     * @param visibility   predicate controlling section display
+     * @return created exclusive action bar section
+     */
+    public static ActionbarSection exclusiveOf(String id, int priority, Function<Player, @Nullable String> textSupplier, Predicate<Player> visibility) {
+        return new ActionbarSection(id, priority, textSupplier, visibility, true);
     }
 }

bedrock/src/main/java/fr/moussax/bedrock/ui/actionbar/ActionbarService.java

@@ -25,6 +25,7 @@
  */
 public final class ActionbarService implements Listener {
 
+    // ponytail: kept — shared instance across plugins avoids actionbar packet collisions
     @Getter
     @Setter
     private static ActionbarService instance;
@@ -52,10 +53,14 @@ public ActionbarService(@NonNull Plugin plugin) {
      * @param periodTicks interval between renders in server ticks
      */
     public void start(long periodTicks) {
-        if (running) return;
+        if (running && tickerTask != null && !tickerTask.isCancelled()) return;
         running = true;
 
-        this.tickerTask = Bukkit.getScheduler().runTaskTimer(plugin, this::tickAll, periodTicks, periodTicks);
+        if (tickerTask != null) {
+            tickerTask.cancel();
+        }
+
+        this.tickerTask = Bukkit.getScheduler().runTaskTimer(plugin, this::tickAll, 0L, periodTicks);
     }
 
     /**
@@ -178,7 +183,7 @@ private void tickAll() {
             try {
                 renderPlayer(player);
             } catch (Exception exception) {
-                Log.warn("ActionbarService", "Failed to render for " + player.getName() + ": " + exception.getMessage());
+                Log.warn("ActionbarService", "Failed to render actionbar for " + player.getName() + ": " + exception.getMessage());
             }
         }
     }
@@ -192,6 +197,7 @@ private ActionbarComposer getOrCreateComposer(UUID uuid) {
     }
 
     private void sendRawPacket(@NonNull Player player, @NonNull String text) {
+        if (text == null || text.isEmpty()) return;
         player.spigot().sendMessage(ChatMessageType.ACTION_BAR, new TextComponent(text));
     }
 }