Add command permissions for dimension scheduling and Nether access management

- Introduced MarkedNetherPortal and MarkedNetherPortals classes to manage the marking and activation of Nether portals.
- Added PortalMarkStore for persistent storage of marked portals in YAML format.
- Created NetherPortalIgniter for a special item that allows marking portals in creative mode.
- Enhanced NetherAccess and NetherAccessListener to integrate the new portal marking system.
- Implemented commands and event handling for marking portals and managing their states.
- Added validation and chunk loading mechanisms to ensure proper portal functionality.

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/Arena.java

@@ -20,6 +20,7 @@ import org.bukkit.Material;
 import org.bukkit.Sound;
 import org.bukkit.World;
 import org.bukkit.attribute.Attribute;
+import org.bukkit.entity.Entity;
 import org.bukkit.entity.Player;
 import org.bukkit.entity.Villager;
 import org.bukkit.event.Listener;
@@ -104,6 +105,7 @@ public class Arena extends Appliance {
         else Main.logger().warning("Arena: pads are not set up, fights cannot be started");
 
         this.syncRegions().forEach(region -> this.worlds.keepLoaded(region, Main.instance()));
+        this.removeStrayVillagers();
         this.placeStarterPlatform();
         this.syncAll();
 
@@ -178,6 +180,25 @@ public class Arena extends Appliance {
             .forEach(this::toTribune);
     }
 
+    /**
+     * Removes old copies of the return villager, for example after its position was changed in the config by hand.
+     */
+    private void removeStrayVillagers() {
+        Region region = this.settings.syncRegion();
+        if(region == null || this.villager == null) return;
+        UUID current = this.villager.getUniqueId();
+        for(int cx = region.minChunkX(); cx <= region.maxChunkX(); cx++) {
+            for(int cz = region.minChunkZ(); cz <= region.maxChunkZ(); cz++) {
+                for(Entity entity : this.worlds.play().getChunkAt(cx, cz).getEntities()) {
+                    if(!(entity instanceof Villager) || entity.getUniqueId().equals(current)) continue;
+                    if(!entity.getScoreboardTags().contains(Displays.MANAGED_TAG)) continue;
+                    entity.remove();
+                    Main.logger().info("Arena: removed a stray return villager at " + entity.getLocation().toVector());
+                }
+            }
+        }
+    }
+
     /**
      * A fresh, empty world gets a small platform at the tribune spawn, so the first visitors do not fall into the void.
      */
@@ -204,14 +225,13 @@ public class Arena extends Appliance {
         return this.slots.stream().anyMatch(slot -> slot.state == ArenaSlot.State.FREE);
     }
 
-    void startFight(Player red, Player blue, UUID challenger, FightMode mode) {
+    void startFight(List<List<Player>> teams, FightMode mode, Map<UUID, UUID> kits) {
         ArenaSlot slot = this.slots.stream().filter(s -> s.state == ArenaSlot.State.FREE).findFirst().orElse(null);
         if(slot == null) {
-            this.toTribune(red);
-            this.toTribune(blue);
+            teams.forEach(team -> team.forEach(this::toTribune));
             return;
         }
-        new Fight(this, slot, red, blue, challenger, mode).start();
+        new Fight(this, slot, teams, mode, kits).start();
     }
 
     void resetSlot(ArenaSlot slot) {
@@ -293,7 +313,7 @@ public class Arena extends Appliance {
 
     public void handleQuit(Player player) {
         Fight fight = this.fightOf(player);
-        if(fight != null && this.state(player) == PlayerState.FIGHT) fight.forfeit(player.getUniqueId());
+        if(fight != null && fight.isAlive(player.getUniqueId())) fight.forfeit(player.getUniqueId());
         if(this.lobby != null) this.lobby.leave(player);
         this.teams.leave(player);
         this.states.remove(player.getUniqueId());
@@ -327,7 +347,7 @@ public class Arena extends Appliance {
 
     public @Nullable Region arenaRegionOf(Player player) {
         Fight fight = this.fightOf(player);
-        return fight == null ? null : fight.slot().settings.region();
+        return fight == null ? null : fight.region();
     }
 
     public @Nullable Lobby lobby() {
@@ -373,6 +393,7 @@ public class Arena extends Appliance {
             new FightListener(),
             new WorldProtectionListener(),
             new ModeMenuListener(),
+            new NoProgressListener(),
             new PlayerInteractAtEntityEventListener(villager, event -> this.sendToCraftAttack(event.getPlayer())),
             new DismissInventoryOpenFromHolder(villager)
         );

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/ArenaSlot.java

@@ -23,7 +23,8 @@ final class ArenaSlot {
 
     ArenaSlot(ArenaSettings.Slot settings, World world) {
         this.settings = settings;
-        this.display = Displays.spawn(settings.displayLocation(world));
+        // seen from the tribune across half an arena, so twice the size
+        this.display = Displays.spawn(settings.displayLocation(world), 2f);
     }
 
     void updateDisplay() {

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/ArenaWorlds.java

@@ -39,6 +39,7 @@ final class ArenaWorlds {
             world.setGameRule(GameRules.SPAWN_WARDENS, false);
             world.setGameRule(GameRules.RAIDS, false);
             world.setGameRule(GameRules.SHOW_DEATH_MESSAGES, false);
+            world.setGameRule(GameRules.SHOW_ADVANCEMENT_MESSAGES, false);
             world.setStorm(false);
             world.setThundering(false);
             world.setTime(6000);

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/Displays.java

@@ -5,6 +5,7 @@ import org.bukkit.Color;
 import org.bukkit.Location;
 import org.bukkit.entity.Display;
 import org.bukkit.entity.TextDisplay;
+import org.bukkit.util.Transformation;
 
 /**
  * Floating texts above pads and arenas. They are not saved with the world and come back with every start.
@@ -16,6 +17,10 @@ final class Displays {
     }
 
     static TextDisplay spawn(Location location) {
+        return spawn(location, 1f);
+    }
+
+    static TextDisplay spawn(Location location, float scale) {
         // displays are not saved, they would vanish with an unloaded chunk
         location.getWorld().addPluginChunkTicket(location.getBlockX() >> 4, location.getBlockZ() >> 4, Main.instance());
         return location.getWorld().spawn(location, TextDisplay.class, display -> {
@@ -26,6 +31,11 @@ final class Displays {
             display.setBackgroundColor(Color.fromARGB(110, 0, 0, 0));
             display.setLineWidth(220);
             display.addScoreboardTag(MANAGED_TAG);
+            if(scale != 1f) {
+                Transformation transformation = display.getTransformation();
+                transformation.getScale().set(scale);
+                display.setTransformation(transformation);
+            }
         });
     }
 }

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/Fight.java

@@ -1,9 +1,11 @@
 package eu.mhsl.craftattack.spawn.arena.appliances.arena;
 
 import eu.mhsl.craftattack.spawn.arena.appliances.arena.logic.FightMode;
+import eu.mhsl.craftattack.spawn.arena.appliances.arena.logic.Region;
 import eu.mhsl.craftattack.spawn.core.Main;
 import net.kyori.adventure.bossbar.BossBar;
 import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.JoinConfiguration;
 import net.kyori.adventure.text.format.NamedTextColor;
 import net.kyori.adventure.title.Title;
 import org.bukkit.Bukkit;
@@ -18,37 +20,44 @@ import org.jetbrains.annotations.Nullable;
 
 import java.time.Duration;
 import java.util.ArrayList;
+import java.util.HashMap;
 import java.util.HashSet;
+import java.util.LinkedHashSet;
 import java.util.List;
+import java.util.Map;
 import java.util.Set;
 import java.util.UUID;
 
 /**
- * A running fight in one arena. Fighter 0 comes from the red pad and uses spawn 1, fighter 1 the blue pad and spawn 2.
+ * A running fight in one arena between team 0 (red pad, spawn 1) and team 1 (blue pad, spawn 2).
+ * A team loses once none of its players is left in the arena.
  */
 final class Fight {
     private static final int CELEBRATION_TICKS = 60;
-    private static final double SPECTATOR_RANGE = 24;
+    private static final double SPECTATOR_RANGE = 32;
+    private static final double SPAWN_SPREAD = 2;
 
     private final Arena arena;
     private final ArenaSlot slot;
-    private final UUID[] fighters;
-    private final String[] names;
-    private final UUID challenger;
+    private final List<List<UUID>> teams;
+    private final Map<UUID, String> names = new HashMap<>();
+    private final List<Set<UUID>> alive;
     private final FightMode mode;
+    private final Map<UUID, UUID> kits;
     private final BossBar bossBar;
     private final Set<UUID> bossBarViewers = new HashSet<>();
     private int secondsLeft;
     private boolean over;
     private @Nullable BukkitTask timer;
 
-    Fight(Arena arena, ArenaSlot slot, Player red, Player blue, UUID challenger, FightMode mode) {
+    Fight(Arena arena, ArenaSlot slot, List<List<Player>> teams, FightMode mode, Map<UUID, UUID> kits) {
         this.arena = arena;
         this.slot = slot;
-        this.fighters = new UUID[]{red.getUniqueId(), blue.getUniqueId()};
-        this.names = new String[]{red.getName(), blue.getName()};
-        this.challenger = challenger;
+        this.teams = teams.stream().map(team -> team.stream().map(Player::getUniqueId).toList()).toList();
+        teams.forEach(team -> team.forEach(player -> this.names.put(player.getUniqueId(), player.getName())));
+        this.alive = this.teams.stream().map(team -> (Set<UUID>) new LinkedHashSet<>(team)).toList();
         this.mode = mode;
+        this.kits = kits;
         this.secondsLeft = arena.settings().fightSeconds();
         this.bossBar = BossBar.bossBar(Component.empty(), 1f, BossBar.Color.RED, BossBar.Overlay.NOTCHED_10);
     }
@@ -57,44 +66,72 @@ final class Fight {
         this.slot.state = ArenaSlot.State.FIGHT;
         this.slot.fight = this;
 
-        FightMode.Role[] roles = new FightMode.Role[2];
-        for(int i = 0; i < 2; i++) {
-            roles[i] = this.fighters[i].equals(this.challenger) ? FightMode.Role.CHALLENGER : FightMode.Role.OPPONENT;
-        }
-        UUID challengerId = this.challenger;
-        UUID opponentId = this.fighters[0].equals(challengerId) ? this.fighters[1] : this.fighters[0];
-
-        for(int i = 0; i < 2; i++) {
-            Player player = Bukkit.getPlayer(this.fighters[i]);
-            if(player == null) continue;
-            UUID kitOwner = this.mode.kitSource(roles[i]) == FightMode.Role.CHALLENGER ? challengerId : opponentId;
-
-            this.arena.setState(player, Arena.PlayerState.FIGHT);
-            this.arena.teams().join(player, Teams.fight(i));
-            player.closeInventory();
-            player.teleport(this.slot.settings.spawns()[i]);
-            Arena.restore(player, GameMode.SURVIVAL);
-            InventoryStore.apply(player, kitOwner);
-
-            player.showTitle(Title.title(
-                Component.text("Kampf!", NamedTextColor.GOLD),
-                Component.text("gegen ", NamedTextColor.GRAY).append(Component.text(this.names[1 - i], Style.PAD_TEXT_COLORS[1 - i])),
-                Title.Times.times(Duration.ZERO, Duration.ofMillis(1500), Duration.ofMillis(500))
-            ));
-            Style.play(player, Sound.EVENT_RAID_HORN, 1.2f);
+        for(int team = 0; team < 2; team++) {
+            List<UUID> members = this.teams.get(team);
+            for(int i = 0; i < members.size(); i++) {
+                Player player = Bukkit.getPlayer(members.get(i));
+                if(player == null) continue;
+                this.arena.setState(player, Arena.PlayerState.FIGHT);
+                this.arena.teams().join(player, Teams.fight(team));
+                player.closeInventory();
+                player.teleport(this.spawnFor(team, i, members.size()));
+                Arena.restore(player, GameMode.SURVIVAL);
+                InventoryStore.apply(player, this.kits.getOrDefault(player.getUniqueId(), player.getUniqueId()));
+
+                player.showTitle(Title.title(
+                    Component.text("Kampf!", NamedTextColor.GOLD),
+                    Component.text("gegen ", NamedTextColor.GRAY).append(this.teamNames(1 - team)),
+                    Title.Times.times(Duration.ZERO, Duration.ofMillis(1500), Duration.ofMillis(500))
+                ));
+                Style.play(player, Sound.EVENT_RAID_HORN, 1.2f);
+            }
         }
+        // players who left during the countdown never arrived
+        for(int team = 0; team < 2; team++) this.alive.get(team).removeIf(uuid -> Bukkit.getPlayer(uuid) == null);
 
         Bukkit.broadcast(Style.message(
-            this.headline().append(Component.text(" in Arena " + this.slot.settings.name() + ". Modus: " + this.mode.displayName(), NamedTextColor.GRAY))
+            this.teamNames(0).append(Component.text(" gegen ", NamedTextColor.GRAY)).append(this.teamNames(1))
+                .append(Component.text(" in Arena " + this.slot.settings.name() + ". Modus: " + this.mode.displayName(this.isTeamFight()), NamedTextColor.GRAY))
         ));
         this.updateBossBar();
         this.timer = Bukkit.getScheduler().runTaskTimer(Main.instance(), this::tickSecond, 20, 20);
+        if(this.alive.get(0).isEmpty() || this.alive.get(1).isEmpty()) this.checkEnd();
     }
 
+    /**
+     * Team members stand in a small circle around the spawn, facing the same way.
+     */
+    private Location spawnFor(int team, int index, int count) {
+        Location center = this.slot.settings.spawns()[team];
+        if(count == 1) return center;
+        double angle = 2 * Math.PI * index / count;
+        Location spot = center.clone().add(Math.cos(angle) * SPAWN_SPREAD, 0, Math.sin(angle) * SPAWN_SPREAD);
+        boolean free = spot.getBlock().isPassable() && spot.clone().add(0, 1, 0).getBlock().isPassable()
+            && !spot.clone().subtract(0, 1, 0).getBlock().isPassable();
+        return free ? spot : center;
+    }
+
+    private boolean isTeamFight() {
+        return this.teams.get(0).size() > 1 || this.teams.get(1).size() > 1;
+    }
+
+    private Component teamNames(int team) {
+        return Component.join(
+            JoinConfiguration.separator(Component.text(", ", NamedTextColor.GRAY)),
+            this.teams.get(team).stream().map(uuid -> Component.text(this.names.get(uuid), Style.PAD_TEXT_COLORS[team])).toList()
+        );
+    }
+
+    /**
+     * Short form for bossbar and displays: names in a duel, "Rot 2/3" in a team fight.
+     */
     Component headline() {
-        return Component.text(this.names[0], Style.PAD_TEXT_COLORS[0])
+        if(!this.isTeamFight()) {
+            return this.teamNames(0).append(Component.text(" gegen ", NamedTextColor.GRAY)).append(this.teamNames(1));
+        }
+        return Component.text("Rot " + this.alive.get(0).size() + "/" + this.teams.get(0).size(), Style.PAD_TEXT_COLORS[0])
             .append(Component.text(" gegen ", NamedTextColor.GRAY))
-            .append(Component.text(this.names[1], Style.PAD_TEXT_COLORS[1]));
+            .append(Component.text("Blau " + this.alive.get(1).size() + "/" + this.teams.get(1).size(), Style.PAD_TEXT_COLORS[1]));
     }
 
     int secondsLeft() {
@@ -106,7 +143,20 @@ final class Fight {
     }
 
     boolean involves(UUID player) {
-        return this.fighters[0].equals(player) || this.fighters[1].equals(player);
+        return this.teams.get(0).contains(player) || this.teams.get(1).contains(player);
+    }
+
+    boolean isAlive(UUID player) {
+        return this.alive.get(0).contains(player) || this.alive.get(1).contains(player);
+    }
+
+    boolean sameTeam(UUID a, UUID b) {
+        int team = this.teamOf(a);
+        return team != -1 && team == this.teamOf(b);
+    }
+
+    Region region() {
+        return this.slot.settings.region();
     }
 
     ArenaSlot slot() {
@@ -116,11 +166,11 @@ final class Fight {
     private void tickSecond() {
         if(this.over) return;
         if(--this.secondsLeft <= 0) {
-            this.finish(-1, Component.text("Die Zeit ist abgelaufen.", NamedTextColor.GRAY));
+            this.timeUp();
             return;
         }
         if(this.secondsLeft == 60 || this.secondsLeft == 10) {
-            this.fighterPlayers().forEach(player -> {
+            this.alivePlayers().forEach(player -> {
                 player.sendActionBar(Component.text("Noch " + this.secondsLeft + " Sekunden", NamedTextColor.YELLOW));
                 Style.play(player, Sound.BLOCK_NOTE_BLOCK_HAT, 0.8f);
             });
@@ -128,13 +178,40 @@ final class Fight {
         this.updateBossBar();
     }
 
+    /**
+     * More survivors win, then more hearts left, otherwise a draw.
+     */
+    private void timeUp() {
+        int red = this.alive.get(0).size();
+        int blue = this.alive.get(1).size();
+        if(red != blue) {
+            this.finish(red > blue ? 0 : 1, Component.text("(Zeit abgelaufen, mehr Überlebende)", NamedTextColor.GRAY));
+            return;
+        }
+        double redHealth = this.health(0);
+        double blueHealth = this.health(1);
+        if(Math.abs(redHealth - blueHealth) >= 0.5) {
+            this.finish(redHealth > blueHealth ? 0 : 1, Component.text("(Zeit abgelaufen, mehr Herzen übrig)", NamedTextColor.GRAY));
+            return;
+        }
+        this.finish(-1, Component.text("Die Zeit ist abgelaufen.", NamedTextColor.GRAY));
+    }
+
+    private double health(int team) {
+        return this.alive.get(team).stream()
+            .map(Bukkit::getPlayer)
+            .filter(player -> player != null)
+            .mapToDouble(player -> player.getHealth() + player.getAbsorptionAmount())
+            .sum();
+    }
+
     private void updateBossBar() {
         this.bossBar.name(this.headline().append(Component.text("   " + Style.time(this.secondsLeft), NamedTextColor.WHITE)));
         this.bossBar.progress(Math.clamp((float) this.secondsLeft / this.arena.settings().fightSeconds(), 0f, 1f));
 
         Set<UUID> viewers = new HashSet<>();
         for(Player player : this.arena.worlds().play().getPlayers()) {
-            if(this.involves(player.getUniqueId()) || this.isSpectating(player)) viewers.add(player.getUniqueId());
+            if(this.isAlive(player.getUniqueId()) || this.isSpectating(player)) viewers.add(player.getUniqueId());
         }
         for(UUID uuid : this.bossBarViewers) {
             Player player = Bukkit.getPlayer(uuid);
@@ -150,32 +227,72 @@ final class Fight {
 
     private boolean isSpectating(Player player) {
         if(this.arena.state(player) != Arena.PlayerState.TRIBUNE && this.arena.state(player) != Arena.PlayerState.PAD) return false;
-        var region = this.slot.settings.region();
+        Region region = this.slot.settings.region();
         double dx = Math.max(0, Math.max(region.minX() - player.getX(), player.getX() - (region.maxX() + 1)));
         double dz = Math.max(0, Math.max(region.minZ() - player.getZ(), player.getZ() - (region.maxZ() + 1)));
         return Math.hypot(dx, dz) <= SPECTATOR_RANGE;
     }
 
     /**
-     * The player took lethal damage.
+     * The player took lethal damage: out of the fight and back to the tribune.
      */
-    void defeated(Player loser) {
-        int index = this.indexOf(loser.getUniqueId());
-        if(index == -1 || this.over) return;
-        Player winner = Bukkit.getPlayer(this.fighters[1 - index]);
-        Component detail = winner == null
-            ? Component.empty()
-            : Component.text("(" + this.mode.displayName() + ", " + Style.hearts(winner.getHealth() + winner.getAbsorptionAmount()) + " ❤ übrig)", NamedTextColor.GRAY);
-        this.finish(1 - index, detail);
+    void defeated(Player player) {
+        this.knockOut(player, Component.empty(), "ist ausgeschieden");
+    }
+
+    /**
+     * The player got out of the box, for example by glitching through a wall with an ender pearl.
+     */
+    void leftBox(Player player) {
+        this.knockOut(player, Component.text("Du hast die Arena verlassen", NamedTextColor.GRAY), "hat die Arena verlassen");
+    }
+
+    private void knockOut(Player player, Component subtitle, String what) {
+        if(this.over || !this.eliminate(player.getUniqueId())) return;
+        player.showTitle(Title.title(Component.text("Ausgeschieden", NamedTextColor.RED), subtitle));
+        Style.play(player, Sound.BLOCK_BEACON_DEACTIVATE, 1f);
+        this.arena.toTribune(player);
+        this.announceElimination(player.getUniqueId(), what);
+        this.checkEnd();
     }
 
     /**
      * The player left the server during the fight.
      */
     void forfeit(UUID quitter) {
-        int index = this.indexOf(quitter);
-        if(index == -1 || this.over) return;
-        this.finish(1 - index, Component.text("(" + this.names[index] + " hat die Arena verlassen)", NamedTextColor.GRAY));
+        if(this.over || !this.eliminate(quitter)) return;
+        this.announceElimination(quitter, "hat die Arena verlassen");
+        this.checkEnd();
+    }
+
+    private boolean eliminate(UUID player) {
+        int team = this.teamOf(player);
+        return team != -1 && this.alive.get(team).remove(player);
+    }
+
+    private void announceElimination(UUID player, String what) {
+        if(!this.isTeamFight()) return;
+        int team = this.teamOf(player);
+        Component message = Component.text(this.names.get(player), Style.PAD_TEXT_COLORS[team])
+            .append(Component.text(" " + what + ". ", NamedTextColor.GRAY))
+            .append(this.headline());
+        this.alivePlayers().forEach(fighter -> fighter.sendActionBar(message));
+        this.updateBossBar();
+    }
+
+    private void checkEnd() {
+        if(this.over) return;
+        boolean redOut = this.alive.get(0).isEmpty();
+        boolean blueOut = this.alive.get(1).isEmpty();
+        if(redOut && blueOut) this.finish(-1, Component.text("Niemand ist mehr übrig.", NamedTextColor.GRAY));
+        else if(redOut) this.finish(1, this.detail(1));
+        else if(blueOut) this.finish(0, this.detail(0));
+    }
+
+    private Component detail(int winner) {
+        String hearts = Style.hearts(this.health(winner));
+        String survivors = this.isTeamFight() ? this.alive.get(winner).size() + " übrig, " : "";
+        return Component.text("(" + this.mode.displayName(this.isTeamFight()) + ", " + survivors + hearts + " ❤)", NamedTextColor.GRAY);
     }
 
     /**
@@ -186,23 +303,20 @@ final class Fight {
         this.over = true;
         this.stopTimer();
         this.hideBossBar();
-        this.fighterPlayers().forEach(this.arena::toTribune);
+        this.alivePlayers().forEach(this.arena::toTribune);
         this.slot.fight = null;
     }
 
-    private void finish(int winnerIndex, Component detail) {
+    private void finish(int winner, Component detail) {
         this.over = true;
         this.stopTimer();
 
-        if(winnerIndex == -1) {
+        if(winner == -1) {
             Bukkit.broadcast(Style.message(
-                Component.text(this.names[0], Style.PAD_TEXT_COLORS[0])
-                    .append(Component.text(" und ", NamedTextColor.GRAY))
-                    .append(Component.text(this.names[1], Style.PAD_TEXT_COLORS[1]))
-                    .append(Component.text(" trennen sich unentschieden. ", NamedTextColor.GRAY))
-                    .append(detail)
+                this.teamNames(0).append(Component.text(" und ", NamedTextColor.GRAY)).append(this.teamNames(1))
+                    .append(Component.text(" trennen sich unentschieden. ", NamedTextColor.GRAY)).append(detail)
             ));
-            this.fighterPlayers().forEach(player -> {
+            this.alivePlayers().forEach(player -> {
                 player.showTitle(Title.title(Component.text("Unentschieden", NamedTextColor.YELLOW), detail));
                 Style.play(player, Sound.BLOCK_BEACON_DEACTIVATE, 1f);
                 this.arena.toTribune(player);
@@ -211,33 +325,31 @@ final class Fight {
             return;
         }
 
-        int loserIndex = 1 - winnerIndex;
+        int loser = 1 - winner;
+        boolean plural = this.teams.get(winner).size() > 1;
         Bukkit.broadcast(Style.message(
-            Component.text(this.names[winnerIndex], Style.PAD_TEXT_COLORS[winnerIndex])
-                .append(Component.text(" hat gegen ", NamedTextColor.GRAY))
-                .append(Component.text(this.names[loserIndex], Style.PAD_TEXT_COLORS[loserIndex]))
-                .append(Component.text(" gewonnen ", NamedTextColor.GRAY))
+            this.teamNames(winner)
+                .append(Component.text(plural ? " gewinnen gegen " : " hat gegen ", NamedTextColor.GRAY))
+                .append(this.teamNames(loser))
+                .append(Component.text(plural ? " " : " gewonnen ", NamedTextColor.GRAY))
                 .append(detail)
         ));
 
-        Player loser = Bukkit.getPlayer(this.fighters[loserIndex]);
-        if(loser != null) {
-            loser.showTitle(Title.title(
-                Component.text("Verloren", NamedTextColor.RED),
-                Component.text(this.names[winnerIndex] + " hat gewonnen", NamedTextColor.GRAY)
-            ));
-            Style.play(loser, Sound.BLOCK_BEACON_DEACTIVATE, 1f);
-            this.arena.toTribune(loser);
+        for(UUID uuid : this.teams.get(loser)) {
+            Player player = Bukkit.getPlayer(uuid);
+            if(player == null) continue;
+            player.showTitle(Title.title(Component.text("Verloren", NamedTextColor.RED), Component.empty()));
+            if(this.alive.get(loser).contains(uuid)) this.arena.toTribune(player);
         }
-
-        Player winner = Bukkit.getPlayer(this.fighters[winnerIndex]);
-        if(winner != null) {
-            winner.showTitle(Title.title(
+        for(UUID uuid : this.teams.get(winner)) {
+            Player player = Bukkit.getPlayer(uuid);
+            if(player == null) continue;
+            player.showTitle(Title.title(
                 Component.text("Gewonnen!", NamedTextColor.GOLD),
-                Component.text("gegen " + this.names[loserIndex], NamedTextColor.GRAY)
+                Component.text("gegen ", NamedTextColor.GRAY).append(this.teamNames(loser))
             ));
-            Style.play(winner, Sound.UI_TOAST_CHALLENGE_COMPLETE, 1f);
-            this.celebrate(winner.getLocation(), Style.PAD_PARTICLE_COLORS[winnerIndex]);
+            Style.play(player, Sound.UI_TOAST_CHALLENGE_COMPLETE, 1f);
+            if(this.alive.get(winner).contains(uuid)) this.celebrate(player.getLocation(), Style.PAD_PARTICLE_COLORS[winner]);
         }
         this.afterCelebration();
     }
@@ -261,9 +373,8 @@ final class Fight {
     private void afterCelebration() {
         this.hideBossBar();
         Bukkit.getScheduler().runTaskLater(Main.instance(), () -> {
-            for(UUID uuid : this.fighters) {
-                Player player = Bukkit.getPlayer(uuid);
-                if(player != null && this.arena.fightOf(player) == this) this.arena.toTribune(player);
+            for(Player player : this.alivePlayers()) {
+                if(this.arena.fightOf(player) == this && this.arena.state(player) == Arena.PlayerState.FIGHT) this.arena.toTribune(player);
             }
             this.slot.fight = null;
             this.arena.resetSlot(this.slot);
@@ -275,17 +386,19 @@ final class Fight {
         this.timer = null;
     }
 
-    private int indexOf(UUID player) {
-        if(this.fighters[0].equals(player)) return 0;
-        if(this.fighters[1].equals(player)) return 1;
+    private int teamOf(UUID player) {
+        if(this.teams.get(0).contains(player)) return 0;
+        if(this.teams.get(1).contains(player)) return 1;
         return -1;
     }
 
-    private List<Player> fighterPlayers() {
+    private List<Player> alivePlayers() {
         List<Player> players = new ArrayList<>();
-        for(UUID uuid : this.fighters) {
-            Player player = Bukkit.getPlayer(uuid);
-            if(player != null) players.add(player);
+        for(Set<UUID> team : this.alive) {
+            for(UUID uuid : team) {
+                Player player = Bukkit.getPlayer(uuid);
+                if(player != null) players.add(player);
+            }
         }
         return players;
     }

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/FightListener.java

@@ -12,6 +12,7 @@ import org.bukkit.event.EventPriority;
 import org.bukkit.event.entity.EntityDamageByEntityEvent;
 import org.bukkit.event.entity.EntityDamageEvent;
 import org.bukkit.event.entity.PlayerDeathEvent;
+import org.bukkit.event.player.PlayerMoveEvent;
 import org.bukkit.event.player.PlayerRespawnEvent;
 import org.bukkit.event.player.PlayerTeleportEvent;
 import org.bukkit.inventory.ItemStack;
@@ -22,19 +23,23 @@ import org.bukkit.inventory.ItemStack;
 class FightListener extends ApplianceListener<Arena> {
     private boolean isFighting(Player player) {
         Fight fight = this.getAppliance().fightOf(player);
-        return fight != null && !fight.isOver() && this.getAppliance().state(player) == Arena.PlayerState.FIGHT;
+        return fight != null && !fight.isOver() && fight.isAlive(player.getUniqueId());
     }
 
+    /**
+     * Only fighters hit each other, and never their own team directly. Explosions still hurt everyone.
+     */
     @EventHandler(priority = EventPriority.HIGH, ignoreCancelled = true)
     public void onDamageByPlayer(EntityDamageByEntityEvent event) {
-        if(!(event.getEntity() instanceof Player)) return;
+        if(!(event.getEntity() instanceof Player victim)) return;
         Player attacker = switch(event.getDamager()) {
             case Player player -> player;
             case Projectile projectile when projectile.getShooter() instanceof Player shooter -> shooter;
             default -> null;
         };
-        if(attacker == null || attacker == event.getEntity()) return;
-        if(!this.isFighting(attacker)) event.setCancelled(true);
+        if(attacker == null || attacker == victim) return;
+        Fight fight = this.getAppliance().fightOf(attacker);
+        if(!this.isFighting(attacker) || fight.sameTeam(attacker.getUniqueId(), victim.getUniqueId())) event.setCancelled(true);
     }
 
     @EventHandler(priority = EventPriority.HIGHEST, ignoreCancelled = true)
@@ -90,4 +95,17 @@ class FightListener extends ApplianceListener<Arena> {
             event.setCancelled(true);
         }
     }
+
+    /**
+     * Whoever ends up outside the box anyway (ender pearl through a wall or corner) loses.
+     */
+    @EventHandler(priority = EventPriority.MONITOR, ignoreCancelled = true)
+    public void onMove(PlayerMoveEvent event) {
+        if(!event.hasChangedBlock()) return;
+        Player player = event.getPlayer();
+        if(this.getAppliance().state(player) != Arena.PlayerState.FIGHT || !this.isFighting(player)) return;
+        Fight fight = this.getAppliance().fightOf(player);
+        if(event.getTo().getWorld() == this.getAppliance().worlds().play() && fight.region().contains(event.getTo().getX(), event.getTo().getY(), event.getTo().getZ())) return;
+        fight.leftBox(player);
+    }
 }

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/Lobby.java

@@ -5,6 +5,7 @@ import eu.mhsl.craftattack.spawn.arena.appliances.arena.logic.PadLobby;
 import eu.mhsl.craftattack.spawn.arena.appliances.arena.logic.Region;
 import eu.mhsl.craftattack.spawn.core.util.world.InteractSounds;
 import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.JoinConfiguration;
 import net.kyori.adventure.text.format.NamedTextColor;
 import net.kyori.adventure.title.Title;
 import org.bukkit.Bukkit;
@@ -19,7 +20,9 @@ import org.jetbrains.annotations.Nullable;
 
 import java.time.Duration;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
+import java.util.Objects;
 import java.util.UUID;
 
 /**
@@ -29,6 +32,10 @@ import java.util.UUID;
 final class Lobby implements PadLobby.Listener {
     /** How far around a taken pad other players get pushed away. */
     private static final double PUSH_MARGIN = 0.4;
+    /** How long a full lobby waits for the challenger to close the options. */
+    private static final int CHOOSING_SECONDS = 20;
+    /** Whoever keeps the options open this long without clicking anything gets sent off the pad. */
+    private static final int MENU_IDLE_TICKS = 60 * 20;
 
     private final Arena arena;
     private final Region[] regions;
@@ -36,11 +43,13 @@ final class Lobby implements PadLobby.Listener {
     private final TextDisplay[] displays = new TextDisplay[PadLobby.PADS];
     private final Map<UUID, Long> lastPushSound = new HashMap<>();
     private long ticks;
+    private @Nullable UUID menuViewer;
+    private int menuIdleTicks;
 
     Lobby(Arena arena, Region[] regions) {
         this.arena = arena;
         this.regions = regions;
-        this.pads = new PadLobby(this, arena.settings().countdownSeconds());
+        this.pads = new PadLobby(this, arena.settings().countdownSeconds(), CHOOSING_SECONDS);
         for(int i = 0; i < PadLobby.PADS; i++) {
             Region region = regions[i];
             this.displays[i] = Displays.spawn(new Location(arena.worlds().play(), region.centerX(), region.maxY() + 2.6, region.centerZ()));
@@ -55,12 +64,23 @@ final class Lobby implements PadLobby.Listener {
             else if(state == Arena.PlayerState.TRIBUNE) this.checkEnter(player);
         }
 
+        this.checkMenuIdle();
         this.pads.tick(this.arena.hasFreeSlot());
 
         if(this.ticks % 3 == 0) this.drawParticles();
         if(this.ticks % 5 == 0) this.updateDisplays();
     }
 
+    private void checkMenuIdle() {
+        if(this.menuViewer == null || ++this.menuIdleTicks < MENU_IDLE_TICKS) return;
+        Player player = Bukkit.getPlayer(this.menuViewer);
+        this.menuViewer = null;
+        if(player == null || !ModeMenu.isOpen(player)) return;
+        this.arena.toTribune(player);
+        player.sendMessage(Style.message("Du hast eine Minute lang nichts ausgewählt und wurdest vom Feld geschickt."));
+        Style.play(player, Sound.BLOCK_NOTE_BLOCK_BASS, 0.6f);
+    }
+
     private void checkLeave(Player player) {
         int pad = this.pads.padOf(player.getUniqueId());
         if(pad != -1 && this.isOn(player, pad, 0)) return;
@@ -69,7 +89,7 @@ final class Lobby implements PadLobby.Listener {
 
     private void checkEnter(Player player) {
         for(int pad = 0; pad < PadLobby.PADS; pad++) {
-            if(this.pads.occupant(pad) != null) {
+            if(this.pads.isPadFull(pad)) {
                 if(this.isOn(player, pad, PUSH_MARGIN)) this.pushAway(player, pad);
                 continue;
             }
@@ -79,6 +99,12 @@ final class Lobby implements PadLobby.Listener {
             this.arena.setState(player, Arena.PlayerState.PAD);
             this.arena.teams().join(player, Teams.pad(pad));
             Style.play(player, Sound.BLOCK_NOTE_BLOCK_PLING, 1.4f);
+            if(this.pads.isWaitingForChallenger()) {
+                player.sendActionBar(this.choosingText());
+            } else if(!player.getUniqueId().equals(this.pads.challenger())) {
+                player.sendActionBar(Component.text(Style.PAD_NAMES[pad] + " " + this.pads.players(pad).size() + "/" + this.pads.size(pad)
+                    + ", Modus: " + this.modeName(), Style.PAD_TEXT_COLORS[pad]));
+            }
             return;
         }
     }
@@ -94,14 +120,81 @@ final class Lobby implements PadLobby.Listener {
         this.arena.setState(player, Arena.PlayerState.TRIBUNE);
     }
 
-    void chooseMode(Player player, FightMode mode) {
-        if(!this.pads.setMode(player.getUniqueId(), mode)) {
-            player.closeInventory();
+    void handleMenuClick(Player player, ModeMenu menu, ModeMenu.Click click) {
+        int ownSize = menu.ownSize;
+        int opponentSize = menu.opponentSize;
+        FightMode mode = menu.mode;
+        this.menuIdleTicks = 0;
+        switch(click) {
+            case ModeMenu.OwnSize(int size) -> ownSize = size;
+            case ModeMenu.OpponentSize(int size) -> opponentSize = size;
+            case ModeMenu.Mode(FightMode chosen) -> mode = chosen;
+            case ModeMenu.Done() -> {
+                InteractSounds.of(player).success();
+                player.closeInventory();
+                player.sendActionBar(Component.text(this.pads.size(this.pads.challengerPad()) + " gegen " + this.pads.size(1 - this.pads.challengerPad())
+                    + ", Modus: " + this.modeName() + ". Rechtsklick öffnet die Auswahl wieder.", NamedTextColor.GOLD));
+                return;
+            }
+        }
+        // switching to teams drops the opponent's inventory mode
+        if(!mode.isAllowed(ownSize, opponentSize)) mode = FightMode.OWN;
+
+        int ownPad = this.pads.challengerPad();
+        String problem = switch(this.pads.configure(player.getUniqueId(), ownSize, opponentSize, mode)) {
+            case OK -> null;
+            case NOT_ALLOWED -> "Der Countdown läuft schon";
+            case OWN_TOO_SMALL -> "Auf deinem Feld stehen schon " + this.pads.players(ownPad).size();
+            case OPPONENT_TOO_SMALL -> "Auf dem anderen Feld stehen schon " + this.pads.players(1 - ownPad).size();
+            case INVALID -> "Das geht so nicht";
+        };
+        if(problem != null) {
+            Style.play(player, Sound.BLOCK_NOTE_BLOCK_BASS, 0.6f);
+            player.sendActionBar(Component.text(problem, NamedTextColor.RED));
+            if(!this.pads.canConfigure(player.getUniqueId())) player.closeInventory();
             return;
         }
+        menu.ownSize = ownSize;
+        menu.opponentSize = opponentSize;
+        menu.mode = mode;
+        menu.draw();
         InteractSounds.of(player).click();
-        player.closeInventory();
-        player.sendActionBar(Component.text("Modus: " + mode.displayName(), NamedTextColor.GOLD));
+    }
+
+    /**
+     * Right click on the pad: the challenger opens the options again.
+     */
+    boolean openMenu(Player player) {
+        if(!this.pads.canConfigure(player.getUniqueId()) || ModeMenu.isOpen(player)) return false;
+        int pad = this.pads.challengerPad();
+        InteractSounds.of(player).open();
+        ModeMenu.open(player, pad, this.pads.size(pad), this.pads.size(1 - pad), this.pads.mode());
+        this.menuViewer = player.getUniqueId();
+        this.menuIdleTicks = 0;
+        this.pads.setChoosing(player.getUniqueId(), true);
+        return true;
+    }
+
+    /**
+     * The challenger closed the options: a full lobby starts counting down now.
+     */
+    void menuClosed(Player player) {
+        if(player.getUniqueId().equals(this.menuViewer)) this.menuViewer = null;
+        this.pads.setChoosing(player.getUniqueId(), false);
+    }
+
+    private Component choosingText() {
+        Player challenger = this.pads.challenger() == null ? null : Bukkit.getPlayer(this.pads.challenger());
+        String name = challenger == null ? "Der Herausforderer" : challenger.getName();
+        return Component.text(name + " wählt noch Teams und Modus", NamedTextColor.YELLOW);
+    }
+
+    private boolean isTeamFight() {
+        return this.pads.size(0) > 1 || this.pads.size(1) > 1;
+    }
+
+    private String modeName() {
+        return this.pads.mode().displayName(this.isTeamFight());
     }
 
     boolean isIdle() {
@@ -109,11 +202,7 @@ final class Lobby implements PadLobby.Listener {
     }
 
     void shutdown() {
-        for(int pad = 0; pad < PadLobby.PADS; pad++) {
-            UUID occupant = this.pads.occupant(pad);
-            Player player = occupant == null ? null : Bukkit.getPlayer(occupant);
-            if(player != null) this.leave(player);
-        }
+        for(int pad = 0; pad < PadLobby.PADS; pad++) this.playersOn(pad).forEach(this::leave);
         for(TextDisplay display : this.displays) display.remove();
     }
 
@@ -134,121 +223,143 @@ final class Lobby implements PadLobby.Listener {
         if(now - this.lastPushSound.getOrDefault(player.getUniqueId(), 0L) < 1000) return;
         this.lastPushSound.put(player.getUniqueId(), now);
         Style.play(player, Sound.BLOCK_NOTE_BLOCK_BASS, 0.6f);
-        player.sendActionBar(Component.text("Dieses Feld ist besetzt", NamedTextColor.RED));
+        player.sendActionBar(Component.text("Dieses Feld ist voll", NamedTextColor.RED));
     }
 
     @Override
-    public void challengerSelected(UUID challenger) {
+    public void challengerSelected(UUID challenger, boolean first) {
         Player player = Bukkit.getPlayer(challenger);
         if(player == null) return;
-        player.sendMessage(Style.message("Du forderst heraus. Wähle den Modus. Wer sich auf das andere Feld stellt, nimmt an."));
-        InteractSounds.of(player).open();
-        ModeMenu.open(player, this.pads.mode());
+        if(!first) {
+            player.sendMessage(Style.message("Du führst jetzt die Herausforderung an. Rechtsklick auf dem Feld öffnet die Auswahl."));
+            Style.play(player, Sound.BLOCK_NOTE_BLOCK_PLING, 1.8f);
+            return;
+        }
+        player.sendMessage(Style.message("Du forderst heraus. Wähle Teamgröße und Modus, Rechtsklick auf dem Feld öffnet die Auswahl wieder. Wer sich auf die Felder stellt, macht mit."));
+        this.openMenu(player);
     }
 
     @Override
-    public void kitsApplied(UUID challenger, UUID opponent, FightMode mode) {
-        Player challengerPlayer = Bukkit.getPlayer(challenger);
-        Player opponentPlayer = Bukkit.getPlayer(opponent);
-        if(challengerPlayer == null || opponentPlayer == null) return;
-        if(ModeMenu.isOpen(challengerPlayer)) challengerPlayer.closeInventory();
-
-        InventoryStore.apply(challengerPlayer, mode.kitSource(FightMode.Role.CHALLENGER) == FightMode.Role.CHALLENGER ? challenger : opponent);
-        InventoryStore.apply(opponentPlayer, mode.kitSource(FightMode.Role.OPPONENT) == FightMode.Role.CHALLENGER ? challenger : opponent);
-
-        String kitText = switch(mode) {
-            case OWN -> "Jeder kämpft mit seinem eigenen Inventar.";
-            case CHALLENGER -> "Ihr kämpft beide mit dem Inventar von " + challengerPlayer.getName() + ".";
-            case OPPONENT -> "Ihr kämpft beide mit dem Inventar von " + opponentPlayer.getName() + ".";
-        };
-        opponentPlayer.sendMessage(Style.message("Du nimmst die Herausforderung von " + challengerPlayer.getName() + " an. " + kitText + " Verlasse das Feld, um abzubrechen."));
-        challengerPlayer.sendMessage(Style.message(opponentPlayer.getName() + " nimmt deine Herausforderung an. " + kitText + " Verlasse das Feld, um abzubrechen."));
-        for(Player player : new Player[]{challengerPlayer, opponentPlayer}) {
-            Style.play(player, Sound.ITEM_ARMOR_EQUIP_NETHERITE, 1f);
+    public void waitingForChallenger() {
+        UUID challenger = this.pads.challenger();
+        Player player = challenger == null ? null : Bukkit.getPlayer(challenger);
+        if(player != null && player.getOpenInventory().getTopInventory().getHolder(false) instanceof ModeMenu menu) {
+            menu.everyoneThere = true;
+            menu.draw();
+            Style.play(player, Sound.BLOCK_NOTE_BLOCK_PLING, 1.8f);
+        }
+        for(int pad = 0; pad < PadLobby.PADS; pad++) {
+            this.playersOn(pad).stream()
+                .filter(occupant -> !occupant.getUniqueId().equals(challenger))
+                .forEach(occupant -> occupant.sendActionBar(this.choosingText()));
         }
     }
 
     @Override
-    public void kitReverted(UUID uuid) {
+    public void countdownStarted() {
+        UUID challenger = this.pads.challenger();
+        Player player = challenger == null ? null : Bukkit.getPlayer(challenger);
+        if(player != null && ModeMenu.isOpen(player)) player.closeInventory();
+    }
+
+    @Override
+    public void kitAssigned(UUID uuid, UUID kitOwner) {
         Player player = Bukkit.getPlayer(uuid);
-        if(player != null) InventoryStore.apply(player, uuid);
+        if(player == null) return;
+        InventoryStore.apply(player, kitOwner);
+        if(uuid.equals(kitOwner)) return;
+        Player owner = Bukkit.getPlayer(kitOwner);
+        player.sendMessage(Style.message("Du kämpfst mit dem Inventar von " + (owner == null ? "jemand anderem" : owner.getName()) + ". Verlasse das Feld, um abzubrechen."));
+        Style.play(player, Sound.ITEM_ARMOR_EQUIP_NETHERITE, 1f);
     }
 
     @Override
     public void countdown(int secondsLeft) {
         for(int pad = 0; pad < PadLobby.PADS; pad++) {
-            Player player = this.occupantPlayer(pad);
-            Player other = this.occupantPlayer(1 - pad);
-            if(player == null || other == null) continue;
-            player.showTitle(Title.title(
-                Component.text(secondsLeft, NamedTextColor.GOLD),
-                Component.text("Kampf gegen ", NamedTextColor.GRAY).append(Component.text(other.getName(), Style.PAD_TEXT_COLORS[1 - pad])),
-                Title.Times.times(Duration.ZERO, Duration.ofMillis(1100), Duration.ZERO)
-            ));
-            Style.play(player, Sound.BLOCK_NOTE_BLOCK_PLING, 0.6f + (this.arena.settings().countdownSeconds() - secondsLeft) * 0.2f);
+            Component opponents = this.namesOn(1 - pad);
+            for(Player player : this.playersOn(pad)) {
+                player.showTitle(Title.title(
+                    Component.text(secondsLeft, NamedTextColor.GOLD),
+                    Component.text("Kampf gegen ", NamedTextColor.GRAY).append(opponents),
+                    Title.Times.times(Duration.ZERO, Duration.ofMillis(1100), Duration.ZERO)
+                ));
+                Style.play(player, Sound.BLOCK_NOTE_BLOCK_PLING, 0.6f + (this.arena.settings().countdownSeconds() - secondsLeft) * 0.2f);
+            }
         }
     }
 
     @Override
     public void countdownCancelled() {
         for(int pad = 0; pad < PadLobby.PADS; pad++) {
-            Player player = this.occupantPlayer(pad);
-            if(player == null) continue;
-            player.clearTitle();
-            player.sendActionBar(Component.text("Abgebrochen", NamedTextColor.RED));
-            Style.play(player, Sound.BLOCK_NOTE_BLOCK_BASS, 0.5f);
+            for(Player player : this.playersOn(pad)) {
+                player.clearTitle();
+                player.sendActionBar(Component.text("Abgebrochen", NamedTextColor.RED));
+                Style.play(player, Sound.BLOCK_NOTE_BLOCK_BASS, 0.5f);
+            }
         }
     }
 
     @Override
-    public void start(UUID challenger, UUID opponent, FightMode mode, int challengerPad) {
-        Player challengerPlayer = Bukkit.getPlayer(challenger);
-        Player opponentPlayer = Bukkit.getPlayer(opponent);
-        if(challengerPlayer == null || opponentPlayer == null) {
-            if(challengerPlayer != null) this.arena.toTribune(challengerPlayer);
-            if(opponentPlayer != null) this.arena.toTribune(opponentPlayer);
+    public void start(List<List<UUID>> teams, UUID challenger, FightMode mode, Map<UUID, UUID> kits) {
+        List<List<Player>> players = teams.stream()
+            .map(team -> team.stream().map(Bukkit::getPlayer).filter(Objects::nonNull).toList())
+            .toList();
+        if(players.get(0).isEmpty() || players.get(1).isEmpty()) {
+            players.forEach(team -> team.forEach(this.arena::toTribune));
             return;
         }
-        Player red = challengerPad == 0 ? challengerPlayer : opponentPlayer;
-        Player blue = challengerPad == 0 ? opponentPlayer : challengerPlayer;
-        this.arena.startFight(red, blue, challenger, mode);
+        this.arena.startFight(players, mode, kits);
     }
 
-    private @Nullable Player occupantPlayer(int pad) {
-        UUID occupant = this.pads.occupant(pad);
-        return occupant == null ? null : Bukkit.getPlayer(occupant);
+    private List<Player> playersOn(int pad) {
+        return this.pads.players(pad).stream().map(Bukkit::getPlayer).filter(Objects::nonNull).toList();
+    }
+
+    private Component namesOn(int pad) {
+        return Component.join(
+            JoinConfiguration.separator(Component.text(", ", NamedTextColor.GRAY)),
+            this.playersOn(pad).stream().map(player -> Component.text(player.getName(), Style.PAD_TEXT_COLORS[pad])).toList()
+        );
     }
 
     private void updateDisplays() {
         boolean waiting = this.pads.isFull() && !this.arena.hasFreeSlot();
         Player challenger = this.pads.challenger() == null ? null : Bukkit.getPlayer(this.pads.challenger());
-        String modeText = "Modus: " + this.pads.mode().displayName();
+        int challengerPad = this.pads.challengerPad();
+        String modeText = "Modus: " + this.modeName();
 
         for(int pad = 0; pad < PadLobby.PADS; pad++) {
+            List<Player> players = this.playersOn(pad);
             Component title = Component.text(Style.PAD_NAMES[pad], Style.PAD_TEXT_COLORS[pad]);
-            Player occupant = this.occupantPlayer(pad);
+            if(challenger != null) title = title.append(Component.text("  " + players.size() + "/" + this.pads.size(pad), NamedTextColor.WHITE));
+
             Component body;
             if(waiting) {
-                body = Component.text("Alle Arenen belegt", NamedTextColor.GRAY).appendNewline()
-                    .append(Component.text("Gleich geht es los", NamedTextColor.WHITE));
+                body = this.namesOn(pad).appendNewline()
+                    .append(Component.text("Alle Arenen belegt, gleich geht es los", NamedTextColor.GRAY));
+            } else if(this.pads.isWaitingForChallenger() && challenger != null) {
+                body = this.namesOn(pad).appendNewline()
+                    .append(Component.text(challenger.getName() + " wählt noch", NamedTextColor.YELLOW));
             } else if(this.pads.isCountingDown()) {
-                body = Component.text(occupant == null ? "" : occupant.getName(), Style.PAD_TEXT_COLORS[pad]).appendNewline()
+                body = this.namesOn(pad).appendNewline()
                     .append(Component.text("Kampf beginnt in " + this.pads.secondsLeft(), NamedTextColor.GOLD));
-            } else if(occupant != null) {
-                body = Component.text(occupant.getName(), Style.PAD_TEXT_COLORS[pad]).appendNewline()
-                    .append(Component.text("fordert heraus", NamedTextColor.GRAY)).appendNewline()
+            } else if(challenger == null) {
+                body = !this.arena.hasFreeSlot()
+                    ? Component.text("Alle Arenen belegt", NamedTextColor.GRAY).appendNewline()
+                        .append(Component.text("Du kannst dich trotzdem anstellen", NamedTextColor.WHITE))
+                    : Component.text("Stell dich hierhin,", NamedTextColor.WHITE).appendNewline()
+                        .append(Component.text("um herauszufordern", NamedTextColor.WHITE));
+            } else if(pad == challengerPad) {
+                body = this.namesOn(pad).appendNewline()
+                    .append(Component.text(players.size() == 1 ? "fordert heraus" : "fordern heraus", NamedTextColor.GRAY)).appendNewline()
                     .append(Component.text(modeText, NamedTextColor.WHITE));
-            } else if(challenger != null) {
-                body = Component.text("Stell dich hierhin, um gegen", NamedTextColor.WHITE).appendNewline()
-                    .append(Component.text(challenger.getName(), Style.PAD_TEXT_COLORS[1 - pad]))
-                    .append(Component.text(" zu kämpfen", NamedTextColor.WHITE)).appendNewline()
-                    .append(Component.text(modeText, NamedTextColor.GRAY));
-            } else if(!this.arena.hasFreeSlot()) {
-                body = Component.text("Alle Arenen belegt", NamedTextColor.GRAY).appendNewline()
-                    .append(Component.text("Du kannst dich trotzdem anstellen", NamedTextColor.WHITE));
             } else {
-                body = Component.text("Stell dich hierhin,", NamedTextColor.WHITE).appendNewline()
-                    .append(Component.text("um herauszufordern", NamedTextColor.WHITE));
+                Component who = players.isEmpty()
+                    ? Component.text("Stell dich hierhin, um gegen", NamedTextColor.WHITE).appendNewline()
+                        .append(Component.text(challenger.getName(), Style.PAD_TEXT_COLORS[challengerPad]))
+                        .append(Component.text(" zu kämpfen", NamedTextColor.WHITE))
+                    : this.namesOn(pad).appendNewline().append(Component.text("nehmen an", NamedTextColor.GRAY));
+                body = who.appendNewline().append(Component.text(modeText, NamedTextColor.GRAY));
             }
             this.displays[pad].text(title.appendNewline().append(body));
         }
@@ -260,18 +371,18 @@ final class Lobby implements PadLobby.Listener {
         for(int pad = 0; pad < PadLobby.PADS; pad++) {
             Region region = this.regions[pad];
             Color color = waiting ? Style.WAITING_PARTICLE_COLOR : Style.PAD_PARTICLE_COLORS[pad];
-            boolean taken = this.pads.occupant(pad) != null;
-            double spacing = countdown ? 0.25 : taken ? 0.4 : 0.6;
-            this.drawOutline(region, new Particle.DustOptions(color, taken ? 1.2f : 0.9f), spacing);
+            boolean full = this.pads.isPadFull(pad);
+            double spacing = countdown ? 0.25 : full ? 0.4 : 0.6;
+            this.drawOutline(region, new Particle.DustOptions(color, full ? 1.2f : 0.9f), spacing);
 
-            Player occupant = this.occupantPlayer(pad);
-            if(occupant == null) continue;
             double speed = countdown ? 0.6 : 0.3;
-            for(int strand = 0; strand < 2; strand++) {
-                double angle = this.ticks * speed + strand * Math.PI;
-                double height = (this.ticks % 40) / 20.0;
-                Location point = occupant.getLocation().add(Math.cos(angle) * 0.7, height, Math.sin(angle) * 0.7);
-                Particle.DUST.builder().location(point).data(new Particle.DustOptions(color, 1f)).receivers(48).spawn();
+            for(Player occupant : this.playersOn(pad)) {
+                for(int strand = 0; strand < 2; strand++) {
+                    double angle = this.ticks * speed + strand * Math.PI;
+                    double height = (this.ticks % 40) / 20.0;
+                    Location point = occupant.getLocation().add(Math.cos(angle) * 0.7, height, Math.sin(angle) * 0.7);
+                    Particle.DUST.builder().location(point).data(new Particle.DustOptions(color, 1f)).receivers(48).spawn();
+                }
             }
         }
     }

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/ModeMenu.java

@@ -1,6 +1,7 @@
 package eu.mhsl.craftattack.spawn.arena.appliances.arena;
 
 import eu.mhsl.craftattack.spawn.arena.appliances.arena.logic.FightMode;
+import eu.mhsl.craftattack.spawn.arena.appliances.arena.logic.PadLobby;
 import eu.mhsl.craftattack.spawn.core.util.inventory.ItemBuilder;
 import eu.mhsl.craftattack.spawn.core.util.inventory.PlaceholderItems;
 import net.kyori.adventure.text.Component;
@@ -14,55 +15,130 @@ import org.bukkit.inventory.InventoryHolder;
 import org.bukkit.inventory.ItemStack;
 import org.bukkit.inventory.meta.SkullMeta;
 import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
 
 /**
- * Chest menu in which the challenger picks the mode. Works for Bedrock players as well.
+ * Chest menu in which the challenger picks team sizes and mode. Every click applies at once.
+ * Works for Bedrock players as well.
  */
 final class ModeMenu implements InventoryHolder {
-    private static final int[] SLOTS = {11, 13, 15};
+    private static final int OWN_ROW = 10;
+    private static final int OPPONENT_ROW = 19;
+    private static final int[] MODE_SLOTS = {29, 31, 33};
     private static final FightMode[] MODES = {FightMode.OWN, FightMode.CHALLENGER, FightMode.OPPONENT};
+    private static final int DONE_SLOT = 40;
 
-    private final Inventory inventory;
-
-    private ModeMenu(Player challenger, FightMode current) {
-        this.inventory = Bukkit.createInventory(this, 27, Component.text("Wähle den Kampfmodus"));
-        for(int i = 0; i < this.inventory.getSize(); i++) this.inventory.setItem(i, PlaceholderItems.grayStainedGlassPane);
-        for(int i = 0; i < MODES.length; i++) this.inventory.setItem(SLOTS[i], this.item(MODES[i], challenger, MODES[i] == current));
+    sealed interface Click {
     }
 
-    static void open(Player challenger, FightMode current) {
-        challenger.openInventory(new ModeMenu(challenger, current).getInventory());
+    record OwnSize(int size) implements Click {
+    }
+
+    record OpponentSize(int size) implements Click {
+    }
+
+    record Mode(FightMode mode) implements Click {
+    }
+
+    record Done() implements Click {
+    }
+
+    private final Inventory inventory;
+    private final Player challenger;
+    private final int ownPad;
+    int ownSize;
+    int opponentSize;
+    FightMode mode;
+    /** Both pads are full, only the challenger closing the menu is missing. */
+    boolean everyoneThere;
+
+    private ModeMenu(Player challenger, int ownPad, int ownSize, int opponentSize, FightMode mode) {
+        this.challenger = challenger;
+        this.ownPad = ownPad;
+        this.ownSize = ownSize;
+        this.opponentSize = opponentSize;
+        this.mode = mode;
+        this.inventory = Bukkit.createInventory(this, 45, Component.text("Teams und Kampfmodus"));
+        this.draw();
+    }
+
+    static void open(Player challenger, int ownPad, int ownSize, int opponentSize, FightMode mode) {
+        challenger.openInventory(new ModeMenu(challenger, ownPad, ownSize, opponentSize, mode).getInventory());
     }
 
     static boolean isOpen(Player player) {
         return player.getOpenInventory().getTopInventory().getHolder(false) instanceof ModeMenu;
     }
 
-    @Nullable FightMode modeAt(int slot) {
-        for(int i = 0; i < SLOTS.length; i++) {
-            if(SLOTS[i] == slot) return MODES[i];
+    Click clickAt(int slot) {
+        if(slot > OWN_ROW && slot <= OWN_ROW + PadLobby.MAX_TEAM_SIZE) return new OwnSize(slot - OWN_ROW);
+        if(slot > OPPONENT_ROW && slot <= OPPONENT_ROW + PadLobby.MAX_TEAM_SIZE) return new OpponentSize(slot - OPPONENT_ROW);
+        for(int i = 0; i < MODE_SLOTS.length; i++) {
+            if(MODE_SLOTS[i] == slot) return new Mode(MODES[i]);
         }
+        if(slot == DONE_SLOT) return new Done();
         return null;
     }
 
-    private ItemStack item(FightMode mode, Player challenger, boolean selected) {
+    void draw() {
+        for(int i = 0; i < this.inventory.getSize(); i++) this.inventory.setItem(i, PlaceholderItems.grayStainedGlassPane);
+        int opponentPad = 1 - this.ownPad;
+        boolean teams = this.ownSize > 1 || this.opponentSize > 1;
+
+        this.inventory.setItem(OWN_ROW, this.label(Material.PLAYER_HEAD, "Dein Team", this.ownPad, "So viele stehen mit dir auf dem " + Style.PAD_NAMES[this.ownPad] + ".")
+            .withMeta(meta -> ((SkullMeta) meta).setOwningPlayer(this.challenger)).build());
+        this.inventory.setItem(OPPONENT_ROW, this.label(Material.SKELETON_SKULL, "Gegner", opponentPad, "So viele stellen sich auf das " + Style.PAD_NAMES[opponentPad] + ".").build());
+        for(int size = 1; size <= PadLobby.MAX_TEAM_SIZE; size++) {
+            this.inventory.setItem(OWN_ROW + size, this.sizeItem(size, this.ownPad, size == this.ownSize));
+            this.inventory.setItem(OPPONENT_ROW + size, this.sizeItem(size, opponentPad, size == this.opponentSize));
+        }
+
+        for(int i = 0; i < MODES.length; i++) {
+            FightMode mode = MODES[i];
+            this.inventory.setItem(MODE_SLOTS[i], this.modeItem(mode, teams, mode == this.mode, mode.isAllowed(this.ownSize, this.opponentSize)));
+        }
+
+        ItemBuilder done = ItemBuilder.of(Material.LIME_CONCRETE)
+            .displayName(Component.text(this.everyoneThere ? "Fertig, Kampf starten" : "Fertig", NamedTextColor.GREEN).decoration(TextDecoration.ITALIC, false))
+            .lore(this.ownSize + " gegen " + this.opponentSize + ", " + this.mode.displayName(teams) + ". "
+                + (this.everyoneThere ? "Alle sind da, der Countdown startet, sobald du fertig bist." : "Jetzt fehlen nur noch die anderen auf den Feldern."));
+        if(this.everyoneThere) done.glint();
+        this.inventory.setItem(DONE_SLOT, done.build());
+    }
+
+    private ItemBuilder label(Material material, String name, int pad, String text) {
+        return ItemBuilder.of(material)
+            .displayName(Component.text(name, Style.PAD_TEXT_COLORS[pad]).decoration(TextDecoration.ITALIC, false))
+            .lore(text);
+    }
+
+    private ItemStack sizeItem(int size, int pad, boolean selected) {
+        ItemBuilder builder = ItemBuilder.of(pad == 0 ? Material.RED_CONCRETE : Material.BLUE_CONCRETE)
+            .amount(size)
+            .displayName(Component.text(size + " Spieler", Style.PAD_TEXT_COLORS[pad]).decoration(TextDecoration.ITALIC, false));
+        builder.lore(selected ? "Ausgewählt" : "Klicken zum Auswählen", selected ? NamedTextColor.GREEN : NamedTextColor.YELLOW);
+        if(selected) builder.glint();
+        return builder.build();
+    }
+
+    private ItemStack modeItem(FightMode mode, boolean teams, boolean selected, boolean allowed) {
         ItemBuilder builder = switch(mode) {
             case OWN -> ItemBuilder.of(Material.IRON_SWORD)
-                .lore("Ihr kämpft beide mit eurem eigenen Inventar.");
+                .lore("Jeder kämpft mit seinem eigenen Inventar.");
             case CHALLENGER -> ItemBuilder.of(Material.PLAYER_HEAD)
-                .withMeta(meta -> ((SkullMeta) meta).setOwningPlayer(challenger))
-                .lore("Ihr kämpft beide mit deinem Inventar.");
-            case OPPONENT -> ItemBuilder.of(Material.CHEST)
-                .lore("Ihr kämpft beide mit dem Inventar von dem, der sich auf das andere Feld stellt.");
+                .withMeta(meta -> ((SkullMeta) meta).setOwningPlayer(this.challenger))
+                .lore(teams ? "Alle kämpfen mit deinem Inventar." : "Ihr kämpft beide mit deinem Inventar.");
+            case OPPONENT -> ItemBuilder.of(allowed ? Material.CHEST : Material.BARRIER)
+                .lore(allowed
+                    ? "Ihr kämpft beide mit dem Inventar von dem, der sich auf das andere Feld stellt."
+                    : "Geht nur bei 1 gegen 1.");
         };
-        builder.displayName(Component.text(mode.displayName(), NamedTextColor.GOLD).decoration(TextDecoration.ITALIC, false));
+        builder.displayName(Component.text(mode.displayName(teams), allowed ? NamedTextColor.GOLD : NamedTextColor.DARK_GRAY).decoration(TextDecoration.ITALIC, false));
+        if(!allowed) return builder.build();
+        builder.appendLore(Component.empty());
         if(selected) {
-            builder.glint().appendLore(Component.empty())
-                .appendLore(Component.text("Ausgewählt", NamedTextColor.GREEN).decoration(TextDecoration.ITALIC, false));
+            builder.glint().appendLore(Component.text("Ausgewählt", NamedTextColor.GREEN).decoration(TextDecoration.ITALIC, false));
         } else {
-            builder.appendLore(Component.empty())
-                .appendLore(Component.text("Klicken zum Auswählen", NamedTextColor.YELLOW).decoration(TextDecoration.ITALIC, false));
+            builder.appendLore(Component.text("Klicken zum Auswählen", NamedTextColor.YELLOW).decoration(TextDecoration.ITALIC, false));
         }
         return builder.build();
     }

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/ModeMenuListener.java

@@ -1,10 +1,13 @@
 package eu.mhsl.craftattack.spawn.arena.appliances.arena;
 
-import eu.mhsl.craftattack.spawn.arena.appliances.arena.logic.FightMode;
 import eu.mhsl.craftattack.spawn.core.appliance.ApplianceListener;
 import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
+import org.bukkit.event.block.Action;
+import org.bukkit.event.player.PlayerInteractEvent;
+import org.bukkit.inventory.EquipmentSlot;
 import org.bukkit.event.inventory.InventoryClickEvent;
+import org.bukkit.event.inventory.InventoryCloseEvent;
 
 class ModeMenuListener extends ApplianceListener<Arena> {
     @EventHandler
@@ -14,8 +17,25 @@ class ModeMenuListener extends ApplianceListener<Arena> {
         if(!(event.getWhoClicked() instanceof Player player)) return;
         if(event.getRawSlot() >= event.getView().getTopInventory().getSize()) return;
 
-        FightMode mode = menu.modeAt(event.getRawSlot());
+        ModeMenu.Click click = menu.clickAt(event.getRawSlot());
         Lobby lobby = this.getAppliance().lobby();
-        if(mode != null && lobby != null) lobby.chooseMode(player, mode);
+        if(click != null && lobby != null) lobby.handleMenuClick(player, menu, click);
+    }
+
+    @EventHandler
+    public void onClose(InventoryCloseEvent event) {
+        if(!(event.getInventory().getHolder(false) instanceof ModeMenu)) return;
+        if(!(event.getPlayer() instanceof Player player)) return;
+        Lobby lobby = this.getAppliance().lobby();
+        if(lobby != null) lobby.menuClosed(player);
+    }
+
+    @EventHandler
+    public void onRightClick(PlayerInteractEvent event) {
+        if(event.getHand() != EquipmentSlot.HAND) return;
+        if(event.getAction() != Action.RIGHT_CLICK_AIR && event.getAction() != Action.RIGHT_CLICK_BLOCK) return;
+        if(this.getAppliance().state(event.getPlayer()) != Arena.PlayerState.PAD) return;
+        Lobby lobby = this.getAppliance().lobby();
+        if(lobby != null && lobby.openMenu(event.getPlayer())) event.setCancelled(true);
     }
 }

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/NoProgressListener.java

@@ -0,0 +1,21 @@
+package eu.mhsl.craftattack.spawn.arena.appliances.arena;
+
+import com.destroystokyo.paper.event.player.PlayerAdvancementCriterionGrantEvent;
+import eu.mhsl.craftattack.spawn.core.appliance.ApplianceListener;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.player.PlayerRecipeDiscoverEvent;
+
+/**
+ * Nothing done in the arena counts as progress: no advancements, no recipe unlocks.
+ */
+class NoProgressListener extends ApplianceListener<Arena> {
+    @EventHandler
+    public void onCriterion(PlayerAdvancementCriterionGrantEvent event) {
+        event.setCancelled(true);
+    }
+
+    @EventHandler
+    public void onRecipe(PlayerRecipeDiscoverEvent event) {
+        event.setCancelled(true);
+    }
+}

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/logic/FightMode.java

@@ -1,36 +1,25 @@
 package eu.mhsl.craftattack.spawn.arena.appliances.arena.logic;
 
 /**
- * Which inventory the two fighters use. The challenger chooses it.
+ * Which inventory the fighters use. The challenger chooses it.
  */
 public enum FightMode {
-    OWN("Jeder sein eigenes"),
-    CHALLENGER("Beide mit meinem"),
-    OPPONENT("Beide mit dem des Gegners");
-
-    public enum Role {
-        CHALLENGER,
-        OPPONENT
-    }
-
-    private final String displayName;
-
-    FightMode(String displayName) {
-        this.displayName = displayName;
-    }
-
-    public String displayName() {
-        return this.displayName;
-    }
+    OWN,
+    CHALLENGER,
+    OPPONENT;
 
     /**
-     * @return whose inventory the fighter with the given role gets
+     * With more than one player on a side, "the opponent's inventory" would be ambiguous.
      */
-    public Role kitSource(Role fighter) {
+    public boolean isAllowed(int ownSize, int opponentSize) {
+        return this != OPPONENT || (ownSize == 1 && opponentSize == 1);
+    }
+
+    public String displayName(boolean teams) {
         return switch(this) {
-            case OWN -> fighter;
-            case CHALLENGER -> Role.CHALLENGER;
-            case OPPONENT -> Role.OPPONENT;
+            case OWN -> "Jeder sein eigenes";
+            case CHALLENGER -> teams ? "Alle mit meinem" : "Beide mit meinem";
+            case OPPONENT -> "Beide mit dem des Gegners";
         };
     }
 }

arena/src/main/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/logic/PadLobby.java

@@ -2,61 +2,89 @@ package eu.mhsl.craftattack.spawn.arena.appliances.arena.logic;
 
 import org.jetbrains.annotations.Nullable;
 
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
 import java.util.UUID;
 
 /**
- * State of the two start pads. The first player on a pad becomes the challenger and picks the mode,
- * stepping on the other pad means accepting. Once both stand there long enough, the fight starts.
+ * State of the two start pads. The first player on a pad becomes the challenger and picks team sizes and mode.
+ * Everyone else joins a team by stepping on a pad. Once both pads hold exactly the chosen number of players
+ * and the challenger is done choosing (or took too long), the countdown runs and then the fight starts.
  */
 public class PadLobby {
     public static final int PADS = 2;
+    public static final int MAX_TEAM_SIZE = 4;
 
     public interface Listener {
-        /** The player is now the challenger and should pick a mode. */
-        void challengerSelected(UUID challenger);
+        /** The player is now the challenger and may change the options until the countdown runs. */
+        void challengerSelected(UUID challenger, boolean first);
 
-        /** Both pads are taken: give both the inventories of the chosen mode. */
-        void kitsApplied(UUID challenger, UUID opponent, FightMode mode);
+        /** The player should now hold the inventory of {@code kitOwner} (the own one to revert). */
+        void kitAssigned(UUID player, UUID kitOwner);
 
-        /** The player gets the own inventory back. */
-        void kitReverted(UUID player);
+        /** Both pads are exactly full, but the challenger still has the options open. */
+        void waitingForChallenger();
+
+        /** Both pads are exactly full, the options are fixed now. */
+        void countdownStarted();
 
         void countdown(int secondsLeft);
 
         void countdownCancelled();
 
-        void start(UUID challenger, UUID opponent, FightMode mode, int challengerPad);
+        /**
+         * @param teams players per pad
+         * @param kits  whose inventory each player fights with
+         */
+        void start(List<List<UUID>> teams, UUID challenger, FightMode mode, Map<UUID, UUID> kits);
     }
 
     private final Listener listener;
     private final int countdownTicks;
-    private final UUID[] occupants = new UUID[PADS];
-    private int challengerPad = -1;
+    private final int choosingTicks;
+    private final List<List<UUID>> pads = List.of(new ArrayList<>(), new ArrayList<>());
+    /** Everyone on a pad, in the order they stepped on. The first one is the challenger. */
+    private final List<UUID> order = new ArrayList<>();
+    private final Map<UUID, UUID> kits = new HashMap<>();
+    private final int[] sizes = {1, 1};
     private FightMode mode = FightMode.OWN;
     private int ticksLeft = -1;
+    private boolean choosing;
+    /** How much longer everyone waits for the challenger to finish choosing; -1 while nobody waits. */
+    private int choosingTicksLeft = -1;
 
-    public PadLobby(Listener listener, int countdownSeconds) {
+    /**
+     * @param choosingSeconds how long a full lobby waits for the challenger to close the options
+     */
+    public PadLobby(Listener listener, int countdownSeconds, int choosingSeconds) {
         this.listener = listener;
         this.countdownTicks = countdownSeconds * 20;
+        this.choosingTicks = choosingSeconds * 20;
     }
 
     /**
-     * @return false if the pad is already taken
+     * @return false if the pad is already full or the player stands on a pad
      */
     public boolean enter(int pad, UUID player) {
-        if(this.occupants[pad] != null) return false;
         if(this.padOf(player) != -1) return false;
+        boolean first = this.order.isEmpty();
+        if(!first && this.pads.get(pad).size() >= this.sizes[pad]) return false;
 
-        this.occupants[pad] = player;
-        if(this.challengerPad == -1) {
-            this.challengerPad = pad;
+        this.pads.get(pad).add(player);
+        this.order.add(player);
+        this.kits.put(player, player);
+        if(first) {
+            this.sizes[0] = 1;
+            this.sizes[1] = 1;
             this.mode = FightMode.OWN;
-            this.listener.challengerSelected(player);
+            this.listener.challengerSelected(player, true);
             return true;
         }
 
-        this.listener.kitsApplied(this.challenger(), this.opponent(), this.mode);
-        this.ticksLeft = this.countdownTicks;
+        this.refreshKits();
+        this.startCountdownIfReady();
         return true;
     }
 
@@ -64,39 +92,100 @@ public class PadLobby {
         int pad = this.padOf(player);
         if(pad == -1) return;
 
-        int other = 1 - pad;
-        boolean bothThere = this.isFull();
-        this.occupants[pad] = null;
-        this.listener.kitReverted(player);
-        if(bothThere) {
-            this.ticksLeft = -1;
-            this.listener.kitReverted(this.occupants[other]);
-            this.listener.countdownCancelled();
-        }
+        boolean wasFull = this.isFull();
+        boolean wasChallenger = player.equals(this.challenger());
+        this.pads.get(pad).remove(player);
+        this.order.remove(player);
+        this.kits.remove(player);
+        this.listener.kitAssigned(player, player);
 
-        if(pad != this.challengerPad) return;
-        if(this.occupants[other] == null) {
-            this.challengerPad = -1;
-            return;
+        if(wasFull) {
+            if(this.isCountingDown()) this.listener.countdownCancelled();
+            this.ticksLeft = -1;
+            this.choosingTicksLeft = -1;
         }
-        this.challengerPad = other;
-        this.mode = FightMode.OWN;
-        this.listener.challengerSelected(this.occupants[other]);
+        if(wasChallenger) this.choosing = false;
+
+        this.refreshKits();
+        // the longest waiting player takes over; team sizes and mode stay as chosen
+        if(wasChallenger && !this.order.isEmpty()) {
+            this.listener.challengerSelected(this.order.getFirst(), false);
+        }
+    }
+
+    public enum ConfigureResult {
+        OK,
+        NOT_ALLOWED,
+        OWN_TOO_SMALL,
+        OPPONENT_TOO_SMALL,
+        INVALID
     }
 
     /**
-     * Only the challenger can change the mode, and only while nobody stands on the other pad.
+     * Only the challenger can change the options, and only until the countdown runs.
+     * Teams cannot be smaller than the players already standing there.
+     *
+     * @param ownSize      players on the challenger's pad
+     * @param opponentSize players on the other pad
      */
-    public boolean setMode(UUID player, FightMode mode) {
-        if(!player.equals(this.challenger()) || this.isFull()) return false;
+    public ConfigureResult configure(UUID player, int ownSize, int opponentSize, FightMode mode) {
+        if(!this.canConfigure(player)) return ConfigureResult.NOT_ALLOWED;
+        if(ownSize < 1 || ownSize > MAX_TEAM_SIZE || opponentSize < 1 || opponentSize > MAX_TEAM_SIZE) return ConfigureResult.INVALID;
+        if(!mode.isAllowed(ownSize, opponentSize)) return ConfigureResult.INVALID;
+        int own = this.challengerPad();
+        if(ownSize < this.pads.get(own).size()) return ConfigureResult.OWN_TOO_SMALL;
+        if(opponentSize < this.pads.get(1 - own).size()) return ConfigureResult.OPPONENT_TOO_SMALL;
+
+        this.sizes[own] = ownSize;
+        this.sizes[1 - own] = opponentSize;
         this.mode = mode;
-        return true;
+        this.refreshKits();
+        this.startCountdownIfReady();
+        return ConfigureResult.OK;
+    }
+
+    /**
+     * The challenger opened or closed the options. While they are open, a full lobby waits instead of counting down.
+     */
+    public void setChoosing(UUID player, boolean choosing) {
+        if(!this.canConfigure(player) || this.choosing == choosing) return;
+        this.choosing = choosing;
+        this.startCountdownIfReady();
+    }
+
+    public boolean isWaitingForChallenger() {
+        return this.choosingTicksLeft >= 0;
+    }
+
+    private void startCountdownIfReady() {
+        if(this.isCountingDown()) return;
+        if(!this.isFull()) {
+            this.choosingTicksLeft = -1;
+            return;
+        }
+        if(this.choosing) {
+            if(this.choosingTicksLeft >= 0) return;
+            this.choosingTicksLeft = this.choosingTicks;
+            this.listener.waitingForChallenger();
+            return;
+        }
+        this.choosingTicksLeft = -1;
+        this.ticksLeft = this.countdownTicks;
+        this.listener.countdownStarted();
+    }
+
+    public boolean canConfigure(UUID player) {
+        return player.equals(this.challenger()) && !this.isCountingDown();
     }
 
     /**
      * Called every server tick. The countdown only runs while an arena is free.
      */
     public void tick(boolean arenaAvailable) {
+        if(this.choosingTicksLeft >= 0 && this.choosingTicksLeft-- == 0) {
+            this.choosing = false;
+            this.startCountdownIfReady();
+        }
         if(this.ticksLeft < 0) return;
         if(!arenaAvailable) {
             this.ticksLeft = this.countdownTicks;
@@ -106,39 +195,68 @@ public class PadLobby {
         if(this.ticksLeft % 20 == 0 && this.ticksLeft > 0) this.listener.countdown(this.ticksLeft / 20);
         if(this.ticksLeft-- > 0) return;
 
+        List<List<UUID>> teams = List.of(List.copyOf(this.pads.get(0)), List.copyOf(this.pads.get(1)));
         UUID challenger = this.challenger();
-        UUID opponent = this.opponent();
         FightMode mode = this.mode;
-        int challengerPad = this.challengerPad;
-        this.occupants[0] = null;
-        this.occupants[1] = null;
-        this.challengerPad = -1;
+        Map<UUID, UUID> kits = Map.copyOf(this.kits);
+        this.pads.forEach(List::clear);
+        this.order.clear();
+        this.kits.clear();
+        this.sizes[0] = 1;
+        this.sizes[1] = 1;
         this.mode = FightMode.OWN;
         this.ticksLeft = -1;
-        this.listener.start(challenger, opponent, mode, challengerPad);
+        this.choosing = false;
+        this.listener.start(teams, challenger, mode, kits);
+    }
+
+    /**
+     * Works out whose inventory everyone should hold and reports only the changes.
+     */
+    private void refreshKits() {
+        UUID challenger = this.challenger();
+        if(challenger == null) return;
+        int challengerPad = this.challengerPad();
+        UUID firstOpponent = this.pads.get(1 - challengerPad).isEmpty() ? null : this.pads.get(1 - challengerPad).getFirst();
+
+        for(UUID player : this.order) {
+            UUID wanted = switch(this.mode) {
+                case OWN -> player;
+                case CHALLENGER -> challenger;
+                case OPPONENT -> player.equals(challenger) && firstOpponent != null ? firstOpponent : player;
+            };
+            if(wanted.equals(this.kits.get(player))) continue;
+            this.kits.put(player, wanted);
+            this.listener.kitAssigned(player, wanted);
+        }
     }
 
     public int padOf(UUID player) {
         for(int i = 0; i < PADS; i++) {
-            if(player.equals(this.occupants[i])) return i;
+            if(this.pads.get(i).contains(player)) return i;
         }
         return -1;
     }
 
-    public @Nullable UUID occupant(int pad) {
-        return this.occupants[pad];
+    public List<UUID> players(int pad) {
+        return List.copyOf(this.pads.get(pad));
+    }
+
+    public int size(int pad) {
+        return this.sizes[pad];
+    }
+
+    public boolean isPadFull(int pad) {
+        return !this.order.isEmpty() && this.pads.get(pad).size() >= this.sizes[pad];
     }
 
     public @Nullable UUID challenger() {
-        return this.challengerPad == -1 ? null : this.occupants[this.challengerPad];
-    }
-
-    public @Nullable UUID opponent() {
-        return this.challengerPad == -1 ? null : this.occupants[1 - this.challengerPad];
+        return this.order.isEmpty() ? null : this.order.getFirst();
     }
 
     public int challengerPad() {
-        return this.challengerPad;
+        UUID challenger = this.challenger();
+        return challenger == null ? -1 : this.padOf(challenger);
     }
 
     public FightMode mode() {
@@ -146,7 +264,7 @@ public class PadLobby {
     }
 
     public boolean isFull() {
-        return this.occupants[0] != null && this.occupants[1] != null;
+        return this.pads.get(0).size() == this.sizes[0] && this.pads.get(1).size() == this.sizes[1];
     }
 
     public boolean isCountingDown() {
@@ -154,7 +272,7 @@ public class PadLobby {
     }
 
     public boolean isIdle() {
-        return this.occupants[0] == null && this.occupants[1] == null;
+        return this.order.isEmpty();
     }
 
     /** Seconds until the start, rounded up; -1 without countdown. */

arena/src/test/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/logic/FightModeTest.java

@@ -2,26 +2,21 @@ package eu.mhsl.craftattack.spawn.arena.appliances.arena.logic;
 
 import org.junit.jupiter.api.Test;
 
-import static eu.mhsl.craftattack.spawn.arena.appliances.arena.logic.FightMode.Role.CHALLENGER;
-import static eu.mhsl.craftattack.spawn.arena.appliances.arena.logic.FightMode.Role.OPPONENT;
-import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.*;
 
 class FightModeTest {
     @Test
-    void ownKeepsEveryonesInventory() {
-        assertEquals(CHALLENGER, FightMode.OWN.kitSource(CHALLENGER));
-        assertEquals(OPPONENT, FightMode.OWN.kitSource(OPPONENT));
+    void opponentInventoryOnlyInOneVersusOne() {
+        assertTrue(FightMode.OPPONENT.isAllowed(1, 1));
+        assertFalse(FightMode.OPPONENT.isAllowed(1, 2));
+        assertFalse(FightMode.OPPONENT.isAllowed(3, 1));
+        assertTrue(FightMode.CHALLENGER.isAllowed(4, 3));
+        assertTrue(FightMode.OWN.isAllowed(2, 4));
     }
 
     @Test
-    void challengerKitForBoth() {
-        assertEquals(CHALLENGER, FightMode.CHALLENGER.kitSource(CHALLENGER));
-        assertEquals(CHALLENGER, FightMode.CHALLENGER.kitSource(OPPONENT));
-    }
-
-    @Test
-    void opponentKitForBoth() {
-        assertEquals(OPPONENT, FightMode.OPPONENT.kitSource(CHALLENGER));
-        assertEquals(OPPONENT, FightMode.OPPONENT.kitSource(OPPONENT));
+    void namesForTeams() {
+        assertEquals("Beide mit meinem", FightMode.CHALLENGER.displayName(false));
+        assertEquals("Alle mit meinem", FightMode.CHALLENGER.displayName(true));
     }
 }

arena/src/test/java/eu/mhsl/craftattack/spawn/arena/appliances/arena/logic/PadLobbyTest.java

@@ -5,7 +5,9 @@ import org.junit.jupiter.api.Test;
 
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Map;
 import java.util.UUID;
+import java.util.stream.Collectors;
 
 import static org.junit.jupiter.api.Assertions.*;
 
@@ -13,22 +15,29 @@ class PadLobbyTest {
     private final UUID a = UUID.randomUUID();
     private final UUID b = UUID.randomUUID();
     private final UUID c = UUID.randomUUID();
+    private final UUID d = UUID.randomUUID();
+    private final UUID e = UUID.randomUUID();
     private final List<String> events = new ArrayList<>();
+    private Map<UUID, UUID> startedKits;
     private PadLobby lobby;
 
     @BeforeEach
     void setUp() {
         this.lobby = new PadLobby(new PadLobby.Listener() {
-            public void challengerSelected(UUID challenger) {
-                PadLobbyTest.this.events.add("challenger " + PadLobbyTest.this.name(challenger));
+            public void challengerSelected(UUID challenger, boolean first) {
+                PadLobbyTest.this.events.add("challenger " + PadLobbyTest.this.name(challenger) + (first ? " first" : ""));
             }
 
-            public void kitsApplied(UUID challenger, UUID opponent, FightMode mode) {
-                PadLobbyTest.this.events.add("kits " + PadLobbyTest.this.name(challenger) + PadLobbyTest.this.name(opponent) + " " + mode);
+            public void waitingForChallenger() {
+                PadLobbyTest.this.events.add("waiting");
             }
 
-            public void kitReverted(UUID player) {
-                PadLobbyTest.this.events.add("revert " + PadLobbyTest.this.name(player));
+            public void countdownStarted() {
+                PadLobbyTest.this.events.add("countdown started");
+            }
+
+            public void kitAssigned(UUID player, UUID kitOwner) {
+                PadLobbyTest.this.events.add("kit " + PadLobbyTest.this.name(player) + "<-" + PadLobbyTest.this.name(kitOwner));
             }
 
             public void countdown(int secondsLeft) {
@@ -39,59 +48,111 @@ class PadLobbyTest {
                 PadLobbyTest.this.events.add("cancelled");
             }
 
-            public void start(UUID challenger, UUID opponent, FightMode mode, int challengerPad) {
-                PadLobbyTest.this.events.add("start " + PadLobbyTest.this.name(challenger) + PadLobbyTest.this.name(opponent) + " " + mode + " " + challengerPad);
+            public void start(List<List<UUID>> teams, UUID challenger, FightMode mode, Map<UUID, UUID> kits) {
+                PadLobbyTest.this.startedKits = kits;
+                PadLobbyTest.this.events.add("start " + PadLobbyTest.this.names(teams.get(0)) + " vs " + PadLobbyTest.this.names(teams.get(1))
+                    + " by " + PadLobbyTest.this.name(challenger) + " " + mode);
             }
-        }, 2);
+        }, 2, 3);
     }
 
     private String name(UUID uuid) {
         if(uuid.equals(this.a)) return "a";
         if(uuid.equals(this.b)) return "b";
-        return "c";
+        if(uuid.equals(this.c)) return "c";
+        if(uuid.equals(this.d)) return "d";
+        return "e";
+    }
+
+    private String names(List<UUID> uuids) {
+        return uuids.stream().map(this::name).collect(Collectors.joining());
+    }
+
+    private void run(int ticks) {
+        for(int i = 0; i < ticks; i++) this.lobby.tick(true);
     }
 
     @Test
-    void firstOnPadBecomesChallenger() {
+    void firstOnPadBecomesChallengerAndMayConfigure() {
         assertTrue(this.lobby.enter(1, this.a));
-        assertEquals(List.of("challenger a"), this.events);
+        assertEquals(List.of("challenger a first"), this.events);
         assertEquals(this.a, this.lobby.challenger());
-        assertNull(this.lobby.opponent());
+        assertTrue(this.lobby.canConfigure(this.a));
         assertFalse(this.lobby.isCountingDown());
     }
 
     @Test
-    void takenPadIsRefused() {
+    void oneVersusOneStartsAfterCountdown() {
         this.lobby.enter(0, this.a);
-        assertFalse(this.lobby.enter(0, this.b));
-        assertFalse(this.lobby.enter(1, this.a), "a player can only take one pad");
-    }
-
-    @Test
-    void secondPlayerAppliesKitsAndStartsAfterCountdown() {
-        this.lobby.enter(0, this.a);
-        assertTrue(this.lobby.setMode(this.a, FightMode.CHALLENGER));
+        assertEquals(PadLobby.ConfigureResult.OK, this.lobby.configure(this.a, 1, 1, FightMode.CHALLENGER));
         this.lobby.enter(1, this.b);
-        assertFalse(this.lobby.setMode(this.a, FightMode.OWN), "mode is fixed once the opponent stands there");
-
-        for(int i = 0; i < 41; i++) this.lobby.tick(true);
+        assertEquals(PadLobby.ConfigureResult.NOT_ALLOWED, this.lobby.configure(this.a, 1, 1, FightMode.OWN), "options are fixed during the countdown");
+        this.run(41);
 
         assertEquals(List.of(
-            "challenger a",
-            "kits ab CHALLENGER",
+            "challenger a first",
+            "kit b<-a",
+            "countdown started",
             "countdown 2",
             "countdown 1",
-            "start ab CHALLENGER 0"
+            "start a vs b by a CHALLENGER"
         ), this.events);
+        assertEquals(Map.of(this.a, this.a, this.b, this.a), this.startedKits);
         assertTrue(this.lobby.isIdle());
-        assertNull(this.lobby.challenger());
     }
 
     @Test
-    void onlyChallengerMayChangeMode() {
+    void fullPadIsRefusedAndPlayerOnlyTakesOnePad() {
         this.lobby.enter(0, this.a);
-        assertFalse(this.lobby.setMode(this.b, FightMode.OPPONENT));
-        assertEquals(FightMode.OWN, this.lobby.mode());
+        this.lobby.enter(1, this.b);
+        assertFalse(this.lobby.enter(1, this.c), "1v1: the blue pad is full");
+        assertFalse(this.lobby.enter(0, this.b), "a player can only stand on one pad");
+    }
+
+    @Test
+    void unevenTeamsStartWhenBothPadsAreExactlyFull() {
+        this.lobby.enter(0, this.a);
+        assertEquals(PadLobby.ConfigureResult.OK, this.lobby.configure(this.a, 2, 3, FightMode.OWN));
+        assertTrue(this.lobby.enter(0, this.b));
+        assertFalse(this.lobby.enter(0, this.c), "red is full with 2");
+        this.lobby.enter(1, this.c);
+        this.lobby.enter(1, this.d);
+        assertFalse(this.lobby.isCountingDown());
+        this.lobby.enter(1, this.e);
+        assertTrue(this.lobby.isCountingDown());
+        this.run(41);
+        assertEquals("start ab vs cde by a OWN", this.events.getLast());
+    }
+
+    @Test
+    void challengerKitGoesToEveryone() {
+        this.lobby.enter(0, this.a);
+        this.lobby.configure(this.a, 2, 2, FightMode.CHALLENGER);
+        this.lobby.enter(0, this.b);
+        this.lobby.enter(1, this.c);
+        this.lobby.enter(1, this.d);
+        assertEquals(List.of("challenger a first", "kit b<-a", "kit c<-a", "kit d<-a", "countdown started"), this.events);
+    }
+
+    @Test
+    void opponentModeOnlyForOneVersusOne() {
+        this.lobby.enter(0, this.a);
+        assertNotEquals(PadLobby.ConfigureResult.OK, this.lobby.configure(this.a, 2, 1, FightMode.OPPONENT));
+        assertEquals(PadLobby.ConfigureResult.OK, this.lobby.configure(this.a, 1, 1, FightMode.OPPONENT));
+        this.lobby.enter(1, this.b);
+        assertTrue(this.events.contains("kit a<-b"));
+
+        this.lobby.leave(this.b);
+        assertTrue(this.events.contains("kit a<-a"), "challenger gets the own inventory back");
+        assertTrue(this.events.contains("cancelled"));
+    }
+
+    @Test
+    void onlyChallengerMayConfigure() {
+        this.lobby.enter(0, this.a);
+        assertNotEquals(PadLobby.ConfigureResult.OK, this.lobby.configure(this.b, 2, 2, FightMode.OWN));
+        assertNotEquals(PadLobby.ConfigureResult.OK, this.lobby.configure(this.a, 5, 1, FightMode.OWN));
+        assertNotEquals(PadLobby.ConfigureResult.OK, this.lobby.configure(this.a, 0, 1, FightMode.OWN));
     }
 
     @Test
@@ -101,42 +162,76 @@ class PadLobbyTest {
         for(int i = 0; i < 100; i++) this.lobby.tick(false);
         assertFalse(this.events.contains("countdown 2"));
         assertEquals(2, this.lobby.secondsLeft());
-
-        for(int i = 0; i < 41; i++) this.lobby.tick(true);
-        assertTrue(this.events.contains("start ab OWN 0"));
+        this.run(41);
+        assertEquals("start a vs b by a OWN", this.events.getLast());
     }
 
     @Test
-    void opponentLeavingCancelsAndRevertsBoth() {
+    void leavingCancelsCountdownAndRevertsKit() {
         this.lobby.enter(0, this.a);
-        this.lobby.setMode(this.a, FightMode.OPPONENT);
+        this.lobby.configure(this.a, 1, 1, FightMode.CHALLENGER);
         this.lobby.enter(1, this.b);
         this.events.clear();
 
         this.lobby.leave(this.b);
 
-        assertEquals(List.of("revert b", "revert a", "cancelled"), this.events);
+        assertEquals(List.of("kit b<-b", "cancelled"), this.events);
         assertEquals(this.a, this.lobby.challenger());
-        assertEquals(FightMode.OPPONENT, this.lobby.mode(), "challenger keeps the chosen mode");
+        assertEquals(FightMode.CHALLENGER, this.lobby.mode());
         assertFalse(this.lobby.isCountingDown());
     }
 
     @Test
-    void challengerLeavingHandsOverRole() {
+    void longestWaitingTakesOverAndKeepsTeamSizes() {
         this.lobby.enter(0, this.a);
-        this.lobby.setMode(this.a, FightMode.CHALLENGER);
+        this.lobby.configure(this.a, 2, 2, FightMode.CHALLENGER);
         this.lobby.enter(1, this.b);
+        this.lobby.enter(0, this.c);
         this.events.clear();
 
         this.lobby.leave(this.a);
 
-        assertEquals(List.of("revert a", "revert b", "cancelled", "challenger b"), this.events);
+        assertEquals(List.of("kit a<-a", "kit b<-b", "kit c<-b", "challenger b"), this.events);
         assertEquals(this.b, this.lobby.challenger());
-        assertEquals(1, this.lobby.challengerPad());
-        assertEquals(FightMode.OWN, this.lobby.mode());
+        assertTrue(this.lobby.canConfigure(this.b), "the new challenger may change the options");
+        assertEquals(2, this.lobby.size(0));
+        assertEquals(2, this.lobby.size(1));
+    }
 
-        this.lobby.enter(0, this.c);
-        assertEquals("kits bc OWN", this.events.getLast());
+    @Test
+    void handOverWhenAlone() {
+        this.lobby.enter(0, this.a);
+        this.lobby.enter(1, this.b);
+        this.lobby.leave(this.a);
+        assertEquals("challenger b", this.events.getLast());
+        assertTrue(this.lobby.canConfigure(this.b));
+    }
+
+    @Test
+    void challengerMayChangeOptionsWhileOthersWait() {
+        this.lobby.enter(0, this.a);
+        this.lobby.configure(this.a, 2, 2, FightMode.OWN);
+        this.lobby.enter(0, this.b);
+        this.lobby.enter(1, this.c);
+
+        assertEquals(PadLobby.ConfigureResult.OWN_TOO_SMALL, this.lobby.configure(this.a, 1, 2, FightMode.OWN),
+            "two already stand on the own pad");
+        assertEquals(2, this.lobby.size(0));
+
+        this.events.clear();
+        assertEquals(PadLobby.ConfigureResult.OK, this.lobby.configure(this.a, 2, 1, FightMode.CHALLENGER));
+        assertEquals(List.of("kit b<-a", "kit c<-a", "countdown started"), this.events, "shrinking to the players there starts the countdown");
+        assertTrue(this.lobby.isCountingDown());
+    }
+
+    @Test
+    void opponentSideCannotShrinkBelowPlayers() {
+        this.lobby.enter(0, this.a);
+        this.lobby.configure(this.a, 1, 3, FightMode.OWN);
+        this.lobby.enter(1, this.b);
+        this.lobby.enter(1, this.c);
+        assertEquals(PadLobby.ConfigureResult.OPPONENT_TOO_SMALL, this.lobby.configure(this.a, 1, 1, FightMode.OWN));
+        assertEquals(PadLobby.ConfigureResult.OK, this.lobby.configure(this.a, 1, 4, FightMode.OWN));
     }
 
     @Test
@@ -146,6 +241,62 @@ class PadLobbyTest {
         assertTrue(this.lobby.isIdle());
         assertNull(this.lobby.challenger());
         this.lobby.leave(this.b);
-        assertEquals(List.of("challenger a", "revert a"), this.events);
+        assertEquals(List.of("challenger a first", "kit a<-a"), this.events);
+    }
+
+    @Test
+    void fullLobbyWaitsWhileChallengerChooses() {
+        this.lobby.enter(0, this.a);
+        this.lobby.setChoosing(this.a, true);
+        this.lobby.enter(1, this.b);
+        assertEquals("waiting", this.events.getLast());
+        assertFalse(this.lobby.isCountingDown());
+        assertTrue(this.lobby.isWaitingForChallenger());
+        assertEquals(PadLobby.ConfigureResult.OK, this.lobby.configure(this.a, 1, 1, FightMode.CHALLENGER), "the menu stays usable");
+
+        this.lobby.setChoosing(this.a, false);
+        assertEquals("countdown started", this.events.getLast());
+        assertFalse(this.lobby.isWaitingForChallenger());
+    }
+
+    @Test
+    void choosingTimesOut() {
+        this.lobby.enter(0, this.a);
+        this.lobby.setChoosing(this.a, true);
+        this.lobby.enter(1, this.b);
+        this.run(60);
+        assertFalse(this.lobby.isCountingDown());
+        this.run(1);
+        assertTrue(this.lobby.isCountingDown());
+        this.lobby.setChoosing(this.a, false);
+        assertEquals(1, this.events.stream().filter("countdown started"::equals).count());
+    }
+
+    @Test
+    void onlyChallengerChoosingBlocks() {
+        this.lobby.enter(0, this.a);
+        this.lobby.setChoosing(this.b, true);
+        this.lobby.enter(1, this.b);
+        assertTrue(this.lobby.isCountingDown());
+    }
+
+    @Test
+    void opponentLeavingWhileWaitingIsQuiet() {
+        this.lobby.enter(0, this.a);
+        this.lobby.setChoosing(this.a, true);
+        this.lobby.enter(1, this.b);
+        this.lobby.leave(this.b);
+        assertFalse(this.events.contains("cancelled"));
+        assertFalse(this.lobby.isWaitingForChallenger());
+    }
+
+    @Test
+    void newChallengerIsNotChoosing() {
+        this.lobby.enter(0, this.a);
+        this.lobby.setChoosing(this.a, true);
+        this.lobby.enter(1, this.b);
+        this.lobby.leave(this.a);
+        this.lobby.enter(0, this.c);
+        assertTrue(this.lobby.isCountingDown());
     }
 }

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/chatMention/ChatMention.java

@@ -1,66 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.chatMention;
-
-import eu.mhsl.craftattack.spawn.core.Main;
-import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.settings.Settings;
-import net.kyori.adventure.sound.Sound;
-import org.bukkit.Bukkit;
-import org.bukkit.OfflinePlayer;
-import org.bukkit.event.Listener;
-import org.jetbrains.annotations.NotNull;
-
-import java.util.Arrays;
-import java.util.List;
-import java.util.Objects;
-
-public class ChatMention extends Appliance {
-    private static List<String> playerNames;
-
-    public String formatPlayer(String name) {
-        return "@" + name;
-    }
-
-    public List<String> getPlayerNames() {
-        return playerNames;
-    }
-
-    public void refreshPlayers() {
-        Bukkit.getScheduler().runTaskAsynchronously(
-            Main.instance(),
-            () -> playerNames = Arrays.stream(Bukkit.getOfflinePlayers())
-                .map(OfflinePlayer::getName)
-                .filter(Objects::nonNull)
-                .toList()
-        );
-    }
-
-    public void notifyPlayers(List<String> playerNames) {
-        playerNames.stream()
-            .distinct()
-            .map(Bukkit::getPlayer)
-            .filter(Objects::nonNull)
-            .filter(player -> Settings.instance()
-                .getSetting(player, Settings.Key.ChatMentions, ChatMentionSetting.ChatMentionConfig.class)
-                .notifyOnMention()
-            )
-            .forEach(player -> player.playSound(
-                Sound.sound(
-                    org.bukkit.Sound.ENTITY_EXPERIENCE_ORB_PICKUP,
-                    Sound.Source.PLAYER,
-                    1.0f,
-                    1.0f
-                )
-            ));
-    }
-
-    @Override
-    public void onEnable() {
-        Settings.instance().declareSetting(ChatMentionSetting.class);
-        this.refreshPlayers();
-    }
-
-    @Override
-    protected @NotNull List<Listener> listeners() {
-        return List.of(new ChatMentionListener());
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/chatMention/ChatMentionListener.java

@@ -1,56 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.chatMention;
-
-import eu.mhsl.craftattack.spawn.core.Main;
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceListener;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.chatMessages.ChatMessages;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.settings.Settings;
-import eu.mhsl.craftattack.spawn.core.util.text.ComponentUtil;
-import io.papermc.paper.event.player.AsyncChatDecorateEvent;
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.format.NamedTextColor;
-import net.kyori.adventure.text.serializer.plain.PlainTextComponentSerializer;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.player.PlayerJoinEvent;
-
-import java.util.ArrayList;
-import java.util.List;
-
-class ChatMentionListener extends ApplianceListener<ChatMention> {
-    @SuppressWarnings("UnstableApiUsage")
-    @EventHandler
-    public void coloringEvent(AsyncChatDecorateEvent event) {
-        String message = PlainTextComponentSerializer.plainText().serialize(event.result());
-        List<String> words = List.of(message.split(" "));
-        List<String> mentioned = new ArrayList<>();
-
-        ChatMentionSetting.ChatMentionConfig config = Settings.instance()
-            .getSetting(event.player(), Settings.Key.ChatMentions, ChatMentionSetting.ChatMentionConfig.class);
-        ChatMessages chatMessages = Main.instance().getAppliance(ChatMessages.class);
-
-        Component result = words.stream()
-            .map(word -> {
-                String wordWithoutAnnotation = word.replace("@", "");
-                boolean isPlayer = this.getAppliance().getPlayerNames().contains(wordWithoutAnnotation);
-                if(isPlayer && config.applyMentions()) {
-                    mentioned.add(wordWithoutAnnotation);
-                    Component mention = Component.text(
-                        this.getAppliance().formatPlayer(wordWithoutAnnotation),
-                        NamedTextColor.GOLD
-                    );
-                    return chatMessages.addReportActions(mention, wordWithoutAnnotation);
-                } else {
-                    return Component.text(word);
-                }
-            })
-            .reduce(ComponentUtil::appendWithSpace)
-            .orElseThrow();
-
-        this.getAppliance().notifyPlayers(mentioned);
-        event.result(result);
-    }
-
-    @EventHandler
-    public void onJoin(PlayerJoinEvent event) {
-        this.getAppliance().refreshPlayers();
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/chatMessages/ChatMessages.java

@@ -1,36 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.chatMessages;
-
-import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.settings.Settings;
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.event.ClickEvent;
-import net.kyori.adventure.text.event.HoverEvent;
-import net.kyori.adventure.text.format.NamedTextColor;
-import org.bukkit.entity.Player;
-import org.bukkit.event.Listener;
-import org.jetbrains.annotations.NotNull;
-
-import java.util.List;
-
-public class ChatMessages extends Appliance {
-    @Override
-    public void onEnable() {
-        Settings.instance().declareSetting(ShowJoinAndLeaveMessagesSetting.class);
-    }
-
-    public Component getReportablePlayerName(Player player) {
-        return this.addReportActions(player.displayName(), player.getName());
-    }
-
-    public Component addReportActions(Component message, String username) {
-        return message
-            .hoverEvent(HoverEvent.showText(Component.text("Klicke, um diesen Spieler zu reporten").color(NamedTextColor.GOLD)))
-            .clickEvent(ClickEvent.suggestCommand(String.format("/report %s ", username)));
-    }
-
-    @Override
-    @NotNull
-    protected List<Listener> listeners() {
-        return List.of(new ChatMessagesListener());
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/chatMessages/ChatMessagesListener.java

@@ -1,74 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.chatMessages;
-
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceListener;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.settings.Settings;
-import eu.mhsl.craftattack.spawn.core.util.IteratorUtil;
-import io.papermc.paper.event.player.AsyncChatEvent;
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.format.NamedTextColor;
-import net.kyori.adventure.text.format.TextColor;
-import org.bukkit.Color;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.EventPriority;
-import org.bukkit.event.entity.PlayerDeathEvent;
-import org.bukkit.event.player.PlayerJoinEvent;
-import org.bukkit.event.player.PlayerQuitEvent;
-
-import java.util.Optional;
-
-class ChatMessagesListener extends ApplianceListener<ChatMessages> {
-    @EventHandler
-    public void onPlayerChatEvent(AsyncChatEvent event) {
-        event.renderer(
-            (source, sourceDisplayName, message, viewer) ->
-                Component.text("")
-                    .append(this.getAppliance().getReportablePlayerName(source))
-                    .append(Component.text(" > ").color(TextColor.color(Color.GRAY.asRGB())))
-                    .append(message).color(TextColor.color(Color.SILVER.asRGB()))
-        );
-    }
-
-    @EventHandler(priority = EventPriority.HIGH)
-    public void onPlayerJoin(PlayerJoinEvent event) {
-        boolean wasHidden = event.joinMessage() == null;
-        event.joinMessage(null);
-        if(wasHidden) return;
-        IteratorUtil.onlinePlayers(player -> {
-            if(!Settings.instance().getSetting(player, Settings.Key.ShowJoinAndLeaveMessages, Boolean.class)) return;
-            player.sendMessage(
-                Component
-                    .text(">>> ").color(NamedTextColor.GREEN)
-                    .append(this.getAppliance().getReportablePlayerName(event.getPlayer()))
-            );
-        });
-    }
-
-    @EventHandler
-    public void onPlayerLeave(PlayerQuitEvent event) {
-        boolean wasHidden = event.quitMessage() == null;
-        event.quitMessage(null);
-        if(wasHidden) return;
-        IteratorUtil.onlinePlayers(player -> {
-            if(!Settings.instance().getSetting(player, Settings.Key.ShowJoinAndLeaveMessages, Boolean.class)) return;
-            player.sendMessage(
-                Component
-                    .text("<<< ").color(NamedTextColor.RED)
-                    .append(this.getAppliance().getReportablePlayerName(event.getPlayer()))
-            );
-        });
-    }
-
-    @EventHandler
-    public void onDeath(PlayerDeathEvent event) {
-        event.deathMessage(
-            Component
-                .text("☠ ")
-                .append(
-                    Optional
-                        .ofNullable(event.deathMessage())
-                        .orElse(Component.text(event.getPlayer().getName()))
-                )
-                .color(TextColor.color(Color.SILVER.asRGB()))
-        );
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/displayName/DisplayName.java

@@ -2,10 +2,12 @@ package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.displayName;
 
 import eu.mhsl.craftattack.spawn.core.Main;
 import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
+import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.networkChat.NetworkChat;
 import eu.mhsl.craftattack.spawn.core.util.server.Floodgate;
 import eu.mhsl.craftattack.spawn.core.util.text.ComponentUtil;
 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.ComponentBuilder;
+import net.kyori.adventure.text.JoinConfiguration;
 import net.kyori.adventure.text.TextComponent;
 import net.kyori.adventure.text.event.HoverEvent;
 import net.kyori.adventure.text.format.NamedTextColor;
@@ -49,15 +51,27 @@ public class DisplayName extends Appliance {
             .map(appliance -> (Prefixed) appliance)
             .toList();
 
-        ComponentBuilder<TextComponent, TextComponent.Builder> playerName = Component.text();
-        prefixes.stream()
+        List<Component> prefixComponents = prefixes.stream()
             .map(prefixed -> prefixed.getNamePrefix(player))
             .filter(Objects::nonNull)
-            .forEach(prefix -> playerName
-                .append(prefix)
-                .append(ComponentUtil.clearedSpace())
+            .toList();
+
+        ComponentBuilder<TextComponent, TextComponent.Builder> playerName = Component.text();
+        prefixComponents.forEach(prefix -> playerName
+            .append(prefix)
+            .append(ComponentUtil.clearedSpace())
         );
 
+        // Den Chat-Namen baut Velocity selbst (Farbe, Bedrock), es braucht von hier nur die Prefixe
+        Main.instance().getAppliances().stream()
+            .filter(NetworkChat.class::isInstance)
+            .map(NetworkChat.class::cast)
+            .findFirst()
+            .ifPresent(networkChat -> networkChat.setPrefix(
+                player,
+                prefixComponents.isEmpty() ? null : Component.join(JoinConfiguration.separator(ComponentUtil.clearedSpace()), prefixComponents)
+            ));
+
         if(Floodgate.isBedrock(player)) {
             playerName
                 .append(

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/infoBars/InfoBarSetting.java

@@ -19,7 +19,8 @@ public class InfoBarSetting extends MultiBoolSetting<InfoBarSetting.InfoBarConfi
     public record InfoBarConfiguration(
         @DisplayName("Millisekunden pro Tick") boolean mspt,
         @DisplayName("Spieler online") boolean playerCounter,
-        @DisplayName("Ticks pro Sekunde") boolean tps
+        @DisplayName("Ticks pro Sekunde") boolean tps,
+        @DisplayName("TPS, MSPT & Spieler") boolean tpsMsptPlayerCounter
     ) {}
 
     @Override
@@ -39,7 +40,7 @@ public class InfoBarSetting extends MultiBoolSetting<InfoBarSetting.InfoBarConfi
 
     @Override
     protected InfoBarConfiguration defaultValue() {
-        return new InfoBarConfiguration(false, false, false);
+        return new InfoBarConfiguration(false, false, false, false);
     }
 
     @Override

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/infoBars/InfoBars.java

@@ -1,5 +1,6 @@
 package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.infoBars;
 
+import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.infoBars.bars.TpsMsptPlayerCounterBar;
 import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.settings.Settings;
 import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
 import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
@@ -16,7 +17,8 @@ public class InfoBars extends Appliance {
     private final List<Bar> infoBars = List.of(
         new TpsBar(),
         new MsptBar(),
-        new PlayerCounterBar()
+        new PlayerCounterBar(),
+        new TpsMsptPlayerCounterBar()
     );
 
     public void showAllEnabled(Player player) {
@@ -24,6 +26,7 @@ public class InfoBars extends Appliance {
         this.setVisible(player, MsptBar.name, config.mspt());
         this.setVisible(player, PlayerCounterBar.name, config.playerCounter());
         this.setVisible(player, TpsBar.name, config.tps());
+        this.setVisible(player, TpsMsptPlayerCounterBar.name, config.tpsMsptPlayerCounter());
     }
 
     public void setVisible(Player player, String bar, boolean visible) {

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/infoBars/bars/TpsMsptPlayerCounterBar.java

@@ -0,0 +1,103 @@
+package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.infoBars.bars;
+
+import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.infoBars.Bar;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.playerlimit.PlayerLimit;
+import eu.mhsl.craftattack.spawn.core.Main;
+import eu.mhsl.craftattack.spawn.core.util.statistics.ServerMonitor;
+import eu.mhsl.craftattack.spawn.core.util.text.ColorUtil;
+import net.kyori.adventure.bossbar.BossBar;
+import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.format.NamedTextColor;
+import net.kyori.adventure.text.format.TextColor;
+import org.bukkit.Bukkit;
+
+import java.time.Duration;
+
+public class TpsMsptPlayerCounterBar extends Bar {
+    public static String name = "serverStats";
+
+    @Override
+    protected Duration refresh() {
+        return Duration.ofSeconds(3);
+    }
+
+    @Override
+    protected String name() {
+        return name;
+    }
+
+    @Override
+    protected Component title() {
+        float tps = this.currentTps();
+        float mspt = this.currentMspt();
+        int players = this.currentPlayerCount();
+
+        Component separator = Component.text(" | ", NamedTextColor.DARK_GRAY);
+        TextColor color = ColorUtil.mapGreenToRed(players, 0, this.getMaxPlayerCount(), true);
+
+        return Component.text()
+                .append(Component.text("TPS: ", NamedTextColor.GRAY))
+                .append(Component.text(String.format("%.2f", tps), ColorUtil.tpsColor(tps)))
+                .append(separator)
+                .append(Component.text("MSPT: ", NamedTextColor.GRAY))
+                .append(Component.text(String.format("%.2f", mspt), ColorUtil.msptColor(mspt)))
+                .append(separator)
+                .append(Component.text("Spieler: ", NamedTextColor.GRAY))
+                .append(Component.text(players, color))
+                .build();
+    }
+
+    @Override
+    protected float progress() {
+        return Math.clamp(this.currentTps() / 20f, 0f, 1f);
+    }
+
+    @Override
+    protected BossBar.Color color() {
+        int severity = Math.max(
+                this.tpsSeverity(),
+                Math.max(this.msptSeverity(), this.playerSeverity())
+        );
+
+        return switch (severity) {
+            case 2 -> BossBar.Color.RED;
+            case 1 -> BossBar.Color.YELLOW;
+            default -> BossBar.Color.GREEN;
+        };
+    }
+
+    @Override
+    protected BossBar.Overlay overlay() {
+        return BossBar.Overlay.PROGRESS;
+    }
+
+    private int tpsSeverity() {
+        float tps = this.currentTps();
+        return tps >= 18 ? 0 : tps >= 15 ? 1 : 2;
+    }
+
+    private int msptSeverity() {
+        return this.currentMspt() <= 50 ? 0 : 2;
+    }
+
+    private int playerSeverity() {
+        int freeSlots = this.getMaxPlayerCount() - this.currentPlayerCount();
+        return freeSlots <= 0 ? 2 : freeSlots < 5 ? 1 : 0;
+    }
+
+    private float currentTps() {
+        return (float) Bukkit.getTPS()[0];
+    }
+
+    private float currentMspt() {
+        return ServerMonitor.getServerMSPT();
+    }
+
+    private int currentPlayerCount() {
+        return Bukkit.getOnlinePlayers().size();
+    }
+
+    private int getMaxPlayerCount() {
+        return Main.instance().getAppliance(PlayerLimit.class).getLimit();
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/networkChat/ChatMentionSetting.java

@@ -1,4 +1,4 @@
-package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.chatMention;
+package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.networkChat;
 
 import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.settings.CategorizedSetting;
 import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.settings.SettingCategory;
@@ -29,7 +29,7 @@ public class ChatMentionSetting extends MultiBoolSetting<ChatMentionSetting.Chat
 
     @Override
     protected String description() {
-        return "Erwähnungen werden automatisch im Chat angewandt und der Empfänger erhält einen Signalton";
+        return "Wirst du im Chat erwähnt, wird dein Name hervorgehoben und du hörst einen Signalton";
     }
 
     @Override

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/networkChat/NetworkChat.java

@@ -0,0 +1,101 @@
+package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.networkChat;
+
+import com.google.common.io.ByteArrayDataInput;
+import com.google.common.io.ByteArrayDataOutput;
+import com.google.common.io.ByteStreams;
+import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.settings.Settings;
+import eu.mhsl.craftattack.spawn.core.Main;
+import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
+import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.serializer.gson.GsonComponentSerializer;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.Listener;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
+
+/**
+ * Chat läuft über Velocity (Plugin chat-bridge): Der öffentliche Chat, /msg, /r, /adminchat, /mute und
+ * Join/Leave-Meldungen gelten im ganzen Netzwerk. Hier wird der Chat nur verworfen, Velocity bekommt
+ * die Rang-Prefixe für den Namen, und die Chat-Einstellungen werden mit Velocity abgeglichen.
+ * <p>
+ * Kanal {@value #channel}, Nachrichten (UTF-Typ, dann Daten):
+ * <ul>
+ *   <li>→ Proxy {@code prefix}: Adventure-JSON oder leer</li>
+ *   <li>→ Proxy {@code settings-hello} beim Join, {@code settings-set} nach einer Änderung: Join/Leave,
+ *       Erwähnungen hervorheben, Erwähnungston (je boolean). Velocity speichert sie; kennt es schon
+ *       Werte, antwortet es auf das Hello mit {@code settings}.</li>
+ *   <li>← Proxy {@code settings}: gespeicherte Werte, werden hier übernommen</li>
+ * </ul>
+ */
+public class NetworkChat extends Appliance {
+    public static final String channel = "craftattack:chat";
+
+    private final Map<UUID, Component> prefixes = new ConcurrentHashMap<>();
+
+    @Override
+    public void onEnable() {
+        Bukkit.getMessenger().registerOutgoingPluginChannel(Main.instance(), channel);
+        Bukkit.getMessenger().registerIncomingPluginChannel(Main.instance(), channel, (channel, player, message) -> this.receive(player, message));
+
+        Settings.instance().declareSetting(ShowJoinAndLeaveMessagesSetting.class);
+        Settings.instance().declareSetting(ChatMentionSetting.class);
+        Settings.instance().addChangeListener(ShowJoinAndLeaveMessagesSetting.class, player -> this.sendSettings(player, "settings-set"));
+        Settings.instance().addChangeListener(ChatMentionSetting.class, player -> this.sendSettings(player, "settings-set"));
+    }
+
+    public void setPrefix(Player player, @Nullable Component prefix) {
+        if(prefix == null) this.prefixes.remove(player.getUniqueId());
+        else this.prefixes.put(player.getUniqueId(), prefix);
+        this.sendPrefix(player);
+    }
+
+    void sendPrefix(Player player) {
+        Component prefix = this.prefixes.get(player.getUniqueId());
+        ByteArrayDataOutput output = ByteStreams.newDataOutput();
+        output.writeUTF("prefix");
+        output.writeUTF(prefix == null ? "" : GsonComponentSerializer.gson().serialize(prefix));
+        this.send(player, output);
+    }
+
+    void sendSettings(Player player, String type) {
+        ChatMentionSetting.ChatMentionConfig mentions = Settings.instance()
+            .getSetting(player, Settings.Key.ChatMentions, ChatMentionSetting.ChatMentionConfig.class);
+        ByteArrayDataOutput output = ByteStreams.newDataOutput();
+        output.writeUTF(type);
+        output.writeBoolean(Settings.instance().getSetting(player, Settings.Key.ShowJoinAndLeaveMessages, Boolean.class));
+        output.writeBoolean(mentions.applyMentions());
+        output.writeBoolean(mentions.notifyOnMention());
+        this.send(player, output);
+    }
+
+    private void receive(Player player, byte[] message) {
+        ByteArrayDataInput input = ByteStreams.newDataInput(message);
+        if(!input.readUTF().equals("settings")) return;
+        boolean joinAndLeave = input.readBoolean();
+        boolean applyMentions = input.readBoolean();
+        boolean notifyOnMention = input.readBoolean();
+        Settings.instance().setSetting(player, Settings.Key.ShowJoinAndLeaveMessages, joinAndLeave);
+        Settings.instance().setSetting(player, Settings.Key.ChatMentions, new ChatMentionSetting.ChatMentionConfig(applyMentions, notifyOnMention));
+    }
+
+    private void send(Player player, ByteArrayDataOutput output) {
+        // Velocity meldet den Kanal erst kurz nach dem Join an, dann folgt PlayerRegisterChannelEvent
+        if(!player.getListeningPluginChannels().contains(channel)) return;
+        player.sendPluginMessage(Main.instance(), channel, output.toByteArray());
+    }
+
+    void forget(Player player) {
+        this.prefixes.remove(player.getUniqueId());
+    }
+
+    @Override
+    protected @NotNull List<Listener> listeners() {
+        return List.of(new NetworkChatListener());
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/networkChat/NetworkChatListener.java

@@ -0,0 +1,74 @@
+package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.networkChat;
+
+import eu.mhsl.craftattack.spawn.core.appliance.ApplianceListener;
+import io.papermc.paper.event.player.AsyncChatEvent;
+import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.format.NamedTextColor;
+import net.kyori.adventure.text.format.TextColor;
+import org.bukkit.Color;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.EventPriority;
+import org.bukkit.event.entity.PlayerDeathEvent;
+import org.bukkit.event.player.PlayerCommandPreprocessEvent;
+import org.bukkit.event.player.PlayerJoinEvent;
+import org.bukkit.event.player.PlayerQuitEvent;
+import org.bukkit.event.player.PlayerRegisterChannelEvent;
+
+import java.util.Locale;
+import java.util.Optional;
+import java.util.Set;
+
+class NetworkChatListener extends ApplianceListener<NetworkChat> {
+    // Vanilla-Befehle, die am Proxy vorbei in den lokalen Chat schreiben; /msg, /tell, /w fängt Velocity ab
+    private static final Set<String> localChatCommands = Set.of(
+        "me", "minecraft:me", "teammsg", "tm", "minecraft:teammsg", "minecraft:tm",
+        "minecraft:msg", "minecraft:tell", "minecraft:w"
+    );
+
+    @EventHandler(priority = EventPriority.HIGHEST)
+    public void onChat(AsyncChatEvent event) {
+        // Velocity hat die Nachricht schon an alle verteilt
+        event.setCancelled(true);
+    }
+
+    @EventHandler(priority = EventPriority.HIGHEST)
+    public void onCommand(PlayerCommandPreprocessEvent event) {
+        String label = event.getMessage().substring(1).split(" ", 2)[0].toLowerCase(Locale.ROOT);
+        if(!localChatCommands.contains(label)) return;
+        event.setCancelled(true);
+        event.getPlayer().sendMessage(Component.text("Dieser Befehl ist hier nicht verfügbar.", NamedTextColor.RED));
+    }
+
+    @EventHandler
+    public void onRegisterChannel(PlayerRegisterChannelEvent event) {
+        if(!event.getChannel().equals(NetworkChat.channel)) return;
+        this.getAppliance().sendPrefix(event.getPlayer());
+        this.getAppliance().sendSettings(event.getPlayer(), "settings-hello");
+    }
+
+    @EventHandler(priority = EventPriority.HIGHEST)
+    public void onJoin(PlayerJoinEvent event) {
+        // Join- und Leave-Meldungen schreibt Velocity, beim Serverwechsel gar keine
+        event.joinMessage(null);
+    }
+
+    @EventHandler(priority = EventPriority.HIGHEST)
+    public void onQuit(PlayerQuitEvent event) {
+        event.quitMessage(null);
+        this.getAppliance().forget(event.getPlayer());
+    }
+
+    @EventHandler
+    public void onDeath(PlayerDeathEvent event) {
+        event.deathMessage(
+            Component
+                .text("☠ ")
+                .append(
+                    Optional
+                        .ofNullable(event.deathMessage())
+                        .orElse(Component.text(event.getPlayer().getName()))
+                )
+                .color(TextColor.color(Color.SILVER.asRGB()))
+        );
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/networkChat/ShowJoinAndLeaveMessagesSetting.java

@@ -1,4 +1,4 @@
-package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.chatMessages;
+package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.networkChat;
 
 import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.settings.CategorizedSetting;
 import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.settings.SettingCategory;

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/privateMessage/PrivateMessage.java

@@ -1,194 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.privateMessage;
-
-import eu.mhsl.craftattack.spawn.core.Main;
-import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.chatMessages.ChatMessages;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.privateMessage.commands.PrivateMessageCommand;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.privateMessage.commands.PrivateReplyCommand;
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.ComponentBuilder;
-import net.kyori.adventure.text.TextComponent;
-import net.kyori.adventure.text.event.ClickEvent;
-import net.kyori.adventure.text.event.HoverEvent;
-import net.kyori.adventure.text.format.NamedTextColor;
-import org.bukkit.Bukkit;
-import org.bukkit.entity.Player;
-import org.jetbrains.annotations.NotNull;
-
-import java.util.*;
-import java.util.stream.Collectors;
-
-public class PrivateMessage extends Appliance {
-    public final int targetChangeTimeoutSeconds = 30;
-    public final int conversationTimeoutMinutes = 30;
-
-    private record Conversation(UUID target, Long lastSet) {
-    }
-
-    private final Map<Player, List<Conversation>> replyMapping = new WeakHashMap<>();
-
-    public void reply(Player sender, String message) {
-        this.replyMapping.computeIfAbsent(sender, player -> new ArrayList<>());
-
-        List<Conversation> replyList = this.replyMapping.get(sender);
-
-        List<Conversation> tooOldConversations = replyList.stream()
-            .filter(conversation -> conversation.lastSet < System.currentTimeMillis() - (this.conversationTimeoutMinutes * 60 * 1000))
-            .toList();
-        replyList.removeAll(tooOldConversations);
-
-        if(replyList.isEmpty()) throw new ApplianceCommand.Error("Du führst aktuell keine Konversation.");
-
-        Component privatePrefix = Component.text("[Privat] ", NamedTextColor.LIGHT_PURPLE);
-
-        Conversation youngestEntry = replyList.stream()
-            .max(Comparator.comparingLong(o -> o.lastSet))
-            .orElse(replyList.getLast());
-
-        if(message.isBlank()) {
-            Player currentTargetPlayer = Bukkit.getPlayer(youngestEntry.target());
-
-            Component currentTargetComponent = currentTargetPlayer != null
-                ? Main.instance().getAppliance(ChatMessages.class).getReportablePlayerName(currentTargetPlayer)
-                : Component.text("niemandem.");
-
-            sender.sendMessage(
-                privatePrefix
-                    .append(Component.text("Du schreibst aktuell mit ", NamedTextColor.GRAY))
-                    .append(currentTargetComponent)
-            );
-            return;
-        }
-
-        List<Conversation> oldConversations = replyList.stream()
-            .filter(conversation -> conversation.lastSet < System.currentTimeMillis() - (this.targetChangeTimeoutSeconds * 1000))
-            .toList();
-
-        if(oldConversations.contains(youngestEntry) || replyList.size() == 1) {
-            Player target = Bukkit.getPlayer(youngestEntry.target());
-            if(target == null)
-                throw new ApplianceCommand.Error("Der Spieler " + Bukkit.getOfflinePlayer(youngestEntry.target()).getName() + " ist nicht mehr verfügbar.");
-
-            replyList.clear();
-            this.sendWhisper(sender, new ResolvedPmUserArguments(target, message));
-            return;
-        }
-
-        ComponentBuilder<TextComponent, TextComponent.Builder> component = Component.text();
-
-        component.append(
-            Component.newline()
-                .append(privatePrefix)
-                .append(Component.text("Das Ziel für /r hat sich bei dir in den letzten ", NamedTextColor.RED))
-                .append(Component.text(String.valueOf(this.targetChangeTimeoutSeconds), NamedTextColor.RED))
-                .append(Component.text(" Sekunden geändert. Wer soll deine Nachricht erhalten? ", NamedTextColor.RED))
-                .appendNewline()
-                .appendNewline()
-        );
-
-        if(!oldConversations.isEmpty()) {
-            Conversation youngestOldConversation = oldConversations.stream()
-                .max(Comparator.comparingLong(o -> o.lastSet))
-                .orElse(oldConversations.getLast());
-            replyList.removeAll(oldConversations);
-            replyList.add(youngestOldConversation);
-        }
-
-        List<String> playerNames = replyList.stream()
-            .map(conversation -> Bukkit.getOfflinePlayer(conversation.target()).getName())
-            .distinct()
-            .toList();
-
-        playerNames.forEach(playerName -> component.append(
-                Component.text("[")
-                    .append(Component.text(playerName, NamedTextColor.GOLD))
-                    .append(Component.text("]"))
-                    .clickEvent(ClickEvent.runCommand(String.format("/msg %s %s", playerName, message)))
-                    .hoverEvent(HoverEvent.showText(Component.text("Klicke, um diesem Spieler zu schreiben.").color(NamedTextColor.GOLD))))
-            .append(Component.text("  "))
-        );
-        component.appendNewline();
-
-        sender.sendMessage(component.build());
-
-    }
-
-    public void sendWhisper(Player sender, ResolvedPmUserArguments userArguments) {
-        Conversation newReceiverConversation = new Conversation(
-            sender.getUniqueId(),
-            System.currentTimeMillis()
-        );
-
-        if(this.replyMapping.get(userArguments.receiver) != null) {
-            List<Conversation> oldEntries = this.replyMapping.get(userArguments.receiver).stream()
-                .filter(conversation -> conversation.target() == sender.getUniqueId())
-                .toList();
-            this.replyMapping.get(userArguments.receiver).removeAll(oldEntries);
-        } else {
-            this.replyMapping.put(
-                userArguments.receiver,
-                new ArrayList<>()
-            );
-        }
-
-        this.replyMapping.get(userArguments.receiver).add(newReceiverConversation);
-
-        List<Conversation> senderConversationList = new ArrayList<>();
-        senderConversationList.add(
-            new Conversation(
-                userArguments.receiver.getUniqueId(),
-                System.currentTimeMillis()
-            )
-        );
-
-        this.replyMapping.put(
-            sender,
-            senderConversationList
-        );
-
-        ChatMessages chatMessages = Main.instance().getAppliance(ChatMessages.class);
-        Component privatePrefix = Component.text("[Privat] ", NamedTextColor.LIGHT_PURPLE);
-
-        sender.sendMessage(
-            Component.text()
-                .append(privatePrefix.clickEvent(ClickEvent.suggestCommand(String.format("/msg %s ", userArguments.receiver.getName()))))
-                .append(sender.displayName())
-                .append(Component.text(" zu ", NamedTextColor.GRAY))
-                .append(chatMessages.getReportablePlayerName(userArguments.receiver))
-                .append(Component.text(" > ", NamedTextColor.GRAY))
-                .append(Component.text(userArguments.message))
-        );
-        userArguments.receiver.sendMessage(
-            Component.text()
-                .append(privatePrefix.clickEvent(ClickEvent.suggestCommand(String.format("/msg %s ", sender.getName()))))
-                .append(chatMessages.getReportablePlayerName(sender))
-                .append(Component.text(" zu ", NamedTextColor.GRAY))
-                .append(userArguments.receiver.displayName())
-                .append(Component.text(" > ", NamedTextColor.GRAY))
-                .append(Component.text(userArguments.message))
-        );
-    }
-
-    public record ResolvedPmUserArguments(Player receiver, String message) {
-    }
-
-    public ResolvedPmUserArguments resolveImplicit(String[] args) {
-        if(args.length < 2)
-            throw new ApplianceCommand.Error("Es muss ein Spieler sowie eine Nachricht angegeben werden.");
-        List<String> arguments = List.of(args);
-        Player targetPlayer = Bukkit.getPlayer(arguments.getFirst());
-        if(targetPlayer == null)
-            throw new ApplianceCommand.Error(String.format("Der Spieler %s konnte nicht gefunden werden.", arguments.getFirst()));
-        String message = arguments.stream().skip(1).collect(Collectors.joining(" "));
-        return new ResolvedPmUserArguments(targetPlayer, message);
-    }
-
-    @Override
-    protected @NotNull List<ApplianceCommand<?>> commands() {
-        return List.of(
-            new PrivateMessageCommand(),
-            new PrivateReplyCommand()
-        );
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/privateMessage/commands/PrivateMessageCommand.java

@@ -1,18 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.privateMessage.commands;
-
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.privateMessage.PrivateMessage;
-import org.bukkit.command.Command;
-import org.bukkit.command.CommandSender;
-import org.jetbrains.annotations.NotNull;
-
-public class PrivateMessageCommand extends ApplianceCommand.PlayerChecked<PrivateMessage> {
-    public PrivateMessageCommand() {
-        super("msg");
-    }
-
-    @Override
-    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) throws Exception {
-        this.getAppliance().sendWhisper(this.getPlayer(), this.getAppliance().resolveImplicit(args));
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/privateMessage/commands/PrivateReplyCommand.java

@@ -1,18 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.privateMessage.commands;
-
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.privateMessage.PrivateMessage;
-import org.bukkit.command.Command;
-import org.bukkit.command.CommandSender;
-import org.jetbrains.annotations.NotNull;
-
-public class PrivateReplyCommand extends ApplianceCommand.PlayerChecked<PrivateMessage> {
-    public PrivateReplyCommand() {
-        super("r");
-    }
-
-    @Override
-    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) throws Exception {
-        this.getAppliance().reply(this.getPlayer(), String.join(" ", args));
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/settings/Settings.java

@@ -112,6 +112,18 @@ public class Settings extends Appliance {
         return clazz.cast(setting.state());
     }
 
+    /** Setzt einen Wert von außen (z. B. vom Proxy), ohne die Change-Listener auszulösen. */
+    public <T> void setSetting(Player player, Key key, T value) {
+        Setting<?> setting = this.getSettings(player).stream()
+            .filter(s -> Objects.equals(s.getKey(), key))
+            .findFirst()
+            .orElseThrow();
+
+        if(!setting.dataType().isInstance(value))
+            throw new IllegalStateException("Tried to set Setting with Datatype " + value.getClass().getSimpleName() + " but expected " + setting.dataType().getSimpleName());
+        setting.restore(player, value);
+    }
+
     public void openSettings(Player player) {
         List<Setting<?>> settings = this.getSettings(player);
         Inventory inventory = Bukkit.createInventory(null, this.calculateInvSize(settings), Component.text("Einstellungen"));

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/metaGameplay/settings/datatypes/Setting.java

@@ -62,6 +62,12 @@ public abstract class Setting<TDataType> {
         Settings.instance().invokeChangeListener(p, this.getClass());
     }
 
+    @SuppressWarnings("unchecked")
+    public void restore(Player p, Object value) {
+        this.state = (TDataType) value;
+        this.toStorage(p.getPersistentDataContainer(), this.state);
+    }
+
     public ItemStack buildItem() {
         ItemStack stack = new ItemStack(this.icon(), 1);
         stack.setItemMeta(this.buildMeta(stack.getItemMeta()));

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/adminChat/AdminChat.java

@@ -1,37 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.tooling.adminChat;
-
-import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.event.ClickEvent;
-import net.kyori.adventure.text.format.NamedTextColor;
-import org.bukkit.Bukkit;
-import org.bukkit.entity.Player;
-import org.jetbrains.annotations.NotNull;
-
-import java.util.List;
-
-public class AdminChat extends Appliance {
-    public void sendMessage(Player sender, String message) {
-        Component privatePrefix = Component
-            .text("[Admin] ", NamedTextColor.LIGHT_PURPLE)
-            .clickEvent(ClickEvent.suggestCommand(AdminChatCommand.commandName));
-
-        Bukkit.getOnlinePlayers().stream()
-            .filter(player -> player.hasPermission("admin"))
-            .forEach(player -> {
-                Component formattedMessage = Component.text()
-                    .append(privatePrefix)
-                    .append(sender.displayName())
-                    .append(Component.text(" > ", NamedTextColor.DARK_GRAY))
-                    .append(Component.text(message))
-                    .build();
-                player.sendMessage(formattedMessage);
-            });
-    }
-
-    @Override
-    protected @NotNull List<ApplianceCommand<?>> commands() {
-        return List.of(new AdminChatCommand());
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/adminChat/AdminChatCommand.java

@@ -1,22 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.tooling.adminChat;
-
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
-import org.bukkit.command.Command;
-import org.bukkit.command.CommandSender;
-import org.jetbrains.annotations.NotNull;
-
-class AdminChatCommand extends ApplianceCommand.PlayerChecked<AdminChat> {
-    public static final String commandName = "adminchat";
-
-    public AdminChatCommand() {
-        super(commandName);
-    }
-
-    @Override
-    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) throws Exception {
-        if(!sender.hasPermission("admin")) return;
-
-        String message = String.join(" ", args);
-        this.getAppliance().sendMessage(this.getPlayer(), message);
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/chatMute/ChatMute.java

@@ -1,44 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.tooling.chatMute;
-
-import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
-import org.bukkit.NamespacedKey;
-import org.bukkit.entity.Player;
-import org.bukkit.event.Listener;
-import org.bukkit.persistence.PersistentDataContainer;
-import org.bukkit.persistence.PersistentDataType;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.List;
-import java.util.Locale;
-import java.util.Objects;
-
-public class ChatMute extends Appliance {
-    private static final String namespace = ChatMute.class.getSimpleName().toLowerCase(Locale.ROOT);
-    public static NamespacedKey mutedUntilKey = new NamespacedKey(namespace, "mutedUntilMillis".toLowerCase());
-
-    public void mutePlayer(Player player, int durationHours) {
-        PersistentDataContainer container = player.getPersistentDataContainer();
-        long mutedUntil = System.currentTimeMillis() + (long) durationHours * 60 * 60 * 1000;
-        container.set(ChatMute.mutedUntilKey, PersistentDataType.LONG, mutedUntil);
-    }
-
-    public @Nullable Long muteStatus(Player player) {
-        PersistentDataContainer container = player.getPersistentDataContainer();
-        if(!container.has(mutedUntilKey)) return null;
-        long mutedUntil = Objects.requireNonNull(container.get(mutedUntilKey, PersistentDataType.LONG));
-        if(mutedUntil < System.currentTimeMillis()) return null;
-        return mutedUntil;
-    }
-
-    @Override
-    protected @NotNull List<ApplianceCommand<?>> commands() {
-        return List.of(new MuteCommand());
-    }
-
-    @Override
-    protected @NotNull List<Listener> listeners() {
-        return List.of(new ChatMuteListener());
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/chatMute/ChatMuteListener.java

@@ -1,25 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.tooling.chatMute;
-
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceListener;
-import eu.mhsl.craftattack.spawn.core.util.text.DataSizeConverter;
-import io.papermc.paper.event.player.AsyncChatEvent;
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.format.NamedTextColor;
-import org.bukkit.event.EventHandler;
-import org.jetbrains.annotations.Nullable;
-
-class ChatMuteListener extends ApplianceListener<ChatMute> {
-    @EventHandler
-    public void onChat(AsyncChatEvent event) {
-        @Nullable Long muteDuration = this.getAppliance().muteStatus(event.getPlayer());
-        if(muteDuration == null) return;
-        event.setCancelled(true);
-        event.getPlayer().sendMessage(Component.text(
-            String.format(
-                "Du bist für %s gestummt!",
-                DataSizeConverter.formatSecondsToHumanReadable((int) ((muteDuration - System.currentTimeMillis()) / 1000))
-            ),
-            NamedTextColor.RED
-        ));
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/chatMute/MuteCommand.java

@@ -1,35 +0,0 @@
-package eu.mhsl.craftattack.spawn.common.appliances.tooling.chatMute;
-
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
-import org.bukkit.Bukkit;
-import org.bukkit.command.Command;
-import org.bukkit.command.CommandSender;
-import org.bukkit.entity.Player;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.List;
-import java.util.Objects;
-
-class MuteCommand extends ApplianceCommand<ChatMute> {
-    public MuteCommand() {
-        super("mute");
-    }
-
-    @Override
-    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) throws Exception {
-        if(args.length < 2) throw new Error("Syntax: mute <player> <duration in hours>");
-        Player player = Objects.requireNonNull(Bukkit.getPlayer(args[0]));
-        int durationInHours = Integer.parseInt(args[1]);
-        this.getAppliance().mutePlayer(player, durationInHours);
-        sender.sendMessage(String.format("%s wurde für %d Stunden gestummt!", player.getName(), durationInHours));
-    }
-
-    @Override
-    public @Nullable List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
-        if(args.length == 2) {
-            return List.of("1", "2", "4", "8", "24", "48");
-        }
-        return null;
-    }
-}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/dimensionScheduler/DimensionOpeningEffects.java

@@ -0,0 +1,63 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduler.Effect;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduler.MessageGroup;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduler.SoundSettings;
+import net.kyori.adventure.sound.Sound;
+import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.format.TextColor;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Optional;
+import java.util.concurrent.ThreadLocalRandom;
+
+/** Shared message/sound delivery. Group names and color are supplied by the owning appliance. */
+public final class DimensionOpeningEffects {
+    private final String effectsGroup;
+    private final String denialGroup;
+    private final TextColor color;
+    private @Nullable DimensionScheduler scheduler;
+
+    public DimensionOpeningEffects(String effectsGroup, String denialGroup, TextColor color) {
+        this.effectsGroup = effectsGroup;
+        this.denialGroup = denialGroup;
+        this.color = color;
+    }
+
+    public void configure(DimensionScheduler scheduler) {
+        this.scheduler = scheduler;
+    }
+
+    public List<Effect> getConfiguredEffects() {
+        return this.scheduler == null ? List.of() : this.scheduler.getEffects(this.effectsGroup);
+    }
+
+    public void denyActivation(Player player) {
+        if(this.scheduler == null) return;
+        MessageGroup group = this.scheduler.getMessageGroup(this.denialGroup);
+        List<String> messages = group.texts();
+        if(messages.isEmpty()) return;
+        String message = messages.get(ThreadLocalRandom.current().nextInt(messages.size()));
+        send(player, DimensionScheduleText.message(message, this.color), group.sound().map(SoundSettings::asSound));
+    }
+
+    public void playOpening() {
+        for(Effect effect : this.getConfiguredEffects()) {
+            if(effect.minutesBeforeOpening() == 0) this.play(effect);
+        }
+    }
+
+    public void play(Effect effect) {
+        Component message = DimensionScheduleText.message(effect.message(), this.color);
+        Optional<Sound> sound = effect.sound().map(SoundSettings::asSound);
+        Bukkit.getOnlinePlayers().forEach(player -> send(player, message, sound));
+    }
+
+    private static void send(Player player, Component message, Optional<Sound> sound) {
+        player.sendMessage(message);
+        sound.ifPresent(value -> player.playSound(value, Sound.Emitter.self()));
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/dimensionScheduler/DimensionScheduleCommand.java

@@ -0,0 +1,49 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler;
+
+import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.bukkit.configuration.InvalidConfigurationException;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.IOException;
+import java.time.Instant;
+import java.util.List;
+
+class DimensionScheduleCommand extends ApplianceCommand<DimensionScheduler> {
+    public DimensionScheduleCommand() {
+        super("dimensionSchedule");
+    }
+
+    @Override
+    public @NotNull String permission() {
+        return "spawn.command.dimensionschedule";
+    }
+
+    @Override
+    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        if(!sender.isOp()) throw new Error("Dieser Befehl ist nur für die Konsole und OPs verfügbar.");
+        if(args.length != 1 || !args[0].equalsIgnoreCase("reload")) {
+            throw new Error("Verwendung: /dimensionSchedule reload");
+        }
+
+        try {
+            this.getAppliance().reload();
+        } catch(IOException | InvalidConfigurationException | IllegalArgumentException e) {
+            throw new Error("dimension-schedule.yml konnte nicht neu eingelesen werden: " + e.getMessage());
+        }
+        Instant now = Instant.now();
+        sender.sendMessage(DimensionScheduleText.message("Die Öffnungszeiten, Texte und Effekte wurden neu eingelesen."));
+        sender.sendMessage(DimensionScheduleText.message("End-Termin: "
+            + DimensionScheduleText.appointment(this.getAppliance().getTime("end-open-at"), now)));
+        sender.sendMessage(DimensionScheduleText.message("Nether-Termin: "
+            + DimensionScheduleText.appointment(this.getAppliance().getTime("nether-open-at"), now),
+            DimensionScheduleText.NETHER_RED));
+    }
+
+    @Override
+    public @NotNull List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        if(!sender.isOp() || args.length != 1) return List.of();
+        return this.tabCompleteReducer(List.of("reload"), args);
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/dimensionScheduler/DimensionScheduleText.java

@@ -0,0 +1,53 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler;
+
+import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.format.TextColor;
+
+import java.time.Duration;
+import java.time.Instant;
+import java.time.ZoneId;
+import java.time.format.DateTimeFormatter;
+import java.util.Locale;
+import java.util.Optional;
+
+/** Shared appearance and German time formatting for dimension messages and commands. */
+public final class DimensionScheduleText {
+    public static final TextColor END_GREEN = TextColor.color(0x80A71A);
+    public static final TextColor NETHER_RED = TextColor.color(0xB83D32);
+    private static final DateTimeFormatter DATE = DateTimeFormatter
+        .ofPattern("dd.MM.yyyy 'um' HH:mm:ss 'Uhr' z", Locale.GERMAN)
+        .withZone(ZoneId.of("Europe/Berlin"));
+
+    private DimensionScheduleText() {
+    }
+
+    public static Component message(String text) {
+        return message(text, END_GREEN);
+    }
+
+    public static Component message(String text, TextColor color) {
+        return Component.text(text, color);
+    }
+
+    /** Round up partial minutes so a pending opening never reads as zero minutes away. */
+    public static String remaining(Instant openingAt, Instant now) {
+        Duration duration = Duration.between(now, openingAt);
+        if(duration.isNegative() || duration.isZero()) return "0 Tagen, 0 Stunden und 0 Minuten";
+        long minutes = duration.toMinutes();
+        if(!duration.minusMinutes(minutes).isZero()) minutes++;
+        long days = minutes / (24 * 60);
+        long hours = minutes / 60 % 24;
+        long minutePart = minutes % 60;
+        return days + (days == 1 ? " Tag, " : " Tagen, ")
+            + hours + (hours == 1 ? " Stunde und " : " Stunden und ")
+            + minutePart + (minutePart == 1 ? " Minute" : " Minuten");
+    }
+
+    public static String appointment(Optional<Instant> openingAt, Instant now) {
+        if(openingAt.isEmpty()) return "nicht festgelegt";
+        Instant time = openingAt.get();
+        return DATE.format(time) + (time.isAfter(now)
+            ? " (in " + remaining(time, now) + ")"
+            : " (Termin bereits erreicht)");
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/dimensionScheduler/DimensionScheduler.java

@@ -0,0 +1,231 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler;
+
+import eu.mhsl.craftattack.spawn.core.Main;
+import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
+import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
+import net.kyori.adventure.key.InvalidKeyException;
+import net.kyori.adventure.key.Key;
+import net.kyori.adventure.sound.Sound;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.configuration.InvalidConfigurationException;
+import org.bukkit.configuration.file.YamlConfiguration;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.File;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.nio.charset.StandardCharsets;
+import java.time.Duration;
+import java.time.Instant;
+import java.time.OffsetDateTime;
+import java.time.format.DateTimeParseException;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.logging.Level;
+
+/** Reads named times, message groups and effect definitions; execution belongs to their consumers. */
+public class DimensionScheduler extends Appliance {
+    public record SoundSettings(String name, float volume, float pitch) {
+        public Sound asSound() {
+            return Sound.sound(Key.key(this.name), Sound.Source.MASTER, this.volume, this.pitch);
+        }
+    }
+
+    public record MessageGroup(List<String> texts, Optional<SoundSettings> sound) {
+    }
+
+    public record Effect(String name, int minutesBeforeOpening, String message, Optional<SoundSettings> sound) {
+        public Duration leadTime() {
+            return Duration.ofMinutes(this.minutesBeforeOpening);
+        }
+    }
+
+    private static final String FILE_NAME = "dimension-schedule.yml";
+    private static final MessageGroup EMPTY_MESSAGE_GROUP = new MessageGroup(List.of(), Optional.empty());
+    private final File scheduleFile = new File(Main.instance().getDataFolder(), FILE_NAME);
+    private Map<String, Instant> times = Map.of();
+    private Map<String, MessageGroup> messages = Map.of();
+    private Map<String, List<Effect>> effects = Map.of();
+    private Instant loadedAt = Instant.now();
+
+    @Override
+    public void onEnable() {
+        try {
+            if(!this.scheduleFile.exists()) Main.instance().saveResource(FILE_NAME, false);
+            this.reload();
+        } catch(IOException | InvalidConfigurationException | IllegalArgumentException e) {
+            Main.logger().log(Level.WARNING, "Could not load " + FILE_NAME + "; keeping previous configuration", e);
+        }
+    }
+
+    /** Validates the complete configuration before replacing it. Never creates or writes the file. */
+    public void reload() throws IOException, InvalidConfigurationException {
+        YamlConfiguration configuration = new YamlConfiguration();
+        configuration.load(this.scheduleFile);
+        YamlConfiguration defaults = this.readDefaults();
+
+        Map<String, Instant> loadedTimes = new HashMap<>();
+        ConfigurationSection timeSection = section(configuration, "times");
+        boolean legacyTimes = timeSection == null;
+        if(legacyTimes) timeSection = configuration;
+        for(Map.Entry<String, Object> entry : timeSection.getValues(false).entrySet()) {
+            if(legacyTimes && List.of("times", "messages", "effects").contains(entry.getKey())) continue;
+            readTime(entry.getKey(), entry.getValue()).ifPresent(time -> loadedTimes.put(entry.getKey(), time));
+        }
+        ConfigurationSection messageSection = section(configuration, "messages");
+        ConfigurationSection effectSection = section(configuration, "effects");
+        Map<String, MessageGroup> loadedMessages = readMessages(messageSection == null ? section(defaults, "messages") : messageSection);
+        Map<String, List<Effect>> loadedEffects = readEffects(effectSection == null ? section(defaults, "effects") : effectSection);
+
+        this.times = Map.copyOf(loadedTimes);
+        this.messages = loadedMessages;
+        this.effects = loadedEffects;
+        this.loadedAt = Instant.now();
+    }
+
+    private YamlConfiguration readDefaults() throws IOException, InvalidConfigurationException {
+        YamlConfiguration defaults = new YamlConfiguration();
+        try(InputStream resource = Main.instance().getResource(FILE_NAME)) {
+            if(resource == null) throw new IOException("Missing bundled " + FILE_NAME);
+            defaults.load(new InputStreamReader(resource, StandardCharsets.UTF_8));
+        }
+        return defaults;
+    }
+
+    private static ConfigurationSection section(ConfigurationSection parent, String key) {
+        Object value = parent.get(key);
+        if(value == null) return null;
+        if(value instanceof ConfigurationSection section) return section;
+        throw new IllegalArgumentException(parent.getCurrentPath() + "." + key + " muss ein YAML-Abschnitt sein.");
+    }
+
+    private static Map<String, MessageGroup> readMessages(ConfigurationSection section) {
+        if(section == null) return Map.of();
+        Map<String, MessageGroup> messages = new HashMap<>();
+        for(Map.Entry<String, Object> entry : section.getValues(false).entrySet()) {
+            Object configured = entry.getValue();
+            Optional<SoundSettings> sound = Optional.empty();
+            if(configured instanceof ConfigurationSection group) {
+                configured = group.get("texts");
+                sound = readSound(group);
+            }
+            if(!(configured instanceof List<?> values)) {
+                throw new IllegalArgumentException("messages." + entry.getKey() + " muss eine Textliste oder ein Abschnitt mit texts sein.");
+            }
+            List<String> texts = new ArrayList<>();
+            for(Object value : values) {
+                if(!(value instanceof String text) || text.isBlank()) {
+                    throw new IllegalArgumentException("messages." + entry.getKey() + " enthält einen ungültigen Text.");
+                }
+                texts.add(text);
+            }
+            messages.put(entry.getKey(), new MessageGroup(List.copyOf(texts), sound));
+        }
+        return Map.copyOf(messages);
+    }
+
+    private static Map<String, List<Effect>> readEffects(ConfigurationSection section) {
+        if(section == null) return Map.of();
+        Map<String, List<Effect>> effects = new HashMap<>();
+        for(String groupName : section.getKeys(false)) {
+            ConfigurationSection group = section(section, groupName);
+            if(group == null) throw new IllegalArgumentException("effects." + groupName + " muss ein YAML-Abschnitt sein.");
+            List<Effect> definitions = new ArrayList<>();
+            for(String name : group.getKeys(false)) {
+                ConfigurationSection effect = section(group, name);
+                if(effect == null) throw new IllegalArgumentException("effects." + groupName + "." + name + " muss ein YAML-Abschnitt sein.");
+                Object minutes = effect.get("minutes-before-opening");
+                Object message = effect.get("message");
+                if(!(minutes instanceof Integer count) || count < 0) {
+                    throw new IllegalArgumentException(effect.getCurrentPath() + ".minutes-before-opening muss eine nicht negative ganze Zahl sein.");
+                }
+                if(!(message instanceof String text) || text.isBlank()) {
+                    throw new IllegalArgumentException(effect.getCurrentPath() + ".message muss ein nicht leerer Text sein.");
+                }
+                definitions.add(new Effect(name, count, text, readSound(effect)));
+            }
+            effects.put(groupName, List.copyOf(definitions));
+        }
+        return Map.copyOf(effects);
+    }
+
+    private static Optional<SoundSettings> readSound(ConfigurationSection section) {
+        Object configured = section.get("sound");
+        if(configured == null) return Optional.empty();
+        if(!(configured instanceof String name)) {
+            throw new IllegalArgumentException(section.getCurrentPath() + ".sound muss ein Sound-Name sein.");
+        }
+        if(name.isBlank()) return Optional.empty();
+        String key;
+        try {
+            key = Key.key(name.trim()).asString();
+        } catch(InvalidKeyException e) {
+            throw new IllegalArgumentException("Ungültiger Sound-Name bei " + section.getCurrentPath() + ".sound: " + name, e);
+        }
+        float volume = readSoundNumber(section, "volume", true);
+        float pitch = readSoundNumber(section, "pitch", false);
+        return Optional.of(new SoundSettings(key, volume, pitch));
+    }
+
+    private static float readSoundNumber(ConfigurationSection section, String key, boolean allowZero) {
+        Object configured = section.get(key);
+        if(configured == null) return 1.0f;
+        if(!(configured instanceof Number number)) {
+            throw new IllegalArgumentException(section.getCurrentPath() + "." + key + " muss eine Zahl sein.");
+        }
+        float value = number.floatValue();
+        if(!Float.isFinite(value) || (allowZero ? value < 0 : value <= 0)) {
+            throw new IllegalArgumentException(section.getCurrentPath() + "." + key
+                + (allowZero ? " muss endlich und mindestens 0 sein." : " muss endlich und größer als 0 sein."));
+        }
+        return value;
+    }
+
+    private static Optional<Instant> readTime(String key, Object configured) {
+        if(configured == null) return Optional.empty();
+        if(!(configured instanceof String value)) {
+            throw new IllegalArgumentException(key + " muss null oder ein Datum in Anführungszeichen mit UTC-Offset sein.");
+        }
+        if(value.isBlank()) return Optional.empty();
+        try {
+            return Optional.of(OffsetDateTime.parse(value.trim()).toInstant());
+        } catch(DateTimeParseException e) {
+            throw new IllegalArgumentException("Ungültiger Zeitpunkt für " + key + ". Beispiel: \"2026-11-15T18:00:00+01:00\"", e);
+        }
+    }
+
+    public Optional<Instant> getTime(String name) {
+        return Optional.ofNullable(this.times.get(name));
+    }
+
+    /** Immutable snapshot of all configured, non-empty times. */
+    public Map<String, Instant> getTimes() {
+        return this.times;
+    }
+
+    public List<String> getMessages(String name) {
+        return this.getMessageGroup(name).texts();
+    }
+
+    public MessageGroup getMessageGroup(String name) {
+        return this.messages.getOrDefault(name, EMPTY_MESSAGE_GROUP);
+    }
+
+    public List<Effect> getEffects(String name) {
+        return this.effects.getOrDefault(name, List.of());
+    }
+
+    /** Wall-clock time of the last successful load, before consumers check the new times. */
+    public Instant getLoadedAt() {
+        return this.loadedAt;
+    }
+
+    @Override
+    protected @NotNull List<ApplianceCommand<?>> commands() {
+        return List.of(new DimensionScheduleCommand());
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/dimensionScheduler/OpeningAnnouncements.java

@@ -0,0 +1,64 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduler.Effect;
+
+import java.time.Instant;
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Optional;
+import java.util.Set;
+
+/** Tracks one dimension's announcement cycle in memory. Owns no timer or file operations. */
+public final class OpeningAnnouncements {
+    private final DimensionOpeningEffects effects;
+    private final Set<String> handled = new HashSet<>();
+    private Optional<Instant> openingAt = Optional.empty();
+    private List<Effect> configuredEffects = List.of();
+    private boolean initialized;
+
+    public OpeningAnnouncements(DimensionOpeningEffects effects) {
+        this.effects = effects;
+    }
+
+    /** Reconfigure only when the opening time or its effects change; skip stages before cutoff. */
+    public void prepare(Optional<Instant> openingAt, Instant cutoff) {
+        List<Effect> configuredEffects = this.effects.getConfiguredEffects();
+        if(this.initialized && openingAt.equals(this.openingAt) && configuredEffects.equals(this.configuredEffects)) return;
+        this.openingAt = openingAt;
+        this.configuredEffects = configuredEffects;
+        this.initialized = true;
+        this.handled.clear();
+        if(openingAt.isEmpty()) return;
+        for(Effect effect : configuredEffects) {
+            if(effect.minutesBeforeOpening() > 0 && openingAt.get().minus(effect.leadTime()).isBefore(cutoff)) {
+                this.handled.add(effect.name());
+            }
+        }
+    }
+
+    /** Consume all crossed stages, but emit only the latest due time while access is closed. */
+    public void announceDue(Instant now, boolean closed) {
+        if(this.openingAt.isEmpty()) return;
+        if(!now.isBefore(this.openingAt.get())) {
+            // Zero-minute effects belong to the actual opening transition, never to polling.
+            for(Effect effect : this.configuredEffects) this.handled.add(effect.name());
+            return;
+        }
+
+        List<Effect> latestDue = new ArrayList<>();
+        Instant latestDueAt = null;
+        for(Effect effect : this.configuredEffects) {
+            if(effect.minutesBeforeOpening() == 0 || this.handled.contains(effect.name())) continue;
+            Instant dueAt = this.openingAt.get().minus(effect.leadTime());
+            if(now.isBefore(dueAt)) continue;
+            this.handled.add(effect.name());
+            if(latestDueAt == null || dueAt.isAfter(latestDueAt)) {
+                latestDue.clear();
+                latestDueAt = dueAt;
+            }
+            if(dueAt.equals(latestDueAt)) latestDue.add(effect);
+        }
+        if(closed) latestDue.forEach(this.effects::play);
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/dimensionScheduler/README.md

@@ -0,0 +1,254 @@
+# Dimension schedule
+
+## Zuständigkeiten und Lebenszyklus
+
+| Klasse | Aufgabe und Erstellung |
+| --- | --- |
+| `DimensionScheduler` | Automatisch geladene Appliance. Erstellt die fehlende `plugins/spawn/dimension-schedule.yml` aus der Vorlage und liest benannte Zeitpunkte, Textgruppen und Effektdefinitionen. Kennt keine End- oder Nether-Aktionen. |
+| `DimensionScheduleCommand` | Wird über die Appliance registriert. `/dimensionSchedule reload` liest die Datei für Konsole und OPs neu ein und zeigt nur dem Ausführenden den End- und Nether-Termin. Bei Fehlern bleiben alle bisherigen Werte erhalten. |
+| `DimensionScheduleText` | End-Grün (`#80A71A`), Nether-Rot (`#B83D32`) und deutsche Formatierung von Restzeiten und Terminen. Absolute Zeiten werden in `Europe/Berlin` mit Zeitzone ausgegeben. |
+| `EndPrevent` | Besitzt die End-Effektausgabe. Erstellt in `onEnable()` eine `EndOpeningSchedule`, wenn die Scheduler-Appliance vorhanden ist, und stoppt sie in `onDisable()`. Verwaltet End-Zustand und Weltgrenze. |
+| `NetherAccess` | Neue Appliance in `common`. Besitzt die Nether-Effektausgabe, erstellt und stoppt `NetherOpeningSchedule` und verwaltet den Nether-Zustand. Die bisherigen Varo-Klassen bleiben unverändert und werden hierfür nicht eingebunden. |
+| `NetherPortalIgniter` / `NetherIgniterCommand` | Erstellen das eindeutig markierte Portalfeuerzeug und geben es über `/netherIgniter` an OPs im Kreativmodus aus. |
+| `MarkedNetherPortals` | Wird von `NetherAccess` erstellt. Verwaltet Markierungen, Chunk-Index und die vorübergehende Aktivierungswarteschlange auf dem Hauptthread. |
+| `MarkedNetherPortal` / `PortalMarkStore` | Unveränderliche Portalgeometrie ohne gespeicherte Welt-/Block-/Spielerobjekte und serialisierte Hintergrundspeicherung in einer eigenen YAML. |
+| `EndOpeningSchedule` / `NetherOpeningSchedule` | Je ein Bukkit-Task. Starten im nächsten Tick nach der Initialisierung aller Appliances und prüfen dann alle 20 Ticks Termine und Ankündigungen. Die Zustandslogik bleibt bei der jeweiligen Dimension; End behält seine Outer-End-Logik. |
+| `DimensionOpeningEffects` | Gemeinsame Nachrichten- und Soundausgabe mit übergebenen Konfigurationsgruppen und Farbe. Wählt Ablehnungstexte zufällig aus und gibt Effekte über `play(effect)` aus. Den Nachrichten-Cooldown verwaltet der jeweilige Portal-Listener. |
+| `OpeningAnnouncements` | Gemeinsame Verfolgung fälliger und übersprungener Vorankündigungen. Verwendet die dynamischen Effekte, ohne Zustände zu ändern oder eigene Tasks anzulegen. |
+| `EndCommand` / `NetherCommand` | Öffentliche Informationsbefehle `/end` und `/nether`. Zeigen die Restzeit oder einen passenden Hinweis zum tatsächlichen Zustand. |
+
+## YAML und dynamische Effekte
+
+```yaml
+times:
+  end-open-at: "2026-11-15T18:00:00+01:00"
+  outer-end-open-at: "2026-11-16T18:00:00+01:00"
+  nether-open-at: null
+
+messages:
+  end-activation-denied:
+    texts:
+      - "Die Augen scheinen dich für einen kurzen Moment anzustarren. Dir läuft ein kalter Schauer über den Rücken ..."
+    sound: "entity.warden.roar"
+    pitch: 0.2
+    volume: 1.0
+
+effects:
+  end-opening:
+    five-minutes-before:
+      minutes-before-opening: 5
+      message: "Etwas regt sich in der Leere ..."
+      sound: "ambient.cave"
+      pitch: 0.5
+      volume: 1.0
+    opened:
+      minutes-before-opening: 0
+      message: "Der Weg ins End ist nun offen!"
+      sound: "block.end_portal.spawn"
+      pitch: 1.0
+      volume: 1.0
+```
+
+`times` kann beliebige benannte Zeitpunkte enthalten. `messages.end-activation-denied.texts`
+und `messages.nether-activation-denied.texts` enthalten die Texte für zufällige private
+Chat-Nachrichten. Beide Dimensionen verwenden dasselbe oben gezeigte Format.
+Die bisherige direkte Textliste wird ebenfalls weiterhin gelesen.
+`sound`, `pitch` und `volume` stehen direkt bei den zugehörigen Texten beziehungsweise Effekten.
+Diese Sound-Angaben werden beim Reload mit eingelesen und direkt mit der jeweiligen Nachricht
+einmal beim Empfänger abgespielt. Der Ablehnungs-Sound ist nur für den auslösenden Spieler hörbar;
+Ankündigungs- und Öffnungssounds erhalten alle Empfänger der Chat-Nachricht jeweils an ihrer
+eigenen Position. Es gibt keine zusätzlichen Tasks oder Schleifen für die Sound-Wiedergabe.
+Ohne `sound` oder mit leerem Sound-Namen bleibt es bei der Textausgabe. `volume` und `pitch`
+haben den Standardwert `1.0`; Lautstärke muss mindestens `0`, Pitch größer als `0` sein.
+Ungültige Sound-Schlüssel oder nicht endliche Zahlen lassen den Reload wie andere ungültige
+Konfigurationswerte scheitern und behalten die bisherige Konfiguration.
+Unter `effects.end-opening` und `effects.nether-opening` können frei benannte Effekte ergänzt
+oder entfernt werden.
+`minutes-before-opening` ist eine nicht negative ganze Zahl: Ein positiver Wert gibt den
+Abstand zur jeweiligen Öffnung in Minuten an, `0` kennzeichnet einen Effekt beim tatsächlichen Öffnen.
+Texte und Vorlaufzeiten stehen ausschließlich in der YAML; eine feste Stufen-Enum gibt es nicht.
+Die mitgelieferte Vorlage enthält die bisherigen End-Originaltexte mit 240, 60, 10, 1 und 0 Minuten.
+Für den Nether enthält sie fünf Ablehnungstexte sowie Effekte mit 120, 30, 1 und 0 Minuten.
+Die Nether-Texte bleiben wortgetreu. Die Vorlage verwendet `entity.wither.ambient` bei Ablehnung
+(Lautstärke `1.0`, Pitch `0.3`), `block.portal.ambient` bei 120 Minuten (Lautstärke `2.0`, Pitch `0.3`),
+`entity.warden.roar` bei 30 Minuten (Lautstärke `2.0`, Pitch `0.2`), `entity.wither.spawn` bei einer Minute
+(Lautstärke `2.0`, Pitch `0.5`) und `block.end_portal.spawn` bei der Öffnung
+(Lautstärke `1.0`, Pitch `1.0`). Sounds bleiben optional konfigurierbar.
+
+Die ursprünglichen flachen Zeitangaben (`end-open-at` direkt im YAML-Hauptabschnitt) bleiben
+lesbar, solange kein `times`-Abschnitt vorhanden ist. Fehlt der gesamte `messages`- oder
+`effects`-Abschnitt, wird nur für diesen Abschnitt die mitgelieferte Vorlage im Arbeitsspeicher
+verwendet. Bestehende Serverdateien werden nicht überschrieben oder automatisch ergänzt.
+Zur Inbetriebnahme die Termine unter `times` setzen und die gewünschten Abschnitte aus der
+Vorlage in die Serverdatei übernehmen. Sind eigene `messages`- beziehungsweise `effects`-Abschnitte
+bereits vorhanden, müssen fehlende Nether-Gruppen (`nether-activation-denied` und `nether-opening`)
+aus der Vorlage übernommen werden. Anschließend `/dimensionSchedule reload` ausführen.
+Explizite leere Abschnitte (`messages: {}`, `effects: {}`) verwenden keine Standardgruppen;
+einzelne Gruppen lassen sich durch `end-activation-denied: []` beziehungsweise `end-opening: {}` leeren.
+
+## Öffnungszeiten
+
+Vor `end-open-at` ist das End `CLOSED`, danach bis `outer-end-open-at` ist nur die
+Hauptinsel verfügbar (`NO_OUTER`), anschließend ist es vollständig `OPEN`.
+Ohne Outer-End-Termin öffnet `end-open-at` das gesamte End. Mit ausschließlich einem
+Outer-End-Termin ist die Hauptinsel sofort verfügbar und das Outer End öffnet zum Termin.
+Ein zukünftiger End-Termin hat Vorrang vor einem bereits vergangenen Outer-End-Termin.
+Sind beide Einträge leer oder `null`, erfolgt keine automatische Zustandsänderung.
+Weitere Namen können in der YAML ergänzt werden; nur die End-Klasse interpretiert diese zwei Namen.
+
+`NetherOpeningSchedule` liest `times.nether-open-at`: Vor dem Termin ist der Nether `CLOSED`,
+danach `OPEN`. `NetherAccess` speichert den Zustand unter `netherAccess.state` in `config.yml`.
+Ohne gespeicherten Zustand startet der Nether geschlossen. Ohne Öffnungstermin bleibt der
+gespeicherte Zustand maßgeblich; es erfolgt keine automatische Änderung.
+
+## Gemeinsamer Zustandswechsel und Commands
+
+`/end` und `/nether` sind für alle Spieler und die Konsole verfügbar. Bei geschlossenem End mit zukünftigem
+Termin lautet die Antwort beispielsweise: „Das End öffnet in 2 Tagen, 3 Stunden und 4 Minuten.“
+Angebrochene Minuten werden aufgerundet. Ist das End schon geöffnet, kein Termin gesetzt oder
+ein vergangener Termin bei weiterhin geschlossenem End vorhanden, wird dies entsprechend gemeldet.
+`/nether` verwendet dieselbe Restzeitformatierung und entsprechende Hinweise auf einen bereits
+geöffneten Nether, einen fehlenden Termin oder einen vergangenen Termin. Informationsbefehle
+ändern keinen Zustand und schreiben keine Datei.
+
+`/endPrevent preventEnd`, `/endPrevent allowEnd` und `/endPrevent onlyInnerEnd` bleiben bestehen.
+`/endPrevent` ohne Argument zeigt den Zustand. `/netherPrevent preventNether` sperrt den Nether,
+`/netherPrevent allowNether` öffnet ihn und `/netherPrevent` ohne Argument zeigt seinen Zustand.
+Beide Verwaltungsbefehle sowie `/dimensionSchedule` und `/netherIgniter` besitzen registrierte
+Command-Berechtigungen mit `default: op`. Für normale Spieler erscheinen auch die Befehlsnamen
+und ihre `spawn:`-Varianten nicht in der Autovervollständigung. Die OP-Prüfungen bei der
+Ausführung bleiben zusätzlich erhalten; `/netherIgniter` erfordert außerdem einen Spieler im Kreativmodus.
+Nach Installation dieser Änderung den Server neu starten; `/dimensionSchedule reload` lädt nur die Termin-YAML.
+Status und Bestätigungen sind auf Deutsch in End-Grün beziehungsweise Nether-Rot formuliert;
+ungültige Argumente zeigen die Verwendung statt einer Erfolgsmeldung.
+Commands und laufende zeitgesteuerte Übergänge verwenden `EndPrevent.setEndState()`.
+Der gemeinsame Zustandswechsel aktualisiert Zustand und Weltgrenze, speichert Änderungen in
+`config.yml` und führt beim Wechsel von `CLOSED` zu `NO_OUTER` oder `OPEN` alle Effekte mit
+`minutes-before-opening: 0` aus.
+Bereits offene Zustände erzeugen bei erneutem Öffnen keine weitere Meldung. Die spätere
+Freigabe des Outer Ends (`NO_OUTER` zu `OPEN`) wiederholt die End-Öffnungsmeldung ebenfalls nicht.
+Für den Nether verwenden Command und Zeitplan entsprechend denselben zentralen Zustandswechsel
+in `NetherAccess`. Jede tatsächliche Zustandsänderung wird gespeichert; nur der Wechsel von
+`CLOSED` zu `OPEN` führt alle Nether-Öffnungseffekte aus. Wiederholtes Öffnen erzeugt keine doppelten Effekte.
+
+Beim Start und bei geänderten Öffnungszeiten verwendet der Zeitplan `restoreEndState()`.
+Der Nether stellt seinen Zustand auf dieselbe Weise still wieder her. Diese Übergänge
+führen denselben Zustandswechsel mit Speicherung aus, stellen den aktuellen
+Zustand aber ohne nachträgliche Öffnungseffekte her. Entfernte Termine heben den zuletzt
+gesetzten Zustand nicht auf; die Steuerung bleibt dann vollständig manuell.
+
+Manuelle Commands werden nicht bei jeder Prüfung überschrieben: Erst beim nächsten
+zeitgesteuerten Zustandswechsel oder bei geänderten Terminen der jeweiligen Dimension greift der
+Zeitplan erneut ein. Ein Reload mit unveränderten Terminen setzt einen manuellen Zustand nicht zurück.
+Die Reload-Bestätigung zeigt End- und Nether-Termin als Datum mit Uhrzeit und Berliner Zeitzone,
+bei zukünftigen Terminen zusätzlich die Restzeit. Fehlende und vergangene Termine sind gekennzeichnet.
+Diese Zusammenfassung wird ausschließlich an den ausführenden CommandSender gesendet.
+Die End-Zeile ist grün, die Nether-Zeile rot.
+
+## Ankündigungen und Portalversuche
+
+Vorankündigungen erscheinen einmalig für alle Online-Spieler im Chat, solange die jeweilige
+Dimension geschlossen ist. Bereits vergangene Stufen werden beim Start oder bei einem neuen Termin
+übersprungen. Unveränderte Reloads, neue Outer-End-Termine und Änderungen anderer YAML-Einträge
+setzen die bereits behandelten Stufen nicht zurück. Bei Verzögerungen wird höchstens die
+zuletzt fällige Vorankündigungszeit berücksichtigt. Mehrere Effekte mit genau derselben
+Vorlaufzeit werden gemeinsam ausgeführt. Ist die Öffnung bereits fällig, entfallen alte Teaser.
+Während einer manuellen Freigabe fällige Teaser werden still als behandelt markiert.
+
+Geänderte Definitionen unter `effects.end-opening` und `effects.nether-opening` werden nach einem erfolgreichen Reload
+ebenfalls übernommen. Bereits vor diesem Reload vergangene Ankündigungen werden übersprungen;
+zukünftige Effekte laufen mit den neuen Texten und Minutenwerten. Reine Textänderungen in
+`messages` setzen die Ankündigungen nicht zurück. Ungültige Zeiten, Minutenwerte oder Texte
+lassen den gesamten Reload scheitern und behalten die bisherige Konfiguration.
+
+Für einen geänderten Termin gilt der erfolgreiche Ladezeitpunkt als Grenze für verpasste
+Stufen. Wird eine Ankündigung erst zwischen dem Reload und der nächsten Sekundenprüfung
+fällig, wird sie regulär ausgeführt. Dasselbe gilt für eine in diesem Zeitraum fällige Öffnung.
+Beim erneuten Aktivieren einer Appliance gilt frühestens deren Startzeitpunkt als Grenze.
+
+Ein Rechtsklick mit Enderauge auf einen leeren, gesperrten Endportalrahmen wird für beide Hände
+abgebrochen. Aktivierungs- und Betretversuche gesperrter Endportale verwenden dieselbe Sperrprüfung
+und einen gemeinsamen Nachrichten-Cooldown: Nur der auslösende Spieler erhält einen zufälligen
+konfigurierten Text im Chat, höchstens einmal alle drei echten Sekunden. Versuche während des
+Cooldowns werden weiterhin abgebrochen; sie verlängern den Nachrichten-Cooldown nicht.
+Die Prüfung nutzt `System.nanoTime()`, benötigt keinen zusätzlichen Task und entfernt
+Spieler-Einträge beim Verlassen. Die Gateway-Meldung für das gesperrte Outer End bleibt getrennt davon.
+End-Flavourtexte und zeitgesteuerte End-Effekte verwenden End-Grün (`#80A71A`).
+
+Solange der Nether geschlossen ist, verhindert `NetherAccess` neue Netherportale mit Ursache
+`FIRE` außerhalb des Nethers sowie automatisch erzeugte Zielportale mit Ursache `NETHER_PAIR`
+im Nether. `END_PLATFORM` bleibt unberührt. Der Eintritt in den Nether durch bestehende Portale
+wird für Spieler, Mobs und Gegenstände über `PlayerPortalEvent` und `EntityPortalEvent` gesperrt.
+Die Rückreise aus dem Nether und dafür nötige Rückportale bleiben erlaubt; das Zünden eines
+Rückportals innerhalb des Nethers wird ebenfalls nicht verhindert.
+
+Bei Spieleraktionen erhält ausschließlich der auslösende Spieler einen zufälligen Text aus
+`messages.nether-activation-denied` und gegebenenfalls den konfigurierten Sound. Bei
+`PortalCreateEvent` wird dafür nur ein von `getEntity()` gelieferter Spieler verwendet;
+automatische Ereignisse ohne Spieler werden still blockiert. Es wird kein Spieler über die
+Entfernung zum Portal ermittelt. Nachrichten und Sounds teilen einen Cooldown von drei echten
+Sekunden pro Spieler. Die Sperre gilt auch während des Cooldowns; Spieler-Einträge werden beim
+Verlassen entfernt. Alle Nether-Ausgaben verwenden Nether-Rot (`#B83D32`).
+
+## Portalfeuerzeug und vorgemerkte Netherportale
+
+OPs im Kreativmodus erhalten mit `/netherIgniter` ein glänzendes Feuerzeug namens
+„Portalfeuerzeug“ mit erklärender Lore. Bei vollem Inventar schlägt der Befehl fehl;
+es wird kein Item fallen gelassen. Ein PersistentDataContainer-Marker identifiziert das
+Item unabhängig vom Anzeigenamen. Das Umbenennen eines normalen Feuerzeugs genügt nicht.
+Auch ein weitergegebenes Portalfeuerzeug lässt sich ausschließlich im Kreativmodus benutzen.
+
+Bei offenem Nether und für Rückportale innerhalb des Nethers bleibt die gewöhnliche
+Vanilla-Benutzung erhalten. Ist der Nether geschlossen, kann das Spezialitem gültige
+Zugangsportale außerhalb des Nethers vormerken: Der Listener erfasst die tatsächlich
+verwendete Hand, Position und den Server-Tick. Erst das zugehörige native
+`PortalCreateEvent(FIRE)` liefert den geprüften Rahmen. Die Portalbildung wird abgebrochen
+und das zurückgebliebene Zündfeuer im nächsten Tick gezielt entfernt. Statt einer
+Ablehnungsnachricht erhält nur der Spieler eine Bestätigung in Nether-Rot, sobald die
+Markierung erfolgreich gespeichert wurde. Mehrfaches Vormerken erzeugt keinen zweiten Eintrag.
+
+`plugins/spawn/marked-nether-portals.yml` enthält Welt- und Ersteller-UUID, Innenraum,
+Achse, Rahmen und Zündposition. Die Datei entsteht beim ersten Speichern einer Markierung.
+Ein eigener serieller Hintergrund-Worker schreibt Änderungen zuerst in eine temporäre
+Datei und ersetzt anschließend die Speicherdatei. Fehlgeschlagene Schreibvorgänge werden
+nicht als erfolgreiche Markierung bestätigt. Eine beschädigte Speicherdatei wird weder
+überschrieben noch teilweise geladen; neue Markierungen bleiben bis zur Behebung und
+erneuten Aktivierung der Appliance gesperrt. Die Termin- und Effekt-YAML bleibt unverändert.
+
+Der gemeinsame Zustandswechsel von `NetherAccess` startet vorgemerkte Portale bei Öffnung
+per Command, Zeitplan und stiller Wiederherstellung. Beim Serverstart werden gespeicherte
+Markierungen erst nach der anfänglichen Terminprüfung berücksichtigt. Dadurch funktioniert
+auch ein bereits gespeichert offener Nether, ohne vergangene Öffnungsnachrichten abzuspielen.
+
+Es werden keine Chunks geladen oder erzeugt. Ein Chunk-Index ordnet reguläre
+`ChunkLoadEvent`s den betroffenen Portalen zu. Erst wenn alle Chunks des Rahmens und des
+benötigten Vanilla-Suchbereichs geladen sind, wird das Portal zur Aktivierung eingereiht.
+Ungeladene Portale bleiben gespeichert und öffnen entsprechend später, wenn ihre Umgebung
+regulär geladen wird. Die Warteschlange ist dedupliziert und bearbeitet höchstens ein Portal
+pro Tick. Ihr Task läuft ausschließlich bei gefüllter Warteschlange; Schließen des Nethers
+oder Deaktivieren der Appliance stoppt die Verarbeitung.
+
+Vor der Zündung werden Zugangszustand, geladene Chunks, Obsidianrahmen und freier Innenraum
+erneut geprüft. Beschädigte oder verbaute Portale werden mit protokollierter Ursache aus der
+Registrierung entfernt; fremde Blöcke werden nicht ersetzt. Die Zündung setzt Feuer mit
+Physik und überlässt die Portalbildung Vanilla. Abgebrochene `BlockIgniteEvent`s und native
+`PortalCreateEvent`s anderer Plugins werden respektiert: Die Markierung bleibt gespeichert,
+der Grund wird protokolliert. Es gibt keinen laufenden Wiederholungsversuch; erst erneutes
+reguläres Laden der Umgebung oder eine weitere Nether-Öffnung kann das Portal erneut einreihen.
+Erfolg wird an den tatsächlichen Portalblöcken geprüft. Erfolgreich aktivierte sowie bereits
+vollständig aktive Portale werden aus der Speicherdatei entfernt.
+
+## Erweiterungen und Leistung
+
+Weitere Effektarten können später zentral in `DimensionOpeningEffects.play(effect)`
+ergänzt werden und werden bei manueller sowie zeitgesteuerter Öffnung gleichermaßen ausgeführt.
+Neue Ankündigungen benötigen nur einen weiteren YAML-Eintrag mit Minutenwert und Text.
+
+Für Termine bleibt es bei einem Task pro Dimension mit wenigen Zeitvergleichen pro Sekunde und je einer
+kleinen Menge behandelter Effektnamen. Es entsteht kein allgemeines Scheduler-Framework.
+Die Prüfung arbeitet im Arbeitsspeicher. Chat,
+Zustandswechsel und spätere Bukkit-Effekte laufen auf dem Server-Hauptthread. Gespeichert
+wird nur bei tatsächlichen Zustandsänderungen in `config.yml`; die Termin-YAML wird nach
+ihrer erstmaligen Erstellung ausschließlich gelesen. Es gibt keine persistenten Ausführungsstatus
+für Ankündigungen. Portalmarkierungen verwenden davon getrennt die oben beschriebene Datei und
+begrenzte Warteschlange; ihre Dateioperationen laufen außerhalb des Server-Hauptthreads.

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/endPrevent/EndCommand.java

@@ -0,0 +1,53 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.endPrevent;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduler;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduleText;
+import eu.mhsl.craftattack.spawn.core.Main;
+import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.jetbrains.annotations.NotNull;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.Optional;
+
+/** Public, read-only information command; the existing management command remains separate. */
+class EndCommand extends ApplianceCommand<EndPrevent> {
+    public EndCommand() {
+        super("end");
+    }
+
+    @Override
+    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        if(args.length != 0) throw new Error("Verwendung: /end");
+        EndPrevent end = this.getAppliance();
+        if(!end.isEndClosed()) {
+            sender.sendMessage(DimensionScheduleText.message(end.isOnlyInner()
+                ? "Das End ist bereits geöffnet. Das Outer End ist noch gesperrt."
+                : "Das End ist bereits vollständig geöffnet."));
+            return;
+        }
+
+        Optional<Instant> openingAt = Main.instance().getAppliances().stream()
+            .filter(DimensionScheduler.class::isInstance)
+            .map(DimensionScheduler.class::cast)
+            .findFirst()
+            .flatMap(scheduler -> scheduler.getTime("end-open-at"));
+        Instant now = Instant.now();
+        String message;
+        if(openingAt.isEmpty()) {
+            message = "Für das End ist noch kein Öffnungstermin festgelegt.";
+        } else if(!openingAt.get().isAfter(now)) {
+            message = "Der Öffnungstermin ist bereits erreicht. Das End ist derzeit noch geschlossen.";
+        } else {
+            message = "Das End öffnet in " + DimensionScheduleText.remaining(openingAt.get(), now) + ".";
+        }
+        sender.sendMessage(DimensionScheduleText.message(message));
+    }
+
+    @Override
+    public @NotNull List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        return List.of();
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/endPrevent/EndOpeningSchedule.java

@@ -0,0 +1,98 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.endPrevent;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduler;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionOpeningEffects;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.OpeningAnnouncements;
+import eu.mhsl.craftattack.spawn.core.Main;
+import org.bukkit.Bukkit;
+import org.bukkit.scheduler.BukkitTask;
+import org.jetbrains.annotations.Nullable;
+
+import java.time.Instant;
+import java.util.Optional;
+
+/**
+ * End-specific interpretation of the named times. Created and stopped by EndPrevent.
+ * DimensionScheduler only supplies configuration; this class owns the single polling task.
+ */
+final class EndOpeningSchedule {
+    private final EndPrevent endPrevent;
+    private final DimensionScheduler scheduler;
+    private final OpeningAnnouncements announcements;
+    private @Nullable BukkitTask task;
+    private Optional<Instant> previousEndOpenAt = Optional.empty();
+    private Optional<Instant> previousOuterEndOpenAt = Optional.empty();
+    private @Nullable EndPrevent.State previousScheduledState;
+    private boolean initialized;
+    private Instant startedAt = Instant.EPOCH;
+
+    EndOpeningSchedule(EndPrevent endPrevent, DimensionScheduler scheduler, DimensionOpeningEffects effects) {
+        this.endPrevent = endPrevent;
+        this.scheduler = scheduler;
+        this.announcements = new OpeningAnnouncements(effects);
+    }
+
+    void start() {
+        this.stop();
+        this.startedAt = Instant.now();
+        // Wait until the next tick so all appliances have finished loading, regardless of order.
+        this.task = Bukkit.getScheduler().runTaskTimer(Main.instance(), this::checkOpeningTimes, 1L, 20L);
+    }
+
+    void stop() {
+        if(this.task == null) return;
+        this.task.cancel();
+        this.task = null;
+    }
+
+    private void checkOpeningTimes() {
+        Optional<Instant> endOpenAt = this.scheduler.getTime("end-open-at");
+        Optional<Instant> outerEndOpenAt = this.scheduler.getTime("outer-end-open-at");
+        Instant now = Instant.now();
+        boolean endTimeChanged = !endOpenAt.equals(this.previousEndOpenAt);
+        boolean restoreSchedule = !this.initialized || endTimeChanged
+            || !outerEndOpenAt.equals(this.previousOuterEndOpenAt);
+        Instant restoreAt = this.scheduler.getLoadedAt();
+        if(!this.initialized && this.startedAt.isAfter(restoreAt)) restoreAt = this.startedAt;
+        this.announcements.prepare(endOpenAt, restoreAt);
+        this.previousEndOpenAt = endOpenAt;
+        this.previousOuterEndOpenAt = outerEndOpenAt;
+        this.initialized = true;
+
+        if(endOpenAt.isEmpty() && outerEndOpenAt.isEmpty()) {
+            this.previousScheduledState = null;
+            return;
+        }
+
+        EndPrevent.State scheduledState = stateAt(now, endOpenAt, outerEndOpenAt);
+        EndPrevent.State restoredState = stateAt(restoreAt, endOpenAt, outerEndOpenAt);
+        boolean crossedAfterLoad = restoreSchedule && restoredState != scheduledState;
+        if(crossedAfterLoad) {
+            // Restore the state at load time silently, then execute the newly due live transition.
+            this.endPrevent.restoreEndState(restoredState);
+        }
+
+        // Remember the schedule's state, not the current manual state: commands remain effective
+        // until the next scheduled transition or a change to the relevant opening times.
+        if(restoreSchedule || scheduledState != this.previousScheduledState) {
+            if(this.endPrevent.getEndPreventState() != scheduledState) {
+                if(restoreSchedule && !crossedAfterLoad) {
+                    this.endPrevent.restoreEndState(scheduledState);
+                } else {
+                    this.endPrevent.setEndState(scheduledState);
+                }
+                Main.logger().info("End opening schedule applied state " + scheduledState
+                    + " (end-open-at=" + endOpenAt.orElse(null)
+                    + ", outer-end-open-at=" + outerEndOpenAt.orElse(null) + ")");
+            }
+            this.previousScheduledState = scheduledState;
+        }
+        this.announcements.announceDue(now, this.endPrevent.isEndClosed());
+    }
+
+    private static EndPrevent.State stateAt(Instant at, Optional<Instant> endOpenAt, Optional<Instant> outerEndOpenAt) {
+        if(endOpenAt.isPresent() && at.isBefore(endOpenAt.get())) return EndPrevent.State.CLOSED;
+        if(outerEndOpenAt.isPresent() && at.isBefore(outerEndOpenAt.get())) return EndPrevent.State.NO_OUTER;
+        return EndPrevent.State.OPEN;
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/endPrevent/EndPrevent.java

@@ -1,5 +1,9 @@
 package eu.mhsl.craftattack.spawn.common.appliances.tooling.endPrevent;
 
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduler;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionOpeningEffects;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduleText;
+import eu.mhsl.craftattack.spawn.core.Main;
 import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
 import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
 import eu.mhsl.craftattack.spawn.core.config.Configuration;
@@ -7,12 +11,17 @@ import org.bukkit.Bukkit;
 import org.bukkit.World;
 import org.bukkit.event.Listener;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 import java.util.List;
 
 public class EndPrevent extends Appliance {
     private final String endPreventKey = "endPrevent";
+    private final DimensionOpeningEffects openingEffects = new DimensionOpeningEffects(
+        "end-opening", "end-activation-denied", DimensionScheduleText.END_GREEN
+    );
     private State endPreventState;
+    private @Nullable EndOpeningSchedule openingSchedule;
     private final World endWorld = Bukkit.getWorlds().stream().filter(world -> world.getEnvironment().equals(World.Environment.THE_END)).findFirst().orElseThrow();
 
     public enum State {
@@ -27,16 +36,54 @@ public class EndPrevent extends Appliance {
         this.updateEndBorder();
     }
 
+    @Override
+    public void onEnable() {
+        if(this.openingSchedule != null) this.openingSchedule.stop();
+        DimensionScheduler scheduler = Main.instance().getAppliances().stream()
+            .filter(DimensionScheduler.class::isInstance)
+            .map(DimensionScheduler.class::cast)
+            .findFirst().orElse(null);
+        if(scheduler == null) return;
+
+        this.openingEffects.configure(scheduler);
+        this.openingSchedule = new EndOpeningSchedule(this, scheduler, this.openingEffects);
+        this.openingSchedule.start();
+    }
+
+    @Override
+    public void onDisable() {
+        if(this.openingSchedule != null) this.openingSchedule.stop();
+    }
+
     private void updateEndBorder() {
         if(this.endPreventState == State.NO_OUTER) this.endWorld.getWorldBorder().setSize(500);
         if(this.endPreventState == State.OPEN) this.endWorld.getWorldBorder().setSize(this.endWorld.getWorldBorder().getMaxSize());
     }
 
     public void setEndState(State state) {
-        this.localConfig().set(this.endPreventKey, state.name());
-        Configuration.saveChanges();
+        this.changeEndState(state, true);
+    }
+
+    /** Restores a schedule on startup or after changed times without replaying past effects. */
+    void restoreEndState(State state) {
+        this.changeEndState(state, false);
+    }
+
+    /** Shared by commands, live scheduled transitions and silent schedule restoration. */
+    private void changeEndState(State state, boolean announceOpening) {
+        if(this.endPreventState == state) return;
+        boolean wasClosed = this.isEndClosed();
         this.endPreventState = state;
         this.updateEndBorder();
+        this.localConfig().set(this.endPreventKey, state.name());
+        Configuration.saveChanges();
+        if(announceOpening && wasClosed && !this.isEndClosed()) {
+            this.openingEffects.playOpening();
+        }
+    }
+
+    DimensionOpeningEffects effects() {
+        return this.openingEffects;
     }
 
     public boolean isEndClosed() {
@@ -58,6 +105,6 @@ public class EndPrevent extends Appliance {
 
     @Override
     protected @NotNull List<ApplianceCommand<?>> commands() {
-        return List.of(new EndPreventCommand());
+        return List.of(new EndPreventCommand(), new EndCommand());
     }
 }

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/endPrevent/EndPreventCommand.java

@@ -1,12 +1,10 @@
 package eu.mhsl.craftattack.spawn.common.appliances.tooling.endPrevent;
 
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduleText;
 import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.format.NamedTextColor;
 import org.bukkit.command.Command;
 import org.bukkit.command.CommandSender;
 import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
 
 import java.util.List;
 import java.util.Map;
@@ -23,19 +21,30 @@ class EndPreventCommand extends ApplianceCommand<EndPrevent> {
     }
 
     @Override
-    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) throws Exception {
-        if(args.length == 1 && this.arguments.containsKey(args[0])) {
-            this.getAppliance().setEndState(this.arguments.get(args[0]));
-            sender.sendMessage(Component.text("Setting updated!", NamedTextColor.GREEN));
-        }
-        sender.sendMessage(Component.text(
-            String.format("The End is now on '%s'!", this.getAppliance().getEndPreventState().name()),
-            NamedTextColor.GOLD
-        ));
+    public @NotNull String permission() {
+        return "spawn.command.endprevent";
     }
 
     @Override
-    public @Nullable List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
-        return this.arguments.keySet().stream().toList();
+    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        if(!sender.isOp()) throw new Error("Dieser Befehl ist nur für die Konsole und OPs verfügbar.");
+        if(args.length > 1 || (args.length == 1 && !this.arguments.containsKey(args[0]))) {
+            throw new Error("Verwendung: /endPrevent [preventEnd|allowEnd|onlyInnerEnd]");
+        }
+        if(args.length == 1) {
+            this.getAppliance().setEndState(this.arguments.get(args[0]));
+        }
+        String message = switch(this.getAppliance().getEndPreventState()) {
+            case CLOSED -> "Das End ist geschlossen.";
+            case OPEN -> "Das End ist vollständig geöffnet.";
+            case NO_OUTER -> "Die Hauptinsel des Ends ist geöffnet. Das Outer End ist gesperrt.";
+        };
+        sender.sendMessage(DimensionScheduleText.message(message));
+    }
+
+    @Override
+    public @NotNull List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        if(!sender.isOp() || args.length != 1) return List.of();
+        return this.tabCompleteReducer(this.arguments.keySet().stream().toList(), args);
     }
 }

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/endPrevent/EndPreventListener.java

@@ -4,28 +4,49 @@ import com.destroystokyo.paper.event.player.PlayerTeleportEndGatewayEvent;
 import eu.mhsl.craftattack.spawn.core.appliance.ApplianceListener;
 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.format.NamedTextColor;
+import org.bukkit.Location;
 import org.bukkit.Material;
 import org.bukkit.World;
+import org.bukkit.block.data.type.EndPortalFrame;
 import org.bukkit.entity.Player;
 import org.bukkit.event.Cancellable;
 import org.bukkit.event.EventHandler;
+import org.bukkit.event.block.Action;
 import org.bukkit.event.player.PlayerInteractEvent;
 import org.bukkit.event.player.PlayerPortalEvent;
+import org.bukkit.event.player.PlayerQuitEvent;
+
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.TimeUnit;
 
 class EndPreventListener extends ApplianceListener<EndPrevent> {
+    private static final long MESSAGE_COOLDOWN_NANOS = TimeUnit.SECONDS.toNanos(3);
+    private final Map<UUID, Long> lastDeniedMessageAt = new HashMap<>();
+
     @EventHandler
     public void onEnderEyeInteraction(PlayerInteractEvent event) {
+        if(event.getAction() != Action.RIGHT_CLICK_BLOCK) return;
         if(event.getClickedBlock() == null) return;
         if(!event.getClickedBlock().getType().equals(Material.END_PORTAL_FRAME)) return;
+        if(!(event.getClickedBlock().getBlockData() instanceof EndPortalFrame frame) || frame.hasEye()) return;
         if(event.getItem() == null) return;
         if(!event.getItem().getType().equals(Material.ENDER_EYE)) return;
 
         this.cancelIfClosed(event, event.getPlayer());
     }
 
+    @EventHandler
+    public void onPlayerQuit(PlayerQuitEvent event) {
+        this.lastDeniedMessageAt.remove(event.getPlayer().getUniqueId());
+    }
+
     @EventHandler
     public void onPlayerPortal(PlayerPortalEvent event) {
-        if(!event.getTo().getWorld().getEnvironment().equals(World.Environment.THE_END)) return;
+        Location destination = event.getTo();
+        if(destination == null || destination.getWorld() == null) return;
+        if(!destination.getWorld().getEnvironment().equals(World.Environment.THE_END)) return;
 
         this.cancelIfClosed(event, event.getPlayer());
     }
@@ -35,10 +56,16 @@ class EndPreventListener extends ApplianceListener<EndPrevent> {
         this.cancelIfOnlyInner(event, event.getPlayer());
     }
 
-    private void cancelIfClosed(Cancellable event, Player p) {
+    private void cancelIfClosed(Cancellable event, Player player) {
         if(!this.getAppliance().isEndClosed()) return;
         event.setCancelled(true);
-        p.sendActionBar(Component.text("Das End ist nicht freigeschaltet!", NamedTextColor.RED));
+
+        // Always block access. Only messages are throttled, using elapsed real time independent of TPS.
+        long now = System.nanoTime();
+        Long previousMessageAt = this.lastDeniedMessageAt.get(player.getUniqueId());
+        if(previousMessageAt != null && now - previousMessageAt < MESSAGE_COOLDOWN_NANOS) return;
+        this.lastDeniedMessageAt.put(player.getUniqueId(), now);
+        this.getAppliance().effects().denyActivation(player);
     }
 
     private void cancelIfOnlyInner(Cancellable event, Player p) {

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/netherAccess/MarkedNetherPortal.java

@@ -0,0 +1,232 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.netherAccess;
+
+import org.bukkit.Axis;
+import org.bukkit.Material;
+import org.bukkit.World;
+import org.bukkit.block.Block;
+import org.bukkit.block.BlockState;
+import org.bukkit.block.data.Orientable;
+import org.bukkit.entity.Player;
+import org.bukkit.event.world.PortalCreateEvent;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Objects;
+import java.util.Set;
+import java.util.UUID;
+
+/** An immutable portal shape; no blocks, worlds or players survive the marking event. */
+record MarkedNetherPortal(
+    UUID worldId,
+    UUID creatorId,
+    Position origin,
+    int width,
+    int height,
+    Axis axis,
+    Position ignition,
+    List<Position> frame
+) {
+    private static final int NATIVE_SEARCH_RADIUS = 22;
+
+    record Position(int x, int y, int z) {
+        Block block(World world) {
+            return world.getBlockAt(this.x, this.y, this.z);
+        }
+    }
+
+    record ChunkKey(UUID worldId, int x, int z) {
+    }
+
+    enum Validation {
+        WAITING,
+        INVALID,
+        READY,
+        ALREADY_ACTIVE
+    }
+
+    MarkedNetherPortal {
+        Objects.requireNonNull(worldId, "worldId");
+        Objects.requireNonNull(creatorId, "creatorId");
+        Objects.requireNonNull(origin, "origin");
+        Objects.requireNonNull(ignition, "ignition");
+        Objects.requireNonNull(frame, "frame");
+        if(axis != Axis.X && axis != Axis.Z) throw new IllegalArgumentException("Invalid portal axis");
+        if(width < 2 || width > 21 || height < 3 || height > 21) {
+            throw new IllegalArgumentException("Invalid portal dimensions");
+        }
+
+        List<Position> expectedFrame;
+        try {
+            expectedFrame = framePositions(origin, width, height, axis);
+            Math.subtractExact(ignition.x, NATIVE_SEARCH_RADIUS);
+            Math.addExact(ignition.x, NATIVE_SEARCH_RADIUS);
+            Math.subtractExact(ignition.z, NATIVE_SEARCH_RADIUS);
+            Math.addExact(ignition.z, NATIVE_SEARCH_RADIUS);
+        } catch(ArithmeticException exception) {
+            throw new IllegalArgumentException("Portal coordinates overflow", exception);
+        }
+        if(!contains(origin, width, height, axis, ignition)) {
+            throw new IllegalArgumentException("Ignition position is outside the portal");
+        }
+        if(frame.size() != expectedFrame.size() || !new HashSet<>(frame).equals(new HashSet<>(expectedFrame))) {
+            throw new IllegalArgumentException("Frame positions do not match the portal perimeter");
+        }
+        frame = List.copyOf(expectedFrame);
+    }
+
+    String id() {
+        return this.worldId + ":" + this.origin.x + ":" + this.origin.y + ":" + this.origin.z
+            + ":" + this.axis + ":" + this.width + ":" + this.height;
+    }
+
+    /** Uses proposed block snapshots, after Vanilla has already recognised a valid frame. */
+    static MarkedNetherPortal from(PortalCreateEvent event, Player creator, Position ignition) {
+        if(event.getReason() != PortalCreateEvent.CreateReason.FIRE) {
+            throw new IllegalArgumentException("Only fire-created portals can be marked");
+        }
+
+        Set<Position> interior = new HashSet<>();
+        Set<Position> obsidian = new HashSet<>();
+        Axis axis = null;
+        for(BlockState block : event.getBlocks()) {
+            if(!block.getWorld().getUID().equals(event.getWorld().getUID())) {
+                throw new IllegalArgumentException("Portal snapshots belong to a different world");
+            }
+            Position position = new Position(block.getX(), block.getY(), block.getZ());
+            if(block.getType() == Material.OBSIDIAN) obsidian.add(position);
+            if(block.getType() != Material.NETHER_PORTAL) continue;
+            if(!(block.getBlockData() instanceof Orientable orientable)) {
+                throw new IllegalArgumentException("Portal snapshot has no axis");
+            }
+            Axis blockAxis = orientable.getAxis();
+            if(blockAxis != Axis.X && blockAxis != Axis.Z) {
+                throw new IllegalArgumentException("Invalid portal snapshot axis");
+            }
+            if(axis != null && axis != blockAxis) throw new IllegalArgumentException("Mixed portal axes");
+            axis = blockAxis;
+            if(!interior.add(position)) throw new IllegalArgumentException("Duplicate portal snapshot");
+        }
+        if(interior.isEmpty()) throw new IllegalArgumentException("No proposed portal blocks");
+
+        int minX = interior.stream().mapToInt(Position::x).min().orElseThrow();
+        int maxX = interior.stream().mapToInt(Position::x).max().orElseThrow();
+        int minY = interior.stream().mapToInt(Position::y).min().orElseThrow();
+        int maxY = interior.stream().mapToInt(Position::y).max().orElseThrow();
+        int minZ = interior.stream().mapToInt(Position::z).min().orElseThrow();
+        int maxZ = interior.stream().mapToInt(Position::z).max().orElseThrow();
+        if((axis == Axis.X && minZ != maxZ) || (axis == Axis.Z && minX != maxX)) {
+            throw new IllegalArgumentException("Portal snapshots do not form a plane");
+        }
+        long proposedWidth = axis == Axis.X ? (long) maxX - minX + 1 : (long) maxZ - minZ + 1;
+        long proposedHeight = (long) maxY - minY + 1;
+        if(proposedWidth < 2 || proposedWidth > 21 || proposedHeight < 3 || proposedHeight > 21
+            || interior.size() != proposedWidth * proposedHeight) {
+            throw new IllegalArgumentException("Portal snapshots do not form a valid rectangle");
+        }
+        int width = (int) proposedWidth;
+        int height = (int) proposedHeight;
+
+        Position origin = new Position(minX, minY, minZ);
+        for(int horizontal = 0; horizontal < width; horizontal++) {
+            for(int vertical = 0; vertical < height; vertical++) {
+                if(!interior.contains(offset(origin, horizontal, vertical, axis))) {
+                    throw new IllegalArgumentException("Portal snapshots contain a hole");
+                }
+            }
+        }
+        List<Position> frame = framePositions(origin, width, height, axis);
+        if(!obsidian.containsAll(frame)) throw new IllegalArgumentException("Missing obsidian frame snapshots");
+        return new MarkedNetherPortal(
+            event.getWorld().getUID(), creator.getUniqueId(), origin, width, height, axis, ignition, frame
+        );
+    }
+
+    Set<ChunkKey> requiredChunks() {
+        Set<ChunkKey> chunks = new LinkedHashSet<>();
+        // Native fire placement searches neighbouring possible frames, not only this exact rectangle.
+        this.addChunkRectangle(
+            chunks,
+            this.ignition.x - NATIVE_SEARCH_RADIUS, this.ignition.x + NATIVE_SEARCH_RADIUS,
+            this.ignition.z - NATIVE_SEARCH_RADIUS, this.ignition.z + NATIVE_SEARCH_RADIUS
+        );
+        for(Position position : this.frame) {
+            chunks.add(new ChunkKey(this.worldId, Math.floorDiv(position.x, 16), Math.floorDiv(position.z, 16)));
+        }
+        return Set.copyOf(chunks);
+    }
+
+    boolean isLoaded(World world) {
+        if(world == null || !world.getUID().equals(this.worldId)) return false;
+        for(ChunkKey chunk : this.requiredChunks()) {
+            if(!world.isChunkLoaded(chunk.x, chunk.z)) return false;
+        }
+        return true;
+    }
+
+    /** Must run on the main thread; no block is read until every required chunk is present. */
+    Validation validate(World world) {
+        if(!this.isLoaded(world)) return Validation.WAITING;
+        if(this.origin.y - 1 < world.getMinHeight() || this.origin.y + this.height >= world.getMaxHeight()) {
+            return Validation.INVALID;
+        }
+        for(Position position : this.frame) {
+            if(position.block(world).getType() != Material.OBSIDIAN) return Validation.INVALID;
+        }
+
+        int active = 0;
+        for(int horizontal = 0; horizontal < this.width; horizontal++) {
+            for(int vertical = 0; vertical < this.height; vertical++) {
+                Block block = offset(this.origin, horizontal, vertical, this.axis).block(world);
+                Material type = block.getType();
+                if(type == Material.NETHER_PORTAL) {
+                    if(!(block.getBlockData() instanceof Orientable data) || data.getAxis() != this.axis) {
+                        return Validation.INVALID;
+                    }
+                    active++;
+                } else if(!type.isAir() && type != Material.FIRE) {
+                    return Validation.INVALID;
+                }
+            }
+        }
+        if(active == this.width * this.height) return Validation.ALREADY_ACTIVE;
+        return active == 0 ? Validation.READY : Validation.INVALID;
+    }
+
+    private void addChunkRectangle(Set<ChunkKey> chunks, int minX, int maxX, int minZ, int maxZ) {
+        for(int x = Math.floorDiv(minX, 16); x <= Math.floorDiv(maxX, 16); x++) {
+            for(int z = Math.floorDiv(minZ, 16); z <= Math.floorDiv(maxZ, 16); z++) {
+                chunks.add(new ChunkKey(this.worldId, x, z));
+            }
+        }
+    }
+
+    private static boolean contains(Position origin, int width, int height, Axis axis, Position position) {
+        long horizontal = axis == Axis.X ? (long) position.x - origin.x : (long) position.z - origin.z;
+        long vertical = (long) position.y - origin.y;
+        boolean samePlane = axis == Axis.X ? position.z == origin.z : position.x == origin.x;
+        return samePlane && horizontal >= 0 && horizontal < width && vertical >= 0 && vertical < height;
+    }
+
+    private static List<Position> framePositions(Position origin, int width, int height, Axis axis) {
+        List<Position> positions = new ArrayList<>(2 * (width + height));
+        for(int horizontal = 0; horizontal < width; horizontal++) {
+            positions.add(offset(origin, horizontal, -1, axis));
+            positions.add(offset(origin, horizontal, height, axis));
+        }
+        for(int vertical = 0; vertical < height; vertical++) {
+            positions.add(offset(origin, -1, vertical, axis));
+            positions.add(offset(origin, width, vertical, axis));
+        }
+        return positions;
+    }
+
+    private static Position offset(Position origin, int horizontal, int vertical, Axis axis) {
+        return new Position(
+            Math.addExact(origin.x, axis == Axis.X ? horizontal : 0),
+            Math.addExact(origin.y, vertical),
+            Math.addExact(origin.z, axis == Axis.Z ? horizontal : 0)
+        );
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/netherAccess/MarkedNetherPortals.java

@@ -0,0 +1,284 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.netherAccess;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduleText;
+import eu.mhsl.craftattack.spawn.core.Main;
+import org.bukkit.Bukkit;
+import org.bukkit.Chunk;
+import org.bukkit.Material;
+import org.bukkit.World;
+import org.bukkit.block.Block;
+import org.bukkit.entity.Player;
+import org.bukkit.event.block.BlockIgniteEvent;
+import org.bukkit.event.world.PortalCreateEvent;
+import org.bukkit.plugin.IllegalPluginAccessException;
+import org.bukkit.scheduler.BukkitTask;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.Map;
+import java.util.Set;
+import java.util.UUID;
+import java.util.logging.Level;
+
+/** Main-thread registry and bounded activation queue; only the store touches its YAML. */
+final class MarkedNetherPortals {
+    private final NetherAccess owner;
+    private final PortalMarkStore store;
+    private final Map<String, MarkedNetherPortal> portals = new LinkedHashMap<>();
+    private final Map<MarkedNetherPortal.ChunkKey, Set<String>> chunkIndex = new HashMap<>();
+    private final Set<String> removing = new HashSet<>();
+    private final LinkedHashSet<String> queue = new LinkedHashSet<>();
+    private @Nullable BukkitTask processingTask;
+    private @Nullable BukkitTask startupTask;
+    private boolean loaded;
+    private boolean loadFailed;
+    private boolean ready;
+    private volatile boolean closed;
+
+    MarkedNetherPortals(NetherAccess owner) {
+        this.owner = owner;
+        this.store = new PortalMarkStore(Main.instance().getDataFolder().toPath().resolve("marked-nether-portals.yml"));
+    }
+
+    void start() {
+        this.store.load().whenComplete((saved, error) -> {
+            if(error != null) {
+                this.logStorageFailure("Portalmarkierungen konnten nicht geladen werden; neue Markierungen sind gesperrt.", error);
+                this.onMainThread(() -> this.loadFailed = true);
+                return;
+            }
+            this.onMainThread(() -> {
+                saved.forEach(this::register);
+                this.loaded = true;
+                this.enqueueLoadedPortals();
+            });
+        });
+        // The opening schedule reconciles its initial state on tick one. In particular,
+        // a persisted OPEN must not ignite portals before a future date restores CLOSED.
+        this.startupTask = Bukkit.getScheduler().runTaskLater(Main.instance(), () -> {
+            this.startupTask = null;
+            this.ready = true;
+            this.enqueueLoadedPortals();
+        }, 2L);
+    }
+
+    void mark(PortalCreateEvent event, Player player, MarkedNetherPortal.Position ignition) {
+        UUID playerId = player.getUniqueId();
+        UUID worldId = event.getWorld().getUID();
+        // Cancellation leaves the source fire behind. Remove only that exact fire,
+        // after the original native ignition has returned, without touching other blocks.
+        Bukkit.getScheduler().runTask(Main.instance(), () -> {
+            if(this.closed) return;
+            World world = Bukkit.getWorld(worldId);
+            if(world == null || !world.isChunkLoaded(ignition.x() >> 4, ignition.z() >> 4)) return;
+            Block block = ignition.block(world);
+            if(block.getType() == Material.FIRE) block.setType(Material.AIR, false);
+        });
+        if(!this.loaded) {
+            this.message(playerId, this.loadFailed
+                ? "Die Portal-Speicherdatei konnte nicht geladen werden. Bitte informiere einen Administrator. Das Portal wurde nicht vorgemerkt."
+                : "Die Portalmarkierungen werden noch geladen. Bitte versuche es gleich erneut.");
+            return;
+        }
+
+        final MarkedNetherPortal portal;
+        try {
+            portal = MarkedNetherPortal.from(event, player, ignition);
+        } catch(IllegalArgumentException error) {
+            this.message(playerId, "Dieses Portal konnte nicht vorgemerkt werden.");
+            Main.logger().log(Level.WARNING, "Ungültige Geometrie beim Vormerken eines Netherportals.", error);
+            return;
+        }
+        this.store.putIfAbsent(portal).whenComplete((saved, error) -> {
+            if(error != null) {
+                this.logStorageFailure("Netherportal " + portal.id() + " konnte nicht gespeichert werden.", error);
+                this.onMainThread(() -> this.message(playerId, "Das Portal konnte nicht gespeichert werden und wurde nicht vorgemerkt. Bitte informiere einen Administrator."));
+                return;
+            }
+            this.onMainThread(() -> {
+                boolean existing = this.portals.containsKey(saved.id());
+                this.register(saved);
+                this.message(playerId, existing
+                    ? "Dieses Portal ist bereits vorgemerkt und wird nach der Nether-Freigabe entzündet."
+                    : "Das Portal wurde vorgemerkt und wird nach der Nether-Freigabe automatisch entzündet.");
+                this.enqueue(saved);
+            });
+        });
+    }
+
+    /** Called for both live transitions and silent schedule restoration. */
+    void onStateChanged() {
+        if(this.owner.isClosed()) {
+            this.queue.clear();
+            this.stopProcessing();
+        } else {
+            this.enqueueLoadedPortals();
+        }
+    }
+
+    void onChunkLoad(Chunk chunk) {
+        if(!this.canProcess()) return;
+        Set<String> affected = this.chunkIndex.get(new MarkedNetherPortal.ChunkKey(chunk.getWorld().getUID(), chunk.getX(), chunk.getZ()));
+        if(affected == null) return;
+        affected.forEach(id -> this.enqueue(this.portals.get(id)));
+    }
+
+    void onWorldLoad(World world) {
+        if(!this.canProcess()) return;
+        this.portals.values().stream().filter(portal -> portal.worldId().equals(world.getUID())).forEach(this::enqueue);
+    }
+
+    private void register(MarkedNetherPortal portal) {
+        if(this.portals.putIfAbsent(portal.id(), portal) != null) return;
+        for(MarkedNetherPortal.ChunkKey chunk : portal.requiredChunks()) {
+            this.chunkIndex.computeIfAbsent(chunk, ignored -> new HashSet<>()).add(portal.id());
+        }
+    }
+
+    private boolean canProcess() {
+        return !this.closed && this.loaded && this.ready && !this.owner.isClosed();
+    }
+
+    private void enqueueLoadedPortals() {
+        if(this.canProcess()) this.portals.values().forEach(this::enqueue);
+    }
+
+    private void enqueue(@Nullable MarkedNetherPortal portal) {
+        if(portal == null || !this.canProcess() || this.removing.contains(portal.id())) return;
+        World world = Bukkit.getWorld(portal.worldId());
+        if(world == null || !portal.isLoaded(world)) return;
+        this.queue.add(portal.id());
+        if(this.processingTask == null) {
+            this.processingTask = Bukkit.getScheduler().runTaskTimer(Main.instance(), this::processNext, 1L, 1L);
+        }
+    }
+
+    private void processNext() {
+        if(!this.canProcess()) {
+            this.queue.clear();
+            this.stopProcessing();
+            return;
+        }
+        if(this.queue.isEmpty()) {
+            this.stopProcessing();
+            return;
+        }
+        String id = this.queue.removeFirst();
+        MarkedNetherPortal portal = this.portals.get(id);
+        World world = portal == null ? null : Bukkit.getWorld(portal.worldId());
+        if(portal != null && world != null && !this.removing.contains(id)) {
+            switch(portal.validate(world)) {
+                case WAITING -> { /* A required chunk unloaded while this entry was queued. */ }
+                case INVALID -> this.discard(portal, "Rahmen beschädigt oder Innenraum verbaut");
+                case ALREADY_ACTIVE -> this.remove(portal);
+                case READY -> this.ignite(portal, world);
+            }
+        }
+        if(this.queue.isEmpty()) this.stopProcessing();
+    }
+
+    private void ignite(MarkedNetherPortal portal, World world) {
+        Block ignition = portal.ignition().block(world);
+        Player creator = Bukkit.getPlayer(portal.creatorId());
+        BlockIgniteEvent igniteEvent = new BlockIgniteEvent(ignition, BlockIgniteEvent.IgniteCause.FLINT_AND_STEEL, creator);
+        Bukkit.getPluginManager().callEvent(igniteEvent);
+        if(igniteEvent.isCancelled()) {
+            this.logRetained(portal, "BlockIgniteEvent abgebrochen");
+            return;
+        }
+        // Other plugins may have changed access, blocks or chunk availability in the event.
+        if(!this.canProcess()) return;
+        switch(portal.validate(world)) {
+            case WAITING -> { return; }
+            case INVALID -> { this.discard(portal, "Portal während des Zündereignisses verändert"); return; }
+            case ALREADY_ACTIVE -> { this.remove(portal); return; }
+            case READY -> { }
+        }
+
+        boolean hadFire = ignition.getType() == Material.FIRE;
+        if(hadFire) ignition.setType(Material.AIR, false);
+        // Native physics performs shape validation and fires PortalCreateEvent. Writing
+        // portal blocks ourselves would bypass cancellation by protection plugins.
+        ignition.setType(Material.FIRE, true);
+        MarkedNetherPortal.Validation result = portal.validate(world);
+        if(result == MarkedNetherPortal.Validation.ALREADY_ACTIVE) {
+            this.remove(portal);
+        } else {
+            if(!hadFire && world.isChunkLoaded(ignition.getX() >> 4, ignition.getZ() >> 4)
+                && ignition.getType() == Material.FIRE) ignition.setType(Material.AIR, false);
+            if(result == MarkedNetherPortal.Validation.INVALID) {
+                this.discard(portal, "Portal beim Zünden beschädigt oder verbaut");
+            } else {
+                this.logRetained(portal, "Vanilla-Portalbildung nicht erfolgt oder von einem Plugin abgebrochen");
+            }
+        }
+    }
+
+    private void discard(MarkedNetherPortal portal, String reason) {
+        Main.logger().warning("Netherportal-Markierung " + portal.id() + " wird entfernt: " + reason + ".");
+        this.remove(portal);
+    }
+
+    private void logRetained(MarkedNetherPortal portal, String reason) {
+        Main.logger().warning("Netherportal " + portal.id() + " bleibt vorgemerkt: " + reason
+            + ". Kein automatischer Wiederholungsversuch ohne erneutes Laden oder Öffnen.");
+    }
+
+    private void remove(MarkedNetherPortal portal) {
+        String id = portal.id();
+        if(!this.removing.add(id)) return;
+        this.store.remove(id).whenComplete((ignored, error) -> {
+            if(error != null) this.logStorageFailure("Netherportal-Markierung " + id + " konnte nicht entfernt werden.", error);
+            this.onMainThread(() -> {
+                this.removing.remove(id);
+                if(error != null) return;
+                this.portals.remove(id);
+                this.queue.remove(id);
+                for(MarkedNetherPortal.ChunkKey chunk : portal.requiredChunks()) {
+                    Set<String> entries = this.chunkIndex.get(chunk);
+                    if(entries == null) continue;
+                    entries.remove(id);
+                    if(entries.isEmpty()) this.chunkIndex.remove(chunk);
+                }
+            });
+        });
+    }
+
+    private void message(UUID playerId, String text) {
+        Player player = Bukkit.getPlayer(playerId);
+        if(player != null) player.sendMessage(DimensionScheduleText.message(text, DimensionScheduleText.NETHER_RED));
+    }
+
+    private void onMainThread(Runnable action) {
+        if(this.closed) return;
+        try {
+            Bukkit.getScheduler().runTask(Main.instance(), () -> {
+                if(!this.closed) action.run();
+            });
+        } catch(IllegalPluginAccessException ignored) {
+            // Persisted changes survive shutdown even when no main-thread callback can run.
+        }
+    }
+
+    private void logStorageFailure(String message, Throwable error) {
+        Main.logger().log(Level.SEVERE, message, error);
+    }
+
+    private void stopProcessing() {
+        if(this.processingTask == null) return;
+        this.processingTask.cancel();
+        this.processingTask = null;
+    }
+
+    void close() {
+        this.closed = true;
+        if(this.startupTask != null) this.startupTask.cancel();
+        this.startupTask = null;
+        this.stopProcessing();
+        this.queue.clear();
+        this.store.close();
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/netherAccess/NetherAccess.java

@@ -0,0 +1,103 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.netherAccess;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionOpeningEffects;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduleText;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduler;
+import eu.mhsl.craftattack.spawn.core.Main;
+import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
+import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
+import eu.mhsl.craftattack.spawn.core.config.Configuration;
+import org.bukkit.event.Listener;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Objects;
+
+/** Owns Nether access; commands and the schedule use the same persisted state transition. */
+public class NetherAccess extends Appliance {
+    private final DimensionOpeningEffects openingEffects = new DimensionOpeningEffects(
+        "nether-opening", "nether-activation-denied", DimensionScheduleText.NETHER_RED
+    );
+    private State state;
+    private @Nullable NetherOpeningSchedule openingSchedule;
+    private @Nullable MarkedNetherPortals markedPortals;
+
+    public enum State {
+        CLOSED,
+        OPEN
+    }
+
+    public NetherAccess() {
+        super("netherAccess");
+        this.state = State.valueOf(this.localConfig().getString("state", State.CLOSED.name()));
+    }
+
+    @Override
+    public void onEnable() {
+        if(this.openingSchedule != null) this.openingSchedule.stop();
+        if(this.markedPortals != null) this.markedPortals.close();
+        this.markedPortals = new MarkedNetherPortals(this);
+        this.markedPortals.start();
+        DimensionScheduler scheduler = Main.instance().getAppliances().stream()
+            .filter(DimensionScheduler.class::isInstance)
+            .map(DimensionScheduler.class::cast)
+            .findFirst().orElse(null);
+        if(scheduler == null) return;
+
+        this.openingEffects.configure(scheduler);
+        this.openingSchedule = new NetherOpeningSchedule(this, scheduler, this.openingEffects);
+        this.openingSchedule.start();
+    }
+
+    @Override
+    public void onDisable() {
+        if(this.openingSchedule != null) this.openingSchedule.stop();
+        if(this.markedPortals != null) this.markedPortals.close();
+    }
+
+    public void setState(State state) {
+        this.changeState(state, true);
+    }
+
+    /** Restore startup or changed schedule state without replaying past opening effects. */
+    void restoreState(State state) {
+        this.changeState(state, false);
+    }
+
+    private void changeState(State state, boolean announceOpening) {
+        if(this.state == state) return;
+        boolean wasClosed = this.isClosed();
+        this.state = state;
+        this.localConfig().set("state", state.name());
+        Configuration.saveChanges();
+        if(this.markedPortals != null) this.markedPortals.onStateChanged();
+        if(announceOpening && wasClosed && !this.isClosed()) this.openingEffects.playOpening();
+    }
+
+    public State getState() {
+        return this.state;
+    }
+
+    public boolean isClosed() {
+        return this.state == State.CLOSED;
+    }
+
+    DimensionOpeningEffects effects() {
+        return this.openingEffects;
+    }
+
+    MarkedNetherPortals markedPortals() {
+        return Objects.requireNonNull(this.markedPortals, "Nether portal registry is not enabled");
+    }
+
+    @Override
+    protected @NotNull List<Listener> listeners() {
+        return List.of(new NetherAccessListener());
+    }
+
+    @Override
+    protected @NotNull List<ApplianceCommand<?>> commands() {
+        return List.of(new NetherCommand(), new NetherPreventCommand(), new NetherIgniterCommand());
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/netherAccess/NetherAccessListener.java

@@ -0,0 +1,143 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.netherAccess;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduleText;
+import eu.mhsl.craftattack.spawn.core.appliance.ApplianceListener;
+import org.bukkit.Bukkit;
+import org.bukkit.GameMode;
+import org.bukkit.Location;
+import org.bukkit.Material;
+import org.bukkit.World;
+import org.bukkit.block.Block;
+import org.bukkit.entity.Entity;
+import org.bukkit.entity.Player;
+import org.bukkit.event.Cancellable;
+import org.bukkit.event.Event;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.EventPriority;
+import org.bukkit.event.block.Action;
+import org.bukkit.event.entity.EntityPortalEvent;
+import org.bukkit.event.player.PlayerInteractEvent;
+import org.bukkit.event.player.PlayerPortalEvent;
+import org.bukkit.event.player.PlayerQuitEvent;
+import org.bukkit.event.world.ChunkLoadEvent;
+import org.bukkit.event.world.PortalCreateEvent;
+import org.bukkit.event.world.WorldLoadEvent;
+import org.bukkit.inventory.EquipmentSlot;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.TimeUnit;
+
+class NetherAccessListener extends ApplianceListener<NetherAccess> {
+    private static final long MESSAGE_COOLDOWN_NANOS = TimeUnit.SECONDS.toNanos(3);
+    private final Map<UUID, Long> lastDeniedMessageAt = new HashMap<>();
+    private final Map<UUID, IgnitionAttempt> ignitionAttempts = new HashMap<>();
+
+    @EventHandler(priority = EventPriority.HIGHEST)
+    public void onSpecialItemUse(PlayerInteractEvent event) {
+        if(!NetherPortalIgniter.isSpecial(event.getItem()) || event.getPlayer().getGameMode() == GameMode.CREATIVE) return;
+        event.setCancelled(true);
+        this.ignitionAttempts.remove(event.getPlayer().getUniqueId());
+        if(!this.canSendMessage(event.getPlayer())) return;
+        event.getPlayer().sendMessage(DimensionScheduleText.message(
+            "Das Portalfeuerzeug kann nur im Kreativmodus verwendet werden.", DimensionScheduleText.NETHER_RED
+        ));
+    }
+
+    @EventHandler(priority = EventPriority.MONITOR)
+    public void onIgnitionAttempt(PlayerInteractEvent event) {
+        if(event.getAction() != Action.RIGHT_CLICK_BLOCK) return;
+        UUID playerId = event.getPlayer().getUniqueId();
+        // Record the hand actually used, including ordinary tools. Merely holding the special
+        // item in the other hand must never turn a normal ignition into a marked portal.
+        this.ignitionAttempts.remove(playerId);
+        if(event.useItemInHand() == Event.Result.DENY || event.useInteractedBlock() == Event.Result.DENY) return;
+        if(event.getClickedBlock() == null || event.getHand() == null || event.getItem() == null) return;
+        Material material = event.getItem().getType();
+        if(material != Material.FLINT_AND_STEEL && material != Material.FIRE_CHARGE) return;
+        Block ignition = event.getClickedBlock().getRelative(event.getBlockFace());
+        this.ignitionAttempts.put(playerId, new IgnitionAttempt(
+            ignition.getWorld().getUID(), event.getHand(), Bukkit.getCurrentTick(),
+            new MarkedNetherPortal.Position(ignition.getX(), ignition.getY(), ignition.getZ()),
+            NetherPortalIgniter.isSpecial(event.getItem())
+        ));
+    }
+
+    @EventHandler(priority = EventPriority.HIGHEST, ignoreCancelled = true)
+    public void onPortalCreate(PortalCreateEvent event) {
+        boolean nether = event.getWorld().getEnvironment() == World.Environment.NETHER;
+        boolean blockedCreation = switch(event.getReason()) {
+            case FIRE -> !nether;
+            case NETHER_PAIR -> nether;
+            default -> false;
+        };
+        if(!blockedCreation || !this.getAppliance().isClosed()) return;
+        if(event.getReason() == PortalCreateEvent.CreateReason.FIRE && event.getEntity() instanceof Player player) {
+            IgnitionAttempt attempt = this.ignitionAttempts.remove(player.getUniqueId());
+            if(attempt != null && attempt.special() && player.getGameMode() == GameMode.CREATIVE
+                && attempt.tick() == Bukkit.getCurrentTick() && attempt.worldId().equals(event.getWorld().getUID())
+                && event.getBlocks().stream().anyMatch(block -> block.getType() == Material.NETHER_PORTAL
+                    && block.getX() == attempt.ignition().x() && block.getY() == attempt.ignition().y()
+                    && block.getZ() == attempt.ignition().z())) {
+                event.setCancelled(true);
+                this.getAppliance().markedPortals().mark(event, player, attempt.ignition());
+                return;
+            }
+        }
+        this.cancelIfClosed(event, event.getEntity());
+    }
+
+    @EventHandler
+    public void onChunkLoad(ChunkLoadEvent event) {
+        this.getAppliance().markedPortals().onChunkLoad(event.getChunk());
+    }
+
+    @EventHandler
+    public void onWorldLoad(WorldLoadEvent event) {
+        this.getAppliance().markedPortals().onWorldLoad(event.getWorld());
+    }
+
+    @EventHandler(ignoreCancelled = true)
+    public void onPlayerPortal(PlayerPortalEvent event) {
+        if(isNetherDestination(event.getTo())) this.cancelIfClosed(event, event.getPlayer());
+    }
+
+    @EventHandler(ignoreCancelled = true)
+    public void onEntityPortal(EntityPortalEvent event) {
+        if(isNetherDestination(event.getTo())) this.cancelIfClosed(event, event.getEntity());
+    }
+
+    @EventHandler
+    public void onPlayerQuit(PlayerQuitEvent event) {
+        this.lastDeniedMessageAt.remove(event.getPlayer().getUniqueId());
+        this.ignitionAttempts.remove(event.getPlayer().getUniqueId());
+    }
+
+    private static boolean isNetherDestination(@Nullable Location destination) {
+        return destination != null && destination.getWorld() != null
+            && destination.getWorld().getEnvironment() == World.Environment.NETHER;
+    }
+
+    private void cancelIfClosed(Cancellable event, @Nullable Entity actor) {
+        if(!this.getAppliance().isClosed()) return;
+        event.setCancelled(true);
+        if(!(actor instanceof Player player)) return;
+
+        if(this.canSendMessage(player)) this.getAppliance().effects().denyActivation(player);
+    }
+
+    private boolean canSendMessage(Player player) {
+        // Cancellation always applies; message and sound share an elapsed-real-time cooldown.
+        long now = System.nanoTime();
+        Long previousMessageAt = this.lastDeniedMessageAt.get(player.getUniqueId());
+        if(previousMessageAt != null && now - previousMessageAt < MESSAGE_COOLDOWN_NANOS) return false;
+        this.lastDeniedMessageAt.put(player.getUniqueId(), now);
+        return true;
+    }
+
+    private record IgnitionAttempt(UUID worldId, EquipmentSlot hand, int tick,
+                                   MarkedNetherPortal.Position ignition, boolean special) {
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/netherAccess/NetherCommand.java

@@ -0,0 +1,50 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.netherAccess;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduleText;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduler;
+import eu.mhsl.craftattack.spawn.core.Main;
+import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.jetbrains.annotations.NotNull;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.Optional;
+
+/** Public information about Nether access and the configured opening date. */
+class NetherCommand extends ApplianceCommand<NetherAccess> {
+    public NetherCommand() {
+        super("nether", DimensionScheduleText.message("Fehler: ", DimensionScheduleText.NETHER_RED));
+    }
+
+    @Override
+    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        if(args.length != 0) throw new Error("Verwendung: /nether");
+        if(!this.getAppliance().isClosed()) {
+            sender.sendMessage(DimensionScheduleText.message("Der Nether ist bereits geöffnet.", DimensionScheduleText.NETHER_RED));
+            return;
+        }
+
+        Optional<Instant> openingAt = Main.instance().getAppliances().stream()
+            .filter(DimensionScheduler.class::isInstance)
+            .map(DimensionScheduler.class::cast)
+            .findFirst()
+            .flatMap(scheduler -> scheduler.getTime("nether-open-at"));
+        Instant now = Instant.now();
+        String message;
+        if(openingAt.isEmpty()) {
+            message = "Für den Nether ist noch kein Öffnungstermin festgelegt.";
+        } else if(!openingAt.get().isAfter(now)) {
+            message = "Der Öffnungstermin ist bereits erreicht. Der Nether ist derzeit noch geschlossen.";
+        } else {
+            message = "Der Nether öffnet in " + DimensionScheduleText.remaining(openingAt.get(), now) + ".";
+        }
+        sender.sendMessage(DimensionScheduleText.message(message, DimensionScheduleText.NETHER_RED));
+    }
+
+    @Override
+    public @NotNull List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        return List.of();
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/netherAccess/NetherIgniterCommand.java

@@ -0,0 +1,40 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.netherAccess;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduleText;
+import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
+import org.bukkit.GameMode;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+
+class NetherIgniterCommand extends ApplianceCommand<NetherAccess> {
+    public NetherIgniterCommand() {
+        super("netherIgniter", DimensionScheduleText.message("Fehler: ", DimensionScheduleText.NETHER_RED));
+    }
+
+    @Override
+    public @NotNull String permission() {
+        return "spawn.command.netherigniter";
+    }
+
+    @Override
+    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        if(!(sender instanceof Player player)) throw new Error("Dieser Befehl kann nur von Spielern ausgeführt werden.");
+        if(!player.isOp()) throw new Error("Dieser Befehl ist nur für OPs verfügbar.");
+        if(player.getGameMode() != GameMode.CREATIVE) throw new Error("Das Portalfeuerzeug ist nur im Kreativmodus verfügbar.");
+        if(args.length != 0) throw new Error("Verwendung: /netherIgniter");
+        if(player.getInventory().firstEmpty() == -1) throw new Error("Dein Inventar ist voll. Schaffe einen freien Platz für das Portalfeuerzeug.");
+        if(!player.getInventory().addItem(NetherPortalIgniter.create()).isEmpty()) {
+            throw new Error("Das Portalfeuerzeug konnte nicht in dein Inventar gelegt werden.");
+        }
+        player.sendMessage(DimensionScheduleText.message("Du hast ein Portalfeuerzeug erhalten.", DimensionScheduleText.NETHER_RED));
+    }
+
+    @Override
+    public @NotNull List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        return List.of();
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/netherAccess/NetherOpeningSchedule.java

@@ -0,0 +1,86 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.netherAccess;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionOpeningEffects;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduler;
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.OpeningAnnouncements;
+import eu.mhsl.craftattack.spawn.core.Main;
+import org.bukkit.Bukkit;
+import org.bukkit.scheduler.BukkitTask;
+import org.jetbrains.annotations.Nullable;
+
+import java.time.Instant;
+import java.util.Optional;
+
+/** Interprets nether-open-at; NetherAccess creates and stops its single polling task. */
+final class NetherOpeningSchedule {
+    private final NetherAccess netherAccess;
+    private final DimensionScheduler scheduler;
+    private final OpeningAnnouncements announcements;
+    private @Nullable BukkitTask task;
+    private Optional<Instant> previousOpenAt = Optional.empty();
+    private @Nullable NetherAccess.State previousScheduledState;
+    private boolean initialized;
+    private Instant startedAt = Instant.EPOCH;
+
+    NetherOpeningSchedule(NetherAccess netherAccess, DimensionScheduler scheduler, DimensionOpeningEffects effects) {
+        this.netherAccess = netherAccess;
+        this.scheduler = scheduler;
+        this.announcements = new OpeningAnnouncements(effects);
+    }
+
+    void start() {
+        this.stop();
+        this.startedAt = Instant.now();
+        // All appliances must finish loading before the first check, regardless of their order.
+        this.task = Bukkit.getScheduler().runTaskTimer(Main.instance(), this::checkOpeningTime, 1L, 20L);
+    }
+
+    void stop() {
+        if(this.task == null) return;
+        this.task.cancel();
+        this.task = null;
+    }
+
+    private void checkOpeningTime() {
+        Optional<Instant> openingAt = this.scheduler.getTime("nether-open-at");
+        Instant now = Instant.now();
+        boolean restoreSchedule = !this.initialized || !openingAt.equals(this.previousOpenAt);
+        Instant restoreAt = this.scheduler.getLoadedAt();
+        if(!this.initialized && this.startedAt.isAfter(restoreAt)) restoreAt = this.startedAt;
+        this.announcements.prepare(openingAt, restoreAt);
+        this.previousOpenAt = openingAt;
+        this.initialized = true;
+
+        if(openingAt.isEmpty()) {
+            this.previousScheduledState = null;
+            return;
+        }
+
+        NetherAccess.State scheduledState = stateAt(now, openingAt.get());
+        NetherAccess.State restoredState = stateAt(restoreAt, openingAt.get());
+        boolean crossedAfterLoad = restoreSchedule && restoredState != scheduledState;
+        if(crossedAfterLoad) {
+            // A boundary crossed since loading is a live transition, not a missed opening.
+            this.netherAccess.restoreState(restoredState);
+        }
+
+        // Manual changes remain effective until the next scheduled transition or changed date.
+        if(restoreSchedule || scheduledState != this.previousScheduledState) {
+            if(this.netherAccess.getState() != scheduledState) {
+                if(restoreSchedule && !crossedAfterLoad) {
+                    this.netherAccess.restoreState(scheduledState);
+                } else {
+                    this.netherAccess.setState(scheduledState);
+                }
+                Main.logger().info("Nether opening schedule applied state " + scheduledState
+                    + " (nether-open-at=" + openingAt.get() + ")");
+            }
+            this.previousScheduledState = scheduledState;
+        }
+        this.announcements.announceDue(now, this.netherAccess.isClosed());
+    }
+
+    private static NetherAccess.State stateAt(Instant at, Instant openingAt) {
+        return at.isBefore(openingAt) ? NetherAccess.State.CLOSED : NetherAccess.State.OPEN;
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/netherAccess/NetherPortalIgniter.java

@@ -0,0 +1,32 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.netherAccess;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduleText;
+import eu.mhsl.craftattack.spawn.core.Main;
+import eu.mhsl.craftattack.spawn.core.util.inventory.ItemBuilder;
+import org.bukkit.Material;
+import org.bukkit.NamespacedKey;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.persistence.PersistentDataType;
+import org.jetbrains.annotations.Nullable;
+
+/** The data marker identifies the item independently of its displayed name. */
+final class NetherPortalIgniter {
+    private static final NamespacedKey KEY = new NamespacedKey(Main.instance(), "nether_portal_igniter");
+
+    private NetherPortalIgniter() {
+    }
+
+    static ItemStack create() {
+        return ItemBuilder.of(Material.FLINT_AND_STEEL)
+            .displayName(DimensionScheduleText.message("Portalfeuerzeug", DimensionScheduleText.NETHER_RED))
+            .lore("Nur im Kreativmodus verwendbar. Bei geschlossenem Nether werden gültige Portale zur späteren Öffnung vorgemerkt. Bei offenem Nether funktioniert es wie ein normales Feuerzeug.")
+            .glint()
+            .withMeta(meta -> meta.getPersistentDataContainer().set(KEY, PersistentDataType.BOOLEAN, true))
+            .build();
+    }
+
+    static boolean isSpecial(@Nullable ItemStack item) {
+        return item != null && item.getType() == Material.FLINT_AND_STEEL && item.hasItemMeta()
+            && Boolean.TRUE.equals(item.getItemMeta().getPersistentDataContainer().get(KEY, PersistentDataType.BOOLEAN));
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/netherAccess/NetherPreventCommand.java

@@ -0,0 +1,44 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.netherAccess;
+
+import eu.mhsl.craftattack.spawn.common.appliances.tooling.dimensionScheduler.DimensionScheduleText;
+import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+import java.util.Map;
+
+class NetherPreventCommand extends ApplianceCommand<NetherAccess> {
+    private final Map<String, NetherAccess.State> arguments = Map.of(
+        "preventNether", NetherAccess.State.CLOSED,
+        "allowNether", NetherAccess.State.OPEN
+    );
+
+    public NetherPreventCommand() {
+        super("netherPrevent", DimensionScheduleText.message("Fehler: ", DimensionScheduleText.NETHER_RED));
+    }
+
+    @Override
+    public @NotNull String permission() {
+        return "spawn.command.netherprevent";
+    }
+
+    @Override
+    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        if(!sender.isOp()) throw new Error("Dieser Befehl ist nur für die Konsole und OPs verfügbar.");
+        if(args.length > 1 || (args.length == 1 && !this.arguments.containsKey(args[0]))) {
+            throw new Error("Verwendung: /netherPrevent [preventNether|allowNether]");
+        }
+        if(args.length == 1) this.getAppliance().setState(this.arguments.get(args[0]));
+
+        String message = this.getAppliance().isClosed() ? "Der Nether ist geschlossen." : "Der Nether ist geöffnet.";
+        sender.sendMessage(DimensionScheduleText.message(message, DimensionScheduleText.NETHER_RED));
+    }
+
+    @Override
+    public @NotNull List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        if(!sender.isOp() || args.length != 1) return List.of();
+        return this.tabCompleteReducer(this.arguments.keySet().stream().toList(), args);
+    }
+}

common/src/main/java/eu/mhsl/craftattack/spawn/common/appliances/tooling/netherAccess/PortalMarkStore.java

@@ -0,0 +1,237 @@
+package eu.mhsl.craftattack.spawn.common.appliances.tooling.netherAccess;
+
+import org.bukkit.Axis;
+import org.bukkit.configuration.InvalidConfigurationException;
+import org.bukkit.configuration.file.YamlConfiguration;
+
+import java.io.IOException;
+import java.io.Reader;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.AtomicMoveNotSupportedException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.StandardCopyOption;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.UUID;
+import java.util.concurrent.Callable;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.concurrent.RejectedExecutionException;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.locks.ReentrantLock;
+import java.util.logging.Logger;
+
+/** Serial file ownership keeps failed writes out of both the committed map and later snapshots. */
+final class PortalMarkStore implements AutoCloseable {
+    private static final int FORMAT_VERSION = 1;
+    private static final Logger LOGGER = Logger.getLogger(PortalMarkStore.class.getName());
+    // Kept across store instances: timed-out old IO must finish before a restarted appliance can load this path.
+    private static final ConcurrentHashMap<Path, ReentrantLock> PATH_LOCKS = new ConcurrentHashMap<>();
+
+    private final Path path;
+    private final ReentrantLock pathLock;
+    private final ExecutorService worker = Executors.newSingleThreadExecutor(task -> {
+        Thread thread = new Thread(task, "Spawn-PortalMarks");
+        thread.setDaemon(true);
+        return thread;
+    });
+    private final Set<CompletableFuture<?>> pending = ConcurrentHashMap.newKeySet();
+
+    // Only the IO worker accesses the following state.
+    private Map<String, MarkedNetherPortal> committed = new LinkedHashMap<>();
+    private boolean loaded;
+
+    PortalMarkStore(Path path) {
+        this.path = Objects.requireNonNull(path, "path").toAbsolutePath().normalize();
+        this.pathLock = PATH_LOCKS.computeIfAbsent(this.path, ignored -> new ReentrantLock());
+    }
+
+    CompletableFuture<List<MarkedNetherPortal>> load() {
+        return this.submit(() -> {
+            if(this.loaded) return List.copyOf(this.committed.values());
+            Map<String, MarkedNetherPortal> entries = new LinkedHashMap<>();
+            if(!Files.notExists(this.path)) {
+                YamlConfiguration yaml = new YamlConfiguration();
+                try(Reader reader = Files.newBufferedReader(this.path, StandardCharsets.UTF_8)) {
+                    yaml.load(reader);
+                } catch(InvalidConfigurationException exception) {
+                    throw new IOException("Invalid portal marking YAML: " + this.path, exception);
+                }
+                Object version = yaml.get("version");
+                if(!(version instanceof Integer number) || number != FORMAT_VERSION) {
+                    throw new IOException("Unsupported or missing portal marking version: " + this.path);
+                }
+                if(!(yaml.get("portals") instanceof List<?> portals)) {
+                    throw new IOException("Missing portal marking list: " + this.path);
+                }
+                for(int index = 0; index < portals.size(); index++) {
+                    MarkedNetherPortal portal;
+                    try {
+                        portal = readPortal(portals.get(index));
+                    } catch(RuntimeException exception) {
+                        throw new IOException("Invalid portal marking at index " + index + ": " + this.path, exception);
+                    }
+                    if(entries.putIfAbsent(portal.id(), portal) != null) {
+                        throw new IOException("Duplicate portal marking: " + portal.id());
+                    }
+                }
+            }
+            this.committed = entries;
+            this.loaded = true;
+            return List.copyOf(entries.values());
+        });
+    }
+
+    CompletableFuture<MarkedNetherPortal> putIfAbsent(MarkedNetherPortal portal) {
+        return this.submit(() -> {
+            this.requireLoaded();
+            Objects.requireNonNull(portal, "portal");
+            MarkedNetherPortal existing = this.committed.get(portal.id());
+            if(existing != null) return existing;
+            Map<String, MarkedNetherPortal> snapshot = new LinkedHashMap<>(this.committed);
+            snapshot.put(portal.id(), portal);
+            this.save(snapshot);
+            this.committed = snapshot;
+            return portal;
+        });
+    }
+
+    CompletableFuture<Void> remove(String id) {
+        return this.submit(() -> {
+            this.requireLoaded();
+            if(!this.committed.containsKey(id)) return null;
+            Map<String, MarkedNetherPortal> snapshot = new LinkedHashMap<>(this.committed);
+            snapshot.remove(id);
+            this.save(snapshot);
+            this.committed = snapshot;
+            return null;
+        });
+    }
+
+    private void requireLoaded() throws IOException {
+        if(!this.loaded) throw new IOException("Portal markings have not been loaded successfully: " + this.path);
+    }
+
+    private void save(Map<String, MarkedNetherPortal> snapshot) throws IOException {
+        YamlConfiguration yaml = new YamlConfiguration();
+        yaml.set("version", FORMAT_VERSION);
+        yaml.set("portals", snapshot.values().stream().map(PortalMarkStore::writePortal).toList());
+
+        Path directory = this.path.getParent();
+        Files.createDirectories(directory);
+        Path temporary = Files.createTempFile(directory, this.path.getFileName() + ".", ".tmp");
+        try {
+            Files.writeString(temporary, yaml.saveToString(), StandardCharsets.UTF_8);
+            try {
+                Files.move(temporary, this.path, StandardCopyOption.ATOMIC_MOVE, StandardCopyOption.REPLACE_EXISTING);
+            } catch(AtomicMoveNotSupportedException exception) {
+                Files.move(temporary, this.path, StandardCopyOption.REPLACE_EXISTING);
+            }
+        } catch(IOException | RuntimeException failure) {
+            try {
+                Files.deleteIfExists(temporary);
+            } catch(IOException cleanupFailure) {
+                failure.addSuppressed(cleanupFailure);
+            }
+            throw failure;
+        }
+    }
+
+    private static Map<String, Object> writePortal(MarkedNetherPortal portal) {
+        Map<String, Object> values = new LinkedHashMap<>();
+        values.put("world", portal.worldId().toString());
+        values.put("creator", portal.creatorId().toString());
+        values.put("origin", writePosition(portal.origin()));
+        values.put("width", portal.width());
+        values.put("height", portal.height());
+        values.put("axis", portal.axis().name());
+        values.put("ignition", writePosition(portal.ignition()));
+        values.put("frame", portal.frame().stream().map(PortalMarkStore::writePosition).toList());
+        return values;
+    }
+
+    private static List<Integer> writePosition(MarkedNetherPortal.Position position) {
+        return List.of(position.x(), position.y(), position.z());
+    }
+
+    private static MarkedNetherPortal readPortal(Object value) {
+        if(!(value instanceof Map<?, ?> values)) throw new IllegalArgumentException("Expected a portal mapping");
+        if(!(values.get("frame") instanceof List<?> frame)) throw new IllegalArgumentException("Missing portal frame");
+        return new MarkedNetherPortal(
+            UUID.fromString(string(values, "world")),
+            UUID.fromString(string(values, "creator")),
+            readPosition(values.get("origin")),
+            integer(values.get("width")),
+            integer(values.get("height")),
+            Axis.valueOf(string(values, "axis")),
+            readPosition(values.get("ignition")),
+            frame.stream().map(PortalMarkStore::readPosition).toList()
+        );
+    }
+
+    private static String string(Map<?, ?> values, String key) {
+        if(values.get(key) instanceof String value) return value;
+        throw new IllegalArgumentException("Missing portal string: " + key);
+    }
+
+    private static MarkedNetherPortal.Position readPosition(Object value) {
+        if(!(value instanceof List<?> coordinates) || coordinates.size() != 3) {
+            throw new IllegalArgumentException("Expected three integer coordinates");
+        }
+        return new MarkedNetherPortal.Position(
+            integer(coordinates.get(0)), integer(coordinates.get(1)), integer(coordinates.get(2))
+        );
+    }
+
+    private static int integer(Object value) {
+        if(value instanceof Integer number) return number;
+        throw new IllegalArgumentException("Expected an integer");
+    }
+
+    private <T> CompletableFuture<T> submit(Callable<T> operation) {
+        CompletableFuture<T> result = new CompletableFuture<>();
+        this.pending.add(result);
+        result.whenComplete((value, failure) -> this.pending.remove(result));
+        try {
+            this.worker.execute(() -> {
+                if(result.isDone()) return;
+                try {
+                    T value;
+                    this.pathLock.lockInterruptibly();
+                    try {
+                        if(result.isDone()) return;
+                        value = operation.call();
+                    } finally {
+                        this.pathLock.unlock();
+                    }
+                    result.complete(value);
+                } catch(Throwable failure) {
+                    result.completeExceptionally(failure);
+                }
+            });
+        } catch(RejectedExecutionException failure) {
+            result.completeExceptionally(failure);
+        }
+        return result;
+    }
+
+    @Override
+    public void close() {
+        this.worker.shutdown();
+        try {
+            if(this.worker.awaitTermination(5, TimeUnit.SECONDS)) return;
+            LOGGER.warning("Timed out while saving portal markings: " + this.path);
+        } catch(InterruptedException exception) {
+            Thread.currentThread().interrupt();
+        }
+        this.worker.shutdownNow();
+        IOException failure = new IOException("Portal marking storage stopped before queued operations completed");
+        this.pending.forEach(future -> future.completeExceptionally(failure));
+    }
+}

common/src/main/resources/dimension-schedule.yml

@@ -0,0 +1,90 @@
+# Datum mit UTC-Offset in Anführungszeichen; null bedeutet: kein Termin.
+# Weitere frei benannte Zeitpunkte können hier ergänzt werden.
+times:
+  end-open-at: "2027-01-03T19:00:00+01:00"
+  outer-end-open-at: null
+  nether-open-at: "2026-12-29T14:00:00+01:00"
+
+messages:
+  end-activation-denied:
+    texts:
+      - "Die Augen scheinen dich für einen kurzen Moment anzustarren. Dir läuft ein kalter Schauer über den Rücken ..."
+      - "Der Rahmen fühlt sich ungewöhnlich kalt an. Du hast das Gefühl, als würde er dir die Wärme aus den Fingern ziehen …"
+      - "Die Luft über dem leeren Rahmen scheint ungewöhnlich dunkel. Du hast das Gefühl, in einen bodenlosen Abgrund zu blicken ..."
+      - "Für einen kurzen Moment scheint die Umgebung vollkommen still zu werden. Du fragst dich, ob du dir das nur eingebildet hast ..."
+      - "Ein schwaches, violettes Licht flackert zwischen den Augen auf. Etwas scheint dich zu beobachten ..."
+    # Ein Sound pro Nachricht, gemeinsam mit dem Nachrichten-Cooldown.
+    sound: "entity.warden.roar"
+    pitch: 0.2
+    volume: 1.0
+  nether-activation-denied:
+    texts:
+      - "Der Obsidian scheint von innen heraus zu glühen. Du spürst eine fremdartige Hitze ..."
+      - "Eine seltsame Wärme geht von dem schwarzen Gestein aus. Dich beschleicht ein unheimliches Gefühl ..."
+      - "Für einen kurzen Moment scheint der Obsidian zu pulsieren. Du fragst dich, ob das Feuer etwas in ihm geweckt hat …"
+      - "Die Luft scheint leicht zu flimmern. Du hast das Gefühl, hier geht etwas nicht mit rechten Dingen zu ..."
+      - "Das Gestein knistert, aber das Feuer scheint noch keine Wirkung zu haben ..."
+    sound: "entity.wither.ambient"
+    pitch: 0.3
+    volume: 1.0
+
+effects:
+  end-opening:
+    # Namen und Anzahl der Effekte sind frei wählbar.
+    # Positive Minutenwerte: Vorankündigung im Chat, solange das End geschlossen ist.
+    four-hours-before:
+      minutes-before-opening: 240
+      message: "Eine unheimliche Stille scheint sich langsam über die Welt auszubreiten. Du hast das seltsame Gefühl, beobachtet zu werden ..."
+      sound: "ambient.cave"
+      pitch: 0.5
+      volume: 3.0
+    one-hour-before:
+      minutes-before-opening: 60
+      message: "Die Luft fühlt sich plötzlich ungewöhnlich schwer an. Du hast das Gefühl, als würde eine unsichtbare Kraft auf dir lasten ..."
+      sound: "entity.wither.spawn"
+      pitch: 0.5
+      volume: 2.0
+    ten-minutes-before:
+      minutes-before-opening: 10
+      message: "Ein seltsames Geräusch hallt durch die Welt. Könnte es das Schlagen gewaltiger Flügel sein ...?"
+      sound: "block.sculk_shrieker.shriek"
+      pitch: 0.3
+      volume: 3.0
+    one-minute-before:
+      minutes-before-opening: 1
+      message: "Ein gewaltiger Schatten scheint über die Welt zu ziehen. Du blickst zum Himmel, doch dort ist nichts zu sehen ..."
+      sound: "entity.ender_dragon.growl"
+      pitch: 0.5
+      volume: 3.0
+    # 0: Nur beim tatsächlichen Öffnen, gleichermaßen durch Command oder Zeitplan.
+    opened:
+      minutes-before-opening: 0
+      message: "Ein gewaltiger Riss öffnet sich in der Realität! Die Leere erwacht und die letzte Grenze fällt. Der Weg ins End ist nun offen!"
+      sound: "block.end_portal.spawn"
+      pitch: 1.0
+      volume: 2.0
+  nether-opening:
+    two-hours-before:
+      minutes-before-opening: 120
+      message: "In der ganzen Welt scheint die Luft leicht zu flimmern. Eine fremdartige Wärme breitet sich aus ..."
+      sound: "block.portal.ambient"
+      pitch: 0.3
+      volume: 2.0
+    thirty-minutes-before:
+      minutes-before-opening: 30
+      message: "Ein tiefes Grollen durchzieht die Welt. Du spürst, wie die Luft um dich herum zu vibrieren beginnt ..."
+      sound: "entity.warden.roar"
+      pitch: 0.2
+      volume: 2.0
+    one-minute-before:
+      minutes-before-opening: 1
+      message: "Die Erde bebt. Für einen kurzen Moment scheint die Realität selbst zu zerreißen. Etwas steht unmittelbar bevor ..."
+      sound: "entity.wither.spawn"
+      pitch: 0.5
+      volume: 2.0
+    opened:
+      minutes-before-opening: 0
+      message: "Ein gewaltiger Riss durchzieht die Realität! Die Grenze zwischen den Welten ist gefallen. Der Weg in den Nether ist nun offen!"
+      sound: "block.end_portal.spawn"
+      pitch: 1.0
+      volume: 1.0

core/src/main/java/eu/mhsl/craftattack/spawn/core/util/entity/DisplayVillager.java

@@ -8,6 +8,7 @@ import org.bukkit.configuration.ConfigurationSection;
 import org.bukkit.entity.EntityType;
 import org.bukkit.entity.Villager;
 
+import java.util.Arrays;
 import java.util.Objects;
 import java.util.UUID;
 import java.util.function.Consumer;
@@ -19,11 +20,14 @@ public class DisplayVillager {
     public DisplayVillager(UUID uuid, Location location, Consumer<Villager> villagerCreator) {
         this.location = location;
 
-        try {
-            ChunkUtils.loadChunkAtLocation(this.location);
-            this.villager = (Villager) this.location.getWorld().getEntity(uuid);
-            Objects.requireNonNull(this.villager);
-        } catch(NullPointerException | IllegalArgumentException e) {
+        // getEntities() waits for the chunk's entities; getEntity(uuid) misses them while they are still loading
+        this.villager = Arrays.stream(ChunkUtils.loadChunkAtLocation(this.location).getEntities())
+            .filter(entity -> entity.getUniqueId().equals(uuid))
+            .filter(Villager.class::isInstance)
+            .map(Villager.class::cast)
+            .findFirst()
+            .orElse(null);
+        if(this.villager == null) {
             this.villager = this.getBaseVillager();
             villagerCreator.accept(this.villager);
         }

core/src/main/resources/config.yml

@@ -110,9 +110,6 @@ tablist:
   projectTitle: "Title"
   interface: eth0
 
-outlawed:
-  voluntarily: []
-
 packselect:
   packs:
     - somepack:

core/src/main/resources/plugin.yml

@@ -9,4 +9,18 @@ prefix: mhsl-spawn
 author: MineTec
 contributors: [olischma, 28Pupsi28]
 
-website: https://mhsl.eu/gitea/CraftAttack/spawn
+website: https://mhsl.eu/gitea/CraftAttack/spawn
+
+permissions:
+  spawn.command.dimensionschedule:
+    description: Öffnungszeiten, Texte und Effekte neu einlesen
+    default: op
+  spawn.command.endprevent:
+    description: End-Zugang verwalten
+    default: op
+  spawn.command.netherprevent:
+    description: Nether-Zugang verwalten
+    default: op
+  spawn.command.netherigniter:
+    description: Portalfeuerzeug im Kreativmodus erhalten
+    default: op

craftattack/src/main/java/eu/mhsl/craftattack/spawn/craftattack/appliances/gameplay/outlawed/OutlawChangeNotPermitted.java

@@ -1,7 +0,0 @@
-package eu.mhsl.craftattack.spawn.craftattack.appliances.gameplay.outlawed;
-
-class OutlawChangeNotPermitted extends Exception {
-    public OutlawChangeNotPermitted(String message) {
-        super(message);
-    }
-}

craftattack/src/main/java/eu/mhsl/craftattack/spawn/craftattack/appliances/gameplay/outlawed/Outlawed.java

@@ -1,165 +0,0 @@
-package eu.mhsl.craftattack.spawn.craftattack.appliances.gameplay.outlawed;
-
-import eu.mhsl.craftattack.spawn.core.Main;
-import eu.mhsl.craftattack.spawn.core.appliance.Appliance;
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
-import eu.mhsl.craftattack.spawn.common.appliances.metaGameplay.displayName.DisplayName;
-import eu.mhsl.craftattack.spawn.craftattack.appliances.tooling.whitelist.Whitelist;
-import eu.mhsl.craftattack.spawn.core.config.Configuration;
-import eu.mhsl.craftattack.spawn.core.util.text.DisconnectInfo;
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.event.ClickEvent;
-import net.kyori.adventure.text.event.HoverEvent;
-import net.kyori.adventure.text.format.NamedTextColor;
-import org.bukkit.Bukkit;
-import org.bukkit.entity.Player;
-import org.bukkit.event.Listener;
-import org.jetbrains.annotations.NotNull;
-
-import java.util.*;
-
-public class Outlawed extends Appliance implements DisplayName.Prefixed {
-    public final int timeoutInMs = 1000 * 60 * 60 * 6;
-    private final Map<UUID, Long> timeouts = new HashMap<>();
-
-    public enum Status {
-        DISABLED,
-        VOLUNTARILY,
-        FORCED
-    }
-
-    private final Map<Player, Status> playerStatusMap = new WeakHashMap<>();
-    private final String voluntarilyEntry = "voluntarily";
-
-    public Outlawed() {
-        super("outlawed");
-        Bukkit.getScheduler().runTaskTimerAsynchronously(
-            Main.instance(),
-            () -> this.playerStatusMap.forEach((player, status) -> {
-                if(!player.isOnline()) return;
-                if(status != Status.FORCED) return;
-                try {
-                    this.queryAppliance(Whitelist.class).fullIntegrityCheck(player);
-                } catch(DisconnectInfo.Throwable e) {
-                    e.getDisconnectScreen().applyKick(player);
-                }
-            }),
-            20 * 60,
-            20 * 60 * 5
-        );
-    }
-
-    void askForConfirmation(Player player) {
-        Component confirmationMessage = switch(this.getLawStatus(player)) {
-            case DISABLED -> Component.text("Wenn du den PVP-Modus aktivierst, darfst du von allen anderen PVP-Spielern grundlos angegriffen werden." +
-                " Du kannst den PVP-Modus erst wieder nach " + this.timeoutInMs / 1000 / 60 / 60 + " Stunden deaktivieren!");
-            case VOLUNTARILY -> Component.text("Wenn du den PVP-Modus deaktivierst, darfst du nicht mehr grundlos von anderen Spielern angegriffen werden.");
-            case FORCED -> Component.text("Du darfst zurzeit deinen PVP-Modus nicht ändern, da die˝ser als Strafe auferlegt wurde!");
-        };
-        String command = String.format("/%s confirm", OutlawedCommand.commandName);
-        Component changeText = Component.text(
-            String.format(
-                "Zum ändern deines PVP-Status klicke auf diese Nachricht oder tippe '%s'",
-                command
-            ),
-            NamedTextColor.GOLD
-        ).clickEvent(ClickEvent.suggestCommand(command));
-
-        player.sendMessage(
-            Component.text()
-                .append(confirmationMessage.color(NamedTextColor.RED))
-                .appendNewline()
-                .append(changeText)
-        );
-    }
-
-    void switchLawStatus(Player player) throws OutlawChangeNotPermitted {
-        if(this.getLawStatus(player).equals(Status.FORCED)) {
-            throw new OutlawChangeNotPermitted("Dein PVP-Status wurde als Strafe auferlegt und kann daher nicht verändert werden.");
-        }
-
-        if(this.isTimeout(player)) {
-            throw new OutlawChangeNotPermitted("Du kannst deinen PVP-Status nicht so schnell wechseln. Bitte warte einige Stunden bevor du umschaltest!");
-        }
-
-        this.setLawStatus(player, this.isOutlawed(player) ? Status.DISABLED : Status.VOLUNTARILY);
-        this.setTimeout(player);
-    }
-
-    public void updateForcedStatus(Player player, boolean forced) {
-        this.setLawStatus(player, forced ? Status.FORCED : this.getLawStatus(player) == Status.FORCED ? Status.DISABLED : this.getLawStatus(player));
-    }
-
-    public Status getLawStatus(Player player) {
-        return this.playerStatusMap.computeIfAbsent(player, p -> {
-            if(this.localConfig().getStringList(this.voluntarilyEntry).contains(p.getUniqueId().toString()))
-                return Status.VOLUNTARILY;
-            return Status.DISABLED;
-        });
-    }
-
-    private void setLawStatus(Player player, Status status) {
-        this.playerStatusMap.put(player, status);
-        this.queryAppliance(DisplayName.class).update(player);
-
-        List<String> newList = this.localConfig().getStringList(this.voluntarilyEntry);
-        if(status.equals(Status.VOLUNTARILY)) {
-            newList.add(player.getUniqueId().toString());
-        } else {
-            newList.remove(player.getUniqueId().toString());
-        }
-        this.localConfig().set(this.voluntarilyEntry, newList.stream().distinct().toList());
-        Configuration.saveChanges();
-
-    }
-
-    public boolean isOutlawed(Player player) {
-        return this.getLawStatus(player) != Status.DISABLED;
-    }
-
-    private boolean isTimeout(Player player) {
-        return this.timeouts.getOrDefault(player.getUniqueId(), 0L) > System.currentTimeMillis() - this.timeoutInMs;
-    }
-
-    private void setTimeout(Player player) {
-        this.timeouts.put(player.getUniqueId(), System.currentTimeMillis());
-    }
-
-    public Component getStatusDescription(Status status) {
-        return switch(status) {
-            case DISABLED -> Component.text("PVP-Modus inaktiv: ", NamedTextColor.GREEN)
-                .append(Component.text("Es gelten die normalen Regeln!", NamedTextColor.GOLD));
-
-            case VOLUNTARILY, FORCED -> Component.text("PVP-Modus aktiv: ", NamedTextColor.RED)
-                .append(Component.text(
-                    "Du darfst von allen anderen PVP-Spielern angegriffen und getötet werden!\n" +
-                        "Wenn du getötet wirst, müssen andere Spieler deine Items *nicht* zurückerstatten!",
-                    NamedTextColor.GOLD
-                ));
-        };
-    }
-
-    @Override
-    public Component getNamePrefix(Player player) {
-        if(this.isOutlawed(player)) {
-            return Component.text("[☠]", NamedTextColor.RED)
-                .hoverEvent(HoverEvent.showText(Component.text(
-                    "PVP-Modus Spieler dürfen von anderen vogelfreien Spielern ohne Grund angegriffen werden!"
-                )));
-        }
-
-        return null;
-    }
-
-    @Override
-    @NotNull
-    protected List<ApplianceCommand<?>> commands() {
-        return List.of(new OutlawedCommand());
-    }
-
-    @Override
-    @NotNull
-    protected List<Listener> listeners() {
-        return List.of(new OutlawedReminderListener());
-    }
-}

craftattack/src/main/java/eu/mhsl/craftattack/spawn/craftattack/appliances/gameplay/outlawed/OutlawedCommand.java

@@ -1,30 +0,0 @@
-package eu.mhsl.craftattack.spawn.craftattack.appliances.gameplay.outlawed;
-
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceCommand;
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.format.NamedTextColor;
-import org.bukkit.command.Command;
-import org.bukkit.command.CommandSender;
-import org.jetbrains.annotations.NotNull;
-
-class OutlawedCommand extends ApplianceCommand.PlayerChecked<Outlawed> {
-    public static final String commandName = "pvp";
-
-    public OutlawedCommand() {
-        super(commandName);
-    }
-
-    @Override
-    protected void execute(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) throws Exception {
-        if(args.length == 1 && args[0].equals("confirm")) {
-            try {
-                this.getAppliance().switchLawStatus(this.getPlayer());
-                sender.sendMessage(this.getAppliance().getStatusDescription(this.getAppliance().getLawStatus(this.getPlayer())));
-            } catch(OutlawChangeNotPermitted e) {
-                sender.sendMessage(Component.text(e.getMessage(), NamedTextColor.RED));
-            }
-        } else {
-            this.getAppliance().askForConfirmation(this.getPlayer());
-        }
-    }
-}

craftattack/src/main/java/eu/mhsl/craftattack/spawn/craftattack/appliances/gameplay/outlawed/OutlawedReminderListener.java

@@ -1,14 +0,0 @@
-package eu.mhsl.craftattack.spawn.craftattack.appliances.gameplay.outlawed;
-
-import eu.mhsl.craftattack.spawn.core.appliance.ApplianceListener;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.player.PlayerJoinEvent;
-
-class OutlawedReminderListener extends ApplianceListener<Outlawed> {
-    @EventHandler
-    public void onJoin(PlayerJoinEvent e) {
-        if(this.getAppliance().isOutlawed(e.getPlayer())) {
-            e.getPlayer().sendMessage(this.getAppliance().getStatusDescription(this.getAppliance().getLawStatus(e.getPlayer())));
-        }
-    }
-}

craftattack/src/main/java/eu/mhsl/craftattack/spawn/craftattack/appliances/gameplay/quarzRecipe/QuarzRecipe.java

@@ -14,7 +14,7 @@ import org.jetbrains.annotations.NotNull;
 import java.util.List;
 
 public class QuarzRecipe extends Appliance {
-    private NamespacedKey recipeKey;
+    protected NamespacedKey recipeKey;
     @Override
     public void onEnable() {
         this.recipeKey = new NamespacedKey(Main.instance(), "quarz_block_to_quarz");
@@ -26,11 +26,6 @@ public class QuarzRecipe extends Appliance {
         Bukkit.getOnlinePlayers().forEach(this::unlock);
     }
 
-    @Override
-    public void onDisable() {
-        Bukkit.removeRecipe(this.recipeKey);
-    }
-
     public void unlock(Player player) {
         player.discoverRecipe(this.recipeKey);
     }

craftattack/src/main/java/eu/mhsl/craftattack/spawn/craftattack/appliances/gameplay/quarzRecipe/QuarzRecipeListener.java

@@ -1,12 +1,19 @@
 package eu.mhsl.craftattack.spawn.craftattack.appliances.gameplay.quarzRecipe;
 
 import eu.mhsl.craftattack.spawn.core.appliance.ApplianceListener;
+import io.papermc.paper.event.player.PlayerInventorySlotChangeEvent;
+import org.bukkit.Material;
+import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
-import org.bukkit.event.player.PlayerJoinEvent;
+import org.bukkit.inventory.ItemStack;
 
 class QuarzRecipeListener extends ApplianceListener<QuarzRecipe> {
     @EventHandler
-    public void onPlayerJoin(PlayerJoinEvent event) {
-        this.getAppliance().unlock(event.getPlayer());
+    public void shouldDiscover(PlayerInventorySlotChangeEvent event) {
+        ItemStack clickedItem = event.getNewItemStack();
+        Player player = event.getPlayer();
+        if(clickedItem.getType() != Material.QUARTZ_BLOCK) return;
+        if(player.hasDiscoveredRecipe(this.getAppliance().recipeKey)) return;
+        this.getAppliance().unlock(player);
     }
 }

craftattack/src/main/java/eu/mhsl/craftattack/spawn/craftattack/appliances/metaGameplay/arenaPortal/ArenaPortal.java

@@ -20,7 +20,6 @@ import org.bukkit.event.Listener;
 import org.bukkit.inventory.ItemStack;
 import org.jetbrains.annotations.NotNull;
 
-import java.util.ArrayList;
 import java.util.Base64;
 import java.util.HashSet;
 import java.util.List;
@@ -75,8 +74,7 @@ public class ArenaPortal extends Appliance {
         if(!this.pendingTransfers.add(player.getUniqueId())) return;
         player.sendActionBar(Component.text("Du wirst zur Arena gebracht...", NamedTextColor.GRAY));
 
-        List<ItemStack> contents = new ArrayList<>(List.of(player.getInventory().getContents()));
-        String items = Base64.getEncoder().encodeToString(ItemStack.serializeItemsAsBytes(contents));
+        String items = Base64.getEncoder().encodeToString(ItemStack.serializeItemsAsBytes(player.getInventory().getContents()));
         ArenaRepository.InventorySnapshot snapshot = new ArenaRepository.InventorySnapshot(player.getUniqueId(), items);
 
         Bukkit.getScheduler().runTaskAsynchronously(Main.instance(), () -> {