BungeeChatDiscord

BungeeChatDiscord

BungeeChatDiscord (BCD) is a professional chat synchronization solution designed for BungeeCord networks. It seamlessly links your Minecraft servers with a Discord channel, featuring real-time rank synchronization via LuckPerms, custom server aliases, and

42 downloads

๐Ÿ’Ž BungeeChatDiscord (BCD)

Advanced Chat Bridge for BungeeCord Networks

Java Platform License Version

Professional bi-directional chat synchronization between Minecraft (BungeeCord) and Discord. Developed by ATRCORE

Report Bug ยท Request Feature


โœจ Features

BCD is built for performance and customization. Unlike other bloatware, it does exactly what you need:

  • ๐Ÿ”„ Bi-Directional Sync: Chat flows seamlessly from Minecraft to Discord and vice versa.
  • ๐Ÿ”ฐ LuckPerms Integration: Displays player prefixes (Ranks) from Minecraft in Discord.
  • ๐ŸŽญ Discord Roles: Displays the user's top Discord role in Minecraft chat with custom aliases (e.g., Owner -> &4[Admin]).
  • ๐Ÿ›ก๏ธ Smart Anti-Spam: Prevents Discord channel flooding without blocking in-game chat.
  • ๐ŸŒ Server Aliases: Renames internal server names (e.g., main -> SURVIVAL) for a cleaner look.
  • ๐ŸŽจ Full Color Support: Supports legacy (&a) and Hex colors (&#RRGGBB).
  • โš™๏ธ Hot Reload: Configure everything without restarting the proxy via /bcd reload.

๐Ÿ“ฆ Installation

  1. Download the latest .jar from the Releases page.
  2. Drop the file into your BungeeCord plugins folder.
  3. Restart your proxy.
  4. Open plugins/BungeeChatDiscord/config.yml.
  5. Paste your Discord Bot Token and Channel ID.
  6. Run /bcd reload or restart.

โš™๏ธ Configuration

Everything is configurable in config.yml.

# ==========================================
#         BungeeChatDiscord (BCD)
#           Created by ATRCORE
# ==========================================

# --- DISCORD SETTINGS ---
token: "INSERT_TOKEN_HERE"
channel_id: "000000000000000000"

# Bot Status Settings
# Type: PLAYING, WATCHING, LISTENING, COMPETING
status:
  enabled: true
  text: "ExoticLegacy Network"
  type: "PLAYING"

# --- FEATURES ---

# Server Aliases (Rename your servers for Discord)
# RealName: "Nice Name"
aliases:
  lobby: "HUB"
  main: "SURVIVAL"
  minigames: "GAMES"

# Role Aliases (Rename Discord roles for Minecraft chat)
# DiscordRole: "MinecraftFormat"
roles:
  "Owner": "&4[Owner]"
  "Admin": "&c[Admin]"
  "Moderator": "&9[Mod]"
  "VIP": "&6[VIP]"
  "default": "&7[Player]"

# Anti-Spam System
anti_spam:
  enabled: true
  max_repeats: 3        # How many identical messages allowed?
  time_window: 2000     # Time in ms (2 seconds)
  warning_message: "&cPlease do not spam!"

# --- FORMATTING & MESSAGES (LOCALIZATION) ---
# Supports standard color codes (&a) and Hex colors (&#RRGGBB)

formats:
  # Variables: %role_alias%, %user%, %message%
  discord_to_minecraft: "&b[Discord] %role_alias% &f%user%: &f%message%"
  
  # Variables: %server%, %prefix%, %player%, %message%
  minecraft_to_discord: "**[%server%]** %prefix% %player%: %message%"

messages:
  # Join/Leave Messages for Discord
  join:
    enabled: true
    text: "๐ŸŸข **%player%** joined the server!"
  leave:
    enabled: true
    text: "๐Ÿ”ด **%player%** left the server."
  
  # Plugin Messages (In-Game)
  reload_success: "&a[BCD] Configuration reloaded successfully!"
  no_permission: "&c[BCD] You do not have permission to use this command."
  unknown_command: "&c[BCD] Unknown command. Use /bcd reload"