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

Hat Command

Highly Configurable /hat command!

40
0
40
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.