Skip to content

DiscordSRV

KOKOTO-DEV edited this page Aug 26, 2026 · 3 revisions

DiscordSRV

KOKOTO WebChat 5.0.0 · Minecraft 1.18–26.2 · Java 17 baseline

25. DiscordSRV Integration

discordsrv:
  enabled: true
  channel: "global"
  web-to-discord: true
  game-relay-mode: "discordsrv"
  discord-to-web: true
  ignore-bot-messages: true
  suppress-game-echo: true
  suppress-game-echo-seconds: 5
  send-web-user-chat-to-discord: true
  send-web-guest-chat-to-discord: false
  send-web-admin-chat-to-discord: true
  append-web-emoji-links: true
  append-game-emoji-links: true
  max-emoji-links-per-message: 4
  web-to-discord-format: "[{server}] [Web] {sender}: {message}"
  game-relay-format: "[{server}] {sender}: {message}"
  discord-to-web-sender-format: "Discord:{sender}"
  discord-to-web-message-format: "{message}"

If DiscordSRV already relays normal Minecraft chat, keep KWC game-relay-mode: "discordsrv" to avoid duplicate posts. KWC scans the :emoji: token text in DiscordSRV's actual Discord game post and passes it through the same registered token-to-link routine used by web→Discord. The early Minecraft chat fingerprint is only for origin-server attribution in shared channels; game glyphs are not used as Discord conversion input.

When multiple servers share one Discord channel:

  • Only the server that observed the original local game chat modifies the DiscordSRV message
  • Relay receivers do not repost the message to Discord
  • Other server listeners do not append repeated [Server] or [Web] prefixes

Optional reply preview:

discordsrv:
  reply-relay:
    enabled: false
    prefix-enabled: true
    preview-enabled: true
    preview-max-length: 120

Administrator keyword alerts

5.0.0 adds server-wide administrator keyword alerts under admin-alerts.discord.*. KWC owns matching, source scopes, mention policy, formatting and duplicate suppression. DiscordSRV is used only for its authenticated JDA connection and logical Channels mapping. Web Admin exposes one alert-channel selector with logical channel names; the backing numeric ID is not shown unless the configuration is ID-only. Empty admin-alerts.discord.channel reuses discordsrv.channel. Discord-origin messages are never re-alerted; DM and group scopes are off by default.

Clone this wiki locally