🎩 HeadGear – The Ultimate Custom Headgear Plugin!

HeadGear is a lightweight yet powerful Minecraft Spigot/Paper/Purpur plugin that allows players to wear almost ANY item as headgear while gaining custom effects, bonus hearts, and unique gameplay mechanics.

Perfect for: RPG • Survival • SMP • Minigames • MMO • Custom Servers

✨ Features

✔ Wear ANY Item on Your Head
✔ Custom Potion Effects
✔ Bonus Hearts System ❤️
✔ Dual Cooldown System ⏳
✔ Item Blacklist Support 🚫
✔ Fully Configurable ⚙
✔ Lightweight & Optimized 🪶
✔ Supports 1.8 → 26.1.2 🔄

⚡ Cooldown Systems

🔒 Prevention Cooldown

Prevents players from instantly re-equipping removed headgear.

🔄 Post-Effect Cooldown

Cooldown starts AFTER the effect duration ends.

Perfect for balancing RPG and survival gameplay.

❤️ Bonus Hearts

Give players additional hearts while wearing special items.

Example:

Diamond_Helmat → +4 Hearts

Fully configurable per item.

🖱 Important Usage Information

✅ Use RIGHT CLICK to equip HeadGear

❌ LEFT CLICK will NOT activate effects

Effects and bonus hearts only work when equipped correctly using RIGHT CLICK.

⚠ Version Notice

⚠ Minecraft 1.8.x (especially 1.8.9)

Older versions may contain:

Minor effect bugs
Small visual glitches
Potion synchronization issues

These issues are caused by older Minecraft APIs and will be improved in future updates.

✅ Fully Stable Versions

Recommended & fully stable on:

🔄 1.12 to 26.1.2

📂 Configuration

⚙ Config.yml

Configure:

Messages
Cooldowns
Blacklists
Default settings

🔗 Config.yml

🧩 Items.yml

Configure:

Wearable items
Effects
Bonus hearts
Item cooldowns

🔗 Items.yml

🛡 Permission

Permission	Description	Default
`headgear.use`	Allows usage of HeadGear	`true`

HeadGear – The Ultimate Custom Headgear Plugin! (1.8-26.1.2)

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details