Skip to content

Chat bridge

Jump to bottom
Cyrusbye720 edited this page Jun 6, 2026 · 3 revisions

Chat bridge

Two-way synchronisation between Minecraft chat and a Discord channel.

Configuration

chat:
  use-webhooks: true
  webhook-name: "%displayname%"
  avatar-url: "https://crafatar.com/avatars/%uuid%?overlay=true"
  minecraft-format: "&9[Discord] &b%name% &8> &f%message%"
  show-attachments: true
  attachment-text: "&e[Attachment] &7(Click to open)"

Webhook mode vs plain mode

When use-webhooks is true, ZDiscord creates a webhook named ZChat in the configured channel. Minecraft messages are sent through that webhook so each player appears with their own username and skin. If the webhook is deleted, ZDiscord will create a new one on the next message.

When use-webhooks is false, all Minecraft messages are sent as the bot itself. The bot's name is used for every message and the player's name is included in the content.

Webhook rate limiting

Discord allows four webhooks per channel per two seconds. ZDiscord schedules deferred sends on a background executor and does not block the caller's thread.

Required permission

Players need the zdiscord.chat permission for their chat to be forwarded. By default this is granted to all players.

ZDiscord v1.1.0 · Home · Issues · Source

Clone this wiki locally