Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details

π HeadGear β Hats with Real Powers
Turn helmets, mob heads, blocks and custom skulls into cosmetic crowns with potion effects, extra hearts and animated particle halos.
Built for modern Paper / Purpur / Spigot 1.20+ β 26.3 on Java 21+. Vault is optional β the shop works out of the box with item barter and XP.
π Why HeadGear?

- π Hybrid Mode β Survival mob heads always work. Plain swords and armor are protected, so players never accidentally burn their valuable gear.
- π Anti-Exploit Curse of Binding β Burst hats are locked while active. No taking them off mid-fight to reset timers or cooldowns.
- β³ Burst & Passive Modes β Short adrenaline bursts that can crumble to dust, or lasting passive powers balanced by durability drain.
- π In-Game Shop β A fully configurable 54-slot GUI paid in Vault money, items (Emerald, Diamond, Gold, Netheriteβ¦) or XP levels.
- π¨ 5 Particle Styles β Halo, Crown, Spiral, Aura and Trail.
- π Custom Textured Heads β Base64 skin support for Warden, Enderman, Blaze and any player skin.
- β€οΈ Extra Hearts β Heal instantly on equip, retract safely on removal.
π¨ Animated Particle Crowns

| Style | Look |
|---|---|
HALO |
Rotating ring above the head |
CROWN |
Five-point spiked tiara with a wave motion |
SPIRAL |
Double vertical helix |
AURA |
Ambient cloud around the head |
TRAIL |
Particles left behind as you move |
π Hat Wardrobe GUI

Open with /hats or /headgear menu. Live status on every hat: Equipped, On Cooldown, Locked or Click to Equip. One-click unequip and a shortcut to the shop.
π 16 Ready-to-Use Items

Mob heads (Creeper, Zombie, Skeleton, Wither Skeleton, Dragon, Piglin), custom skins (Warden, Enderman, Blaze) and special gear (Diamond Sword, Golden Apple, Netherite Chestplate, Blaze Rod, Sea Lantern, Bow, Compass). Everything is editable β add your own in items.yml.
The Warden Head alone grants +6 hearts (12 HP) with Resistance II and Night Vision.
π° Flexible Economy

Vault is a soft dependency: without it, players pay with items or XP levels.
β¨οΈ Commands & Permissions
| Command | Description | Permission |
|---|---|---|
/headgear menu (/hats) |
Open the Hat Wardrobe | headgear.menu |
/headgear shop (/hatshop) |
Open the HeadGear Shop | headgear.shop |
/headgear wear (/hat) |
Wear the item in your hand | headgear.hat |
/headgear unequip |
Take off your headgear | headgear.use |
/headgear list |
List all headgear items | headgear.use |
/headgear give <player> <item> [amount] |
Give a headgear item | headgear.admin |
/headgear reload |
Reload all configs | headgear.admin |
βοΈ Easy Configuration
Add a custom hat in a few lines of items.yml:
my_custom_crown:
material: GOLDEN_HELMET
name: "&#FFD700&lImperial Crown"
mode: PASSIVE
max-durability: 500
health-boost: 4
effects:
- type: REGENERATION
level: 2
particle:
type: TOTEM_OF_UNDYING
style: CROWN
Toggle effects, health boost, particles, sounds, the shop, hybrid mode, binding and durability in config.yml.
π¦ Installation
- Download the latest
HeadGear.jar. - Place it in your
plugins/folder. - Restart the server.
- Edit
config.yml,items.ymlandshop.ymlinplugins/HeadGear/.
β FAQ
Can I run it without Vault? Yes β item barter and XP work standalone.
Why doesn't my crafted Diamond Sword give effects? Hybrid Mode protects normal gear. Use /headgear give, the shop, or the wardrobe.
How do crate plugins give hats? Run headgear give <player> <item_key> [amount] from console.
β Enjoying HeadGear? Leave a review and share feedback!


