HeadDropDimension — Changelog

---

v2.0 — 2026-03-01

Fixed

• Skin fetching (PlayerProfile.complete()) now runs on an async thread instead of the main server thread. Previously every player head drop stalled the server while waiting on Mojang's API.
• /head <player> offline lookup (Bukkit.getOfflinePlayer()) now runs async. Previously it blocked the main thread on file I/O and potentially a Mojang UUID lookup.
• /head command now requires the headdropdimension.head permission. Previously it was accessible to every player with no restriction.
• Drop chance can no longer drift outside 0–100% from floating-point arithmetic after repeated GUI clicks.
• Plugin no longer crashes or throws a NullPointerException when a death occurs in a custom/plugin-added world. Those worlds are now silently ignored.

Added

• /headdrop reload — reloads config.yml without restarting the server. Works from console.
• Wither Skeleton skull drop support.
• headdropdimension.head.others permission — allows getting another player's head. Without it, /head is restricted to your own head only.
• Permission re-check on every GUI click. If admin permission is revoked while the GUI is open, the inventory closes immediately.
• Config validation on startup — invalid drop-chance values are clamped to [0, 100] with a console warning instead of silently misbehaving.

Changed

• Config values are now cached in memory on startup and on reload. Previously getConfig() was called 4–6 times per entity death event.
• java.util.Random replaced with ThreadLocalRandom for the drop chance roll.
• GUI inventory identification now uses a typed InventoryHolder instead of checking the inventory title string. This prevents accidental interception of other plugins' inventories.
• saveConfig() after a GUI toggle is debounced — rapid clicks batch into a single disk write after 2 seconds instead of hitting the disk on every click.
• /head now tab-completes online player names.

---

HeadDropDimension
Per-dimension configurable head drops – PvP, PvE, chance, and more!

Features • Head drops work separately in Overworld, Nether and The End
• Toggle head drops completely on/off per dimension
• Separate PvP head drops (player kills) and PvE head drops (mob/player kills by non-players)
• Adjustable drop chance (0–100%) – change in-game with GUI (steps of 5%)
• Player heads show real skins – even for offline or never-joined players (Paper recommended)
• Drops mob heads too (zombie, skeleton, creeper)
• Beautiful centered GUI with toggle buttons, back button and live refresh
• Commands:
/headdrop → open settings GUI (admin only)
/head <player> → get any player's head (supports offline/never joined)

Permissions

• headdropdimension.admin – access to GUI and /head command (default: op)

Why use it? Perfect for survival servers that want rare heads in certain dimensions only, PvP arenas with head trophies, or just fun mob farming with skull rewards.

Tested on
Paper 1.21.x (best skin support)
Spigot 1.21.x (basic name-only fallback)

Planned / possible future updates

• Wither skeleton / Ender Dragon head support
• Charged creeper requirement toggle
• Cooldown on /head command
• Per-player head drop multipliers

Feedback, bugs and suggestions welcome!
Have fun dropping heads! 💀