# 💀 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 ✨
