Matrix Bridge (Better Than Adventure)

Мод Matrix Bridge создаёт беспроблемное соединение между чатом сервера Minecraft и комнатой в Matrix. Используя эту модификацию, участники Matrix могут общаться с игроками в Minecraft напрямую, без необходимости входить в игровой мир.

Основные возможности

Система передаёт различные оповещения в обе стороны: начало и остановка сервера, подключения и отключения игроков, случаи гибели персонажей и переписка в чате. Кроме того, реализована поддержка команд "!ping", "!list" и "!invite <имя_пользователя>". Команда "!invite" позволяет участникам Matrix самостоятельно добавлять пользователей в вайтлист, если это разрешено настройками.

Технически мост ориентирован только на стандартную авторизацию по паролю. Использование токенов доступа или системы единого входа пока не поддерживается.

Настройка конфигурации

Файл конфигурации размещается по пути 'matrix-bridge/config.json'.

Пример конфигурационного файла:

"version": 1, # НЕ ИЗМЕНЯЙТЕ. Служит для определения необходимости обновления конфигурации.
"homeserver": "https://example.org", # Адрес сервера Synapse. Поддерживается делегирование.
"username": "user", # Часть имени пользователя перед доменом в MXID.
"password": "password", # Пароль пользователя. Токены и SSO не поддерживаются.
"deviceName": "Matrix-Minecraft Bridge", # Название устройства.
"verifyType": "KEY", # Может быть KEY или PASSPHRASE
"verifyToken": "AaAA aaAa AAaa...", # Соответствующее значение для verifyType. В примере - KEY
"room": "!Msdjfjxcjdj323:example.org", # Внутренний идентификатор комнаты
"verbose": false, # Включение подробных сообщений журнала Trixnity. Полезно для отладки.
"commandInvite": true, # Включена ли команда !invite.
"messagePlayer": "[§e%player%§r] ", # %player% заменяется именем игрока.
"messageStart": "❇ Server started",
"messageStop": "🛑 Server stopped",
"messageJoin": "🟡 %player% joined the game",
"messageLeft": "🟡 %player% left the game",
"messageDeath": "🪦 %message%",
"messageList": "📜 Online players: ", # Выводится перед списком игроков
"messagePong": "🏓 Pong!",
"messageInvalid": "⛔ Command not found! Available commands: !ping, !list, !invite <username>",
"messageDisabled": "⛔ Command disabled! Please contact an administrator if this is an error.", # Используется при отключённой команде invite.
"messageWhitelistSuccess": "🔵 '%player%' has been whitelisted!",
"messageWhitelistError": "🔵 '%player%' could not be found.",
"messageWhitelistAlready": "🔵 '%player%' is already whitelisted!",
"messageChat": "<%player%> "

Важные замечания по настройке:

• Адрес homeserver должен включать префикс 'http(s)'. Например: 'https://example.org'
• Имя пользователя указывается только как локальная часть: 'user', не '@user:example.org'
• Для комнаты указывается полный идентификатор: '!Msdjfjxcjdj323:example.org'

Если вы не уверены в адресе вашего homeserver, его можно найти в Element в разделе 'Settings' → 'Help & About' → 'Advanced'.

Используемые технологии

Matrix Bridge использует Trixnity Matrix SDK для взаимодействия с платформой Matrix и требует Fabric Language Kotlin для работы в среде Fabric.

Rendering: Mooctip

Данный модификатор совместим только с пакетом модификаций 'Better Than Adventure'. Для стандартных версий Minecraft следует использовать соответствующую версию мода.