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