Simple Player Heads

Simple Player Heads

Customize when player heads drop — on death, on kill, or only when the killer used a
Looting weapon.

Features

• Customizable drops: choose whether a head drops on self‑kill, on a kill by another
  player, and on all other deaths.
• Looting‑based drops: optionally make a player‑kill head drop depend on the killer's
  Looting level, with a separate drop chance per level (none / I / II / III).
• In‑game config screen (Fabric): edit everything from the Mod Menu screen. Uses
  YACL on 1.20+ or Cloth Config
  on 1.18–1.19 — optional, not bundled; the file config works without it.
• Works with pirate mode and other skin‑changing mods.

Dependencies (Fabric mod)

• Fabric API
• Fabric Language Kotlin

Optional (for the in‑game config screen): Mod Menu
plus YACL (1.20+) or Cloth Config (1.18–1.19).

The server plugin has no dependencies.

Configuration

Fabric config file: config/simple-player-heads.toml. The plugin uses
plugins/SimplePlayerHeads/config.yml with the same options.

selfKill = true
playerKill = true
otherDeaths = true

[playerKillLooting]
enabled = false
noLooting = 0.0
looting1 = 0.33
looting2 = 0.67
looting3 = 1.0

Options:

• selfKill — head drops on self‑kill.
• playerKill — head drops when killed by another player.
• otherDeaths — head drops on all other deaths.
• playerKillLooting.enabled — when true, a player‑kill head drop uses the per‑Looting
  chances below instead of always dropping. Requires playerKill = true.
• playerKillLooting.noLooting / looting1 / looting2 / looting3 — drop chance
  (0.0–1.0) when the killer's weapon has no Looting / Looting I / II / III. Looting
  above III uses looting3. Example: noLooting = 0.0, looting3 = 1.0 → a head drops
  only when the killer used a Looting III weapon.

Defaults keep the classic behavior: enabled = false means heads always drop on a
player kill (the Looting chances only apply once you turn it on).

Installation

Fabric mod: download the latest jar and drop it in your mods folder (needs Fabric
API + Fabric Language Kotlin). For the in‑game config screen, also install Mod Menu and
YACL (1.20+) or Cloth Config (1.18–1.19).

Server plugin: download the Bukkit/Paper jar (filter by the Bukkit / Paper / Folia
loaders) and drop it in your server's plugins folder. Edit the config and restart or
reload to apply.