QuizzerBot 插件Wiki文档
1. 插件概述
1.1 基本介绍
QuizzerBot是一款专为Minecraft服务器设计的智能答题插件，支持Paper/Bukkit/Spigot等服务端核心。当前稳定支持API版本1.21及以上（已通过1.21-1.21.5版本测试）。
1.2 运行机制
插件安装后会自动生成：
config.yml配置文件quizzerBook.dbSQLite数据库文件
数据库存储：
- 题目数据（QuizzerBook表）
- 玩家统计数据（PlayerStats表）
警告：请勿手动删除数据库文件，否则将导致数据丢失
2. 安装与初始化
2.1 安装步骤
- 将插件jar文件放入服务器
plugins目录 - 重启服务器
- 检查启动日志确认加载成功
2.2 成功加载标志
正常启动时会显示如下日志信息（具体内容可能因版本不同略有差异）：
[11:15:17 INFO]: [QuizzerBot] 数据库初始化完成
[11:15:17 INFO]: [QuizzerBot] 配置项:最低玩家限制: 1
[11:15:17 INFO]: [QuizzerBot] 配置项:答题时间: 20
[11:15:17 INFO]: [QuizzerBot] 答题系统已成功启动3. 功能详解
3.1 答题流程
触发机制：
- 服务器启动后开始计时
- 在配置的随机时间间隔（默认60-70秒）后检查触发条件
- 满足最低玩家数要求后开始答题活动
题目展示：
[11:31:02 INFO]: [答题Bot] 答题时间到~ ===========问题编号: 1================ 工作台需要几个木板合成? A: 2 B: 4 C: 5 D: 7 ======================================= [11:31:02 INFO]: 答案在10秒后揭晓，【点击选项】即可答题作答方式：
- 点击聊天框中的选项
- 使用命令
/quiz ans <选项>
抢答机制：
- 前N名回答的玩家标记为抢答（N可在配置中设置）
抢答成功后全服公告：
[11:32:37 INFO]: [答题Bot] yanhy2000 抢答成功！[1/3]
结果公布：
[11:32:41 INFO]: [答题Bot] 答案揭晓: 【B】! 抢答正确: 1人, 普通回答正确: 0人, 共发放奖励: 1人
4. 配置详解
4.1 配置文件说明
# 答题活动配置
quiz:
# 最小参与玩家数（设为1可单人测试）
min_players: 1
# 触发间隔范围[最小,最大]（秒）
trigger_interval_sec: [60, 70]
# 答题持续时间（秒）
answer_reveal_delay_sec: 10
# 奖励指令（支持%player%变量）
reward_commands:
- 'say %player% won!'
- 'give %player% diamond 1'
# 每日奖励上限
daily_reward_limit: 5
# 每轮奖励人数上限
player_reward_limit: 3
# 抢答人数上限
player_QuickAnswer_limit: 35. 数据库结构
5.1 题目表(QuizzerBook)
| 字段 | 类型 | 说明 |
|---|---|---|
| id | INTEGER | 自增主键 |
| quiz | TEXT | 题目内容（必填） |
| optA-optD | TEXT | 选项内容（可空） |
| answer | TEXT | 正确答案(A/B/C/D) |
| isEnable | BOOLEAN | 是否启用（默认TRUE） |
| showCount | INTEGER | 题目出现次数统计 |
5.2 玩家表(PlayerStats)
| 字段 | 类型 | 说明 |
|---|---|---|
| uuid | TEXT | 玩家唯一标识 |
| username | TEXT | 玩家名 |
| total_attempts | INTEGER | 总答题次数 |
| correct_answers | INTEGER | 答对次数 |
| quick_answers | INTEGER | 抢答成功次数 |
| daily_rewards | INTEGER | 当日获得奖励数 |
| last_played_date | TEXT | 最后参与日期(YYYY-MM-DD) |
6. 命令手册
6.1 玩家命令
| 命令 | 参数 | 说明 |
|---|---|---|
| /quiz ans | A/B/C/D | 提交答案 |
| /quiz me | - | 查看个人统计 |
| /quiz top | [排序方式] | 查看排行榜 |
6.2 管理员命令
| 命令 | 参数 | 说明 |
|---|---|---|
| /quiz add | 问题 选项... | 添加题目 |
| /quiz modify | ID 字段 值 | 修改题目 |
| /quiz list | [模式] | 题目列表 |
| /quiz reload | - | 重载配置 |
注意：所有管理员命令需要OP权限
7. 常见问题
7.1 答题未触发
- 检查
min_players设置 - 确认题库中有启用状态的问题
- 查看日志是否有错误信息
7.2 题目管理
添加题目示例：
/quiz add 低版本中Minecraft中钻石在第几层最多？ 1-5 5-12 12-20 20+ b- 可使用"-"作为空选项占位符
8. 注意事项
- 版本兼容：确保服务端运行在Paper 1.21+环境
- 数据备份：定期备份
quizzerBook.db文件 - 问题反馈：公测期间请联系 yanhy2000@foxmail.com
本Wiki文档随插件版本更新，最新版请以实际发布为准
