
⚠️ 警告
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 需要强制手动安装。
⁉️ 常见问题
- ¿为什么我的服务器在使用 (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。