快速开始

1. 初始化播放后端

进入游戏后执行：

/videoplayer boot

在向导中选择 MPV 或 VLC，检查操作系统与 CPU 架构，并选择自动下载运行库或已有运行库。默认服务端配置在 native.backend 为空时使用 MPV。

2. 检查客户端状态

/videoplayer diagnostics

确认后端已加载、运行库可用、音视频输出设备正常。YouTube 来源还需要可用的 yt-dlp；受限视频可能需要 Cookie。

3. 建立区域和屏幕

通过客户端管理界面打开创建流程：

1. 选择视频区域，确定允许交互和同步的范围。
2. 创建屏幕并按顺序设置顶点。
3. 检查屏幕朝向、UV、缩放和显示元数据。
4. 将屏幕与区域关联并保存。

创建和更新操作受 videoplayer.action.* 权限控制。在 Residence 内还必须满足领地所有者或 padd 规则。

4. 加入第一个来源

选中屏幕后执行：

/videoplayer play <url>

也可以在管理界面中把 URL 加入队列。使用自己有权公开播放的 HTTP(S) 直链、网络流或受支持平台链接。

5. 验证多人同步

1. 让另一位安装相同兼容版本客户端模组的玩家进入区域。
2. 确认双方看到相同屏幕和队列。
3. 使用同步功能校准进度。
4. 管理员运行 /vlcversion 检查客户端版本。

出现后端、下载、认证或同步问题时，打开诊断与故障排除。