常见问题
先确认玩家客户端模组与服务器 Minecraft 版本一致，再按下面的现象排查。游戏内也可以输入 /nv help 查看分类帮助。
一眼定位
| 现象 | 原因 | 处理 |
|---|---|---|
| 命令提示没有权限 | 缺少 nekovideo.use | 给玩家/组该节点后重新执行命令 |
| 建屏提示已达上限 | 没有或不够 nekovideo.screen.limit.N | 提高数字节点；确认没有更高优先级的限制 |
| 播放控制权不足 | 不是屏主，且屏幕没有向你开放控制 | 让屏主开启 control on 并把你加入名单 |
| 服务器已开启播放管控 | 管理员打开了全服禁播 | 管理员执行 /nv admin lockdown off |
| 播放源不可播放 | 源在黑名单或不符合白名单 | 检查服务器直链白名单/黑名单；换用 B 站或允许的直链 |
| 影视页打不开 | 影视功能暂时关闭 | 改用 B 站、直播或允许的直链 |
| 只有画面没有声音 | 本地静音、音量或子屏同步设置 | 检查自己的音量/静音；子屏默认同步静音 |
| 走近才出画 | 超出 setrange 或全局视距 | 走近屏幕，或请管理员调整范围 |
“尚未通过双向构建验证”
- 确认客户端安装了 NekoVideo 模组，并且版本匹配服务器 Minecraft 版本。
- 等待几秒观察聊天，握手完成后再点播。
- 仍未完成时重进服务器。
- 管理员检查
/pl中NekoVideoPlugin是否为绿色，并查看启动日志。 - 多模组客户端报
Too many channels registered时，在-jar前加入-Dpaper.disableChannelLimit=true并重启。
“只有自己看不到”
这通常是本地状态或观看名单导致：
- 先靠近屏幕，确认没有超出屏幕的播放半径和全局视距；
- 检查自己的静音、音量和亮度，它们不会影响其他观众；
- 让屏主执行
/nv screen view <id> list，确认你不在黑名单； - 白名单模式下，只有名单成员、屏主和管理员能看。
“能看但不能控制”
默认只有屏主和管理员能换源、暂停和跳进度。屏主可以执行：
/nv screen view <id> add <玩家>
/nv screen view <id> control on
直播和实时流本身不能 seek；这不是权限问题。
“播放源不可播放”
按顺序检查：
- 地址是否为当前支持的 B 站视频、直播、虎牙/抖音直播或服务器允许的
.mp4/.m3u8直链。 - 是否误用了
vod:、https://gz360.tv/...或“影视”分页。 - 直链域名是否在
direct-url-whitelist中，协议是否在direct-url-allowed-schemes中（file://永远拒绝）。 - 管理员是否把该源加入了
blocked-sources；黑名单只拦截新点播。
“建屏提示已达上限”
管理员检查玩家身上的 nekovideo.screen.limit.* 节点。插件取最大数字，没有节点就是 0。若 VIP 到期后屏幕被禁用：
/nv screen list
/nv screen active <ID>
只有 screen-limit.reclaim-mode: disable 会保留数据；delete 模式删除后无法恢复。
“音乐投票不生效”
- 确认当前票数达到服务器设置的阈值（默认 3 票）；
- 切歌用
/nv music voteskip，插队用/nv music bump <队列序号>； - 点歌人本人可用
/nv music skip直接切自己点的歌； - 管理员可用
/nv music setvotes <数字>调整阈值，或用bump <序号> force强插。
仍未解决
管理员先记录复现命令、屏幕 ID、播放源类型、玩家是否在范围内，以及 plugins/NekoVideoPlugin 的启动/运行日志；不要在工单或群聊中粘贴 api-key、全服 Cookie 或完整黑名单。