
Revenants Hats
A lightweight, highly configurable, and secure plugin that enables players to equip held items as hats.

Features
- Very simple configuration
- AntiDupe protection (unlike other hat plugins)
- Straightforward permission system
Permissions
The plugin utilizes one primary permission hat.use that allows players to equip items as hats (defaults to true for all players).
Configuration
All settings are stored in the ./plugins/RevenantsHats/ directory. The config.yml file is generated automatically upon first server startup.
Config.yml: stores all confiuration options. Here is the default configuration:
messages:
no-item-held: "§cYou must be holding an item to use /hat"
hat-equipped: "§aHat equipped!"
cannot-remove: "§cThis hat cannot be removed."
cannot-drop: "§cThis hat cannot be dropped."
cannot-pickup: "§cHat items cannot be picked up!"
not-allowed-item: "§cYou cannot equip this item as a hat."
hat-restriction:
mode: BLACKLIST
materials:
- bedrock
- command_block
The messages key support legacy colour codes, custom text for all action bar notifications and can be fully customized.
The hat-restriction's mode supports BLACKLIST (deny listed materials) and WHITELIST (allow only listed materials) respectively allowing you to allow or deny materials or blocks from being a hat.
The materials sub key allows a list of material names to add to your hat-restriction.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as Hats-1.0-RELEASE.jar — drop this file into the mods folder
- Download size: 9 KB
- Download link checked 13 Sept 2026 — working
These come from our own check of the pack file, not from the source page.