Matrix Bridge

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

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

Мод передаёт различные события сервера в Matrix: запуск и остановку сервера, подключение и отключение игроков, смерть персонажей и сообщения из чата. Также доступны специальные команды для пользователей Matrix: '!list' для получения списка игроков онлайн, '!ping' для проверки связи с сервером и '!invite' для добавления игрока в вайтлист.

Технические особенности

Авторизация осуществляется через пароль, поддерживаются зашифрованные комнаты и верификация сессий. Конфигурация настраивается через YAML-файл, а для работы с данными можно использовать различные базы данных: H2 (по умолчанию), SQLite, MariaDB и PostgreSQL.

Конфигурация

config.yaml

# Версия конфигурации
version: 2

# Расширенное логирование Trixnity
verbose: false

# Настройки аккаунта
account:
  homeserver: "https://matrix.example.org"
  username: "user"
  password: "pass"
  device_name: "Matrix-Minecraft Bridge"
  room: "!sdfDsdfsA:matrix.example.org"

# Верификация
verification:
  type: "KEY"
  token: "AaAA aaAa AAaa..."

# База данных
database:
  type: "H2"
  name: "database"
  hostname: "localhost:3306"
  username: "user"
  password: "pass"

# Команды
commands:
  list:
    format: "📜 Онлайн игроки: %players%"
    enabled: true
  ping:
    format: "🏓 Понг!"
    enabled: true
  invite:
    format:
      success: "🔵 '%player%' добавлен в вайтлист!"
      error: "🔵 '%player%' не найден. Использование: !invite <имя_игрока>"
      already: "🔵 '%player%' уже в вайтлисте!"
    enabled: false
  invalid_command: "⛔ Команда не найдена! Доступные команды: %commands%"
  disabled_command: "⛔ Команда отключена! Обратитесь к администратору."

# Сообщения
messages:
  start:
    format: "❇ Сервер запущен"
    enabled: true
  stop:
    format: "🛑 Сервер остановлен"
    enabled: true
  chat_matrix_to_minecraft:
    format: "[§e%player%§r] "
    enabled: true
  chat_minecraft_to_matrix:
    format: "<%player%> "
    enabled: true
  player_join:
    format: "🔹 %player% присоединился к игре"
    enabled: true
  player_quit:
    format: "🔹 %player% покинул игру"
    enabled: true
  player_death:
    format: "🪦 %message%"
    enabled: true
  player_advancement:
    format: "🎉 %player% получил достижение '%advancement%'!"
    enabled: true

Совместимость с Better Than Adventure

Для работы с Better Than Adventure требуется Java 11 или новее, так как на Java 8 мод вызовет краш. Также необходим переопределение зависимости для Fabric Language Kotlin, поскольку BTA Babric не поддерживает требуемую версию Fabric Loader.

fabric_loader_dependencies.json

{
  "version": 1,
  "overrides": {
    "fabric-language-kotlin": {
      "-depends": {
        "fabricloader": "IGNORED"
      }
    }
  }
}

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