Hats Mod Wiki

The Hats Mod, created by iChun, introduces an extensive collection of aesthetic hats that players can discover and wear. These cosmetic items provide a unique way to personalize a player's appearance. The mod was originally developed during a 96-hour modding marathon known as ModJam.

Upon initial installation and first run, the mod automatically includes a substantial number of hats, ranging from dozens to nearly a hundred. The Hats Mod requires the iChun Util library to function.

Acquiring Hats

Hats are primarily acquired by defeating mobs. Both passive and hostile creatures can randomly spawn wearing a hat. When a player successfully kills a mob adorned with a hat, that hat is added to the player's personal collection.

Hat Selector GUI

Players can manage their collected hats through the Hat Selector GUI. This interface allows players to browse their inventory of hats, select one to wear, and apply various customizations. The default keybind to open this menu is typically 'H' or 'V' (in some modpacks), and it can be reconfigured in the game's control settings.

Customization

Hats offer several customization options. Players can colorize their hats using an RGB colorizer within the Hat Selector GUI. In later updates, the colorization system was enhanced to include Hue, Saturation, Brightness, and Glint settings, providing more detailed control over a hat's appearance. Some hats may also support accessories, which can be unlocked and customized separately.

The Hats Mod is designed to function effectively in both single-player and multiplayer environments:

• Servers Without the Mod: If a server does not have the Hats Mod installed, clients who do have the mod will still see players and certain animals wearing random hats. This behavior is often configurable.
• Servers With the Mod: On servers where the mod is installed, players can proudly display their chosen hats. The mod also features a system where custom hats installed by a client are automatically sent to the server and then shared with other players within proximity. This allows everyone to see and even use the custom hat. This custom hat sharing functionality can be disabled in the mod's configuration due to potential security considerations.

Custom Hats

Players have the ability to create and integrate their own custom hat models into the game. For older versions of the mod, custom hats could be created using tools like Techne, with .tcn files placed into the hats folder located in the root of the Minecraft directory. In more recent versions (specifically from Minecraft onwards), the mod primarily utilizes the Tabula format for hat models, though it generally maintains compatibility with older Techne formats. Tabula also includes dedicated features to assist in the creation of new hats.

Custom hats can include specific properties such as rarity and descriptions, which are displayed in the hat's tooltip. The mod also supports an advanced Head Tracker system, allowing hats to be applied to a wider range of entities, including those from other mods, by exporting JSON files with minor adjustments using Tabula.

Hats

Hats are the primary cosmetic items added by the mod. They come in a vast array of designs and can be equipped via the Hat Selector GUI. Later versions introduced a rarity system, categorizing hats as common, uncommon, rare, epic, or legendary.

Hat Stand

The Hat Stand is an addon block that allows players to display their collected hats. It functions as a decorative item, enabling hats to be showcased on a stand, on a wall, or even on various mob heads (such as a skeleton, zombie, player, or creeper head). The appearance of the Hat Stand itself can be customized, offering options for a floating display, a display on a wooden slab base, or a full stand.

To craft a Hat Stand, place a Stick directly above any type of Wooden Slab in a crafting grid. The Hat Stand addon requires both the Hats Mod and the iChun Util library, and must be installed on the server for clients to interact with it.

Hat Launcher

In later iterations of the mod, a Hat Launcher item was introduced. This item provides a unique way to apply hats to mobs or other players.

The Hats Mod offers several configuration options to tailor the experience. Keybinds for the Hat Selector GUI can be changed through Minecraft's control settings. The feature allowing custom hats to be sent to the server and shared with other players can also be disabled in the mod's configuration files due to security considerations. Additionally, the random hat assignment for players on servers without the mod is configurable.

The Hats Mod may exhibit slight incompatibilities with certain other mods, such as Smart Moving and Mine Little Pony. These conflicts can sometimes result in visual glitches, specifically 'floating hats,' where the hat does not correctly attach to the player or mob model.