安装与版本匹配
环境矩阵
| Minecraft | 客户端 | 服务端桥接 | Java | 主要依赖 |
|---|---|---|---|---|
| 1.21.11 | VideoPlayer-2.0.2.jar 对应构建 | VideoPlayer-Paper-2.0.2.jar 对应构建 | 21 | Fabric Loader 0.17.3、Fabric API 0.141.4+1.21.11、Paper API 1.21.11 |
| 26.2 | 文件名带 -26.2 的客户端构建 | 文件名带 -26.2 的桥接构建 | 25 | Fabric Loader 0.19.3、Fabric API 0.156.0+26.2、Paper API 26.2 build 92 |
-26.2 是分发文件名后缀，不会加入内部版本或握手版本。不要只看文件名的一部分；同时核对 Minecraft、VideoPlayer 版本和客户端/桥接类型。
安装 Fabric 客户端
- 安装与 Minecraft 版本匹配的 Fabric Loader。
- 将匹配的 Fabric API 放入客户端
mods目录。 - 将对应版本的 VideoPlayer 客户端 JAR 放入
mods。 - 启动游戏，在模组列表中确认
VideoPlayer 2.0.2已加载。 - 执行
/videoplayer boot，完成播放后端和运行库向导。
Mod Menu 是建议依赖而非必需依赖。Vivecraft 只在需要 VR 显示联动时安装。
安装服务端桥接
- 关闭服务器。
- 将对应 Minecraft 版本的 Paper/Folia 桥接 JAR 放入
plugins。 - 启动服务器，确认控制台显示 VideoPlayer 已启用。
- 使用
/vlcversion检查已连接玩家的客户端版本。 - 按需要安装 Residence；它是
softdepend，不使用领地控制时可不安装。
不要只安装桥接插件后让原版客户端加入。桥接只承担服务端状态与同步，不提供视频解码器或客户端渲染器。
版本匹配
多人播放至少同时满足：
- Minecraft 大版本完全一致，例如 1.21.11 客户端不能连接 26.2 构建。
- 客户端与桥接均为 VideoPlayer 2.0.2 的对应发行构建。
- Java 版本符合目标：1.21.11 使用 Java 21，26.2 使用 Java 25。
- Fabric Loader 与 Fabric API 满足对应模块构建要求。
加入时出现版本提示，先由管理员运行 /vlcversion，再让玩家核对模组列表和 JAR 文件名。不要通过重命名 JAR 伪装版本。
仅客户端与多人服务器
| 使用场景 | 客户端模组 | 服务端桥接 |
|---|---|---|
| 单人世界、本地播放 | 必需 | 不单独安装 |
| 使用 VideoPlayer 的多人服务器 | 每位观看者必需 | 服务器必需 |
| 不使用 VideoPlayer 的普通服务器 | 不需要 | 不需要 |
安装完成后继续快速开始。