WATERMeDIA: Multimedia API

Мод WATERMeDIA: Multimedia API для Minecraft 1.20.1

WATERMeDIA — это библиотека и API для разработчиков модов Minecraft, предоставляющая поддержку мультимедиа. Она использует нативные декодеры Java и LibVLC как видео-бэкенд, что позволяет внедрять воспроизведение видео с YouTube, Twitch, Kick и других сервисов прямо в игру. Проект позиционируется как замена устаревшему FancyVideo-API и работает с большинством популярных загрузчиков.

⚠️ Важное предупреждение о версиях

При использовании проекта обязательно следите за актуальностью версии. Alpha-версия WATERMeDIA v3 может вызывать сбои. Убедитесь, что вы скачиваете стабильную версию 2.1.x, прежде чем открывать тикет с жалобами на краши. Это критически важно для стабильности работы модов, использующих эту библиотеку.

📕 Обзор и возможности

WATERMeDIA предоставляет хорошо спроектированный API для интеграции мультимедиа. В отличие от многих аналогов, она поддерживает воспроизведение видео с множества платформ, включая YouTube, Twitch, Kick, Google Drive, OneDrive, Dropbox, Imgur, Twitter и Streamable. Библиотека работает на основе нативных декодеров Java и LibVLC, что обеспечивает высокую производительность и многопоточность. Она не ограничена только Minecraft и может использоваться в других контекстах.

🧩 Проекты, использующие WATERMeDIA

Библиотека является фундаментом для множества популярных модов, расширяющих возможности отображения контента. Среди основных пользователей — WaterFrames (от SrRapero720), LittleFrames (от CreativeMD) и WaterVision. Также проект поддерживает создание таких модов, как PictureSign, Prologue, Holographic Renderers и Owleaf PlayBack. Эти моды используют API WATERMeDIA для отображения видео, изображений и других медиа-файлов в интерфейсе игры.

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

Одной из ключевых особенностей библиотеки является встроенная предустановка LibVLC для Windows 10/11 (x64), что избавляет пользователей от необходимости искать и настраивать внешний плеер. API имеет упрощенный дизайн, что облегчает разработчикам создание собственных медиа-виджетов. Проект также поддерживает функцию "Picture catching" для снижения нагрузки на сеть при передаче изображений. Важно отметить, что библиотека работает на всех существующих загрузчиках модов и является агностичной к версии Minecraft.

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

Из-за ограничений операционных систем, установка видео-движка на macOS и Linux требует ручной настройки. Пользователям этих платформ необходимо самостоятельно установить VideoLAN (VLC) через официальные дистрибутивы. Для macOS можно скачать универсальный пакет, а для Linux использовать стандартные репозитории. Это обязательное условие для корректной работы мультимедийных функций на этих платформах.

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

Одной из частых проблем является краш сервера при запуске на (Neo)Forge. Причина в том, что WATERMeDIA не может работать на стороне сервера — файл должен быть удален с сервера и оставлен только на клиенте. В отличие от этого, Fabric по-прежнему требует наличия файла на сервере. Также стоит отметить, что использование VLC версии 4.0 не поддерживается, а любые решения с песочницей (Flatpak, Pacman) несовместимы с проектом. Библиотека требует нативной установки через APT-GET или аналогичные методы.

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод
• Just Enough Items (JEI) — похожий мод
• Geckolib — похожий мод
• More Culling — похожий мод
• Bookshelf — похожий мод