Headsteal

Important Stuff for Server Owners

Default Recipie (can be changed):

Default config

========================================================================================================

What do {PLAYER_DEAD}, {PLAYER_KILLER} etc. mean?

These are placeholders — the plugin automatically replaces them

with real player names when the message is sent. You don't need

to change them, just keep them in the message wherever you want

that name to appear.

#

{PLAYER_DEAD} -> the player who died

{PLAYER_KILLER} -> the player who got the kill

{PLAYER_REVIVER} -> the player who revived someone

{PLAYER} -> a player's name (used in error messages)

#

Note: {PLAYER_KILLER} and {PLAYER_REVIVER} only work when a real

player did the action. If it happened through a console/command,

those placeholders won't have anyone to fill in — that's why

there are separate "by-command" messages below for those cases.

#

You can color messages using & Bukkit color codes (&a = green, &c = red, etc.)

To turn off a message completely, set it to: ""

========================================================================================================

============================================================

Main Settings

============================================================

What happens to a player when they get eliminated?

true = they get banned from the server

false = they get put into Spectator mode (can still watch, can't play)

useBan: false

How often does dying actually count as an "elimination" (head drops + player is out)?

This is a percentage from 0 to 100.

0 = never happens

100 = happens every single time someone dies

50 = happens about 50 out of every 100 deaths (good for hardcore servers)

head-drop-percentage: 100

What happens when a player tries to craft a new head?

true = they won't be able to craft

false = they will be allowed to craft a new head

crafting-disabled: false

What happens when a player tries to rename the name on the head?

true = they will be allowed to rename the head

false = they won't be allowed to rename the head

anvil-rename-allowed: true

============================================================

Revival Item — How Players Get Brought Back

============================================================

This is the crafting recipe players need to make the item that revives someone.

Think of it like a 3x3 crafting table grid, numbered like this:

1 2 3

4 5 6

7 8 9

Put the name of the Minecraft item you want in each slot.

Use the real Minecraft item name (e.g. DIAMOND_BLOCK, NETHERITE_INGOT) —

if you misspell it, the recipe won't work.

HeadRecipe:
1: "DIAMOND_BLOCK"
2: "NETHERITE_INGOT"
3: "DIAMOND_BLOCK"
4: "NETHERITE_INGOT"
5: "TOTEM_OF_UNDYING"
6: "NETHERITE_INGOT"
7: "DIAMOND_BLOCK"
8: "NETHERITE_INGOT"
9: "DIAMOND_BLOCK"

============================================================

Visual Effects

============================================================

Show the golden Totem of Undying sparkle effect on the player being brought back to life.

show-totem: true

Show the same sparkle effect on the player who is doing the reviving.

show-totem-reviver: true

============================================================

Commands That Run When a Player Dies

============================================================

Turn on/off running extra server commands automatically when a player dies.

Note: this only works if a player killed them — not if they died from /kill or other commands.

enable-actions-on-death: true

The list of commands to run when someone dies (only if enable-actions-on-death is true above).

These run as if typed by console/server, so make sure they're valid commands for your server.

actions-on-death:

• "eco give {PLAYER_KILLER} 100"
• "eco take {PLAYER_DEAD} 100"

============================================================

Messages — When Someone Is Eliminated

============================================================

Message shown to everyone when one player kills another.

kill-message: "&c[HeadSteal]: {PLAYER_DEAD} is killed by {PLAYER_KILLER} !!"

Message shown when a player is eliminated by a command instead of another player.

{PLAYER_KILLER} is NOT available here — there's no player to credit.

kill-by-command-message: "&c[HeadSteal]: {PLAYER_DEAD} is killed"

============================================================

Messages — When Someone Is Revived

============================================================

Message shown to everyone when one player revives another.

revive-message: "&a[HeadSteal]: {PLAYER_DEAD} is revived by {PLAYER_REVIVER} !!"

Message shown when a player is revived by a command instead of another player.

{PLAYER_REVIVER} is NOT available here — there's no player to credit.

revive-by-command-message: "&a[HeadSteal]: {PLAYER_DEAD} is revived"

============================================================

Messages — Ban/Kick Screen (only matters if useBan is true above)

============================================================

Message a player sees on their kick screen when they get banned.

kick-message: "&c[HeadSteal]: {PLAYER_KILLER} killed you !!"

Same message, but used when used command instead of another player.

{PLAYER_KILLER} is NOT available here — there's no player to credit.

kick-by-command-message: "&c[HeadSteal]: You are killed !!"

============================================================

Messages — When a Player Gets Lucky (the elimination chance didn't trigger)

============================================================

Message sent to the player who died but got lucky and wasn't actually eliminated.

killed-player-escaped-percentage: "&a[HeadSteal]: You got lucky and escaped death !!"

Message sent to the killer, letting them know their kill didn't trigger an elimination this time.

killer-failed-percentage: "&c[HeadSteal]: {PLAYER_DEAD} escaped death !!"

Message shown to the whole server when someone gets lucky and avoids elimination.

escape-broadcast-percentage: "&6[HeadSteal]: {PLAYER_DEAD} got lucky and escaped {PLAYER_KILLER}'s killing attempt !!"

============================================================

Messages — Errors / Things That Went Wrong

============================================================

Shown when someone tries to use a command on a player who has never joined this server.

player-never-played: "&c[HeadSteal]: {PLAYER} Has Never Played on this server !!"

Shown when someone tries to "revive" a player who isn't actually eliminated.

player-not-eliminated: "&c[HeadSteal]: {PLAYER} is not dead yet !!"

Shown when someone tries to eliminate a player who is already eliminated.

player-already-eliminated: "&c[HeadSteal]: {PLAYER} already eliminated !!"

Shown to an eliminated player if they try to rejoin the server (only matters if useBan is true).

player-still-eliminated: "&c[HeadSteal]: You are still eliminated !"

============================================================

Messages — Other

============================================================

Shown when a player tries to place a head that doesn't have a valid player name attached to it.

name-on-head-notvalid: "&c[HeadSteal]: Name on Head Not Valid !!"

Shown when a head item is broken/corrupted and can't be used anymore.

head-broken-cant-be-fixed: "&c[HeadSteal]: This head is broken and cant be fixed !!"

Shown to staff/admins who are allowed to bypass elimination and join even while eliminated.

admin-join-override: "&a[HeadSteal]: You are still eliminated but joined with admin override"

Shown when an eliminated player tries to teleport (since they shouldn't be able to move around).

not-allowed-to-tp-after-death: "&c[HeadSteal]: Not allowed to Teleport after Death"

Shown when a player tries to use a command they don't have permission for.

no-permission: "&c[HeadSteal]: You don't have permission !!"

============================================================

Messages — Crafting / Anvil Messages

============================================================

Shown to a player when they try to craft a new head but crafting is disabled.

crafting-disabled-message: "&c[HeadSteal]: Head Crafting is disabled in the server !"

Shown to a player when they try to rename the head but renaming is disabled.

anvil-rename-disabled-message: "&c[HeadSteal]: Head Renaming is disabled in the server !"

Try out my other plugin:
NightVisionPlusPlus - The most customizible/brandable nightvision plugin

Headsteal

The PvP twist your anarchy server has been missing.

What is Headsteal?

Headsteal is a new game mechanic for Minecraft anarchy servers that adds an extra layer of challenge and excitement to PvP encounters.
When a player is killed, their head drops as loot. If another player picks it up, the victim is banned from the server until the head is placed back down.

Why you'll love Headsteal

• PvP with real stakes: Lose your head and you're out.
• Team up to save your friends: Work together to bring back banned buddies.
• Keeps things interesting: You never know who will be banned next.

✨ Features

• Ban or Spectator: Configurable, so victims can be put in Spectator instead of banned.
• 100% customizable messages: Change every message in the config.
• Works everywhere: Spigot, Paper, Purpur, etc., from 1.8 to 26.1+.

🛠️ Commands & 🔒 Permissions

Command · Description · Permission Node · Note
/hrevive  · revive someone · headsteal.revive · Permission or operator needed
/heliminate  · eliminate someone · headsteal.eliminate · Permission or operator needed
/hreload · Reload the configuration · headsteal.reload · Permission or operator needed

• · Bypass ban and join · headsteal.eliminate.bypass · Permission or operator needed

headsteal.admin is a special permission node that has all four permissions

Get Headsteal today and make your anarchy server the best!