# CraftCubeClash 2.2 — Finale Overhaul, Cube Security & Admin Improvements CraftCubeClash 2.2 is a major gameplay and administration update focused on making the finale more tactical, improving team-cube security without restricting legitimate raids, and making event recovery and management much easier. ## 🏆 Finale Overhaul * **Team beds now control finale respawns** * Each team receives a designated bed near its colored finale spawn. * As long as the team's bed is still intact, players respawn at their team's finale spawn after dying. * Once the bed has been destroyed, the next death eliminates that player from the finale. * Teams cannot destroy their own finale bed, but enemy teams can. * **Removed automatic void rescue** * Falling from the finale island now results in a normal death. * Whether the player respawns or is eliminated is determined by their team's bed. * **Protected the original finale island** * Blocks that belong to the original main-island schematic can no longer be mined or destroyed during the finale. * Players can still place new blocks during the finale. * Blocks placed by players remain breakable. * This prevents the original arena itself from being dismantled while still allowing normal building and PvP. * **Added `/cc revive <player|UUID>`** * Admins can restore a player who was eliminated because of a bug or incorrect event state. * The command removes the finale elimination state and matching event ban. * The player is restored to Survival mode and returned to their real team finale spawn. * If a winner countdown had already started because of the incorrect elimination, the finale can be reopened safely. ## 🧊 Team Cube Anti-Exploit Protection Team cubes remain fully raid-able through legitimate gameplay. **There is no invisible wall around a cube.** Players may still: * enter through an open door, * break or blow open an entrance, * create a legitimate breach, * fight and build normally inside enemy cubes. The new protections only target exploits that bypass the cube shell. ### Ender Pearl protection * Ender Pearls can no longer be used to clip through closed walls, doors, Bedrock shells, or other sealed parts of an enemy cube. * Teleports into a foreign cube are checked for a genuinely passable route to the outside. * Legitimately opened entrances remain usable. ### Chorus Fruit protection * Chorus Fruit remains usable normally. * It can no longer teleport a player through the sealed shell of an enemy team cube. * Legitimately accessible areas inside a cube are still valid. ### Pearl Stasis Stations * Pearl stasis chambers using bubble columns and trapdoors are supported again. * When an Ender Pearl actually hits the trapdoor of a stasis chamber, only that exact trapdoor is ignored for the teleport collision check. * Other solid blocks remain protected against pearl clipping. * The trapdoor exception cannot be used to bypass a sealed enemy cube. ### Bedrock protection Bedrock belonging to a pasted team-cube schematic receives additional protection against known Bedrock-breaking techniques. Protected cube Bedrock cannot be removed through: * direct block breaking, * explosions, * piston manipulation, * TNT/piston Bedrock-breaking setups, * entity or block mutation events. Other blocks inside team cubes remain normally attackable. ## 👥 Player Pool Improvements * The player pool can now be edited even after the initial setup has been completed. * Players can be added or removed through the `/cc` administration menus without rebuilding the event. * Team assignments can then be adjusted normally. This makes last-minute player corrections much easier and avoids having to manually edit server files. ## 🍗 Lobby Improvements * Players no longer lose hunger during the lobby phase. * Food level is kept at full and saturation is automatically maintained while waiting for the event to start. ## 📦 Base Chunk Loading * Base chunk plugin tickets are now reinforced every 30 seconds. * This helps keep configured team bases and their farms loaded reliably. * `/cc status` now exposes the number of active base chunk tickets for easier diagnostics. ## 💾 More Readable Storage Files Player-related UUID entries are now written together with their player name where possible. Example: `6153d8d7-8c78-4765-8924-093b4a58da07 | PlayerName` This makes files such as team, finale, and ban data significantly easier to inspect and repair manually. ## 🔧 Additional Fixes * Events configured without team-cube schematics no longer fail phase validation because of a `0/0` cube state. * Existing start-flight privacy, combat-tag death attribution, private team guidance, player-pool access protection, Crystal PvP settings, End locking, and finale safety systems remain active. * Test-server Gradle deployment no longer attempts to track mutable runtime plugin files. ## Requirements * **Minecraft / Paper:** 26.1.2 * **Java:** 25 * **WorldEdit:** Required when using schematic-based islands or team cubes * **Client mod:** Not required CraftCubeClash 2.2 keeps normal Survival and PvP gameplay open while moving exploit prevention and event recovery into more targeted server-side systems.

