DiscordChats

Communicate between many private Discord channels and Minecraft with easy configuration!

• Supported Versions: 1.20 - 1.21.x
• Supported Platforms: Paper & Folia
• Dependencies: DiscordSRV

Example usage

config.yml:

BotToken: "YOUR_DISCORD_BOT_TOKEN"

DiscordChats:
  yourchatname:
    discordChatID: "000000000000000000"
    aliases: ["ycn", "onlycoolpeople"]
    bracketColor: "§6"          # Color of the [ ] around the chat name
    chatNameColor: "§b"         # Color of the chat name inside the brackets
    usernameColor: "§3"         # Color of the player/Discord nickname
    separatorColor: "§6"        # Color of the > in Minecraft → Discord 
    discordSeparatorColor: "§9" # Color of the > in Discord → Minecraft 
    messageColor: "§f"          # Color of the message body
  ... as many more as you want!

With this config the following will be created for you:

• Command: /yourchatname <msg> - Sends a minecraft message to the configured discord chat ID
  • Also all your optional aliases will work: /ycn <msg> /onlycoolpeople <msg>
• Permission: DiscordChats.yourchatname - Users with this permission can use the above command and will receive Discord messages from the configured chat ID in Minecraft!

Features

Per-chat color customization

Each chat channel can have its own color scheme for the message format displayed in Minecraft. All color keys are optional — omitting any will use the defaults shown above. Colors apply independently for each direction:

• separatorColor controls the > in Minecraft → Discord messages
• discordSeparatorColor controls the > in Discord → Minecraft messages (always blue by default to visually distinguish the direction)

Mentions: Minecraft → Discord

Players can ping Discord users and roles directly from Minecraft chat using @Name syntax.

User mentions

• @MinecraftName — looks up the player's linked DiscordSRV account first, then falls back to searching by Discord nickname/username. Works for both Java and Bedrock/Floodgate players (e.g. @.BedrockPlayer).
• @"Multi Word Name" — quote the name to mention someone whose name contains spaces.

Role mentions

• @RoleName — if the name matches a Discord role, all members of that role are pinged.

Mentions produce real Discord pings regardless of DiscordSRV's or the channel's mention settings.

Mentions: Discord → Minecraft (ping chime)

When a Discord user mentions someone in a linked chat channel, online Minecraft players are notified with an audible chime — only they can hear it. Two resolution paths run in parallel:

• Discord @mention — if the mentioned Discord user has a linked DiscordSRV account and is online in Minecraft, they receive the chime.
• Discord role @mention — every member of the mentioned role who has a linked account and is currently online receives the chime.
• Plain @MinecraftName — typing @SomePlayer without using Discord's mention system also triggers the chime for that online player. Supports Bedrock/Floodgate names starting with ..