ChatSync - Minecraft to Discord Chat Sync

A client-side Fabric mod for Minecraft 1.21.10 that syncs in-game chat messages to a Discord webhook.

Features

• 🔄 Syncs both chat messages and game messages to Discord
• 🎯 Configurable message filtering with regex patterns
• ⚙️ Easy JSON configuration
• 🎮 In-game config screen via Mod Menu
• 🚀 Asynchronous webhook sending (doesn't lag the game)
• 🔒 Client-side only (works on any server)

Installation

1. Make sure you have Fabric Loader installed for Minecraft 1.21.10
2. Install Mod Menu (optional, but required for in-game config)
3. Download the ChatSync mod JAR file
4. Place it in your .minecraft/mods folder
5. Launch Minecraft

Configuration

You can configure ChatSync in two ways:

Option 1: In-Game Config Screen (Recommended)

1. Install Mod Menu
2. In Minecraft, go to: Mods → ChatSync → Config
3. Enter your Discord webhook URL
4. Customize the message prefix
5. Toggle enabled/disabled
6. Click "Done" to save

Option 2: Manual Configuration File

On first launch, the mod will create a configuration file at .minecraft/config/chatsync.json

Setting up your Discord Webhook

1. Go to your Discord server settings
2. Navigate to Integrations → Webhooks
3. Click "New Webhook"
4. Copy the webhook URL
5. Open .minecraft/config/chatsync.json
6. Replace YOUR_WEBHOOK_URL_HERE with your actual webhook URL

Configuration File Structure

{
  "webhookUrl": "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL_HERE",
  "enabled": true,
  "messagePrefix": "> ",
  "ignoredMessages": [
    "^\\[.*\\].*",
    "^>.*"
  ]
}

Configuration Options

• webhookUrl: Your Discord webhook URL
• enabled: Set to false to temporarily disable the mod without removing it
• messagePrefix: Text to prepend to every message (default: "> ")
  • Use "" for no prefix
  • Examples: "> ", "[MC] ", "🎮 ", etc.
  • ignoredMessages: Array of regex patterns for messages to ignore

Ignored Messages Examples

The ignoredMessages array uses regex patterns to filter out unwanted messages:

"ignoredMessages": [
  "^\\[.*\\].*",           // Ignore messages starting with [brackets]
  "^>.*",                  // Ignore messages starting with >
  ".*joined the game.*",   // Ignore join messages
  ".*left the game.*",     // Ignore leave messages
  "^!.*",                  // Ignore commands starting with !
  "^/.*"                   // Ignore commands starting with /
]

How It Works

The mod listens to two Minecraft events:

• Chat Messages: Player chat messages
• Game Messages: System messages (deaths, achievements, etc.)

When a message is received, it:

1. Checks if the mod is enabled
2. Checks if the webhook URL is configured
3. Checks if the message matches any ignored patterns
4. If all checks pass, sends the message to Discord asynchronously

Troubleshooting

Messages aren't appearing in Discord

1. Check that your webhook URL is correct in the config file
2. Make sure enabled is set to true
3. Check the Minecraft logs for any error messages
4. Verify your webhook is still active in Discord

Some messages are being ignored

Check your ignoredMessages patterns - they use regex, so make sure your patterns are correct.

The mod isn't loading

1. Ensure you have Fabric Loader 0.18.4 or higher
2. Ensure you have Fabric API 0.138.4+1.21.10 or higher
3. Check the Minecraft logs for errors

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

Join our discord! Discord