Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for SlimeeyStudios

A Paper plugin that locks player souls on death and revives them when their head is placed.

Report 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


๐Ÿ’€ Made by Slimeey Studios

Enjoy the soul-locking experience โœจ

Information

CategoryGameplay
Published onApril 1, 2026
LicenseMIT
Download1
Stars1
Watchers1
Addon

Pinned Versions

Members