# \ud83d\udcdd HeadGear \u2013 The Ultimate Custom Headgear Plugin!<\/p>\n
## \ud83d\udd39 Description:<\/p>\n
HeadGear is a lightweight yet powerful Minecraft Spigot\/Paper plugin that allows any item to be worn on a player’s head! But that’s not all\u2014each headgear item can apply custom effects, grant extra hearts, introduce configurable cooldowns, and create unique gameplay mechanics. Perfect for RPG, Survival, and Minigame servers!<\/p>\n
## \ud83d\udd17 Links:<\/p>\n
* \ud83d\udcac Support & Updates: [Discord]<\/p>\n
## \u26a1 Features:<\/p>\n
* \u2705 **Wear Any Item on Your Head!** (Not just helmets!)
\n* \u2705 **Apply Custom Effects** (Speed, Strength, Night Vision, and more!)
\n* \u2705 **Grant Extra Hearts!** (Configurable per item)
\n* \u2705 **Two Cooldown Systems:**<\/p>\n
> * **Prevention Cooldown \u23f3 (Prevents instant re-equipping)**
\n > * **Post-Effect Cooldown \ud83d\udd04 (Starts after the effect ends)**
\n* \u2705 **Fully Configurable Cooldowns and Heart Bonuses per Item**
\n* \u2705 **Blacklist Certain Items** (Prevent OP items from being used!)
\n* \u2705 **Customizable Messages** (Change messages in config.yml)
\n* \u2705 **Supports Minecraft 1.8 to 1.21.7**<\/p>\n
## \u2699 How to Use:<\/p>\n
1\ufe0f\u20e3 Drop the plugin into your **\/plugins\/** folder.<\/p>\n
2\ufe0f\u20e3 Restart your server.<\/p>\n
3\ufe0f\u20e3 Edit **config.yml** and **items.yml** to customize cooldowns, effects, extra hearts, and messages!<\/p>\n
4\ufe0f\u20e3 Enjoy custom headgear with awesome effects and unique gameplay!<\/p>\n
## \ud83d\udcc2 Configuration:<\/p>\n
* **Config.yml** \u2013 Set default cooldowns, messages, blacklist items, and heart bonuses.
\n* **Items.yml** \u2013 Define which items can be worn and what effects and heart boosts they apply.<\/p>\n
## \ud83d\udccc Commands & Permissions:<\/p>\n
\ud83d\udd39 **No Commands Required!** The plugin works automatically.<\/p>\n
\ud83d\udd39 **Permissions:**<\/p>\n
“`java
\nPermission\tDescription\tDefault
\nheadgear.use\tAllows players to wear custom headgear\ttrue
\n“`<\/p>\n
## \ud83c\udfae Why Use HeadGear?<\/p>\n
* \u2714 Lightweight & Lag-Free
\n* \u2714 Easy to Use
\n* \u2714 Works with Any Item!
\n* \u2714 Custom Heart Bonuses
\n* \u2714 Perfect for RPG & Custom Survival Servers<\/p>\n
### \ud83d\udc45 Download v4.0 Now & Customize Your Server Like Never Before! \ud83d\ude80<\/p>\n","protected":false},"excerpt":{"rendered":"
Unlock Your Imagination: Wear Any Item, Anywhere with HeadGear!<\/p>\n","protected":false},"featured_media":79928,"template":"","meta":{"_minecraft_slug":"headgear","_minecraft_project_id":"WisKr5S3","_minecraft_author":"Mejbha","_minecraft_license":"MIT","_minecraft_downloads":435,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"headgear.zip","_minecraft_size_bytes":33252,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T10:50:42.297572Z","_minecraft_date_created":"2025-03-15T09:16:52.639033Z","_minecraft_date_modified":"2025-07-10T15:06:25.777029Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/headgear","_minecraft_icon_attachment_id":79928,"_minecraft_imported_at":"2026-06-04T14:33:11+00:00","_minecraft_import_hash":"d4610f21fb98b6abbca0ee6f677cad37","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,88,89,122,866,127,128,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-79927","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-equipment","mod_category-game-mechanics","mod_category-magic","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n