VideoPlayer 是用于 Minecraft 1.21.11 的 Fabric 视频播放模组，配套提供 Paper/Folia 服务端桥接插件。客户端负责解码与渲染，服务端负责区域、屏幕、权限、持久化和玩家间同步；多人服务器中的观看者需要安装相同兼容版本的客户端模组。
- VLC 与 MPV 双播放后端，启动向导可检测、安装运行库并配置下载代理。
- 支持直链和网络流，以及哔哩哔哩视频/直播、YouTube、网易云音乐和 MV、实体视角等来源。
- 支持播放队列、IdlePlay、同步、跳过投票、弹幕、字幕、音频通道和播放诊断。
- 支持自由顶点屏幕、UV 裁切、缩放、360 球面和可选 Vivecraft VR 集成。
- Paper/Folia 服务端桥接支持权限节点和 Residence 区域控制。
- 曲面屏沿用既有
FLAT曲面：以闭合的非共面顶点条带表达，兼容客户端可直接渲染和交互，无需新增数据包字段或CURVED枚举。
| 组件 | 要求 |
|---|---|
| 客户端 | Minecraft 1.21.11、Fabric Loader、Fabric API、Java 21 |
| 服务端桥接 | Paper 1.21.11 或兼容实现、Java 21 |
| Folia/Luminol | 插件声明支持 Folia；目标 Luminol 1.21.11 仍应在实际服务器上验证 |
运行库下载源覆盖 Windows、Linux、macOS 和 Android 的常见架构。MPV 与 VLC 的实际可用性取决于所选平台和本机运行库；可通过启动向导安装或改用已有运行库。
- 从 GitHub Release 或 Actions 构建产物 获取对应 JAR。
- 将 Fabric 模组 JAR 放入每位观看者的
mods目录，并安装匹配版本的 Fabric Loader 与 Fabric API。 - 多人服务器将 Paper 插件 JAR 放入
plugins目录后重启服务器。该插件是客户端模组的服务端桥接，不能单独让原版客户端播放视频。 - 进入游戏后执行
/videoplayer boot，选择 VLC 或 MPV，并按向导完成运行库和yt-dlp配置。 - 使用客户端的创建、管理界面或命令建立区域和屏幕，再将可播放 URL 加入屏幕队列。
请只播放拥有授权或允许公开播放的内容，并遵守视频源及其所在地区的服务条款。
以下是客户端命令；/vlc 是 /videoplayer 的兼容别名。
| 命令 | 用途 |
|---|---|
/videoplayer help |
查看客户端命令及子命令说明 |
/videoplayer boot |
打开播放后端、运行库和下载设置向导 |
/videoplayer backend <backend> |
查看或切换新播放任务使用的后端；backend 为 vlc 或 mpv |
/videoplayer play <url> |
向当前选中的屏幕请求播放 |
/videoplayer diagnostics |
打开播放诊断 |
/videoplayer biliAuth |
打开或管理哔哩哔哩认证 |
/videoplayer youtubeAuth |
打开或管理 YouTube Cookie 认证 |
Paper 插件提供的管理命令如下：
| 命令 | 所需权限 | 用途 |
|---|---|---|
/videoplayer:vlc joinmessage |
videoplayer.joinmessage |
切换客户端版本加入提示 |
/vlcversion |
videoplayer.version |
查看已连接客户端的 VideoPlayer 版本 |
完整的权限节点见 plugin.yml。videoplayer.admin 默认授予 OP，并包含服务端管理权限；在 Residence 区域中，创建与编辑操作还会遵循区域所有者和 padd 控制。
曲面屏不使用新的服务端类型。将屏幕表面保留为 FLAT，并按以下顺序提交闭合条带顶点：
- 上边沿弧线从左到右。
- 下边沿弧线从右到左返回。
顶点总数最多为 64，建议弧角小于 180 度。服务端会沿用现有创建、更新、校验、广播和世界持久化路径，保持顶点顺序及显示配置；兼容客户端会按弧长展开 UV、三角化并参与射线命中。
项目使用 Gradle Wrapper 和 Java 21：
.\gradlew.bat build
.\gradlew.bat test
.\gradlew.bat :paper-plugin:test构建产物：
| 模块 | 产物路径 |
|---|---|
| Fabric 客户端模组 | build/libs/VideoPlayer-*.jar |
| Paper/Folia 服务端插件 | paper-plugin/build/libs/VideoPlayer-Paper-*.jar |
GitHub Actions 会在每次推送和 Pull Request 中使用 Java 21 执行构建，并上传这两个产物。
本项目以 GPL-3.0 发布。
作者：squi2rel、cloudfl4re。