💀 PlayerSkulls

Collect the skulls of players you defeat — and show off your trophies.

PlayerSkulls is a lightweight yet powerful Paper/Spigot plugin that adds skull collection mechanics to your server. Drop chances, messages, permissions — everything is controlled through a single config.yml.

---

✨ Features

Feature	Description
🪦 Skull drop on kill	Players automatically receive the skull of whoever they eliminated. Drop chance is fully configurable (0–100%).
🔌 Admin commands	Give any skull manually, distribute them to all online players at once, or reload the config live — no restart needed.
📊 Collection stats	Track which skulls each player has collected and view them with /playerskulls stats.
🚫 Blocklist	Prevent specific players (e.g. OPs) from having their skull dropped or given out.
💬 PlaceholderAPI	Optional support for PAPI placeholders in all messages (%player%, %killer%, %server_online%, …).
⚙️ Fully configurable	Every message, permission node, and behavior is defined in config.yml. No hardcoded values.

---

🔑 Commands & Permissions

Command	Permission	Default
/playerskulls admin give <Player>	playerskulls.admin.give	OP
/playerskulls admin giveall	playerskulls.admin.giveall	OP
/playerskulls reload	playerskulls.admin.reload	OP
/playerskulls stats [Player]	playerskulls.use	ALL

---

⚙️ Configuration

# ── Skull Drop ─────────────────────────────────────
drop-chance: 1.0    # 1.0 = 100%, 0.5 = 50%

# ── Messages ───────────────────────────────────────
messages:
  got-skull:        "You received the skull of %player%!"
  no-permission:    "You do not have permission for this!"
  skull-given:      "You have been given the skull of %player% (Admin)."
  skull-given-all:  "All online players have received a skull!"
  reload-success:   "Config successfully reloaded."

# ── Blocked Players ────────────────────────────────
blocked-players:
  - Notch
  - Herobrine

# ── Skull Collection ───────────────────────────────
track-skulls: true   # Track which skulls a player has collected

💡 PlaceholderAPI is optional. Without it, the plugin works perfectly — placeholders will just appear as plain text in messages.

---

🔧 Compatibility

• Paper 1.21+
• Spigot 1.21+
• Java 17+
• PlaceholderAPI (optional)