VMC

插件

· 作者 nathanael.buendia

在 Paper 服务器的虚拟游戏内地图屏幕上播放视频。该插件会作为子进程启动现有的原生转换器(mcmm,来自 c version/),并将其解码后的帧以地图数据包的形式发送给玩家。

0 本站下载 0 关注 更新于 3 周前

需要前置:PacketEvents

最新 1.0.1 · 26.3 · Paper / Purpur

一键开服(送7天)

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 二进制文件。


安装与设置

  1. 将 PacketEvents 插件安装到服务器的 plugins/ 文件夹中。
  2. (音频功能可选)安装 Simple Voice Chat 插件。
  3. 下载并将 minecraftvideo-plugin jar 文件放入 plugins/ 目录。
  4. 启动服务器。在首次启动时,插件会将 mcmm 和调色板提取到 plugins/MinecraftVideo/ 中,并生成 config.yml。
  5. 确保 ffmpeg 和 ffprobe 可在系统 PATH 中找到。

快速开始

需要 minecraftvideo.use 权限(默认:OP)。

  • 开始播放:
    /video play <url-or-path>
    
    在你面前生成一个虚拟屏幕并播放视频(可以是本地路径、直接 URL 或 YouTube 链接——页面 URL 将通过 yt-dlp 解析,如果服务器上尚未安装 yt-dlp,插件会在首次使用时自动下载)。
  • 暂停 / 恢复:
    /video pause
    /video resume
    
  • 停止播放:
    /video stop
    
  • 性能状态:
    /video status
    

完整文档与 Wiki

有关高级命令、自定义配置、空间音频和字幕的详细信息,请参阅 Wiki & Documentation Guide (WIKI.md):

  • 屏幕尺寸与 FPS 配置
  • 单声道、立体声与环绕声音频模式
  • 字幕轨道渲染
  • 播放列表与队列管理
  • 音视频同步与延迟调整
  • 从源代码构建与编译

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源