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