Chat Sync

ChatSync — синхронизация чата Minecraft с Discord

Клиентский мод на Fabric для Minecraft 1.21.10, который синхронизирует сообщения чата из игры с вебхуком Discord.

Возможности

• 🔄 Синхронизирует как сообщения чата, так и системные сообщения игры с Discord
• 🎯 Настраиваемая фильтрация сообщений с помощью regex-шаблонов
• ⚙️ Простая конфигурация в JSON
• 🎮 Экран настроек прямо в игре через Mod Menu
• 🚀 Асинхронная отправка вебхуков (не лагает игру)
• 🔒 Только на стороне клиента (работает на любом сервере)

Установка

1. Убедитесь, что у вас установлен Fabric Loader для Minecraft 1.21.10
2. Установите Mod Menu (необязательно, но нужен для настройки прямо в игре)
3. Скачайте JAR-файл мода ChatSync
4. Поместите его в папку .minecraft/mods
5. Запустите Minecraft

Настройка

Настроить ChatSync можно двумя способами:

Вариант 1: Экран настроек в игре (рекомендуется)

1. Установите Mod Menu
2. В Minecraft перейдите: Mods → ChatSync → Config
3. Введите URL вашего вебхука Discord
4. Настройте префикс сообщений
5. Включите или отключите мод
6. Нажмите «Done», чтобы сохранить

Вариант 2: Ручная настройка файла конфигурации

При первом запуске мод создаст файл конфигурации по пути .minecraft/config/chatsync.json

Настройка вебхука Discord

1. Перейдите в настройки вашего сервера Discord
2. Откройте раздел Integrations → Webhooks
3. Нажмите «New Webhook»
4. Скопируйте URL вебхука
5. Откройте .minecraft/config/chatsync.json
6. Замените YOUR_WEBHOOK_URL_HERE на ваш настоящий URL вебхука

Структура файла конфигурации

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

Параметры конфигурации

• webhookUrl: URL вашего вебхука Discord
• enabled: Установите false, чтобы временно отключить мод, не удаляя его

• messagePrefix: Текст, добавляемый перед каждым сообщением (по умолчанию: "> ")

  • Используйте "" для отсутствия префикса
  • Примеры: "> ", "[MC] ", "🎮 " и т. д.
• ignoredMessages: Массив regex-шаблонов для сообщений, которые нужно игнорировать

Примеры игнорируемых сообщений

Массив ignoredMessages использует regex-шаблоны для фильтрации ненужных сообщений:

"ignoredMessages": [
  "^\\[.*\\].*",           // Игнорировать сообщения, начинающиеся с [скобок]
  "^>.*",                  // Игнорировать сообщения, начинающиеся с >
  ".*joined the game.*",   // Игнорировать сообщения о входе в игру
  ".*left the game.*",     // Игнорировать сообщения о выходе из игры
  "^!.*",                  // Игнорировать команды, начинающиеся с !
  "^/.*"                   // Игнорировать команды, начинающиеся с /
]

Как это работает

Мод слушает два события Minecraft:

• Сообщения чата: сообщения игроков в чате
• Системные сообщения: системные сообщения (смерти, достижения и т. д.) Когда приходит сообщение, мод:

1. Проверяет, включён ли мод
2. Проверяет, настроен ли URL вебхука
3. Проверяет, совпадает ли сообщение с каким-либо из игнорируемых шаблонов
4. Если все проверки пройдены, асинхронно отправляет сообщение в Discord

Решение проблем

Сообщения не появляются в Discord

1. Проверьте, что URL вебхука в файле конфигурации указан верно
2. Убедитесь, что параметр enabled установлен в true
3. Проверьте логи Minecraft на наличие сообщений об ошибках
4. Убедитесь, что ваш вебхук всё ещё активен в Discord

Некоторые сообщения игнорируются

Проверьте ваши шаблоны в ignoredMessages — они используют regex, поэтому убедитесь, что шаблоны составлены правильно.

Мод не загружается

1. Убедитесь, что у вас установлен Fabric Loader 0.18.4 или выше
2. Убедитесь, что у вас установлен Fabric API 0.138.4+1.21.10 или выше
3. Проверьте логи Minecraft на наличие ошибок

Лицензия

Этот проект распространяется под лицензией MIT — подробности см. в файле LICENSE.

Поддержка

Присоединяйтесь к нашему Discord! Discord