NyxHeads

📖About NyxHeads

💀 NyxHeads

A hardcore-style revival system for Paper servers where player lives are tied directly to their heads.

⚔️ Features

🗡️ Player Kill System

Only player-versus-player kills count.

If a player is killed by another player:

💀 The victim's player head drops.
🔨 The victim is instantly banned.
🎒 The killer can collect and carry the head.

The following do NOT trigger the system:

Fall damage
Lava
Fire
Drowning
Suffocation
Void damage
TNT
Creepers
Mobs
Environmental damage
Commands
Any non-player death source

❤️ Revival System

Every dropped head is linked to the player who died.

When a revival head is placed:

✨ The head is consumed.
🔓 The banned player is automatically unbanned.
⚡ The player is revived instantly.
📍 The player is teleported to the exact location where the head was placed.

🛡️ Head Protection

Revival heads are protected from storage and abuse.

Heads cannot be placed inside:

Ender Chests
Chests
Trapped Chests
Barrels
Shulker Boxes
Hoppers
Droppers
Dispensers
Furnaces
Bundles
Item Frames
Glow Item Frames
Container Minecarts
Any other storage container

Heads may only:

🎒 Exist in a player's inventory
📦 Exist as a dropped item
❤️ Be placed for revival

⚙️ Administration

Commands:

/nyxheads
/nyxheads reload
/nyxheads status
/nyxheads headsplugin enable
/nyxheads headsplugin disable
/nyxheads revive <player>
/nyxheads unban <player>

🔑 Permissions

nyxheads.admin
nyxheads.reload
nyxheads.revive
nyxheads.unban

🔧 Configuration

Configurable options include:

Plugin enable/disable
Death broadcasts
Revival broadcasts
Save intervals
Custom messages

Supports MiniMessage formatting.

📦 Compatibility

Paper 1.21.x
Java 21

📝 Notes

💾 Data persists through server restarts.
🎭 Revival heads are tied to specific players.
🔒 Designed to prevent duplication glitches and storage exploits.
🌎 Perfect for SMPs, Hardcore, Factions, and PvP-focused servers.

🔥 Bring real consequences to PvP and make every head matter.