Case study · Chat management plugin for Paper

TecnoChat

One plugin that replaces the five or six chat plugins most servers stack: formatting, moderation, anti-spam, staff tools and chat colors, all through a single message pipeline.

ReleasedUpdated 2026-11-21

TecnoChat logo: a red pixel speech bubble next to the word TecnoChat

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

  1. 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.

  2. 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.

  3. 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.

  4. Safe hot reload

    /tc reload reloads 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.

  5. 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

  • /mute with flexible durations (30s, 1h30m, 2d12h, 1w or permanent), working on offline players too
  • /warnings opens 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

Want something built?

I build custom Minecraft plugins, advanced server systems and interactive software experiences. My focus is creating functional, reliable and well-engineered solutions.

Request a custom plugin Discuss a project

Tecnolegend
Hire Tecnolegend