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

Drops player heads with skin on death. Configurable chance, PvP-only, cooldown, custom names, Looting bonus, economy.

Report PlayerHeadDrops?

PlayerHeadDrops Banner

Version Minecraft Platform Java

Modrinth Side Telegram

When a player dies, their head drops — complete with their skin. Everything else is configurable down to the smallest detail.


Features

  • Skin preservation — textures are embedded into the item, so skins survive server restarts.

  • Drop chance — from 0% to 100%, plus Looting and permission bonuses.

  • One-time drop mode — each player's head can drop only once. Data persists across restarts.

  • Cooldown — a specific player's head won't drop again until the configured time passes.

  • PvP-only mode — heads drop only when killed by another player. Mobs, suicide, and /kill don't count.

  • Drop to inventory — send the head directly to the killer's inventory instead of the ground.

  • Anti-farm — ignore suicide, void deaths, and self-kills.

  • World control — blacklist or whitelist worlds.

  • Custom name and lore — format, color, italic, lore with MiniMessage and placeholders support (%player%, %killer%, %world%, %date%, %time%).

  • Mob heads — vanilla mob heads (ZOMBIE, SKELETON, CREEPER, WITHER_SKELETON, PIGLIN, ENDER_DRAGON) with separate chances.

  • Looting bonus — each level of Looting on the killer's weapon adds to the drop chance.

  • Permission bonus — chance multiplier for players with playerheaddrops.boost permission.

  • Announcements — customizable chat message when a head drops, global or radius-based.

  • Economy (Vault) — reward the killer for each head drop.

  • Sounds and particles — accompany head drops with sound effects and particles.


Configuration

config.yml
# ─────────────────────────────────────────
#  PlayerHeadDrops v2.0.0  |  Author: Kasperoid
# ─────────────────────────────────────────

config-version: 2

drop-chance: 1.0
one-time-drop: false
cooldown-seconds: 0
only-pvp: false
drop-to-inventory: false

anti-farm:
  ignore-suicide: true
  ignore-void: false
  ignore-self-kill: true

worlds:
  mode: blacklist
  list:
    - world_the_lobby
    - creative_world

head:
  name-format: "%player%'s Head"
  name-color: yellow
  name-italic: false
  lore:
    - "<gray>Killed by: <white>%killer%</white></gray>"
    - "<gray>World: <white>%world%</white></gray>"
    - "<dark_gray>%date% %time%</dark_gray>"

mob-heads:
  enabled: false
  default-chance: 0.05
  only-player-kill: true
  name-format: ""
  chances:
    ZOMBIE: 0.05
    SKELETON: 0.05
    CREEPER: 0.05
    WITHER_SKELETON: 0.10
    PIGLIN: 0.05
    ENDER_DRAGON: 1.0

looting-boost:
  enabled: false
  per-level: 0.1

permission-boost:
  enabled: false
  multiplier: 2.0

announce:
  enabled: false
  message: "<yellow>☠ %player%'s head has dropped!</yellow>"
  radius: -1

economy:
  enabled: false
  reward: 0.0

effects:
  sound:
    enabled: false
    name: entity.player.levelup
  particles:
    enabled: false
    name: SOUL

Compatibility

Server Paper / Purpur / Bukkit / Spigot
Minecraft 1.13+
Java 8+

Installation

  1. Download the latest .jar from the files tab.
  2. Place it in your server's plugins/ folder.
  3. Restart the server.
  4. Edit config.yml to your liking.
  5. Restart again to apply changes.

FAQ

Do heads survive server restarts?

Yes — the plugin uses embedded texture data, so skins are preserved forever.

Does it work with keepInventory?

Yes — the drop logic is independent of vanilla gamerules.

Can I change the head name and lore?

Yes — fully customizable in config.yml: format, color, italic, lore with MiniMessage support.

Does it support PlaceholderAPI?

Yes — in announcement messages and head lore.

How do I disable drops in certain worlds?

Use the blacklist mode in the worlds section and list the worlds.


Modrinth Telegram GitHub CurseForge Hangar


© 2026 kasperoid — All Rights Reserved

Information

Category
Gameplay
Published
August 9, 2026
License
Unspecified
8Downloads
0Stars

Pinned Versions

Members

1