玩家教程

这是一份从进服到一起听的完整流程。没有 screen.limit.N 也不影响观看别人屏幕和参与点歌。

影视暂时关闭

不要使用“影视”页、vod:数字 或 https://gz360.tv/...。本页示例都使用 B 站、直播和服务器允许的直链。

进服前准备

1. 安装 NekoVideo 客户端模组，版本与服务器 Minecraft 版本一致。
2. 进服后等待几秒完成握手。若聊天显示“客户端尚未通过双向构建验证”，先重进一次或等握手完成，再点播。
3. 确认自己拥有 nekovideo.use（通常默认已有）。没有该权限时，/nv 全部不可用。

快捷键

按键	用途
B	发现页：B 站推荐、历史、直链/直播、关于
N	我的屏幕：创建、绑定、编辑自己的屏幕
M	音乐中心：搜歌、点歌、队列、歌单、一起听
J	切换画质上限：720 / 1080 / 1080P60 / 2K / 4K
U	移动左上角迷你歌词/音乐条
小键盘 1	投票同意
小键盘 2	投票反对

靠近正在播放的屏幕时，右上角会显示灵动岛：进度、画质和下一集。音量、亮度和静音是本地设置，不会改变其他人的体验。

看视频或直播

用界面（推荐）

1. 按 B 打开发现页。
2. 在顶部选择目标屏幕，确认内容要播到哪一块屏。
3. 点击推荐/历史卡片，或打开“直链/直播”粘贴地址。
4. 走近屏幕观看。附近没人时，内容会保留在屏幕上，观众走近后再自动开播。

用命令

/nv play <屏幕id> <内容>

支持的内容：

类型	示例	说明
B 站视频	BV1xxxxxxxx 或视频链接	点播，可暂停、跳进度
B 站直播	https://live.bilibili.com/房间号 / bilibili:房间号	直播，不能跳进度
虎牙直播	https://www.huya.com/房间号 / huya:房间号	直播
抖音直播	直播间链接 / douyin:房间号	直播
直链	https://...mp4 / .m3u8	需要服务器允许该域名

常用控制：

/nv pause <屏幕id>          # 暂停并记住进度
/nv resume <屏幕id>         # 从暂停处继续
/nv seek <屏幕id> <0-100>   # 跳到百分比（直播不可用）
/nv screen stop <屏幕id>    # 停止这块屏
/nv quality                  # 查看当前画质
/nv quality 1080             # 设置画质，也可用 720 / 2k / 1080p60 / 4k

可选参数加在地址后面：

• download / 下载：先缓存再播，需要 nekovideo.download；
• loop / 循环：循环播放，会自动开启下载缓存，同样需要该权限；
• 纯数字：填写视频时长（秒），让播放列表自动切下一首。

直播和实时流不能 download、loop 或 seek。

自己的屏幕

创建

普通玩家需要 nekovideo.screen.limit.N；没有任何 limit 节点时上限为 0。创建流程：

1. 执行 /nv wand，拿到金色苹果“选区工具”。
2. 对着墙或地面左键点击两个对角，框出矩形。
3. 执行 /nv screen create home（名称建议用英文或短拼音）。
4. 创建成功后苹果会收回；选区过期就重新框选。

管理

/nv screen list
/nv screen info <id>
/nv screen stop <id>
/nv screen active <id>
/nv screen deactive <id>
/nv screen delete <id>              # 只能删自己的
/nv screen setrange <id> <半径>
/nv screen setaudiodist <id> <距离>
/nv screen bind <父id> <子id>
/nv screen unbind <子id>

普通玩家的声音距离最高 128 格；管理员/OP 最高 512 格。绑定多屏时，子屏默认静音，避免回声。

谁能看、谁能播

默认走近就能看，屏主和管理员始终能看并控制。屏主可以按观看模式管理名单：

/nv screen view <id> mode none|white|black
/nv screen view <id> add <玩家>
/nv screen view <id> remove <玩家>
/nv screen view <id> list
/nv screen view <id> control on|off

设置	含义
none	不限制，范围内都能看
white	仅名单、屏主和管理员能看
black	名单内玩家看不见
control on	名单内玩家也能换源、暂停、跳进度
control off	只有屏主和管理员能控制

别人的屏默认不能换片；能否观看取决于范围和名单。

B 站登录（可选）

游客也能播放，但高清、大会员或风控较严的内容可能失败或只有低画质。按 B 后点击发现页左下角“登录”，用手机扫码；也可以执行：

/nv bilibili login
/nv bilibili logout

登录只作用于你自己，不会把账号共享给全服。

全服音乐

按 M 打开音乐中心，或使用：

/nv music search <歌名>
/nv music play <歌名>
/nv music playid <歌曲id>
/nv music queue
/nv music skip
/nv music voteskip
/nv music bump <队列序号>
/nv music remove <队列序号>
/nv music playnext <歌曲id>
/nv music pushlist <歌单id>
/nv music bind <网易云UID>
/nv music unbind
/nv vote yes
/nv vote no

规则：

• 全服共用一条队列，大家一起听；
• 切歌、插队和推歌单由投票决定，默认需要 3 票（以服务器设置为准）；
• 点歌人可以用 /nv music skip 直接切自己点的歌；
• 走到视频屏幕附近时，音乐会自动让路给视频声，走远后恢复。

一起听房间

在音乐中心创建房间并邀请好友，需要 nekovideo.music.room.use。房主可以邀请、转让和解散；房间内各自排歌，不影响大厅队列。对方没权限或已在其他房间时邀请会失败，邀请约 2 分钟过期。

播放列表

/nv playlist create <列表id>
/nv playlist add <列表id> <BV或链接> [时长秒]
/nv playlist show <列表id>
/nv playlist remove <列表id> <序号>
/nv playlist loop <列表id> on|off
/nv playlist play <列表id> <屏幕id> [从第几首开始]

给每条内容填写时长秒，播放列表才能稳定自动切到下一集。

玩家权限一览

节点	默认	用途
nekovideo.use	所有人	/nv、发现页、点播和音乐基础功能
nekovideo.screen.limit.1	未分配	最多创建 1 块自己的屏幕
nekovideo.screen.limit.3	未分配	最多创建 3 块；数字可到 512，取身上最大的节点
nekovideo.music.room.use	所有人	创建/加入一起听房间
nekovideo.download	仅 OP	允许下载缓存和循环播放

没有任何屏幕上限节点时不能建屏，但仍然可以看别人的屏幕和点歌。