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

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