权限与配置参考

配置文件位置：plugins/NekoVideoPlugin/config.yml。只改动可热重载项目时执行 /nv reload；修改 api-key、存储类型或授权相关设置时必须整服重启。

权限节点

基础与管理

节点	默认	用途
`nekovideo.use`	所有人	使用 `/nv`、发现页、点播和音乐基础功能
`nekovideo.*`	OP	全部功能的父节点
`nekovideo.admin`	OP	任意屏幕、重载、播放管控、强制切歌/插队、音距上限 512；不受建屏数量限制和超限回收影响
`nekovideo.admin.autoplay`	随 `nekovideo.admin`	预留：设置开服自动播放源
`nekovideo.admin.rename`	随 `nekovideo.admin`	`/nv screen rename <旧id> <新id>`
`nekovideo.download`	OP	`download` 缓存与 `loop` 循环
`nekovideo.music.room.use`	所有人	创建、加入和邀请一起听房间
`nekovideo.music.room.admin`	随 `nekovideo.admin`	处理异常一起听房间

屏幕数量

节点	默认	上限
`nekovideo.screen.limit.0`	`false`	明确禁止建屏
`nekovideo.screen.limit.1`	`false`	1 块自己的屏幕
`nekovideo.screen.limit.N`	`false`	`N` 为 0～512 的整数

规则：插件取玩家身上所有 nekovideo.screen.limit.* 的最大值；没有任何 limit 节点时上限就是 0。管理员/OP 不限数量，也不参与到期回收。

LuckPerms 示例

# 默认玩家：能看、能点歌，不能建屏
/lp group default permission set nekovideo.use true
/lp group default permission set nekovideo.music.room.use true

# 普通 VIP：1 块屏
/lp group vip permission set nekovideo.screen.limit.1 true

# 高级 VIP：3 块屏
/lp group svip permission set nekovideo.screen.limit.3 true

# 管理组
/lp group admin permission set nekovideo.admin true
/lp group admin permission set nekovideo.download true

不要给普通玩家 nekovideo.admin，否则他们可以管理全服屏幕并开关禁播。

屏幕超限回收

screen-limit:
  reclaim-mode: disable # off / disable / delete

玩家进服时若名下启用屏幕超过当前上限，插件按创建时间最早的 N 块保留：

模式	效果
`off`	不回收，只禁止继续新建
`disable`	多出来的屏幕停播并禁用，数据保留；续费后用 `/nv screen active <ID>` 恢复（推荐）
`delete`	直接删除多出来的屏幕，无法恢复

`config.yml` 项目

项目	作用
`api-key`	授权密钥；不要发到公告或给玩家
`debug` / `debug-plugin-messages`	排错日志，平时关闭
`music.enabled`	`false` 时关闭本服全部点歌
`music.skip-votes`	切歌所需的默认票数
`music.rooms.enabled`	一起听总开关
`music.rooms.invite-expire-ms`	邀请过期时间，默认 `120000`（约 2 分钟）
`direct-url-allowed-schemes`	允许的直链协议；`file://` 永远拒绝
`direct-url-whitelist`	直链域名/IP 白名单；`[]` 表示不限制域名
`blocked-sources`	播放源黑名单，只拦截新点播
`storage.type`	`sqlite`（默认）或 `mysql`
`screen-limit.reclaim-mode`	VIP 到期时的回收方式
`screen.back-occlusion-pct`	屏幕后方被方块遮挡达到多少就不渲染，默认 `0.30`

黑名单示例：

blocked-sources:
  - https://live.bilibili.com/1883358196
  - bili:1883358196
  - huya:123456
  - BV1xxxxxxxx

改完黑名单后执行 /nv reload。玩家只会看到“该播放源不可播放”，不会看到黑名单细节。

来源	作用
玩家自己扫码登录 B 站	只给该玩家解析高清/大会员内容
`bilibili-cookie.json` 后 `/nv reload`	导入全服游客兜底 Cookie；导入后文件会被清空
`cookie.json` 后 `/nv reload`	导入网易云全服 Cookie，用于点歌解析
`data.db` 的 `app_cookies`	实际存储位置；不要长期把明文 Cookie 放在投放文件中

没有全服 Cookie 时会走游客模式，可能只有较低画质，也更容易受到风控影响。

权限节点​

基础与管理​

屏幕数量​

LuckPerms 示例​

屏幕超限回收​

config.yml 项目​

Cookie 与账号​