WATERMeDIA: Multimedia API

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

Скоро выйдет альфа-версия WATERMeDIA v3. Пожалуйста, убедитесь, что скачиваете правильную версию (2.1.x), прежде чем сообщать о сбоях на GitHub.

📖 Обзор проекта

WATERMeDIA представляет собой библиотеку с тщательно продуманным API, которая обеспечивает поддержку мультимедиа с использованием нативных/Java декодеров и LibVLC в качестве видеобэкенда. Эта библиотека активно используется многими модами для Minecraft, включая LittleFrames и VideoPlayer, а также заменяет FancyVideo-API в игре.

Система интегрирует поддержку множества популярных платформ: YouTube, Twitch, Kick, Google Drive, OneDrive, Dropbox, Imgur, Twitter, Streamable, Lightshot и многих других!

Библиотека разработана для работы практически со всеми загрузчиками модов (Forge, NeoForge и Fabric) начиная с Minecraft 1.16.5 и может использоваться даже вне контекста Minecraft.

🎯 Моды, использующие WATERMeDIA

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

Особые упоминания

• NightmareCraft: Survival (недоступен)
• VideoPlayer (не поддерживается)

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

• Поддержка множества платформ (перечислены в обзоре)
• Встроенная предустановка LibVLC для Windows 10/11 (x64)
• Совместимость со всеми популярными загрузчиками модов (Forge, NeoForge и Fabric)
• Функция захвата изображений для снижения потребления трафика
• Простой и интуитивно понятный дизайн API
• Независимость от Minecraft (работает на большинстве версий игры и даже вне её)
• Высокая производительность и многопоточность

📦 Установка VideoLAN для macOS и Linux

Из-за ограничений операционных систем, пользователям macOS и Linux требуется принудительная ручная установка.

• Скачайте VideoLAN для macOS здесь
• Скачайте VideoLAN для Linux здесь

❓ Часто задаваемые вопросы

Почему мой сервер крашится при запуске с (Neo)Forge? WATERMeDIA не может работать на стороне сервера. Вам следует удалить JAR-файл с сервера и оставить его только на клиенте. В случае с Fabric необходимо сохранить JAR-файл WATERMeDIA на сервере.

Можно ли использовать VLC 4? Нет.

Почему игра крашится при наличии FancyVideo-API? FancyVideo-API и его форки несовместимы с WATERMeDIA. Обе библиотеки конфликтуют при загрузке VLC, что приводит к невозможности загрузки видеоплеера. Это относится ко всем другим мультимедийным API.

Можно ли установить VLC через Flatpak или Pacman? Нет. Любое решение для установки пакетов, использующее изолированные установки, нельзя использовать с WATERMeDIA. Minecraft, VLC и WATERMeDIA должны быть установлены нативными способами (например, через APT-GET).

⚖️ Лицензирование

WATERMeDIA распространяется под лицензией Polyform Strict License v1.0.0

Разрешено некоммерческое использование (включая, но не ограничиваясь: сборки модов и серверные сборки). Перераспределение или создание производных версий не допускается.

Для коммерческих целей или создания производных версий свяжитесь с нами для согласования коммерческой лицензии через Caprica Software Limited или получения бесплатной лицензии для некоммерческих производных версий при определенных условиях (наша лицензия VLCJ не распространяется на ваши форки).

Лицензирование VLCJ

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

Лицензирование LibVLC

Бинарные файлы LibVLC для Windows 10 (x64) распространяются под лицензией LGPLv2.1