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.

---