MC Matrix Bridge — соединяем чат Minecraft и Matrix без лишних усилий
Игровые серверы живут своей жизнью, а мессенджеры — своей. Но что если объединить их в единое информационное пространство? Именно эту задачу решает дополнение MC Matrix Bridge. Это серверный мод, который превращает обычную комнату Matrix в полноценный чат вашего майнкрафт-сервера. Игроки пишут в игре — сообщения уходят в Matrix. Участники комнаты отвечают — текст появляется в чате Minecraft. Всё просто, надёжно и без установки чего-либо на стороне клиента.
Главная фишка MC Matrix Bridge для Minecraft — ванильные клиенты. Вашим друзьям не придётся ничего скачивать, чтобы общаться через Matrix. Мод работает только на сервере, а значит, любой игрок с обычным лаунчером автоматически получает доступ к мосту. Это особенно удобно для проектов, где администраторы хотят держать связь с сообществом вне игры: в Discord-подобных комнатах, на мобильных устройствах или в веб-интерфейсе.
Как работает MC Matrix Bridge
Мост выполняет две основные задачи, и обе работают в обе стороны. Во-первых, он пересылает игровые сообщения в комнату Matrix. Во-вторых, сообщения из Matrix попадают обратно в чат сервера. При этом мод поддерживает только нешифрованные комнаты — без E2EE. Это осознанное ограничение, которое упрощает настройку и повышает стабильность работы.
Ключевые возможности
- Пересылка чата игроков в комнату Matrix с префиксом [MC] по умолчанию.
- Отправка сообщений из Matrix в игровой чат с префиксом [Matrix].
- Автопринятие приглашений в комнату при запуске сервера.
- Хранение состояния синхронизации в файле мира — это защищает от повторной отправки сообщений после рестарта.
- Гибкая настройка: можно отключить любое направление пересылки, включить уведомления о входе и выходе игроков, а также о старте и остановке сервера.
- OP-команды для управления: статус, перезагрузка конфигурации и тестовое сообщение.
Поддерживаемые версии и требования
Для работы MC Matrix Bridge потребуется сервер на Minecraft Forge. Версии Java зависят от версии игры: для Forge 1.18–1.20 нужна Java 17, а для Forge 1.21 и новее — Java 21. Разработчик вручную тестирует мод на популярных минорных версиях: 1.18.2, 1.19.2, 1.20.1 и 1.21.1. На других минорных версиях мод, скорее всего, тоже заработает, но без гарантий.
Если вы пользуетесь лаунчером foxygame.net, то скачать MC Matrix Bridge и установить его можно буквально в один клик — каталог дополнений в лаунчере сам подберёт совместимую версию мода под ваш сервер. Это избавляет от ручного поиска и проверки зависимостей, а автообновление всегда держит мост в актуальном состоянии.
Как установить MC Matrix Bridge
Процесс установки не займёт много времени. Вам нужно скачать MC Matrix Bridge в виде jar-файла и поместить его в папку mods вашего Forge-сервера. После первого запуска мод создаст конфигурационный файл, который останется только отредактировать.
Пошаговая инструкция
- Скачайте jar-файл мода с официальной страницы проекта.
- Скопируйте его в папку mods на сервере.
- Запустите сервер один раз, чтобы сгенерировался файл конфигурации.
- Откройте config/minecraftmatrixbridge.toml и заполните обязательные поля.
Настройка конфигурации
В файле minecraftmatrixbridge.toml есть три обязательных параметра. Первый — matrix.homeserver, адрес вашего Matrix-сервера, например https://matrix.example.com. Второй — matrix.roomId, идентификатор комнаты. Можно использовать как полный ID вида !abcdef:example.com, так и алиас #myroom:example.com. Важно, чтобы комната не была зашифрована. Третий параметр — matrix.accessToken, токен доступа. Его также можно задать через переменную окружения MATRIX_ACCESS_TOKEN.
Остальные настройки опциональны. Вы можете менять префиксы сообщений, включать или отключать уведомления о подключении, входе и выходе игроков, а также о жизненном цикле сервера. Есть параметры для тонкой настройки синхронизации: таймаут, лимит истории, размер очереди и дедупликация. По умолчанию всё настроено оптимально, так что большинству серверов хватит стандартных значений.
Управление мостом через команды
Для администраторов предусмотрены три OP-команды. Команда /matrix status покажет текущее состояние моста: подключена ли комната, сколько сообщений в очереди и так далее. /matrix reload перезагружает конфигурацию без перезапуска сервера — это удобно, когда нужно быстро поменять настройки. А /matrix test отправляет тестовое сообщение в комнату Matrix, чтобы убедиться, что всё работает корректно.
Отдельно стоит отметить, что состояние синхронизации хранится в папке мира, в файле state.json. Это значит, что после перезапуска сервера мод не будет заново отправлять старые сообщения, и в комнате не появится спам из дублей. Система дедупликации и очередь сообщений дополнительно защищают от потери данных при временных сбоях связи.
Итоги
MC Matrix Bridge — это продуманный инструмент для тех, кто хочет связать игровой чат с внешними коммуникациями. Мод не требует модификаций на клиенте, легко настраивается и стабильно работает на популярных версиях Forge. Если вы ищете способ держать игроков на связи даже вне сервера, этот мост станет отличным решением. А благодаря поддержке в лаунчере foxygame.net, где MC Matrix Bridge доступен в каталоге дополнений с автоматической проверкой совместимости версий, установка превращается в пару кликов мышью. Настройте мост один раз — и забудьте о проблемах с коммуникацией между Minecraft и Matrix.