# Craft CUBE Clash 2.1 **Craft CUBE Clash 2.1 is the largest stability and event-system update since the 2.0 rebuild.** This release focuses on making complete multi-day PvP events safer, more automated and easier to administer. ## ⭐ Major Changes ### 🏠 Team Cubes & Navigation - Added improved automatic team-cube generation - Improved schematic placement and validation - Added persistent team cube positions - Added team-colored particle beams above bases - Team beams are now visible **only to members of the corresponding team** - Locator markers are now private to the player's own team - Improved team member navigation - Added persistent base chunk loading - Improved handling of underground team cubes ### 🪽 Start Flight - Added automatic Elytra and Firework Rocket distribution - Players receive their flight equipment immediately when protection begins - Added landing detection - Added a visible 10-second landing countdown - Taking off again cancels the countdown - Flight equipment is only permanently removed after the initial island departure and completed landing - Improved reconnect handling during the initial flight ### 🛡️ Main Island Protection - Added persistent central-island protection before the finale - Players can travel underneath the island while the protected upper area remains inaccessible - Added high-speed movement-path collision checks - Fixed Elytra + rocket clipping into the protected island - Added vehicle protection - Improved teleport protection - Removed the normal event World Border from the Main Phase ### 🌀 Teleport Exploit Protection - Improved Ender Pearl wall-clipping detection - Added post-teleport collision verification - Disabled unsafe Chorus Fruit teleporting - Added protection against entering restricted areas through teleports ### ⚔️ Combat & Death Bans - Improved the 30-second Combat-Tag system - Fixed Death-Ban kicks being detected as Combat-Logging - Administrative unbans now also clear temporary combat state - Added separate configurable bans for: - PvP deaths - Environmental deaths - Combat-Logging - Finale disconnects - Environmental deaths during Protection are now handled correctly - Improved inventory handling during Combat-Logging ### 💥 Event Rules - Added optional Crystal-PvP disabling - Added optional End dimension locking - Improved protected-phase hostile mob handling - Wild hostile mob spawning can be blocked without deleting intentionally placed or farm-related mobs ### 👥 Player Pool - The player pool is now persistent - Unknown players are no longer automatically registered when they join - After setup is complete, only players already registered in the player pool are allowed to enter the event - Existing player UUIDs remain authoritative even if a player's name changes ### 🏷️ Team Nametags - Added team-colored player nametags - Player names can display their assigned team - Uses Minecraft scoreboard teams instead of additional display entities for lower overhead ### ⏱️ Event Timeline - Improved automatic phase scheduling - Manual phase jumps no longer permanently pause the configured schedule - Automatic phase progression can recover after server downtime - Added schedule catch-up after: - Server startup - Player join - Configuration reload - Fixed phases jumping backwards - Improved phase timer and MOTD status messages ### 🛑 Event Stop - `Stop Event` is now a true event shutdown - Stopping the event prevents old scheduled phases from restarting it - Winner-animation tasks are cancelled correctly - Finale daylight and invulnerability states are restored - Delayed event tasks are cleaned up safely ### 🏆 Finale - Improved team winner detection - Fixed multiple teams receiving winner rewards - Winner players are now stored in an exact UUID snapshot - Added improved colored-island finale spawning - Added colored-carpet spawn preference - Team members can be spread across multiple carpet positions - Offline players at finale start are treated as eliminated for that finale - Players leaving an active finale can be eliminated and punished - Improved finale persistence across server restarts - Improved winner animations and automatic event ending ### 🌍 World Border - The standard event World Border is used only where required - **No artificial Craft CUBE Clash World Border is active during the Main Phase** - The Finale uses its own dedicated World Border - Improved World Border restoration after reloads and restarts ### 🔄 Generation & Restart Safety - Improved setup-generation recovery - Added generation-state persistence - Improved controlled server restart handover - Prevented duplicate Java server starts when the hosting panel already restarted the server - Added safer rollback and recovery logic - Improved cleanup of temporary generation state ### ⚙️ Performance & Stability - Reduced unnecessary particle traffic - Team beams are only sent to the correct team - Reduced unnecessary team navigation processing - Improved scheduled-task cleanup - Improved entity and temporary marker cleanup - Fixed multiple configuration fallback inconsistencies - Improved source/project validation ## 🐛 Fixes This release also includes many smaller fixes involving: - Team assignment - Schematic placement - Cube spawning - Event restarts - Player reconnects - Combat state - Death-Ban handling - Finale winner detection - World Border state - Winner animations - Lobby transitions - Start protection - Elytra handling - Teleport safety - Player-pool persistence - Source/export consistency --- ## 📦 Requirements - **Minecraft:** 26.1.2 - **Server:** Paper - **Java:** Java 25 recommended - **WorldEdit:** Optional, required for automatic schematic pasting No Craft CUBE Clash client mod is required.

