ChatBlock

by c24rew · on Modrinth

A simple configurable proxy plugin to block the use of chat or commands completely. Including plugin/mod commands

Which build do you need?

This mod ships a separate file for every mod loader and every version of the game. Pick both, then download — the wrong build installs fine and then does nothing in the game.

Mod loader

Mod loader BungeeCord1 build
Mod loader Velocity1 build
Mod loader Waterfall1 build

Minecraft version

Minecraft 1.21.2–26.2Newest

Minecraft 1.21.3–26.2Newest

Minecraft 1.21.3–26.2Newest

⬇ Download for 1.21.2–26.2 · BungeeCord ⬇ Download for 1.21.3–26.2 · Velocity ⬇ Download for 1.21.3–26.2 · Waterfall

I don't know my version or loader

Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.

No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.

Open in MC Java Mods Get it on Google Play →

ChatBlock

A simple proxy plugin that blocks commands and chat for selected players before they get sent to the server.

Runs on Velocity, BungeeCord and Waterfall. Designed for server networks where only allowed players (staff, builders) should be able to use commands and chat on certain backend servers, while everyone else is locked down.

Features

Block commands and/or chat independently, per server
Blocks plugin and mod commands too (everything sent to the proxy is covered)
Two blocking modes (global):
- whitelist — only listed players can use commands/chat
- blacklist — everyone except listed players can use commands/chat
Per-server allow lists of commands that are always allowed (e.g. /menu, /warp)
Hot-reload via commands — no proxy restarts needed
Bypass permission for trusted players
Disabled by default — the plugin does nothing until you configure it
Same configuration file and commands on every platform

Requirements

Proxy	Version	Java
Velocity	3.4+ (tested on 3.4/4.0)	17+ (3.4), 21+ (3.5+), 25+ (4.0+)
BungeeCord	1.21+	17+
Waterfall	1.21	17+

Installation

Download the jar for your proxy from the releases:
- Velocity: ChatBlock-velocity-<version>.jar
- BungeeCord / Waterfall: ChatBlock-bungee-<version>.jar
Drop the jar into your proxy's plugins/ folder.
Restart the proxy (or use /velocity plugins reload if available).
Edit the config to enable blocking (see below):
- Velocity: plugins/chatblock/config.yml
- BungeeCord / Waterfall: plugins/ChatBlock/config.yml
Give yourself the chatblock.admin permission and configure everything in-game with /chatblock.

Configuration

By default the plugin is disabled and does nothing. To enable it:

# whitelist | blacklist | disabled
mode: whitelist

# Players holding this permission are never blocked.
bypass-permission: "chatblock.bypass"

messages:
  command-denied: "<red>Only allowed players can use commands."
  chat-denied: "<red>Only allowed players can chat."
  # ... every other message the plugin sends (usage, errors, status, help)
  reloaded: "Configuration reloaded."

servers:
  lobby:
    block-commands: true
    block-chat: true
    whitelist:
      - "Steve"
    blacklist: []
    # Commands always allowed for every player on this server.
    allowed-commands:
      - "menu"
      - "warp"

mode: whitelist — only players in the server's whitelist can use commands/chat.
mode: blacklist — everyone can, except players in the server's blacklist.
mode: disabled — no blocking anywhere.
Only servers listed under servers: are affected. allowed-commands entries match the command name (with or without /); a base command also allows its subcommands.

All user-facing messages (denied messages, command usage/errors, status output, help) are configurable under messages:. Placeholders like {server}, {user}, {command}, {list}, {mode}, {target} and {value} are replaced automatically. The command-denied and chat-denied.

Commands

All commands require the chatblock.admin permission.

Command	Description
`/chatblock whitelist add <server> <user>`	Add a player to the whitelist of a server
`/chatblock whitelist remove <server> <user>`	Remove a player from the whitelist of a server
`/chatblock whitelist list <server>`	List whitelisted players of a server
`/chatblock blacklist add <server> <user>`	Add a player to the blacklist of a server
`/chatblock blacklist remove <server> <user>`	Remove a player from the blacklist of a server
`/chatblock blacklist list <server>`	List blacklisted players of a server
`/chatblock allowed add <server> <command>`	Allow a command for every player on a server
`/chatblock allowed remove <server> <command>`	Disallow a command on a server
`/chatblock allowed list <server>`	List allowed commands of a server
`/chatblock setmode <whitelist\|blacklist\|disabled>`	Change the blocking mode
`/chatblock block <server> <chat\|commands> <true\|false>`	Enable/disable command or chat blocking per server
`/chatblock status [server]`	Show the current configuration
`/chatblock reload`	Reload the configuration from disk

Users can be added by player name or UUID.

Permissions

Permission	Description
`chatblock.admin`	Access to all `/chatblock` commands
`chatblock.bypass`	Never blocked by the plugin (configurable in `config.yml`)

Verified by MCModsHub

Ships as ChatBlock-bungee-1.3.1.jar — drop this file into the mods folder
Download size: 645 KB
Download link checked 6 Sept 2026 — working

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.20 Java mods for 1.21 Java mods for 26