ВЕРСИИ (7)

*** ### 🎉 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](https://www.spigotmc.org/resources/protocollib.1997/) 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.

# 🕯️ SlendermanPlugin v1.5.0 - The Stable Release! 🎉 [](https://github.com/virgenes/SlendermanPlugin) [](https://papermc.io) [](https://adoptium.net) [](LICENSE) > A professional, feature-rich Slender Man horror minigame for Paper/Spigot servers. > Collect 8 pages before the Slenderman catches you — if you dare. We are thrilled to announce the stable release of **SlendermanPlugin v1.5.0**! This update brings a massive overhaul, introducing a standalone disguise system, a terrifying sanity mechanic, progression, and much more. --- ## 🔥 What's New in v1.5.0 (Changelog) - **Complete Rewrite & Polish:** Major bug fixes and performance improvements. - **Internal Disguise System:** No longer requires LibsDisguises! Uses ProtocolLib directly. - **Sanity System:** A brand new visual sanity bar with dynamic terrifying effects. - **Perks & Progression:** Added 9 survivor perks, 3 Slenderman perks, and an economy system. - **Cosmetics:** 6 purchasable Slenderman skins (Enderman, Wither, Phantom, Ravager, Elder Guardian, Warden). - **Quality of Life:** In-game scoreboard, custom chat format with rank badges, and an interactive lantern battery system. - **Localization:** Full 6-language support (English, Spanish, French, German, Portuguese, Chinese). - **Integrations:** Added PlaceholderAPI integration and seamless ViaVersion compatibility. --- ## ✨ Key Features | Category | Description | |---|---| | 🎮 **Gameplay** | 8-page collection, noise mechanics, multiple simultaneous arenas | | 🧠 **Sanity** | Panic effects, hallucinations, darkness drain based on proximity | | 📊 **Progression** | Complete Evolution system: XP, Levels, Skills, and Achievements | | 🔌 **Integrations** | PlaceholderAPI, ProtocolLib, ViaVersion compatible | | 🛠️ **Admin Tools** | Game logs, hot-reload, wizard setup, force-start | --- ## 🚀 Getting Started ### 📋 Requirements - **Server:** Paper or Spigot 1.19 – 1.21.x - **Java:** 17 or higher - **Required Dependency:** [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/) (for the disguise system) - **Optional:** PlaceholderAPI (scoreboards) & ViaVersion (multi-version) ### ⚙️ Quick Installation 1. Download `SlendermanPlugin-1.5.0.jar` from the assets below. 2. Place it in your server's `plugins/` folder along with **ProtocolLib**. 3. Start the server — config files are generated automatically. 4. Set the lobby: `/sis setlobby` 5. Create and configure your first arena: `/sis createarena <id>` ➡️ `/sis editarena <id>` 6. Save and play: `/sis admin save <id>` --- ## 📚 Technical Documentation <details> <summary><b>🎮 Commands & Permissions</b></summary> ### Player Commands | Command | Permission | Description | |---|---|---| | `/sis join <arena>` | `SlendermanPlugin.player` | Join an arena | | `/sis leave` | `SlendermanPlugin.player` | Leave current arena | | `/sis balance [player]` | `slender.economy.balance` | View coin balance | | `/sis baltop` | `slender.economy.balancetop` | Top 10 richest | | `/sis pay <player> <amount>`| `slender.economy.pay` | Send coins | | `/sis money` | `slender.economy.help` | Economy help | ### Admin Commands | Command | Permission | Description | |---|---|---| | `/sis setlobby` | `SlendermanPlugin.admin` | Set lobby location | | `/sis createarena <id>` | `SlendermanPlugin.admin` | Create a new arena | | `/sis editarena <id>` | `SlendermanPlugin.admin` | Open arena editor | | `/sis deletearena <id>` | `SlendermanPlugin.admin` | Delete an arena | | `/sis admin <id>` | `SlendermanPlugin.admin` | Admin menu for arena | | `/sis start <arena>` | `SlendermanPlugin.admin` | Force-start an arena | | `/sis money <give/take/set>`| `slender.economy.<action>` | Manage player balances | | `/sis money reload` | `slender.economy.reload` | Reload config | </details> <details> <summary><b>⚙️ Systems Overview (Sanity, Perks & Skills)</b></summary> ### Sanity System (0–100) Drains when looking at Slenderman, standing in darkness, or being near him. - **75–100:** Normal - **50–74:** Occasional ambient sounds - **25–49:** Nausea, slowness, blindness pulses - **0–24:** **PANIC** — severe effects, vulnerability ### Skills (Up to Level 5) Players spend coins on permanent passives: **Walk Speed** (+5%/lvl), **Stamina**, **Resistance** (-5% dmg/lvl), and **Coin Booster**. ### Perks (Equippable) - **Survivors (9):** Runaway, Better Together, Archaeologist, Iron Will, Shadow Step, Last Stand, Resilience

Dependency: https://www.spigotmc.org/resources/protocollib.1997/