Webcam

Мод и плагин, который позволяет игрокам транслировать видео со своих веб-камер прямо в игре Minecraft.

⚠️ Важное предупреждение

Для работы этого плагина требуется специальная настройка на сервере. Если вы администратор сервера, сначала ознакомьтесь с разделом "Настройка на сервере".

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

• Качественная трансляция видео с веб-камер
• Поддержка видеокодека H.264
• Передача видео через UDP с использованием собственного протокола
• Шифрование AES для защиты данных
• Контроль битрейта и разрешения видео
• Различные формы отображения веб-камер
• Настройка размера и положения дисплея
• Отображение на лице модели игрока
• Ограничение дистанции видимости
• Система разрешений для трансляции и просмотра
• Расширенные настройки клиента (требуются Mod Menu и Cloth Config API)
• Возможность скрывать веб-камеры выбранных игроков
• Поддержка Velocity proxy
• Совместимость с ReplayMod и Flashback

Использование на клиенте

Поместите мод в папку mods (вместе с Fabric API, если используете Fabric). Меню настроек можно открыть с помощью горячей клавиши (по умолчанию C).

Значки статуса

Значок	Описание
	Ваша веб-камера активна
	Ваша веб-камера отключена
	Подключение к серверу Webcam
	Нет соединения с сервером Webcam

Безопасность

Соединение Webcam зашифровано, но мы не гарантируем абсолютную безопасность. Используйте на свой страх и риск!

Настройка на сервере

Плагин Webcam использует UDP-сокет для передачи видеопакетов. Вам необходимо открыть UDP-порт в брандмауэре сервера и панели управления (если есть), чтобы сервер Webcam работал. По умолчанию это порт 25454/udp. Порт можно изменить в конфигурации сервера.

Если вы используете Velocity, см. раздел "Настройка на прокси".

Конфигурация сервера

Расположение файлов:

• Fabric / Quilt / NeoForge: config/webcam/server.json
• Bukkit / Spigot / Paper: plugins/webcam/server.json

Значения по умолчанию с описаниями:

{
  "port": 25454,                 // Порт UDP-сервера Webcam. Не должен конфликтовать с другими используемыми UDP-портами
  "bind_address": "",            // Адрес для привязки сервера Webcam. Оставьте пустым для использования wildcard-адреса
  "host": "",                    // Имя хоста для подключения клиентов. Оставьте пустым для использования адреса подключения игрока
  "keep_alive_period": 1000,     // Период отправки keep alive пакетов в миллисекундах
  "permission_check_period": 60, // Период проверки разрешений webcam.broadcast и webcam.view в тиках
  "max_display_distance": 100.0, // Максимальное расстояние в блоках для отображения веб-камер других игроков
  "display_on_face": false,      // Отображать веб-камеру на лице модели игрока или над головой
  "display_shape": "round",      // Форма отображения веб-камер. Возможные значения: "round", "square"
  "display_offset_y": 1.3,       // Смещение по Y для веб-камер над головами игроков
  "display_size": 1.2,           // Размер отображения веб-камер над головами игроков
  "hide_nicknames": true,        // Скрывать никнейм игрока при включенной веб-камере
  "display_self_webcam": true,   // Показывать собственную веб-камеру игроку
  "synced": {                    // Эти настройки синхронизируются с клиентами
    "image_dimension": 360,      // Размер стороны квадратного изображения веб-камеры
    "mtu": 1100,                 // Максимальный размер передаваемого блока. Уменьшите, если изображение искажается
    "bitrate": 500               // Целевой битрейт видео (кбит/с)
  },
  "messages": {                  // Пользовательские переводы сообщений
    "incompatible_mod_version": "Несовместимая версия Webcam. Ваша - %s, серверная - %s"
  }
}

Команды

• /webcamconfig <поле> [новое_значение] - команда для чтения/изменения значений конфигурации. Требует разрешение webcam.command.config или статус OP.

Разрешения

• webcam.command.config - разрешение на изменение конфигурации сервера Webcam (по умолчанию: уровень OP)
• webcam.broadcast - разрешение на трансляцию веб-камеры (по умолчанию: true)
• webcam.view - разрешение на просмотр веб-камер (по умолчанию: true)

Настройка на прокси

Webcam имеет плагин для Velocity, который проксирует серверы Webcam на бэкенд-серверах Minecraft и позволяет подключаться к разным серверам Webcam через один порт.

Если вы запускаете прокси и бэкенд-серверы на одной машине, вам нужно настроить для них разные порты.

Конфигурация прокси

Файл конфигурации расположен в plugins/webcam/config.properties

Значения по умолчанию с описаниями:

# Конфигурация прокси Webcam

# Порт UDP-сервера Webcam. Не должен конфликтовать с другими используемыми UDP-портами
port=25454

# Адрес для привязки сервера Webcam. Оставьте пустым для использования wildcard-адреса
bind_address=

# Имя хоста для подключения клиентов. Оставьте пустым для использования адреса подключения игрока
host=

Лицензия

Этот мод распространяется под лицензией No Unauthorized Distribution License, полный текст которой можно найти по ссылке: https://github.com/DimasKama/Webcam/blob/master/LICENSE.md

Краткое описание лицензии

• Модпаки: Можно использовать мод в модпаках, но нельзя включать его файлы напрямую. Вместо этого укажите его как зависимость, ссылающуюся на официальный источник загрузки.
• Для разработчиков: Разрешено создавать аддоны или интегрировать поддержку мода, но нельзя копировать его код. Сделайте его внешней зависимостью, загружаемой с официального источника.
• Ограничения распространения: Нельзя перезагружать или делиться кодом или скомпилированными файлами мода публично без явного разрешения автора.
• Личное использование: Можно использовать и изменять мод для личного использования, но любые изменения должны оставаться приватными.
• Официальные источники: Любая зависимость или ссылка на модпак должна указывать на официальные источники загрузки, предоставленные автором.