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

View config.yml (Click to expand)

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