FancyHAT

### The Ultimate Multi-Language Cosmetic Solution



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



---



## ✨ Why FancyHAT?



* ** Native Multi-Language:** Built-in support for 14 languages (EN, PL, DE, ES, FR, IT, PT, RU, ZH, NL, TR, JA, CS, UK).

* ** Dynamic Displays:** Choose how to show messages: ActionBar, Titles, or classic Chat.

* ️ Smart Inventory Guard: Sophisticated swapping logic. If the head slot is busy, the old item is safely moved to the inventory or dropped at the player's feet.

* ⚡ Asynchronous Engine: Update checks and network operations run on separate threads for a lag-free experience.

* ** HEX & RGB Ready:** Full support for modern color formats (&#rrggbb) for that premium feel.



---



## Player Commands

| Command | Description |

| :--- | :--- |

| /hat | Equips the held item as a stylish hat. |

| /fhat discord | Displays the official support community link. |



---



## ️ Admin Commands

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



---



## Permissions

| 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 |



---



## ⚙️ Advanced Configuration



FancyHat gives you full control over sounds, blacklists, and languages.



<details>

<summary><b>View config.yml (Click to expand)</b></summary>



```yaml

# ========================================== #

# 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: "&#611C1Bꜰ&#7F3826ʜ&#9C5432ᴀ&#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)