🎉 SlendermanPlugin v1.7.0: The Game Modes & Anti-Cheat Update!

We are back with one of the most massive and exciting updates for the plugin! This release completely transforms the gameplay experience by introducing new ways to play, a custom music engine, and a robust system to keep matches fair.

🔥 Highlights of this release:

• 🎮 New Game Modes: * Infection: A frantic mode where hunted survivors are assimilated into Proxies. The last player standing ("Last Hope") receives epic buffs to make a final stand!
  • Escape Room: A strategic challenge. Repair generators, find master keys, and use security keypads to unlock the exit.
• 🛡️ Combat-Logout Anti-Cheat: Say goodbye to rage-quitters! If a player disconnects after being hit by the SlenderMan (10s combat tag), they will instantly lose the match. Upon reconnecting, they'll be forcefully relegated to Spectator mode with no items.
• 🎵 Integrated NBS Audio Engine: Enjoy dynamic and independent music tracks for the lobby and combat phases (includes a per-player toggle option).
• 🌍 New Dynamic Localization System: Automatic creation of the lang/ folder for modular and professional translation of every single UI menu and message.
• 🛠️ Core Improvements: A total overhaul of the disguise system using real-time virtual packet injection, fixed iron door synchronization, and official support for 1.16 - 1.21.4.

💡 Installation Note: Make sure to update or install ProtocolLib on your server, as it is now the core engine for both the disguise and the Anti-Cheat systems.

Thank you for the support, and enjoy the scares! 🕯️

Нет описания изменений

Independent original music playback engine, bug fixes in independent maps, game mode correction, implementation of flashlight and decorative function in chat.

Chat Design and Game-End Visuals Plan

This plan aims to implement a professional-grade chat formatting system and immersive game-ending sequences with "spooky" (tenebrus) aesthetics as requested.

User Review Required

[!IMPORTANT] The chat format will be: (Rankup) + (nombre) + (level) = Hola!. Since there is no existing "Rank" system, I will implement a basic Rank utility that determines names like "Novice", "Hunter", etc., based on the player's Level. All formats, titles, and effects will be configurable via config.yml.

[!TIP] Game-ending effects will include:

• Survivors Win: Golden titles, "Sparkle" particles, and triumphant but eerie sounds.
• Slenderman Wins: Dark Red titles, "Smoke/Ash" particles, and haunting sounds (Thunder/Wither Death).

Proposed Changes

Core API

• Add void endGame(Role winner); to the interface.

• Add configuration keys for:

  • Chat: CHAT_FORMAT, CHAT_ENABLED.
  • Win Visuals: WIN_SURVIVORS_TITLE, WIN_SURVIVORS_SUBTITLE, WIN_SLENDER_TITLE, WIN_SLENDER_SUBTITLE.
  • Effects: WIN_EFFECTS_PARTICLES, WIN_EFFECTS_SOUNDS.

Game Logic

• Implement endGame(Role winner).
• Add logic for visual effects (particles and titles) inside endGame.
• Use World.spawnParticle and Player.showTitle for the aesthetics.
• Update run() to call endGame(Role.SLENDER) when the timer reaches 0.

[MODIFY] [GameListeners.java]

• Update deathPlayer to call arena.endGame(Role.SLENDER) when all survivors are dead.
• Update pickupEvent to call arena.endGame(Role.SURVIVOR) when all pages are collected.

Chat System

• Implement AsyncPlayerChatEvent.

• Format: &8(&b%RANK%&8) &f%PLAYER% &8[&eLv. %LEVEL%&8] &7= &f%MESSAGE%.

• Integrate with LevelManager to fetch levels.

• Register the new ChatListener.

Utils

• Small utility to determine Rank name based on Level (e.g. 0-10: Novice, 11-30: Survivor, etc.).

Open Questions

• Should the chat format apply only inside the arena or globally? (I assume globally if they are in the minigame server, or only inside the game if it's a multi-purpose server). I will implement it for everyone who has a profile loaded.

Verification Plan

Automated Tests

• N/A (Minecraft plugin context requires manual verification or mock tests, but I will do manual code review).

Manual Verification

• Join an arena.
• Collect all pages and verify the "Winners" screen and particles.
• Get killed by Slender and verify the "Slender Wins" screen.
• Type in chat and verify the format: (Novice) PlayerName [Lv. 1] = Hello!.

Walkthrough - Slenderman Pages Spawning Fix

I have successfully implemented the missing page spawning logic and resolved the build issues that were preventing the plugin from being updated.

Changes Made

1. Implemented spawnPage() Method

In Arena.java, I implemented the spawnPage() method which was previously empty.

• Logic: It selects a random location from the arena's configuration, drops a PAPER item, sets it to glow, and ensures it never despawns.
• Visuals: Added Particle.ENCHANT (the correct name for 1.21) and custom naming for the dropped item (e.g., "Page 1").
• Safety: Added null-checks for the world to ensure it works correctly with separate worlds.

2. Integrated Spawning into Gameplay

Verified that pages are spawned at the correct times:

• Game Start: The first page spawns immediately when the game transitions to the RUNNING state.
• On Pickup: When a survivor picks up a page, the current item is removed, the counter increments, and the next page is automatically spawned.

3. Build System Resolution

Fixed compilation issues:

• Dependency Map: Ensured slender-api is correctly installed in the local repository so slender-plugin can find it.
• 1.21 Compatibility: Fixed a compilation error where Particle.ENCHANTMENT_TABLE was not recognized (it was renamed to Particle.ENCHANT in Minecraft 1.21).

Verification Results

• Compilation: Successfully ran mvn clean install on the entire project. Both API and Plugin are now updated and built into JAR files.
• Game Logic: Confirmed the sequence of events (Start -> Spawn -> Pickup -> Spawn) is correctly defined in the code.

You can now use the latest slender-plugin-1.5.0.jar from the target/ directory of the slender-plugin module.