ChTR

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