Public Chat

Public Chat

BlueMapWebChat 4.7.0 · Minecraft 1.18–26.2 · Java 17 baseline

8. Public Chat

8.1 Game to Web

chat:
  broadcast-ingame-chat-to-web: true

Normal Minecraft chat is published to the public web chat. Sender names follow player-display.mode.

8.2 Web to Game

chat:
  send-web-chat-to-game: true
  web-user-to-game-format: "[Web] {player}: {message}"
  web-guest-to-game-format: "[Web Guest] {guest}: {message}"
  web-admin-to-game-format: "[Web Admin] {player}: {message}"

Legacy & colors are translated only in configured format templates. User message text is not arbitrarily color-translated.

8.3 Web to Web

chat:
  broadcast-web-chat-to-web: true

A public web message is pushed to other connected browser clients through SSE.

8.4 Message Length

chat:
  max-message-length: 120
  max-url-message-length: 2048

Normal text and URL-oriented messages can use different limits. 0 means unlimited.

8.5 Message Tokens

BlueMapWebChat 4.7.0 can replace administrator-configured :alias: tokens before messages are stored or relayed. The built-in alias names are English-only defaults, but aliases can be replaced or extended in any language.

Default controls:

• :enter:, :newline:, :nextline:, :linebreak:, :br: → one new line
• :blankline:, :emptyline:, :paragraphbreak: → one empty line
• :tab:, :indent: → configurable spaces (4 by default)

Unknown tokens are left unchanged, so ImageEmojis/custom emoji tokens continue to work. Backslash escape forms such as :\n: are not supported. Printable custom replacements can also be configured, for example :separator: → ────────────.

For Minecraft output, ordinary CR/LF characters still follow the existing one-line flattening behavior. Only line breaks produced by configured newline / blank-line aliases are carried through the sanitizer and emitted as explicit Minecraft chat lines at final delivery, so :enter: works without changing the treatment of arbitrary pasted newlines. For server-relayed game output, the receiving BlueMapWebChat server must also have the same 4.7.0 token-line delivery support; an older receiver flattens the normal relayed LF.

message-tokens:
  enabled: true
  max-replacements-per-message: 24
  newline:
    aliases: [enter, newline, nextline, linebreak, br]
  blank-line:
    aliases: [blankline, emptyline, paragraphbreak]
  tab:
    aliases: [tab, indent]
    spaces: 4
  custom: {}

The server-side processor is shared by normal chat, direct messages, group chat, supported Minecraft command/chat paths, and relayed messages, so the stored/relayed content contains the resolved line breaks or printable replacement text.