MinecraftVideo (VMC)
在 Paper 1.21.8 服务器上,于虚拟的游戏内地图屏幕上播放视频,并支持同步的、具有空间感的音频。
该插件以子进程方式启动原生转换器(mcmm),并将解码后的帧作为地图数据包转发给玩家。所有内容均为虚拟:使用假的实体 ID、假的地图 ID,仅涉及数据包——不会向世界或磁盘写入任何内容。
支持从本地文件、直接 URL 或 YouTube(以及 1000+ 其他站点)播放:页面 URL 会通过 yt-dlp 解析为可播放的流媒体;如果服务器上尚未安装 yt-dlp,插件会在首次使用时自动下载——无需手动设置。
要求
- 服务器:Paper 1.21.8(或兼容版本)及 Java 21
- 依赖项:
- PacketEvents 插件(必需,>= 2.11.2)
- 服务器上已安装 ffmpeg & ffprobe 并已添加到系统
PATH中(音频和字幕功能必需) - Simple Voice Chat mod/插件(可选,用于音频;必须在服务器和客户端均安装,>= 2.6.0)
- yt-dlp(可选,用于 YouTube 风格的 URL;如果未包含在服务器的
PATH中,将在首次使用时自动下载。需要保持远程源缓存启用状态——此为默认设置。)
注意:原生 mcmm 二进制文件和原版调色板已打包在 jar 文件中,并在首次启动时自动提取。默认情况下仅打包静态链接的 linux-x64 二进制文件。
安装与设置
- 将 PacketEvents 插件安装到服务器的
plugins/文件夹中。 - (音频功能可选)安装 Simple Voice Chat 插件。
- 下载并将
minecraftvideo-pluginjar 文件放入plugins/目录。 - 启动服务器。在首次启动时,插件会将
mcmm和调色板提取到plugins/MinecraftVideo/中,并生成config.yml。 - 确保
ffmpeg和ffprobe可在系统PATH中找到。
快速开始
需要 minecraftvideo.use 权限(默认:OP)。
- 开始播放:
在你面前生成一个虚拟屏幕并播放视频(可以是本地路径、直接 URL 或 YouTube 链接——页面 URL 将通过 yt-dlp 解析,如果服务器上尚未安装 yt-dlp,插件会在首次使用时自动下载)。/video play <url-or-path> - 暂停 / 恢复:
/video pause /video resume - 停止播放:
/video stop - 性能状态:
/video status
完整文档与 Wiki
有关高级命令、自定义配置、空间音频和字幕的详细信息,请参阅 Wiki & Documentation Guide (WIKI.md):
- 屏幕尺寸与 FPS 配置
- 单声道、立体声与环绕声音频模式
- 字幕轨道渲染
- 播放列表与队列管理
- 音视频同步与延迟调整
- 从源代码构建与编译
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