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

Hat Command

highly configurable /hat command

96
1

Compatibility

Minecraft: Java Edition

1.21–1.21.6

Platforms

Host your next server with Modrinth Servers

Links

Report issues View source Join Discord server

Creators

STIK
STIK Organization

Details

Licensed GPL-3.0-only
Published last month
Updated 2 months ago

HatCommand - Highly Configurable Hat Plugin

HatCommand is a customizable Minecraft plugin that adds a /hat command, allowing players to wear blocks on their head with adjustable mechanics.

Join our Discord — discover other cool plugins, suggest new features, or get help with configuration.

Features ✨

  • Instant Block Hats
    • Wear any block you’re holding as a helmet
    • Optional whitelist of permitted materials
  • Cooldown Control
    • Configurable cooldown in milliseconds
    • Prevents spammy hat changes
  • Permission System
    • Separate perms for using vs. reloading
    • Keeps your server secure
  • Easy Reload
    • /hat reload to apply config changes on the fly

Main config (config.yml) ⚙️

config.yml 
# Join our discord - https://discord.gg/YGzA4UxzFB you can find another good plugins there.
# Permissions
# "hat.use"    - permission required to use "/hat" command
# "hat.reload" - permission required to use "/hat reload" command

# cooldown in milliseconds for "/hat" command
cooldown: 5000

# if enabled: true, "/hat" will work only with permitted materials
materialsEnabled: false
# materials that can be used in "/hat" command
materials:
    - GLASS
    - STONE
    - IRON_BLOCK

Messages Config (messages.yml)

messages.yml 
notPlayer:          "<red>✘ <white>Only players can use this command!"
noPermission:       "<red>✘ <white>You don't have permission!"
noItem:             "<red>✘ <white>You're not holding any item!"
needOneItem:        "<red>✘ <white>You must hold exactly 1 item!"
wrongMaterial:      "<red>✘ <white>You can't use this material!"

# %cooldown% will be replaced with actual cooldown
cooldown:           "<red>✘ <white>You must wait %cooldown%s before using this command again!"
successful:         "<green>✔ <white>You placed the item on your head!"

noPermissionToReload: "<red>✘ <white>You don't have permission!"
configReloaded:       "<green>✔ <white>Config reloaded!"

Permissions 🔐

Permission Node Description
hat.use Basic /hat command access
hat.reload Permission to reload config

Commands 📟

Command Description
/hat Wear the block you’re holding
/hat reload Reload the plugin config