ConditionalVideos (Кондишенал Видео)

Мод для Майнкрафт, который запускает ролики и кат-сцены по событиям в игре. Подойдёт для серверов, сюжетных карт, квестов и ролевых миров: сервер определяет событие, а нужный игрок видит видео с локального файла или по ссылке.

Возможности

• Видеоролики можно назначить на первый вход в мир, смерть, использование тотема бессмертия и сон в кровати.
• Отдельные ролики срабатывают при смерти от конкретного моба, убийстве моба, получении достижения, переходе в измерение, получении или крафте предмета, открытии рецепта и достижении значения в таблице счёта.
• Для каждого события доступен плейлист из нескольких видео. Между частями можно сделать мгновенную смену или плавное затухание и появление, включить повтор плейлиста либо отдельного ролика и задать время перехода к следующему фрагменту.
• На ролик настраиваются громкость, фон, заголовок и описание, расположение и масштаб текста, прозрачность подложки. В названиях и описаниях поддерживаются коды форматирования вроде &6 и &l.
• Одновременные срабатывания не обрывают друг друга: ролики выстраиваются в очередь. Событие firstJoin всегда показывается первым.
• Источником служит путь к файлу на компьютере или ссылка; через WATERMeDIA поддерживаются прямые ссылки и ролики с YouTube, Twitch, Kick, TikTok, SoundCloud и других сервисов.
• Для условия таблицы счёта доступны сравнения equal, less, greater, lessOrEqual и greaterOrEqual. Оно срабатывает при пересечении порога и снова станет активным, только когда значение сначала перестанет соответствовать условию.

Как пользоваться

Правила для одиночной игры и клиента задаются в config/conditionalvideos.json, а правила выделенного сервера — в config/conditionalvideos-server.json. У каждого условия укажите список videos с полем source — путём к видеофайлу или ссылкой.

В сетевой игре сервер использует свой файл настроек как основной, автоматически передаёт игрокам локальные видео и сохраняет их в кэше. Ссылки каждый клиент воспроизводит самостоятельно.

По умолчанию клавиша пропуска не назначена, поэтому используется Esc. Отдельную клавишу можно назначить в меню «Настройки» → «Управление» → «Conditional Videos».

• Короткое нажатие пропускает текущий ролик и переходит к следующему фрагменту плейлиста.
• Удерживайте клавишу до заполнения индикатора, затем отпустите её, чтобы закрыть весь плейлист.
• Для ролика с skippable = false пропуск недоступен.

Настройки

Файл config/conditionalvideos-common.json управляет воспроизведением:

• videoQuality — качество потока: AUTO, LOWEST, LOW, MEDIUM, HIGH или HIGHEST;
• alwaysShowCursor — не скрывать курсор во время ролика;
• allowGameSounds — оставить звуки Майнкрафта включёнными;
• blockMatureContent — блокировать источники с контентом для взрослых;
• debugLogging — включить подробные сообщения для поиска неполадок.

Во время показа ролика уведомления скрываются. Если не включён allowGameSounds, игровые звуки заглушаются.

Требования и совместимость

Работает с Fabric, Forge и NeoForge. На клиенте необходимы WATERMeDIA: Multimedia API и WATERMeDIA: Native Binaries; для Fabric также требуется Fabric API. Видео работают с OpenGL; поддержка рендерера Vulkan экспериментальная.

Команды

Команды доступны операторам с уровнем прав 2, командным блокам и консоли сервера:

/conditionalvideos play <targets> <condition>
/conditionalvideos stop <targets>
/conditionalvideos pause <targets>

play принудительно запускает условие для указанных игроков, stop закрывает ролик и очищает очередь, а pause ставит текущий ролик на паузу или продолжает его. Для простых условий используйте ключи вроде firstJoin и playerDeath; для остальных — формат тип/ключ, например entityKilled/minecraft:warden, advancement/minecraft:story/mine_diamond, dimension/minecraft:the_nether или scoreboard/kills.