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 revival-based mechanic that transforms Minecraft’s death system into a revival-based mechanic.

Instead of respawning normally:

* 💀 Players become head drops at death location * 🪦 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 one active head per player * 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 ✨