A chat mod with two modes:
- Global chat by prefix (default:
!)
- Local chat by radius (default:
100 blocks)
If nobody is in range for a local message, the sender gets a warning.
Compatibility
- Minecraft:
1.21.1
- NeoForge:
21.1.222+
- Java:
21
Clients do not need this mod installed: all chat logic runs on the server side.
How It Works
- A message starting with
globalPrefix is sent to all players.
- A regular message is sent only to players in the same dimension within
localChatRadius.
- If there are no listeners, an optional warning can be shown (
warnIfNoListeners).
Configuration (config/chatter-common.toml)
Available settings:
globalPrefix
Global chat prefix. Default: "!"
localChatRadius
Local chat radius in blocks. Default: 100.0
globalMessageFormat
Global message format.
Default: "&6[G] <{player}> {message}"
localMessageFormat
Local message format.
Default: "&7[L] <{player}> {message}"
emptyGlobalMessage
Message shown when globalPrefix is used without text.
Default: "&cYou must type message text after {prefix}."
noListenersMessage
Warning shown when nobody heard a local message.
Default: "&cNobody heard you within {radius} blocks."
echoLocalToSender
Whether to show local messages to the sender.
Default: true
warnIfNoListeners
Whether to show warning when local message has no listeners.
Default: true
Placeholders
Supported in formats and warning messages:
{player} - player name{message} - message text{radius} - current local chat radius{prefix} - current global chat prefix{listeners} - number of listeners
Colors and Styles
Supported & formatting codes:
- Colors:
&0..&9, &a..&f
- Styles:
&l, &o, &n, &m, &k
- Reset:
&r
- Literal
&: &&
Example Config
globalPrefix = "!"
localChatRadius = 120.0
globalMessageFormat = "&6[GLOBAL] &f<{player}> &e{message}"
localMessageFormat = "&7[LOCAL {radius}] &f<{player}> {message}"
emptyGlobalMessage = "&cYou must type text after {prefix}."
noListenersMessage = "&cNobody heard you ({radius} blocks)."
echoLocalToSender = true
warnIfNoListeners = true
