FancyHAT

# 🎩 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 ` | 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: 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)