MessageBridge

Minecraft ↔ Telegram ↔ Discord. Bidirectional. Multi-platform.

---

Chat messages, join/leave/death events, and server start/stop — all forwarded to Telegram and Discord in real time. Replies from both platforms appear in Minecraft chat. Zero main-thread blocking.

---

Features

• Bidirectional chat — MC ↔ Telegram ↔ Discord, messages tagged with [MC] / [TG] / [DS]
• Discord webhooks — messages show sender avatar and name, not the bot
• Replies — a Telegram or Discord reply keeps its context on every side: in game it reads [TG] Alex ↪ Steve: … with the replied message on hover; Telegram gets a native reply to the original message or to the bridge's copy of it; Discord shows a small ↪ Steve: … line above the message that links to the original. When the bridge no longer remembers the original (restart, cache full) the replied text is quoted instead. Change the look with chat.to_minecraft_reply, chat.to_telegram_reply, chat.to_discord_reply and chat.reply_quote in translations.yml
• Events — player join (first-time flag), leave, death, server start/stop
• Account linking — /link in-game → code → /link <code> in TG or Discord
  • Linking from Discord requires being a member of the Discord server
  • Grants a LuckPerms role and a Discord role on link
  • Revokes both roles on /unlink
  • Revokes the LuckPerms role when a player leaves the Discord server
• Online list — /vanilla (Telegram) or !vanilla (Discord) shows current players
• Proxy support — HTTP proxy with auth for both bots
• Hot reload — /mbreload reloads config; bots reconnect automatically

---

Platform Support

Platform	File	Minecraft
Paper	MessageBridge-bukkit-*.jar	1.18+
NeoForge	MessageBridge-neoforge-*.jar	1.20.1
Forge	MessageBridge-forge-*.jar	1.20.1

---

Installation

1. Drop the jar into plugins/ or mods/
2. Start the server — config.yml and translations.yml are generated
3. Fill in bot tokens and channel IDs
4. /mbreload or restart

Discord: enable Message Content Intent in the Developer Portal; bot needs Send Messages, Manage Channel, Read Message History, Use Webhooks.

Telegram: make the bot an admin in your group; use /minfo in the topic to get chat_id and topic_id.

---

Configuration

config.yml

jdaConfig:
  token: ""
  activity: "play.example.com"
  channelId: ""
  replyPreviewLength: 60          # characters of the replied text quoted under a reply
  relayedMessageCacheSize: 1000   # relayed messages remembered to link replies to them
  # proxy:          # uncomment if Discord is blocked in your region
  #   host: "0.0.0.0"
  #   port: 2222
  #   username: "user"
  #   password: "password"

tgConfig:
  token: ""
  chat_id: "-1001234567890"
  topic_id: "12345"
  max_telegram_message_length: 140
  reply_preview_length: 160          # characters of the replied text quoted when the original is unknown
  relayed_message_cache_size: 1000   # relayed messages remembered to reply to them natively
  # proxy: ...

displayJoinMessage: true
displayLeaveMessage: true
displayDeathMessage: true

# Remove this block to disable account linking
link:
  linkDiscordRole: "123456789012345678"   # Discord role ID
  linkLuckPermsRole: "verified"           # LuckPerms group

---

Commands

In-game

Command	Permission
/mbreload	tbridge.reload
/link	-

Bot

Command	Platform	Action
/vanilla	Telegram	List online players
!vanilla	Discord	List online players
/link <code>	TG & Discord	Link Minecraft account
/minfo	Telegram	Print chat ID and topic ID

---

---

💜 Support Us

If our projects help you, consider supporting their development.

Bitcoin	bc1q9a8dr55jgfae0mhevw3vvczegjv0khfp0ngrnv
Ethereum	0x0BaAeEA44Ce08c8DC139224ff57563695B30d423
Boosty

---

Made with ❤️ by AstraInteractive