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 ✨