二次开发 开源 工具 BiLibiliVideoFork —— B站三连奖励 | GUI界面支持 2.8.0

[MD]
### BiLiBiLiVideo-Fork
## 前情提要
### 在此感谢原作者 BingZi-233 开发的BiliBiliVideo 插件，本项目基于该项目源码进行二次开发，本插件网络缓存部分由AI辅助开发，如有介意请勿使用该插件
#### [插件开源地址](https://github.com/BalanceSea/BilibiliVideo-Fork)
#### [最新构建版下载](https://github.com/BalanceSea/BilibiliVideo-Fork/releases)
#### [交流群](https://qm.qq.com/q/t6LBeFIQjC)
## 项目简介
**BilibiliVideo-Fork** 是一个基于 TabooLib 6.3.0-afd75a7 框架与 BiliBiliVideo Plugin 开发的 Minecraft 服务器插件，为服务器提供完整的哔哩哔哩平台集成能力。每个玩家可以独立登录自己的 B 站账号，在游戏内完成视频三连检测、领取奖励等互动功能。
### 核心亮点
- **游戏内二维码登录** - 创新性地使用地图物品展示 B 站登录二维码
- **游戏内GUI界面** - '傻瓜式'操作,妈妈再也不用担心玩家不会输指令啦
- **自定义语言** - 高度自定义化的语言文件
- **多账户隔离系统** - 每位玩家使用独立的 B 站账号，数据完全隔离
- **异步架构** - 所有网络请求异步执行，不影响服务器性能
- **灵活奖励系统** - 基于 Kether 脚本引擎，支持自定义奖励逻辑
- **风控规避机制** - 内置 buvid3 参数管理，保证请求稳定性
- **双数据库支持** - SQLite 开箱即用，可切换至 MySQL
---
## 功能特性
### 账号系统
| 功能 | 说明 |
|------|------|
| **二维码登录** | 在游戏内生成 B 站登录二维码地图物品，扫码即可绑定 |
| **账号绑定** | 每个玩家绑定独立的 B 站账号，支持查看绑定状态 |
| **Cookie 自动刷新** | 自动维护登录凭证有效性，避免过期失效 |
| **凭证管理** | 完整的凭证生命周期管理（创建、更新、过期、禁用） |
### 互动功能
| 功能 | 说明 |
|------|------|
| **三连状态检测** | 检测玩家是否完成视频的点赞、投币、收藏 |
| **奖励发放** | 基于三连状态自动发放游戏内奖励 |
| **防重复领取** | 智能记录奖励领取历史，避免重复领取 |
---
## 快速开始
### 环境要求
| 组件 | 版本要求 |
|------|----------|
| **Minecraft 服务端** | Bukkit/Spigot/Paper (推荐 1.12+) |
| **Java** | JRE 8 或更高版本 |
| **TabooLib** | 6.3.0-afd75a7 (自动加载) |
| **数据库** | SQLite (默认) 或 MySQL 5.7+ |
### 安装步骤
1. **下载插件**
```bash
# 从 Releases 页面下载最新版本
wget https://github.com/BalanceSea/Bilib...load/v2.0.0-beta/BilibiliVideo-2.0.0-beta.jar
```
2. **放置插件文件**
```
plugins/
└── BilibiliVideo-Fork-2.8.0-beta.jar
```
3. **启动服务器**
插件会自动创建配置文件和数据库：
```
plugins/BilibiliVideo/
├── config.yml # 奖励配置
├── gui.yml # GUI配置
├── database.yml # 数据库配置
├── lang/ # 语言文件
└── bilibili_video.db # SQLite 数据库
```
4. **验证安装**
在控制台或游戏内执行：
```
/bv help
```
---
## 命令系统
### 权限节点
| 权限节点 | 说明 | 默认许可 |
|----------|------|----------|
| `bilibili.video.use` | 玩家基础命令（qrcode/status/triple/reward） | 所有人 |
| `bilibili.video.admin` | 管理员命令（unbind/credential/reload） | 仅 OP |
### 玩家命令
| 命令 | 功能 | 权限节点 |
|---------------------|---------------|----------|
| `/bv help` | 查看帮助信息 | `bilibili.video.use` |
| `/bv menu` | 打开GUI菜单 | `bilibili.video.use` |
| `/bv qrcode` | 生成 B 站登录二维码地图 | `bilibili.video.use` |
| `/bv status` | 查看账号绑定状态 | `bilibili.video.use` |
| `/bv triple <bvid>` | 检测视频三连状态 | `bilibili.video.use` |
| `/bv reward <bvid>` | 领取三连奖励 | `bilibili.video.use` |
### 管理员命令
| 命令 | 功能 | 权限节点 |
|------|------|----------|
| `/bv admin reload` | 重载配置文件 | `bilibili.video.admin` |
| `/bv admin unbind <target>` | 解除玩家绑定（支持玩家名/UUID/B站UID） | `bilibili.video.admin` |
| `/bv admin credential list` | 列出所有登录凭证 | `bilibili.video.admin` |
| `/bv admin credential info <label>` | 查看凭证详细信息 | `bilibili.video.admin` |
| `/bv admin credential refresh <label>` | 刷新指定凭证（待实现） | `bilibili.video.admin` |
### 使用示例
```bash
# 1. 玩家绑定 B 站账号
/bv qrcode
# 系统会给玩家一张地图物品，展示登录二维码
# 用 B 站 APP 扫码并确认登录
# 2. 查看绑定状态
/bv status
# 输出: ✓ 已绑定 B 站账号: 用户名 (UID: 123456789)
# 3. 检测视频三连
/bv triple BV1xx411c7mD
# 输出: ✓ 点赞 | ✓ 投币(2) | ✓ 收藏 - 已完成三连!
# 4. 领取奖励
/bv reward BV1xx411c7mD
# 系统执行奖励脚本并提示领取成功
# 5. 视频菜单
/bv menu
# 傻瓜式一键操作
```
---
## 配置指南
### 数据库配置 (`database.yml`)
```yaml
database:
# 是否启用数据库（必须为 true）
enabled: true
# 数据库类型: sqlite (默认) 或 mysql
type: sqlite
# SQLite 配置（开箱即用）
sqlite:
file: "bilibili_video.db"
# MySQL 配置（可选）
mysql:
host: "127.0.0.1"
port: 3306
database: "bilibili_video"
username: "root"
password: "your_password"
params: "useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai"
# HikariCP 连接池配置
hikari:
pool-name: "BilibiliVideoPool"
maximum-pool-size: 10 # 最大连接数
minimum-idle: 2 # 最小空闲连接
connection-timeout: 30000 # 连接超时 (ms)
idle-timeout: 600000 # 空闲超时 (ms)
max-lifetime: 1800000 # 最大生命周期 (ms)
# 数据库选项
options:
table-prefix: "bv_" # 表名前缀
show-sql: false # 是否打印 SQL
slow-sql-threshold-ms: 500 # 慢查询阈值 (ms)
```
### 奖励配置 (`config.yml`)
```yaml
reward:
# 奖励判重策略
# PLAYER_AND_BILIBILI - 玩家和 B 站账户同时记录（最严格：同一玩家 + 同一 B 站号只能领一次）
# BILIBILI_ONLY - 仅记录 B 站账户（同一 B 站号只能领一次，玩家换号可重新领）
# PLAYER_ONLY - 仅记录玩家（同一玩家只能领一次，换号无法重新领，默认值，兼容旧版本行为）
dedup-strategy: "PLAYER_ONLY"
templates:
default:
# 该介绍会用于显示在 GUI 界面中
description: "完成三连时发放的默认奖励示例"
kether:
# 仅作为示例，实际脚本可根据需要自行编写
- 'tell "&7[&bBiliBili三连奖励&7] &a你已完成该视频的三连，感谢支持！"'
# 执行指令(带有papi解析)
- 'command papi "give %player_name% diamond 3"'
vip:
description: "特殊视频VIP奖励"
kether:
- 'tell "&6你对该视频的支持获得了 VIP 奖励！"'
- # 执行指令(带有papi解析)
- 'command papi "give %player_name% diamond 64"'
- 'command papi "give %player_name% gold_ingot 32"'
# 活动模板（限时活动）
event:
description: "活动期间的特殊奖励"
kether:
- 'tell "&d[活动奖励] &f恭喜完成三连！"'
- 'command papi "crate givekey %player_name% activity 1"'
# 针对特定 bvid 的奖励配置
videos:
# 完全自定义的示例：BV1xxxxx 使用 vip 模板
BV1xxxxx:
rewardKey: "vip"
# 使用活动 event 模板
BV2ccccc:
rewardKey: "event"
# 如果仅配置了 bvid 但不写 rewardKey，将自动回退到 templates.default
BV3yyyyy: { }
```
### GUI配置 (` gui.yml `)
````yaml
Title: "&fBiliBiliVideo &7| &f三连奖励"
#不要填写过多视频占位符 请求过多B站会风控！！！
#不要填写过多视频占位符 请求过多B站会风控！！！
#不要填写过多视频占位符 请求过多B站会风控！！！
Layout:
- "####i####"
- "#1111111#"
- "#p#####n#"
Icons:
# 隔板
'#':
display:
#物品名称
name: "&7▪ 我只是个隔板"
#物品材质
mats: "gray_stained_glass_pane"
#物品CustomModelData
cmd: '-1'
#物品描述
lore:
- "&7爱上一只小猪?"
# BiliBiliVideo
'1':
type: VIDEO
display:
name: "&f&6 %bv%"
mats: "gold_ingot"
lore:
- "&8&m "
- "&f&b&l 三连状态"
- " &7▪ 点赞: &f%status_like%"
- " &7▪ 收藏: &f%status_favorite%"
- " &7▪ 投币: &f%status_coin%"
- " &7▪ 三连: &f%status%"
- "&8&m "
- "&f&b&l 三连奖励"
- " &7▪ %description%"
- "&8&m "
- "&f&b&l 奖励状态"
- " &7▪ %claim_status%"
- "&8&m "
- "&f✔&a&l 左键领取奖励 &7| &r&b&l 右键查看视频链接"
- "&8&m "
'p':
type: PREVIOUS
display:
name: "&f上一页"
mats: "paper"
lore:
- "&7点击前往上一页"
- "&7当前页: &e%page%"
'n':
type: NEXT
display:
name: "&f下一页"
mats: "paper"
lore:
- "&7点击前往下一页"
- "&7当前页: &e%page%"
# 玩家信息
'i':
display:
name: "&f&b&l BiliBiliVideo &7| &f三连奖励"
mats: "player_head"
lore:
- "&8&m "
- " &7点击查看三连奖励"
- "&8&m "
````
### 语言配置(`lang/zh_CN.yml`)
````yaml
prefix: '&7[&bBiliBili三连奖励&7] &r'
no-permission: '&c⚠ 你没有权限执行该指令!'
player-only: '&c⚠ 此命令只能由玩家执行!'
unknown-command: '&c⚠ 未知指令!'
help-player:
- "&b指令帮助"
- " &7▪ /bv help &f查看帮助信息"
- " &7▪ /bv menu &f打开GUI菜单"
- " &7▪ /bv qrcode &f生成 B 站登录二维码地图"
- " &7▪ /bv status &f查看账号绑定状态"
- " &7▪ /bv triple <bvid> &f检测视频三连状态"
- " &7▪ /bv reward <bvid> &f领取三连奖励"
help-admin:
- "&b指令帮助"
- " &7▪ /bv help &f查看帮助信息"
- " &7▪ /bv menu &f打开GUI菜单"
- " &7▪ /bv qrcode &f生成 B 站登录二维码地图"
- " &7▪ /bv status &f查看账号绑定状态"
- " &7▪ /bv triple <bvid> &f检测视频三连状态"
- " &7▪ /bv reward <bvid> &f领取三连奖励"
- "&b管理员指令帮助"
- " &7▪ /bv admin reload &f重载配置文件"
- " &7▪ /bv admin unbind <target> &f解除玩家绑定（支持玩家名/UUID/B站UID）"
- " &7▪ /bv admin credential list &f列出所有登录凭证"
- " &7▪ /bv admin credential info <label> <bvid> &f查看凭证详细信息"
- " &7▪ /bv admin credential refresh <label> <bvid> &f刷新指定凭证（待实现）"
# 账号未绑定
account-not-bind: '&c B站账号未绑定，请通过 &e/bv qrcode &c扫码登录'
# 账号绑定提示
account-bind-tip: '&a 已为你生成二维码，请使用手机扫码完成绑定'
# 账号绑定成功提示
account-bind-success: '&a 已成功绑定 B 站账号 &e{user_name} &7(&e{user_mid}&7)'
# 账号信息
account-bind-info:
- '&8&m '
- '&b&l 当前绑定信息'
- ' &7▪ 玩家: &f{player}'
- ' &7▪ B 站 UID: &f{user_mid}'
- ' &7▪ B 站昵称: &f{user_name}'
- '&8&m '
# 凭证未保存
token-not-save: '&c 尚未为你保存登录凭证，请通过 &e/bv qrcode &c扫码登录'
# 凭证信息
token-info:
- '&8&m '
- '&b&l 当前凭证信息'
- ' &7▪ 标签: &f{token_tag}'
- ' &7▪ 状态: &f{token_status}'
- ' &7▪ 绑定 UID: &f{user_mid}'
- '&8&m '
# 凭证列表
token-list-head: '&b凭证列表:'
token-list-info: '&7 ▪ &fUID: {user_mid} &7| &f状态: {token_status}'
token-list-empty: '&e当前没有任何凭证记录。'

