PlayerHeadBlock

❌ Problem
Do you use custom items made from player heads on your server?

Cosmetics? Quest items? Collectibles?

Then you already know the problem:

Players put them on as hats.
Textures break immersion.
Custom items turn into goofy helmets.
Roleplay and aesthetics suffer.

You don’t want to remove player heads entirely.
You just don’t want them worn.

✅ Solution

PlayerHeadBlock does one thing — and does it perfectly.
This lightweight utility plugin completely prevents players from equipping player heads as helmets, while still allowing them to be placed as decorative blocks.

No commands.
No lag.
No conflicts.
Just clean, enforced behavior.

✨ Key Features
Blocks ALL Head-Equipping Methods
PlayerHeadBlock intercepts every possible way players try to equip heads:

• ❌ Right-click auto-equip
• ❌ Clicking heads into helmet slot
• ❌ Shift-click auto-equip
• ❌ Dragging into helmet slot
• ❌ Number-key hotbar swapping

If it can be abused — it’s blocked.

Still Allows Decorative Placement

Players can still place player heads as blocks
✔ Sneak + click on a block = decoration allowed
✔ Perfect for builds, maps, and aesthetics

Fully Customizable Messages (MiniMessage)
Uses Kyori MiniMessage for rich formatting:

• Colors
• Gradients
• Bold / underline
• Fully multilingual

Default:

messages:
blocked: "<bold><red>You cannot wear player heads!"

Permission-Based Bypass
Want staff or VIPs to wear heads?

✔ Permission support included:

playerheadblock.bypass

Grant it to:

• Admins
• Staff
• Donators
• Special roles

⚡ Performance & Design

• Ultra-lightweight (6.7 KB shaded JAR)
  
  
• Event-driven only — no commands, no schedulers
  
  
• Uses EventPriority.LOWEST to block exploits early
  
  
• ♻️ Respects cancelled events and other plugins

Set it once. Forget it exists.

️ Technical Details
Server Compatibility
Supported:

• ✅ Paper 1.18.2+ (Primary target)
• ✅ Purpur 1.18.2+
• ✅ Pufferfish 1.18.2+
• ✅ Spigot 1.18.2+ (uses Paper Adventure API)

Not Supported:

• ❌ BungeeCord / Velocity (not a proxy plugin)
• ❌ Pre-1.18.2 servers
• ❌ Vanilla Spigot <1.16.5

API & Build Info

• api-version: 1.18
• Compiled against: Paper 1.18.2-R0.1-SNAPSHOT
• Java: 17+
• Adventure API: Included by default in Paper/Purpur
• No deprecated methods used

Version Range

• Minimum: 1.18.2
• Maximum: 1.21.x+ (future-proof)

Uses only stable Bukkit/Paper APIs:

• PlayerInteractEvent
• InventoryClickEvent
• InventoryDragEvent
• Material.PLAYER_HEAD

Tested & Production-Ready
✔ Running flawlessly on Paper 1.21.11
✔ Zero configuration required to get started

Why Choose PlayerHeadBlock?
Because:

• You use player heads for items, not hats
• You care about immersion and control
• You want a clean, focused plugin
• You don’t want a bloated “all-in-one” solution

This plugin does exactly what it promises — nothing more, nothing less.

Install it. Configure once. Never worry about player head helmets again.