🎩 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

🛠️ Admin Commands

🔑 Permissions

⚙️ Advanced Configuration

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

# ========================================== #
#                  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)