SoulLock

# 💀 SoulLock — Death is not the end... When a player dies, their **soul is trapped inside their head**. They cannot return… unless someone places it back. Will your friends save you — or leave you behind? --- ## 🎮 What is SoulLock? SoulLock is a **Paper plugin (1.21+)** that transforms Minecraft’s death system into a **revival-based mechanic**. Instead of respawning normally: * 💀 Players become **soul-locked** * 🪦 Their **head drops at death location** * ⚡ They can only return when someone places their head --- ## ✨ Features ### 💀 Soul Lock System * Player dies → soul is locked * Real **player head drops (with skin)** * Only **one active head per player** * Fully persistent (survives restarts) --- ### 👻 Locked Player Behavior Locked players are restricted until revived: * Cannot break or place blocks * Cannot use items * Cannot interact with entities **Join behavior:** * 👁️ Spectator mode (default) * 🚫 Kick mode (configurable) --- ### ⚡ Revival System When a player head is placed: * 🔍 Automatically detects the player * 🆓 Instantly unlocks their soul * 📩 Message: *"Your soul has been restored! ✨"* If the player is online: * Teleported to revival location * Restored to SURVIVAL mode * Spawn point updated **Effects:** * ⚡ Lightning strike (optional) * 🌟 Particle effects (optional) * 💀 The head disappears after placement --- ## 🤔 Why SoulLock? * 🧠 Adds strategy to survival gameplay * 🤝 Encourages teamwork and cooperation * ⚔️ Makes PvP more intense * 🧭 Turns death into a mission --- ## ⚙️ Configuration ```yml revive-mode: SPECTATOR lightning-effect: true particle-effect: true prevent-head-despawn: true ``` --- ## 🛠️ Installation 1. Download the plugin `.jar` 2. Place it in `/plugins/` 3. Start your server 4. Edit `/plugins/SoulLock/config.yml` **Requirements:** * Paper 1.21+ * Java 21+ --- ## 💬 Commands ### Admin Commands ``` /soullockadmin unlock <player|uuid> ``` **Permission:** `soullock.admin` --- ## 📊 Data Storage * Stored in `/plugins/SoulLock/data.yml` * Automatically saved * Persistent across restarts --- ## 🎯 Perfect For * 🏰 Survival servers * 💀 Hardcore gameplay * ⚔️ PvP challenges * 🎭 Roleplay servers --- ## 📦 Version Info * Version: 1.0 * Minecraft: 1.21+ * Platform: Paper --- ## 📸 Screenshots (Coming Soon) * Player head drop on death * Revival lightning effect * Spectator gameplay --- ## 💀 Made by Slimeey Studios Enjoy the soul-locking experience ✨