WATERMeDIA: Multimedia API - WATERMeDIA：多媒体 API

⚠️ 警告

WATERMeDIA v3 alpha 即将发布，在因崩溃提交 github issue 之前，请确认你下载的是正确的版本（2.1.x）

📕 概览

WaterMedia 是一个拥有良好设计 API 的库，使用原生/java 解码器以及 LibVLC 作为视频后端来提供多媒体支持。它被许多 minecraft 模组使用，例如 LittleFrames 和 VideoPlayer，并且在 Minecraft 中取代了 FancyVideo-API；集成了对许多平台的支持，例如 YouTube、Twitch、Kick、Google Drive、OneDrive、Dropbox、Imgur、Twitter、Streamable、Lightshot 等等！

设计目标是在几乎所有 Minecraft Mod Loader（Forge、NeoForge 和 Fabric）上运行，支持 Minecraft 1.16.5 及以上版本，也可在 Minecraft 环境之外使用。

🧩 使用 WATERMeDIA 的 MOD

• WaterFrames（作者：SrRapero720）
• WaterVision（作者：SrRapero720）
• LittleFrames（作者：CreativeMD）
• WaterFrames: Backported Edition（作者：Toshayo）
• PictureSign（作者：Motschen）
• Prologue（作者：thunderrock424242）
• Holographic Renderers（作者：Mysticpasta1）
• Owleaf PlayBack（作者：

Owleaf_Studio）

特别提及

• NightmareCraft: Survival（不可用）
• VideoPlayer（已停止维护）

🛠️ 功能特性

• 多平台支持（见概览）
• 为 Windows 10/11（x64）集成 LibVLC 预安装
• 支持所有现有模组加载器（Forge、NeoForge 和 Fabric）
• 图片缓存以减少带宽占用
• 简洁的 API 设计
• 不依赖 Minecraft（几乎可在所有 Minecraft 版本上运行，甚至可在其外部运行）
• 高性能与多线程

🎮 支持我们并获得 15% 折扣

KineticHosting 是我们在主机解决方案方面的合作伙伴，非常适合用来搭建服务器，并通过上面列出的所有模组与你的朋友开始分享多媒体内容。

📦 为 MACOS 和 LINUX 安装 VIDEOLAN

由于操作系统限制，MacOS 和 Linux 需要强制手动安装。

• 在这里下载 MacOS 版 VideoLAN
• 在这里下载 Linux 版 VideoLAN

⁉️ 常见问题

• ¿为什么我的服务器在使用 (Neo)Forge 时启动就崩溃？
• WaterMedia 不能在服务端运行，你应该从服务端移除该 jar，只在客户端保留它。另一方面，Fabric 仍然需要在服务端保留 WaterMedia jar
• ¿我可以使用 VLC 4 吗？
• 不可以
• ¿为什么我安装了 FancyVideo-API 时游戏会崩溃？
• 因为 FancyVideo-API 及其分支与 WATERMeDIA 不兼容，这两个库在加载 VLC 时会发生冲突，最终都会导致 VLC 无法加载，这同样适用于所有其他多媒体 API
• ¿我可以通过 Flatpak 或 Pacman 安装 VLC 吗？
• 不可以，实际上，任何使用沙盒化安装的包管理方案都不能与 WATERMeDIA 一起使用，Minecraft、VLC 和 WATERMeDIA 都必须以原生方式安装（例如 APT-GET）

⚖️ 许可证

WaterMedia 采用 Polyform Strict License v1.0.0

允许非商业用途（包括但不限于：ModPacks 或 ServerPacks），不允许再分发或衍生版本

如需商业用途或制作衍生版本，请联系我们，以便与 Caprica Software Limited 协调商业许可证；或者在特定条件下获得一个用于非商业衍生版本的免费许可证（我们的 VLCJ 许可证不适用于你的分支）。

⚖️ VLCJ 许可

VLCJ 和 VLCJ-natives 已被打包并根据 Caprica Software Limited 慷慨提供和捐赠的 vlcj 商业许可证进行分发。

⚖️ LIBVLC 许可

LibVLC Windows 10（x64）二进制文件遵循 LGPLv2.1。