FancyHat is not just another simple script. It's a high-performance, asynchronous plugin designed for modern Minecraft servers. Offer your players a stylish way to wear any item as a hat with zero impact on your TPS.
&#rrggbb) for that premium feel.| Command | Description |
|---|---|
/hat |
Equips the held item as a stylish hat. |
/fhat discord |
Displays the official support community link. |
| Command | Description |
|---|---|
/fhat hat [player] |
Forces a hat onto the specified player's head. |
/fhat reload |
Instantly reloads all configurations and 14+ language files. |
/fhat update |
Manually checks Modrinth for the latest releases. |
| Permission | Description | Default |
|---|---|---|
fancyhat.player.hat |
Use /hat and self-target /fhat hat. |
Everyone |
fancyhat.player.discord |
Access to the Discord command. | Everyone |
fancyhat.admin.hat |
Put hats on other players. | OP |
fancyhat.admin.reload |
Reload the plugin settings. | OP |
fancyhat.admin.update |
Check for updates and receive join alerts. | OP |
FancyHat gives you full control over sounds, blacklists, and languages.
View config.yml
# ========================================== #
# FANCYHAT #
# Created by xFeneq (c) 2026 #
# ========================================== #
# The language file to use from the "/languages" folder.
# Available languages:
# - en-US - English (English)
# - pl-PL - Polish (Polski)
# - de-DE - German (Deutsch)
# - es-ES - Spanish (Español)
# - fr-FR - French (Français)
# - uk-UA - Ukrainian (Українська)
# - it-IT - Italian (Italiano)
# - pt-BR - Portuguese (Português)
# - ru-RU - Russian (Русский)
# - zh-CN - Chinese (中文)
# - nl-NL - Dutch (Nederlands)
# - tr-TR - Turkish (Türkçe)
# - ja-JP - Japanese (日本語)
# - cs-CZ - Czech (Čeština)
language: "en-US"
# Plugin prefix used before messages.
# Supports HEX colors (Birdflop format: &#rrggbb) -> Generator: https://www.birdflop.com/resources/rgb/
prefix: "ɣC1BꜰF3826ʜ	C5432ᴀ&#BA703Dᴛ &#D78C48» "
# ========================================== #
# HAT SETTINGS #
# ========================================== #
settings:
# If true, current helmet will be moved back to player's inventory.
smart-item-swap: true
# If inventory is full, the old helmet will be dropped on the ground.
drop-items-if-full: true
# Automatically check for updates on Modrinth.
update-checker: true
# List of items that cannot be used as a hat.
# You can find all valid Minecraft material names here:
# https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
# Use exactly as written (e.g., "DIAMOND_BLOCK").
blacklist:
- "BEDROCK"
- "BARRIER"
- "COMMAND_BLOCK"
# ========================================== #
# SOUND EFFECTS #
# ========================================== #
# Configure sounds for specific actions. Set name to "NONE" to disable.
# Sound List: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
sounds:
success:
name: "ENTITY_PLAYER_LEVELUP"
volume: 1.0
pitch: 1.0
error:
name: "ENTITY_VILLAGER_NO"
volume: 1.0
pitch: 1.0
# ========================================== #
# COMMAND SETTINGS #
# ========================================== #
# Enable or disable specific commands and add custom aliases.
# NOTE: Changes to aliases require a SERVER RESTART!
# Example of adding an alias: aliases: ["head", "fh"]
commands:
hat:
enabled: true
aliases: []
fhat:
enabled: true
aliases: []
# ========================================== #
# PLACEHOLDERS REFERENCE #
# ========================================== #
# Use these variables in your language files (e.g., en-US.yml):
# ${player} - Name of the person who executed the command
# ${target} - Name of the target player (for admin commands)
