Skip to main content

安装与上线检查

这页给服主和管理员使用。NekoVideo 的播放链路由 服务端插件 + 客户端模组 共同完成；玩家只安装模组，管理员还要确认插件、授权和频道都正常。

上线前清单​

1. 插件已启用​

在控制台或游戏内执行：

/pl

NekoVideoPlugin 必须显示为绿色。红色表示插件没有启用，先查看启动日志里与 NekoVideo 相关的报错。

常见原因：

  • plugins/NekoVideoPlugin/config.yml 中 api-key 为空或无效；
  • 授权服务器无法连接；
  • 数据库初始化失败。

修改授权、存储类型或授权相关配置后，请整服重启，不要用 PlugManX 热加载本插件。

2. 客户端版本匹配​

玩家客户端必须安装 NekoVideo 模组，且模组版本要和服务器的 Minecraft 版本一致。首次进服后等待几秒完成握手。

如果聊天出现：

客户端尚未通过双向构建验证

先不要点播，让玩家重进一次或等待握手完成。握手未完成时，/nv 播放命令会被拦截。

3. 检查插件频道上限​

Paper/Leaf 默认每位玩家最多注册 128 条插件通道。多模组客户端出现 Too many channels registered 时，在启动参数中加入：

-Dpaper.disableChannelLimit=true

参数要写在 -jar 前面，加入后重启服务器。

4. 确认基础权限​

默认玩家至少需要：

nekovideo.use

没有该节点时，发现页、/nv 命令和基础点播都不可用。创建自己的屏幕还需要 nekovideo.screen.limit.N，创建/加入一起听房间需要 nekovideo.music.room.use。

首次验收​

用一个普通玩家账号完成以下动作：

  1. 进服并确认握手提示消失。
  2. 按 B 打开发现页，选择一块已有屏幕并播放 B 站 BV 号。
  3. 走近屏幕确认画面和声音出现，走远确认按视距停止收流。
  4. 按 M 搜索并点一首歌，确认队列和投票按钮可见。
  5. 如果开放建屏权限，执行 /nv wand、框选矩形并创建测试屏，完成后删除。

推荐的首次配置顺序​

  1. 先按配置参考设置 music、直链白名单、黑名单和屏幕回收策略。
  2. 再按管理员手册给默认组、VIP 和管理组分配权限。
  3. 最后用命令速查做一轮播放、屏幕和音乐验收。
影视入口

上线验收不要打开“影视”页，也不要用 vod: 或 https://gz360.tv/... 进行测试；该功能目前对全服关闭。