WATERMeDIA: Multimedia API

WATERMeDIA - это библиотека с продуманным API, которая добавляет в Майнкрафт поддержку видео и аудио из разных источников. В основе лежит LibVLC, что позволяет крутить ролики с YouTube, Twitch, Kick, Google Drive, OneDrive, Dropbox, Imgur, Twitter, Streamable, Lightshot и ещё кучи площадок.

Зачем это вообще нужно? В ванильном Майнкрафте нет нормального способа проигрывать видео внутри игры. Можно, конечно, наклепать картинок или использовать сторонние утилиты, но всё это костыли. WATERMeDIA решает эту проблему: разработчики других модов (например, WaterFrames, LittleFrames, PictureSign) цепляются к её API и делают функционал вроде работающих экранов, голограмм или проигрывателей.

Мод работает на всех популярных загрузчиках: Forge, NeoForge и Fabric, начиная с Minecraft 1.16.5 и выше. При этом сама библиотека не привязана жёстко к версии - может работать даже вне контекста Майнкрафта. Производительность на уровне, всё многопоточное. Есть кэширование картинок для экономии трафика.

Важно знать

• WATERMeDIA v3 alpha скоро выйдет. Сейчас актуальная стабильная версия 2.1.x. Перед тем как создавать баг-репорт, убедись, что скачал правильную версию.
• FancyVideo-API и его форки несовместимы с WATERMeDIA - они конфликтуют при загрузке VLC, и в итоге ничего не работает. Если у тебя стоит FancyVideo-API, сначала удали его.
• На серверах (Forge/NeoForge) библиотека не работает серверсайд. Jar надо ставить только на клиент. Но на Fabric jar должен лежать и на сервере тоже - иначе краш.

Под капотом

На Windows 10/11 (x64) LibVLC встраивается автоматически. А вот на MacOS и Linux придётся ставить VideoLAN вручную. Причём только нативным способом (через APT-GET на Debian/Ubuntu, например). Flatpak, Pacman и прочие изолированные пакетные менеджеры не подходят - VLC не сможет нормально работать с Minecraft, если установлен через сендбокс.

Совместимость с версиями VLC

С VLC 4 библиотека не дружит. Только VLC 3.

Какие моды её используют

• WaterFrames (SrRapero720)
• WaterVision (SrRapero720)
• LittleFrames (CreativeMD)
• WaterFrames: Backported Edition (Toshayo)
• PictureSign (Motschen)
• Prologue (thunderrock424242)
• Holographic Renderers (Mysticpasta1)
• Owleaf PlayBack (Owleaf_Studio)

Были ещё NightmareCraft: Survival и VideoPlayer, но они больше не поддерживаются.

Лицензия

WATERMeDIA распространяется по Polyform Strict License v1.0.0. Нельзя делать форки, распространять изменённые версии. Нельзя использовать в коммерческих целях без отдельного соглашения с Caprica Software Limited.

Для модпаков или серверпаков можно использовать бесплатно, если это не коммерция.

VLCJ и VLCJ-natives внутри библиотеки - под коммерческой лицензией, предоставленной Caprica Software Limited.

LibVLC (бинарники под Windows x64) распространяются под LGPLv2.1.

Короче

Если тебе нужен работающий экран с ютубом в Майнкрафте или хочешь добавить видео в свой мод - WATERMeDIA лучший вариант на данный момент. Без неё никак, если только не писать свой велосипед с нуля. Поддерживает почти всё, что имеет URL с видео. Единственный минус - несовместимость с FancyVideo-API, ну и на маке с линуксом придётся повозиться с ручной установкой VLC.