# Craft CUBE Clash 2.0 Craft CUBE Clash 2.0 is a major rebuild of the original event plugin. The plugin has been rebuilt into a full event system for Minecraft PvP events with teams, custom cube arenas, event phases, combat handling, death bans, and a finale system. ## Requirements * Server Software: Paper * Minecraft Version: 26.1.2 * Recommended Java Version: Java 25 * Optional Dependency: WorldEdit WorldEdit is optional, but required if you want to paste team schematics automatically. ## Main Features * Full admin menu with `/cc` * Planned `/admin` alias * Automatic admin menu opening during setup * Team creation and team management * Custom team colors * Team spawns and finale spawns * Team schematic assignment * Cube position generation * WorldEdit schematic support * Event phases: Setup, Lobby, Protection, Main Phase, Finale, Finished * Automatic and manual phase control * Bossbar with current phase and timer * Lobby protection and lobby border * No hostile mobs during setup and lobby * PvP protection before the main phase * Combat-tag system * Combat-logging punishment * Death-ban system * Configurable ban durations * Console unban commands * Finale worldborder * Winner detection * Winner animation with titles, sounds, fireworks, and effects * Automatic event ending after the winner is found ## Version 2.0 Changes Craft CUBE Clash 2.0 is not just a small update. The plugin was almost completely rebuilt. The old basic event system has been replaced with a much larger and cleaner event structure. Admins can now control almost everything through menus, including teams, timers, cubes, schematics, combat settings, death bans, and finale options. This version also adds a proper setup flow, where normal players can be blocked from joining before the event starts, while admins can prepare the event safely. ## Notes This is a Paper server plugin. Client-side menu changes, such as hiding the lower player inventory in chest menus, would require an additional NeoForge client mod and are not part of the Paper plugin itself.

**v19 Log Fix** * Fixed parse errors in the server log * `prejoin` now loads correctly * `setup` now marks the executor as an administrator, preventing them from being kicked during setup * Fixed the winner animation function * Added alias commands: * `/function cubeclash:setup` * `/function cubeclash:prejoin` * `/function cubeclash:set_anchor` * General stabilization following the log errors

**v19 Log Fix** * Fixed parse errors in the server log * `prejoin` now loads correctly * `setup` now marks the executor as an administrator, preventing them from being kicked during setup * Fixed the winner animation function * Added alias commands: * `/function cubeclash:setup` * `/function cubeclash:prejoin` * `/function cubeclash:set_anchor` * General stabilization following the log errors

**v12 Changes** * Improved teleport for joiners during the prejoin phase * Welcome animation now appears after teleporting * Boss bar now displays phases with formatted times * Prejoin and grace timers now show minutes and seconds * Main phase timer now shows days, hours, minutes, and seconds * Winner animation adjusted to 1 minute * Revised winner end message * Separated death causes: * Player kill = 24-hour ban * Environmental/other death = 6-hour ban * Improved kick/ban messages * Expanded totem effects in the winner animation * Revised README and help texts

**v14 Hotfix** * Setup reset to the last working base * Locator bar is now only deactivated at the start of the pre-join phase * The final now works even when jumping directly to it * Final death text revised: "You have been eliminated from the project." * Winner end message revised * Winner animation visually improved * Additional totem, villager, and firework effects * General hotfix for the final and winner phases

**v13 Changes** * Locator bar at the bottom disabled * Finals are now correctly playable when jumping directly to them * Finals kick text revised: "You are eliminated from the project." * Winner's end message revised * Winner animation significantly more colorful * Totem, firework, villager, and enchant effects expanded * Setup now allows more direct access to additional UI/event settings * General refinements to the finals and winner's phase

**v12 Changes** * Improved teleport for joiners during the prejoin phase * Welcome animation now appears after teleporting * Boss bar now displays phases with formatted times * Prejoin and grace timers now show minutes and seconds * Main phase timer now shows days, hours, minutes, and seconds * Winner animation adjusted to 1 minute * Revised winner end message * Separated death causes: * Player kill = 24-hour ban * Environmental/other death = 6-hour ban * Improved kick/ban messages * Expanded totem effects in the winner animation * Revised README and help texts