SquidGameZ

🦑 SquidGamZ, production-ready: and fully automated server minigame built for Spigot and Paper networks. This plugin coordinates a multi-stage elimination tournament inspired by the global phenomenon! It features autonomous game-state switching, dynamic player lifecycle management, immersive elimination effects, and native Vault economy integration for champion payouts.

🛠 Designed with optimization in mind: the plugin utilizes lightweight event-driven listeners and isolated task schedulers to ensure zero performance degradation or main-thread tick lag, even during high-concurrency event loops.Complete Core Architecture & How It Works: The entire lifecycle of the plugin operates as a centralized state engine managed by GameManager.java. It operates on a zero-admin-dependency model, meaning the server can cycle through games endlessly without staff supervision.

👍 The Queue & Entry System Upon server boot: the plugin initializes a global instance and puts the system into the LOBBY state. A automated background thread continuously checks player counts. The moment the online player count meets or exceeds the minimum threshold a synchronized countdown loop initializes. Global reminders are broadcasted to the server at and every second during the final countdown. the plugin takes a snapshot of all online players, registers their Unique Identifiers (UUID) into the active "Alive" collection, and immediately updates the state to RED_LIGHT_GREEN_LIGHT!

🎁 Event-Driven Game TransitionsWhen a game phase concludes: the system fires a global cleanup routine. It cancels running Bukkit Task timers, unregisters active listeners to free up JVM heap memory, evaluates the surviving directory pool, and moves directly to the next scheduled game! The Elimination Pipeline (PlayerManager.java) Eliminations are fully automated!

🤨 When a player fails a mechanic or dies: They are instantly stripped from the active player array pool and moved to a dedicated Spectators collection. The plugin triggers a localized cosmetic lightning strike at their exact coordinate vector, providing visual and auditory confirmation to nearby competitors. Their Minecraft profile is updated to GameMode.SPECTATOR, letting them fly freely across the arena map to watch the remaining tournament while completely preventing them from breaking blocks, triggering pressure plates, or blocking other players.

💥 Detailed Mini-Game Mechanics Break down Every phase features its own specialized: lightweight Java listener layer to track win/loss boundaries, Red Light, Green Light (RedLightGreenLight.java) A cyclic task runs on a randomized delay interval, Green Light Players are free to move toward the finish line. The code flags isRedLight = true.The Logic, A Player Move Event intercepts all traffic. If a player shifts their $X$ or $Z$ spatial coordinates by more than the internal floating-point tolerance while a Red Light is active, the event schedules a synchronized task to instantly pass that player to the elimination pipeline.

📖 Complete Command & Permissions Directory: The plugin comes with a fully structured command system locked behind explicit permission nodes to prevent standard user exploit manipulation. /squidgame /sg This is the root parent command for the plugin. Typing the root command without valid parameters will print the syntax help map! Commands: /squidgame start /squidgame stop /squidgame setlobby /sg start /sg stop /sg setlobby