ModsFinder

The Mad Hatter

by xiaofanwei123

With The Mad Hatter, a worn hat stores a large inventory that players can fill and empty by clicking, and the mod ports a hat-based storage idea first made by Miyucomic.

NeoForgeClient and serverMIT LicenseOpen source1.21.1

What it does

Putting the hat on opens a storage mode in which items can be placed into it and taken out again, working in a way similar to a bundle. Holding the Left Alt key, by default, switches the hat into a special mode. In that mode, holding right-click vacuums nearby items into the hat, and a left-click shoots stored items back out in quick succession. A middle-click fires confetti.

The mod is written for NeoForge and covers only Minecraft 1.21.1. Every player and the server need a copy of the mod. The code is open source under the MIT License, and the author has published a source repository and an issue tracker. The author notes that bugs should be reported to the mod author rather than the original creator. The mod also fires three events, HatThrowItemEvent, HatVacuumItemEvent and HatConfettiEvent, which other mods can cancel.

Key features

  1. Hat-based storage

    A hat worn by the player holds items in a storage that behaves like a bundle, with items placed and removed by clicking.

  2. Vacuum mode

    Holding right-click in special mode pulls nearby items into the hat, with an animated ejecting system for returning them.

  3. Confetti shots

    A middle-click in special mode fires confetti from the hat, one of the animated effects the mod includes.

  4. Cancellable hat events

    Three events fire during hat actions, and a listener that cancels one can conjure a pigeon in its place, a behavior the mod itself does not add.

Compatibility

Latest build for each game version and loader.

1.21.11.1
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Use cases

Collecting loot in the field

A player walking through a mining area can sweep up dropped items with the vacuum mode instead of picking each one up by hand.

Carrying items on a magic theme

Magic-themed modpacks can use the hat as a portable storage item that fits the rest of the content.

Who it’s for: Players who want a portable, themed storage item on NeoForge 1.21.1 will find the mod useful. Server owners need to install it on the server as well, since the environment is client and server.

Questions

Which loader does The Mad Hatter run on?

The mod is published for NeoForge only, for Minecraft 1.21.1, with the latest file being version 1.1.

Does the server need The Mad Hatter installed?

Yes. Installation covers the server and each player's game.

Which keys control the hat's special mode?

Left Alt enters the special mode while the hat is worn, right-click vacuums items, left-click shoots them out and middle-click fires confetti. Removing the hat is bound to H by default.

In the catalog

The Mad Hatter is one of 4,058 Storage mods on ModsFinder, and one of 1,794 Storage mods for NeoForge. 32,366 mods support Minecraft 1.21.1.

More from xiaofanwei123

All projects

Similar mods

What the author says

This mod is ported from Miyucomic's The Mad Hatter. Thanks to Miyucomics for the creativity! You can now experience this mod in neoforge1.21.1!
xiaofanwei123, on the Modrinth page

Official listing

Owner
xiaofanwei123
Published
2025-09-11
Updated on Modrinth
2026-09-21
Facts verified
2026-10-15

Tags