
FlakeChat
Java mod listed for Minecraft 1.21–26.x. Downloads from the MC Java Mods app on Android.
Chat formatter and smart swear filter for Paper. 14 checks, escalating punishments, LuckPerms ranks and a Discord bridge.
⬇ Download on Modrinth





FlakeChat
A chat formatter and a smart chat filter for Paper, in one jar. Either half can be switched off and the other keeps working.
The filter is the reason to use it
Most chat filters hold a list of a thousand spellings and still miss the thousand and first. FlakeChat holds one entry and compiles it into something that keeps up with how the word will actually be typed.
Say you write badword* once. It then catches b.a.d.w.o.r.d, b a d w o r d, baaadword, b4dword, the same word spelled with lookalike letters from another alphabet, and the same word padded with zero width characters. Every letter also matches the digits and symbols drawn like it, a letter may repeat, up to three non-letters may sit between two letters, accents read as their plain letters and the German double s reads as ss.
The other half of a word list is the allow list, and that is the half everyone forgets. The word around every catch is checked against it first, so class is not an insult and document is not a boast. /flakechat test <message> runs a message past the filter privately and prints every hit, which is how you reproduce and fix a false positive instead of arguing about it.
Fourteen checks, and a ladder
Four checks read word lists: slurs, profanity, insults, sexual language, plus your own patterns. The other ten measure the message itself: shouting, flooding, repeating, talking too fast, strange characters, keyboard noise, addresses, and claiming to be staff.
Each check has its own switch, its own action (allow, censor or block) and its own point value. Points add up per player and fade on their own, and a ladder decides what happens when a total reaches a rung: a warning, a mute, a kick, a ban (off by default), or commands of your own. One word is a word. The same word four times in a minute is somebody who needs stopping.
That holds even while they are already blocked, because the points and the ladder run on every single message. Only the telling is throttled, so flooding while blocked climbs straight into a mute instead of producing fifty copies of "that was not sent".
A rung can hand its punishment to a command of your own instead of the built-in mute, kick or ban, for a server where EssentialsX or LuckPerms already tracks punishments. FlakeChat still decides when a rung is reached.
Books, signs and renamed items go through the filter too. Staff cannot star out one word in a signed book the way they can in chat, so any catch on one of those stops it outright whatever its own action is set to, and the alert carries the world and the coordinates.
The refusal a player gets for a blocked message, a mute or a kick says why, in their own language, naming the category that tripped and never the exact word.
The formatter
One default format, with no rank to set up by hand. A rank's prefix and suffix come straight from LuckPerms through PlaceholderAPI, in whatever colour and wording that rank already uses, legacy codes and all. Anybody with no prefix set simply shows none, and a placeholder that cannot resolve is cut rather than left sitting in chat as literal text.
MiniMessage throughout otherwise: hex colours and gradients, a hover and a click on the name, @name mentions with a ping, and [item] to show what you are holding with its real tooltip.
For more than a prefix and a suffix, formatter.groups gives one format per rank, claimed by a permission or by naming a LuckPerms group directly, so a rank does not have to be mirrored as a permission node just for this. Those formats can read LuckPerms without PlaceholderAPI installed at all, and everything degrades quietly to an empty string without LuckPerms.
A player with flakechat.color may colour their own message. Only the tags that colour text are theirs: the ones that click, hover or insert never are, whatever they paste. The format is parsed, the message is not, and the two are put together as finished pieces.
Configured from in game
/flakechat gui. Everything is reachable without opening a file, and a click writes to config.yml exactly as an edit by hand would. The formats screen previews each format as chat would draw it, the checks screen is one icon per check with its switch, action and points on it, and the log screen lists what was caught with a click to retest it.
Discord
Catches, punishments and staff mutes go to a webhook, queued and sent off the main thread, batched ten to a message, rate limits honoured, with an optional role ping on a punishment.
Separately there is a chat bridge for ordinary chat. In webhook mode it is one way, posting under the player's own name and face so it reads in Discord like they posted it themselves. In bot mode it is both ways, through a hand-rolled gateway client with no framework bundled: a message from Discord appears in game with the sender's highest role and is run through the same chat filter first, and the bridged channel's topic keeps a list of who is online. No message read from Discord is ever treated as a server command, however it is worded. It only ever becomes a chat line.
Requirements
Paper 1.21 or newer. LuckPerms and PlaceholderAPI are both optional, and the plugin works without either.
Support
Questions and bug reports go to the Flake Discord.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.10
- 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 FlakeChat.jar — drop this file into the mods folder
- Download size: 15.1 MB
- Download link checked 20 Nov 2026 — working
These come from our own check of the pack file, not from the source page.