Simple Hats
by fonnymunkey
With Simple Hats installed, players wear cosmetic hats on a dedicated slot provided by Accessories, and the hats are defined through JSON files rather than code.
What it does
Hats are defined in JSON, so server owners and pack makers can add, remove or change them. The mod ships with almost 300 custom hats. Players obtain them from grab-bags that hostile mobs drop and from loot chests, and a grab-bag opens with a right-click. Duplicate or unwanted hats can be recycled into new or upgraded bags to get rarer ones.
Some hats come with alternate models or skins that a player switches between in the crafting grid, and some take dye like leather and can be washed clean in a cauldron. Hats can also be placed on a craftable hat-stand. A season system drops special grab-bags from ordinary bags at certain points in the calendar. Accessories and Cloth Config API are required, and the mod runs on the client and the server, so both need it. Builds exist for Fabric, Forge and NeoForge across 1.18.2 – 1.21.1, and the latest file for 1.20.1 is current as of 2026-02-09 on each loader.
Key features
JSON-defined hats
New hats are added or changed through JSON files, so the set of hats is not fixed by the code.
Hat variants
Some hats offer alternate models or skins that can be switched in the crafting grid.
Dyeable hats
Some hats take dye like normal leather, and the color can be washed off in a cauldron.
Particle effects
Certain hats show particle effects that are visible in third person and to other players.
Seasonal grab-bags
At set points in the calendar, special grab-bags drop from ordinary bags.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 2
Required by 4 mods
Use cases
Hat-stand displays
Players craft a hat-stand to show their collection in a base or hub.
Recycling duplicates
Unwanted or duplicate hats are recycled into new or upgraded bags to chase rarer drops.
Who it’s for: Players who want cosmetic headwear in survival or multiplayer worlds, and server owners or pack makers who want to define their own hat set in JSON.
How it compares
Villager Hats is open source under the MIT License and runs on Fabric, NeoForge and Quilt for 1.17 – 1.21.1. Animals Hats is not open source, is licensed under the MIT License, runs on Forge and NeoForge for 1.20 – 1.21.8, and is client and server. Simple Hats is not open source and uses a custom license, with builds for Fabric, Forge and NeoForge.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Simple Hats | Fabric, Forge and NeoForge | 1.18.2 – 1.21.1 | Client and server | 2026-02-09 |
| Villager Hats | Fabric, NeoForge and Quilt | 1.17 – 1.21.1 | Client and server | 2024-08-18 |
| Animals Hats | Forge and NeoForge | 1.20 – 1.21.8 | Client and server | 2026-04-06 |
Questions
Does Simple Hats need Accessories?
Does Simple Hats have to be installed on the server?
Can server owners add their own hats?
In the catalog
Simple Hats is one of 12,078 Decoration mods on ModsFinder, and one of 6,982 Decoration mods for Fabric. 32,366 mods support Minecraft 1.21.1.
More from fonnymunkey
Similar mods
What the author says
Simple Hats is a JSON-configurable cosmetic hat mod that allows users to define their own hats with various additional options such as variants, dye-ability, particle effects, and seasonality. There are almost 300 custom hats included in the mod by default that users can add/remove/change as they like.
Official listing
- Modrinth page
- modrinth.com/mod/simple-hats
- Owner
- fonnymunkey
- Published
- 2023-03-17
- Updated on Modrinth
- 2026-02-09
- Facts verified
- 2026-10-15