
ChatFlex
Enhance your server's communication with flexible chat channels and user-defined settings.
Screenshots

About this Mod
ChatFlex
Overview
This mod introduces a customizable chat system, allowing server owners to create and manage multiple chat channels with specific settings. The mod can operate with or without the LuckPerms mod, providing flexibility in permissions management.
Key Features
Custom Chat Channels: Define multiple chat channels with unique settings, including:
- ID: Unique identifier for each channel.
- Name: Display name of the channel.
- Format: Customizable message format for the channel.
- Prefix: Character(s) used to identify the channel when sending messages.
- Range: The distance (in blocks) that the channel is active. Use
-1for global channels. - Permissions: Control access to channels using LuckPerms or OP-level checks.
- Cooldown: Time in seconds that players must wait before sending another message in the channel.
- Default Channel: Specify a default channel for messages that do not match any prefix.
LuckPerms Integration:
- If LuckPerms is available, the mod will use it to manage permissions for each channel.
- If LuckPerms is not found, the mod defaults to OP-level permission checks.
Configuration
Channels are configured in a JSON file located at config/chatflex/channels.json. The mod will create a default configuration if the file does not exist.
Example Channel Configuration
[
{
"id": "global",
"name": "Global",
"format": "§e[G] ${prefix}${player}: ${message}",
"prefix": "!",
"range": -1,
"permission": "",
"write_permission": "",
"read_permission": "",
"priority": 0,
"cooldown": 0,
"enabled": true,
"default_channel": true,
"worlds": []
},
{
"id": "local",
"name": "Local",
"format": "§7[L] ${prefix}${player}: ${message}",
"prefix": "",
"range": 100,
"permission": "",
"write_permission": "",
"read_permission": "",
"priority": 0,
"cooldown": 0,
"enabled": true,
"default_channel": true,
"worlds": []
}
]
Usage
- To use a specific channel, simply type the prefix followed by your message. For example:
!Hello everyone!for the global chat.Hello local players!for the local chat (if no prefix is specified, it defaults to local).

Available Versions
How to Install ChatFlex on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.4).
Install Mod
Open the mod browser in the dashboard and search for "ChatFlex". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.4, 1.21.3, 1.21.2 (+2 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
ChatFlex server crashes on startup – what to do?
Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.4). You can switch loaders with one click in the panel.
Is ChatFlex compatible with neoforge?
ChatFlex officially supports neoforge for Minecraft 1.21.4, 1.21.3, 1.21.2. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with ChatFlex – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if ChatFlex consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install ChatFlex with just one click on your server.