# HatPlugin<\/p>\n
Turn anything into your hat \u2013 instantly.<\/p>\n
Made By Pingz0<\/p>\n
A lightweight, optimized **Paper 1.21+ plugin** that lets players wear any item as a helmet with a single command. Built for performance, simplicity, and customization.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
* \ud83c\udfaf **\/hat Command**
\n Instantly equip the item in your hand as your helmet<\/p>\n
* \ud83d\udd04 **Smart Item Swapping**
\n Automatically swaps your current helmet with the item in your hand<\/p>\n
* \u23f1 **Configurable Cooldown**
\n Prevent spam with a customizable cooldown system<\/p>\n
* \ud83d\udd0a **Custom Sounds**
\n Play different sounds for success and failure<\/p>\n
* \ud83d\udcac **Fully Customizable Messages**
\n Supports color codes (`&a`, `&c`, etc.)<\/p>\n
* \u26a1 **Actionbar Feedback**
\n Clean, modern UI feedback instead of chat spam<\/p>\n
* \ud83d\udd01 **Live Config Reload**
\n Reload config instantly with `\/hat reload`<\/p>\n
* \ud83d\udee1 **Permission System**<\/p>\n
* `hat.use` \u2192 Use \/hat
\n * `hat.reload` \u2192 Reload config<\/p>\n
* \ud83d\ude80 **Lightweight & Optimized**
\n No unnecessary listeners, minimal performance impact<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download the latest release
\n2. Place the `.jar` file into your `\/plugins\/` folder
\n3. Start your server
\n4. Done \u2705<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
Located at:<\/p>\n
“`
\n\/plugins\/HatPlugin\/config.yml
\n“`<\/p>\n
### Example:<\/p>\n
“`yaml
\n# Cooldown between using \/hat (seconds)
\ncooldown: 1<\/p>\n
# Message on success
\nmessage: “&aNow wearing your item as a hat!”<\/p>\n
# Message on failure (no item in hand)
\nfailmessage: “&cYou need to hold an item!”<\/p>\n
# Sound on failure
\nfailsound: “ENTITY.VILLAGER.NO”<\/p>\n
# Sound on success
\nsound: “ITEM_ARMOR_EQUIP_GENERIC”
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udcdc Commands<\/p>\n
| Command | Description | Permission |
\n| ————- | ——————– | ———— |
\n| `\/hat` | Equip item as helmet | `hat.use` |
\n| `\/hat reload` | Reload config | `hat.reload` |<\/p>\n
—<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
| Permission | Default | Description |
\n| ———— | ——- | ——————– |
\n| `hat.use` | true | Use the \/hat command |
\n| `hat.reload` | op | Reload the config |<\/p>\n
—<\/p>\n
## \ud83c\udfae How it works<\/p>\n
* Hold any item in your hand
\n* Run `\/hat`
\n* Your item becomes your helmet
\n* If you already have a helmet \u2192 it swaps automatically<\/p>\n
—<\/p>\n
## \u26a1 Compatibility<\/p>\n
* \u2705 Paper 1.21+
\n* \u274c Spigot (not recommended)
\n* \u274c Bukkit (not supported)<\/p>\n
—<\/p>\n
## \ud83e\udde0 Technical Notes<\/p>\n
* Uses **Paper API** for best performance
\n* Safe sound parsing (prevents crashes from invalid config values)
\n* Optimized cooldown handling per player
\n* Clean code structure for easy expansion<\/p>\n
—<\/p>\n
## \ud83d\udd25 Planned Features<\/p>\n
* [ ] Blacklist certain items (e.g. shulker boxes)
\n* [ ] Per-world settings
\n* [ ] GUI-based hat selector
\n* [ ] Particle effects<\/p>\n
—<\/p>\n
## \ud83d\udcac Support<\/p>\n
If you find bugs or want new features:<\/p>\n
* Open an issue
\n* Or contact the developer<\/p>\n
—<\/p>\n
## \ud83d\udcc4 License<\/p>\n
This project is licensed under the MIT License.<\/p>\n","protected":false},"excerpt":{"rendered":"
Highly Configurable \/hat command!<\/p>\n","protected":false},"featured_media":121519,"template":"","meta":{"_minecraft_slug":"pingz-hatcommand","_minecraft_project_id":"Q8net0B4","_minecraft_author":"pingz0","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":15,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pingz-hatcommand.zip","_minecraft_size_bytes":5937,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:49:19.170539Z","_minecraft_date_created":"2026-03-28T00:15:34.147583Z","_minecraft_date_modified":"2026-03-27T21:21:11.862452Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pingz-hatcommand","_minecraft_icon_attachment_id":121519,"_minecraft_imported_at":"2026-06-07T03:28:44+00:00","_minecraft_import_hash":"f65ace82ecf11b56376bd63bec357325","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,88,122,127,129],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-121518","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-equipment","mod_category-magic","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","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"],"yoast_head":"\n