💀 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

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 ✨