# 凭证查找
token-find-success:
- '&8&m '
- '&b&l 凭证详情'
- ' &7▪ UID: &f{user_mid}'
- ' &7▪ 状态: &f{token_status}'
- ' &7▪ lastUsedAt: &f{token_lastUsedAt}'
- ' &7▪ expiredAt: &f{token_expiredAt}'
- '&8&m '
token-find-fail: '&c 未找到名为 &e{token_label} &c的凭证'
# 视频三连信息
video-status:
- '&8&m '
- '&b&l 视频 &e{bv} &b的三连状态'
- ' &7▪ {video_like}'
- ' &7▪ {video_coin}'
- ' &7▪ {video_favorite}'
- ' &7▪ {video_triple}'
- '&8&m '
# 视频点赞
video-like-success: '&a 已点赞'
video-like-fail: '&c 未点赞'
# 视频投币
video-coin-success: '&a 已投币'
video-coin-fail: '&c 未投币'
# 视频收藏
video-favorite-success: '&a 已收藏'
video-favorite-fail: '&c 未收藏'
# 三连状态
video-triple-success: '&a 已完成三连'
video-triple-fail: '&e 未完成三连'
# 三连奖励领取提示
video-claim: '&a 成功领取三连奖励'
video-not-claim: '⚠&e 尚未完成该视频的点赞、投币、收藏，无法领取奖励'
video-claimed: '&a 已领取过该奖励'
video-claim-error: '&c 领取奖励失败，请稍后重试'
video-claim-warn: '⚠&e 已记录该视频三连，但并没有设置奖励'
# 视频链接提示
video-url: '&b&l 视频链接&7: &fhttps://www.bilibili.com/video/{bv}'
# 视频不存在提示
video-not-find: '⚠&e 视频 &e{bv} &e并未登记'
# 二维码失效
qrcode-invalid: '&c 二维码已失效，请重新执行 &e/bv qrcode'
# GUI领取文本
gui-video-claim: '&a 点击领取奖励'
gui-video-cant-claim: '&c 不可领取'
gui-video-already-claim: '✔&a 已领取该奖励'
# 解绑提示
admin-unbind-success: '&a 已解除玩家 &e{player} &a与 B 站账号 &e{user_mid} &a的绑定'
admin-unbind-fail: '&c 未找到与 &e{player} &c匹配的玩家、UUID 或 B 站 UID'
````
#### Kether 脚本语法示例
[Kether Explorer](https://taboolib.hhhhhy.kim/kether-list/)
---
[/MD]