Overview
TecnoChat is a chat plugin for modern Paper servers. It combines chat formatting, an anti-swear filter, anti-spam, anti-advertising, mutes, staff chat and chat colors in one jar.
It uses the Dialog screens added in Minecraft 1.21.6 for warnings, mute notices, staff audits and the chat color menu, so players get real in-game windows instead of walls of chat text.
The problem
Most servers stack five or six chat plugins: one for formatting, one for the swear filter, one for anti-spam, one for chat colors, one for staff chat and one for private messages.
They conflict with each other, they process the same message several times, and each one adds its own overhead to every line of chat.
My role
I designed and built TecnoChat end to end: the message pipeline, the moderation engine, the dialog interfaces, storage and configuration. I publish and support it on BuiltByBit under my plugin label, Tecno Studio.
How it is built
One pipeline for every message
Each message passes through the same ordered stages: chat lock, mute check, channel routing, cooldown, moderation, then formatting. One plugin owns the whole path, so nothing is processed twice and the order is predictable.
Render once, not once per player
The formatted message is built a single time and then delivered, instead of being rebuilt for every recipient. That keeps chat cost flat as the player count grows.
Storage off the main thread
Strikes, mutes and chosen chat colors live in SQLite behind a background writer, so a database write never stalls the server tick.
Safe hot reload
/tc reloadreloads every config file without freezing the server, and configs are thread-safe, so a reload in the middle of a conversation does not break messages.Built for modern Paper
Uses the async chat event and region-aware schedulers. One jar runs on Paper 1.21.11 and the 26.x builds.
Key features
Anti-swear filter
- Catches spaced-out, dotted and repeated letters and symbol swaps
- De-obfuscates leetspeak, Cyrillic look-alike letters, accents and invisible zero-width characters
- Catches words glued to other words while protecting clean words such as class, grass and assassin
- Allowlist, and a choice between blocking the message or masking the word
- Built-in English and Bangla word lists, fully editable
Anti-advertising
- Blocks IP addresses with or without a port, and Discord invite links
- Recognises 40+ domain endings and disguised links such as server[dot]net or p l a y . n e t
- Domain allowlist for the server’s own website and store
Anti-spam and anti-flood
- Token-bucket rate limiter: normal chatting passes, flooding is stopped
- Repeated-character detection and similarity-based duplicate detection, not only exact matches
- Excessive caps can be lower-cased automatically or blocked
Strikes and auto-mute
- Every violation adds a strike, stored in SQLite
- Reaching the limit applies a temporary mute automatically
- Players see a dialog explaining the rule, the reason and their strike count; staff get a live alert with the flagged message
Staff tools
/mutewith flexible durations (30s, 1h30m, 2d12h, 1w or permanent), working on offline players too/warningsopens a staff audit dialog with the player’s recent infractions- Staff chat, command spy (login commands ignored), social spy, chat lock, slowmode and clear chat
- Async chat logging to file for appeals
Formatting and interaction
- LuckPerms group formats with priority order, prefixes and suffixes
- MiniMessage gradients, hex colors and PlaceholderAPI in every format
- Hover a name for rank, ping, health and world; click to message
[item]showcase, @mentions with a sound ping, and private messages that go through the same moderation
Channels and command security
- Global, local (proximity) and trade channels, with quick-send prefixes
- Command whitelist with auto-detection that never whitelists admin commands
- Hides /plugins, /version and namespaced commands from tab-complete, with a fake “Unknown command” reply
Engineering decisions
Filtering bypasses without false positives
Normalising text (removing spacing, symbols, look-alike letters and zero-width characters) catches far more bypass attempts, but it also makes innocent words match. The filter therefore protects known clean words and supports an allowlist, so “class” or “assassin” are never flagged.
Rate limiting that feels fair
A fixed cooldown punishes normal conversation. A token bucket lets players send short bursts naturally while still stopping sustained flooding.
Dialogs instead of chat spam
Warnings, mute notices and the color menu use native dialog screens, with a popup cooldown so a spammer cannot flood their own screen with notices.
TecnoChat is a closed-source, paid plugin, so the source code is not public. Everything on this page comes from the published listing.
Sources
- TecnoChat listing on BuiltByBit (opens in a new tab) · checked 2026-11-21
