?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Hat Command

Hat Command

Highly Configurable /hat command!

41
0
41
0

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

View source

Tags

Creators

Details

Licensed ARR
Published 3 months ago

HatPlugin

Turn anything into your hat โ€“ instantly.

Made By Pingz0

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.

โœจ Features

  • ๐ŸŽฏ /hat Command Instantly equip the item in your hand as your helmet

  • ๐Ÿ”„ Smart Item Swapping Automatically swaps your current helmet with the item in your hand

  • โฑ Configurable Cooldown Prevent spam with a customizable cooldown system

  • ๐Ÿ”Š Custom Sounds Play different sounds for success and failure

  • ๐Ÿ’ฌ Fully Customizable Messages Supports color codes (&a, &c, etc.)

  • โšก Actionbar Feedback Clean, modern UI feedback instead of chat spam

  • ๐Ÿ” Live Config Reload Reload config instantly with /hat reload

  • ๐Ÿ›ก Permission System

    • hat.use โ†’ Use /hat
    • hat.reload โ†’ Reload config

  • ๐Ÿš€ Lightweight & Optimized No unnecessary listeners, minimal performance impact

๐Ÿ“ฆ Installation

  1. Download the latest release
  2. Place the .jar file into your /plugins/ folder
  3. Start your server
  4. Done โœ…

โš™๏ธ Configuration

Located at:

/plugins/HatPlugin/config.yml

Example:

# Cooldown between using /hat (seconds)
cooldown: 1

# Message on success
message: "&aNow wearing your item as a hat!"

# Message on failure (no item in hand)
failmessage: "&cYou need to hold an item!"

# Sound on failure
failsound: "ENTITY.VILLAGER.NO"

# Sound on success
sound: "ITEM_ARMOR_EQUIP_GENERIC"

๐Ÿ“œ Commands

Command Description Permission
/hat Equip item as helmet hat.use
/hat reload Reload config hat.reload

๐Ÿ” Permissions

Permission Default Description
hat.use true Use the /hat command
hat.reload op Reload the config

๐ŸŽฎ How it works

  • Hold any item in your hand
  • Run /hat
  • Your item becomes your helmet
  • If you already have a helmet โ†’ it swaps automatically

โšก Compatibility

  • โœ… Paper 1.21+
  • โŒ Spigot (not recommended)
  • โŒ Bukkit (not supported)

๐Ÿง  Technical Notes

  • Uses Paper API for best performance
  • Safe sound parsing (prevents crashes from invalid config values)
  • Optimized cooldown handling per player
  • Clean code structure for easy expansion

๐Ÿ”ฅ Planned Features

  • [ ] Blacklist certain items (e.g. shulker boxes)
  • [ ] Per-world settings
  • [ ] GUI-based hat selector
  • [ ] Particle effects

๐Ÿ’ฌ Support

If you find bugs or want new features:

  • Open an issue
  • Or contact the developer

๐Ÿ“„ License

This project is licensed under the MIT License.