HatCosmetics

Important Information

This plugin is no longer being developed by the author Tonus_. To ensure its functionality without updates, starting from version 2.0.0, the plugin no longer includes the required NBT-API library. NBT-API is now a mandatory dependency that must be downloaded separately. All 1.x.x versions contain this library but will not work with future Minecraft updates. The source code is available in the GitHub repository.

Plugin Capabilities

Main Function

HatCosmetics provides a simple way to add custom resource pack models to your server using special model data. All available "hats" are placed in a customizable interface where players can select and wear headgear provided they don't have actual armor on their head and have the appropriate permissions.

Key Features

Intuitive Hat Selection Interface

The plugin's main menu allows players to browse and select hats to wear. They can see all available models but can only wear those for which they have permission. The border around hats in the interface can be customized to any item, including complete absence!

Protection Against Accidental Loss

Even with the keep inventory option disabled after death, players cannot drop their hat or move it to another inventory slot (players in creative mode can freely move hats). To remove headgear outside creative mode, players can use a special command or simply click on the hat in their inventory.

Flexible Configuration Without Reloading

If you need to quickly add a new hat, change the interface size, or modify items, you won't have to restart the server - all changes are applied instantly!

Complete Customization

Make your hats unique with custom names, descriptions, and special items for each model. Additionally, you can completely modify all plugin messages according to your preferences!

Plugin Commands

Main command: /hats or /hatcosmetics

• /hats - opens the hat selection interface
• /hats help - shows the list of available commands
• /hats equip [player] - wears the specified hat
• /hats unequip [player] - removes the hat if the player is wearing one
• /hats reload - reloads the configuration

Permissions

• hatcosmetics.hat. - access to a specific hat
• hatcosmetics.equip.other - ability to equip hats on other players
• hatcosmetics.unequip.other - ability to remove hats from other players
• hatcosmetics.reload - permission to reload configuration

Creating Custom Models

For creating custom hat models, it's recommended to use the BlockBench program. This is a professional modeling tool that works excellently for Minecraft resource pack work.