Cleanse Mod: Eliminate Annoying Login Chat Spam in Minecraft
Every seasoned Minecraft player knows the drill: you load into a world or join a server, and before you can even glance at your coordinates, the chat window explodes with a wall of text. Mod update notifications, wiki compatibility reminders, social media plugs, and Patreon links flood the screen, burying anything useful. It is distracting, immersion-breaking, and frankly, a little obnoxious. The Cleanse mod steps in as a minimalist solution, filtering out exactly this kind of non-vanilla chat spam during the critical first moments after you open a world.
What Exactly Does Cleanse Do?
Cleanse has a single, laser-focused function. It blocks any chat message that does not originate from vanilla Minecraft during a configurable window of time right after world load. By default, this window is set to one second, but you can easily adjust it in the mod's configuration file to suit heavier modpacks or delayed message senders. The mod does not permanently disable messages; it simply prevents them from appearing in the chat history during that initial burst. Once the timer expires, chat behaves normally again.
The typical offenders that Cleanse silences include those infamous lines like "We have an update, and we don't care that Forge had a built-in notification system for this for ages," or "We are compatible with this in-game wiki, so we think you MUST know about that." It also handles the self-promotional spam—socials, Patreon links, and other "pure cringe" messages that some mod authors feel compelled to broadcast every single login. If you are tired of seeing the same redundant information day after day, Cleanse offers immediate relief.
How the Filtering Works
Technically, Cleanse hooks into the chat pipeline and discards any non-vanilla lines for a set duration. The mod does not inspect message content or maintain a blacklist; it simply checks whether a message originates from the base game or from an external mod. This approach keeps the mod lightweight and compatible with virtually any modpack. You can find the timer setting in the cleanse-common.toml config file, where the chat_delay value (in milliseconds) can be increased if you notice partial spam still slipping through.
One important caveat: if a mod author deliberately delays their chat message beyond your configured window, Cleanse cannot catch it. The mod’s description openly acknowledges that a particularly determined developer can work around the filter, but in practice, very few go to such lengths. Should you still see partial spam, check the latest log file. If the line [Cleanse]: Reenabled adding new chat lines appears just before a message is sent, the fix is simple—bump up the delay in the config. This is especially common in enormous modpacks where hundreds of mods initialize simultaneously.
Installation and Setup
Cleanse is a client-side mod built for Forge, and it requires no special dependencies. You simply drop the JAR file into your mods folder like any other mod. However, managing mods manually can become tedious, especially when you juggle multiple instances. This is where a modern launcher shines. For example, if you use the foxygame.net launcher, you can install Cleanse directly from the in-app mod browser without ever touching a file explorer. The launcher’s flexible instance management lets you enable or disable the mod per pack, and it automatically handles updates, so you never have to worry about outdated versions.
Once installed, the mod starts working immediately with the default one-second delay. If you want to tweak the timer, navigate to your Minecraft instance’s config folder, open the Cleanse config, and change the value. A setting of 2000 milliseconds (2 seconds) is often enough for most modpacks, while heavy setups might need 3000–5000 milliseconds.
Configuration Options
Cleanse keeps things refreshingly simple. The entire configuration boils down to a single parameter:
- chat_delay – The time in milliseconds after world load during which non-vanilla messages are suppressed. Default: 1000.
There are no toggles for specific mods, no whitelist or blacklist. This minimalism is by design, keeping the mod’s footprint tiny and its behavior predictable. If you ever need to see those suppressed messages for debugging, you can temporarily disable the mod or set the delay to 0.
Using Cleanse in Modpacks
Modpack creators will be happy to know that Cleanse is released under the MIT license. This means you can bundle it in your public or private packs without any additional permissions, as long as the license notice file remains intact. The JAR already contains this file, so you literally do not have to do anything extra. It is a set-and-forget addition that significantly improves the user experience by removing login clutter. Players will appreciate starting their adventure with a clean chat, free from the usual barrage of mod notifications.
Potential Limitations and Workarounds
While Cleanse is highly effective, it is not a silver bullet. Mods that send messages with an intentional delay, or those that inject messages outside the standard chat pipeline, may still appear. Additionally, if a mod author uses a custom packet system that bypasses the vanilla chat layer entirely, Cleanse will not intercept it. The mod’s creator is upfront about these edge cases, noting that the only real defense is to increase the delay or, in extreme cases, avoid mods that aggressively spam. Fortunately, the vast majority of mods play nicely, and Cleanse handles them without issue.
Why You Should Use Cleanse
In a modded environment, every second of immersion counts. The constant stream of login messages is not just annoying—it can actually cause you to miss important vanilla chat, such as server rules, friend whispers, or command feedback. Cleanse restores that initial moment of clarity. It is a tiny mod with a huge quality-of-life impact, and it requires virtually no setup. Whether you are a casual player tired of the noise or a modpack maintainer looking to polish the player experience, Cleanse deserves a spot in your mods folder.
Final Thoughts
Minecraft modding is all about tailoring the game to your preferences, and Cleanse does exactly that by removing an unnecessary annoyance that has become far too common. Its straightforward approach, open license, and zero-config nature make it an easy recommendation. Next time you log into your world and see nothing but a pristine chat box, you will wonder why you did not install this mod sooner. Give Cleanse a try, and take back control of your Minecraft chat.