(注:本自述文件由 AI 协助编写)
? 简介
QuizzerBot 是一款有趣的 Paper(或其分支)服务端答题插件,为 Minecraft 世界带来欢乐的趣味问答挑战。参与全服限时聊天问答,或利用全新的 Dialog GUI 系统探索交互式答题菜单!玩家可以竞争奖励并争夺排行榜席位。
插件默认语言:zh_CN。
注意:多语言支持 (i18n) 尚未实现,但计划在未来的更新中加入。
? 描述
为什么选择 QuizzerBot?
-
? 两种玩法:
-
? 双排行榜: 分别为经典聊天问答和新的 Dialog 问答提供独立的排名,以追踪不同的技能表现。
-
⚙️ 易于管理:
-
? 可定制奖励: 配置自定义命令以奖励回答正确的玩家(支持 %player% 占位符)。
-
? 轻量级且易于设置: 开箱即用,自动配置。使用 SQLite,因此不需要外部数据库。
工作原理
1. 限时聊天问答(经典模式)
-
插件会从主数据库中随机选取问题,触发间隔是在可配置的时间范围(trigger_interval_sec)内随机选择的。
-
问题会在全局聊天中显示,并带有可点击的答案选项。
-
玩家在答题结束前有固定的时间限制(在 answer_reveal_delay_sec 中定义)来回答问题。
-
时间结束后,公布结果。奖励会发给指定数量的正确玩家(最多 player_reward_limit 人)。前几位答对的玩家将获得“快速回答”状态(最多 player_QuickAnswer_limit 人)。
-
如果“快速”玩家回答错误,他们的奖励名额可以由下一位答对的玩家获得,以确保奖励得到合理分配。
2. Dialog GUI 问答(1.2.0 新增功能)
-
玩家可以输入 /quiz dialog 打开新的交互式菜单。
-
该系统使用单独的“Extra”题库,使其统计数据和排行榜与聊天问答区分开来。
-
非常适合创建按需挑战、服务器指南、词汇列表(如 CET-4/6 单词!)或特殊活动 trivia。
命令
玩家命令
-
/quiz ans <answer> - 提交聊天问答的答案。
-
/quiz me - 查看个人的答题统计数据。
-
/quiz query <player> - 查看其他玩家的统计数据。
-
/quiz top [total|correct|quick|rewards] - 显示经典聊天问答的排行榜。
-
/quiz dialog - 打开用于额外问答的全新交互式 Dialog GUI。
管理员命令(通用)
管理员命令(限时聊天问答)
-
/quiz startnow - 强制开始限时聊天问答。
-
/quiz stop - 停止自动限时问答调度器。
-
/quiz enable <true|false> - 启用或禁用限时问答调度器。
-
/quiz add <Q> <A> <B> <C> <D> <Correct> - 添加新问题(例如,/quiz add "What is 1+1?" "1" "2" "3" "4" "B")。
-
/quiz delete <id> - 通过 ID 删除问题。
-
/quiz modify <id> <field> <value> - 修改问题的特定部分。
-
/quiz toggle <id> <true|false> - 启用或禁用特定问题的显示。
-
/quiz list [page] [sort] - 列出主题库中的所有问题。
-
/quiz detail <id> - 查看特定问题的所有详细信息。
管理员命令(Dialog GUI 问答 - “Extra”)
-
/quiz extra add ... - 向 Dialog GUI 题库添加问题。
-
/quiz extra delete <id> - 删除 Dialog GUI 问题。
-
/quiz extra modify <id> ... - 修改 Dialog GUI 问题。
-
/quiz extra toggle <id> ... - 启用/禁用 Dialog GUI 问题。
-
/quiz extra list - 列出所有 Dialog GUI 问题。
-
/quiz extra detail <id> - 查看 Dialog GUI 问题的详细信息。
管理员命令(数据库管理)
配置 (config.yml)
-
min_players: 启动限时问答所需的最低在线玩家数。
-
trigger_interval_sec: 问题随机触发的时间范围(秒,min, max)。如果两个值相同,则间隔固定。
-
answer_reveal_delay_sec: 回答问题的时限(秒)。
-
reward_commands: 获胜者运行的命令列表(例如 ["give %player% diamond 1"])。
-
daily_reward_limit: 玩家每天从限时问答中可获得的最大奖励次数。
-
player_reward_limit: 每次问答可获奖励的最大玩家数。
-
player_QuickAnswer_limit: 可被认可为“快速回答”(必须正确)的最大玩家数。
-
注意:奖励根据 player_reward_limit 发放。“快速回答”玩家优先,但如果他们回答错误,奖励名额将顺延给下一位答对的玩家。
技术信息
? 联系与反馈
(Note: This README was written with AI assistance)
? Summary
QuizzerBot is an engaging Paper (or its forks) server-side quiz plugin that brings fun trivia challenges to your Minecraft world. Compete in server-wide timed chat quizzes, or explore new interactive quiz menus with the new Dialog GUI system! Players can compete for rewards and a spot on the leaderboards.
Plugin default language: zh_CN.
Note: Multi-language support (i18n) is not yet implemented but is planned for future updates.
? Description
Why Choose QuizzerBot?
-
? Two Ways to Play:
-
Classic Chat Quizzes: The original fast-paced, timed trivia event that appears directly in chat.
-
New! Dialog GUI Quizzes: An interactive, on-demand quiz menu built with Paper's new Dialog API (requires 1.21.6+).
-
? Dual Leaderboards: Separate rankings for both the classic chat quizzes and the new Dialog quizzes to track different skills.
-
⚙️ Easy Management:
-
New! CSV Import/Export: Easily manage your question banks! Export questions to a CSV, edit them in any spreadsheet program, and re-import them. (Warning: Importing overwrites the entire table, so please be careful!)
-
Simple in-game commands for adding, deleting, and modifying questions for both systems.
-
? Customizable Rewards: Configure custom commands to reward players for correct answers (supports %player% placeholder).
-
? Lightweight & Easy Setup: Works out-of-the-box with automatic configuration. Uses SQLite, so no external database is required.
How It Works
1. Timed Chat Quizzes (Classic)
-
The plugin randomly selects questions from the main database at intervals randomly chosen from a configurable time range (trigger_interval_sec).
-
Questions appear globally in chat with clickable answer options.
-
Players have a set time limit (defined in answer_reveal_delay_sec) to answer before the quiz ends.
-
After the time is up, results are announced. Rewards are given to a set number of correct players (up to player_reward_limit). 'Quick Answer' status is given to the first few correct players (up to player_QuickAnswer_limit).
-
If a 'quick' player answers incorrectly, their reward slot can be taken by the next correct player in line, ensuring rewards are distributed.
2. Dialog GUI Quizzes (New in 1.2.0)
-
Players can type /quiz dialog to open a new interactive menu.
-
This system uses a separate "Extra" question bank, keeping its stats and leaderboards distinct from the chat quizzes.
-
Perfect for creating on-demand challenges, server guides, vocabulary lists (like CET-4/6 words!), or special event trivia.
Commands
Player Commands
-
/quiz ans <answer> - Submit your answer for a chat quiz.
-
/quiz me - View your personal quiz statistics.
-
/quiz query <player> - View another player's statistics.
-
/quiz top [total|correct|quick|rewards] - Show the leaderboards for classic chat quizzes.
-
/quiz dialog - Open the new interactive Dialog GUI for extra quizzes.
Admin Commands (General)
-
/quiz reload - Reload the plugin's configuration files.
-
/quiz reset <player> - Reset all quiz data for a specific player.
-
/quiz help - Show the help menu.
Admin Commands (Timed Chat Quiz)
-
/quiz startnow - Force-start a timed chat quiz.
-
/quiz stop - Stop the automatic timed quiz scheduler.
-
/quiz enable <true|false> - Enable or disable the timed quiz scheduler.
-
/quiz add <Q> <A> <B> <C> <D> <Correct> - Add a new question (e.g., /quiz add "What is 1+1?" "1" "2" "3" "4" "B").
-
/quiz delete <id> - Delete a question by its ID.
-
/quiz modify <id> <field> <value> - Modify a specific part of a question.
-
/quiz toggle <id> <true|false> - Enable or disable a specific question from appearing.
-
/quiz list [page] [sort] - List all questions in the main bank.
-
/quiz detail <id> - View all details for a specific question.
Admin Commands (Dialog GUI Quiz - "Extra")
-
/quiz extra add ... - Add a question to the Dialog GUI bank.
-
/quiz extra delete <id> - Delete a Dialog GUI question.
-
/quiz extra modify <id> ... - Modify a Dialog GUI question.
-
/quiz extra toggle <id> ... - Enable/disable a Dialog GUI question.
-
/quiz extra list - List all Dialog GUI questions.
-
/quiz extra detail <id> - View details for a Dialog GUI question.
Admin Commands (Database Management)
-
/quiz database export <table_name> - Export a question table (e.g., questions or extra_questions) to a CSV file.
-
/quiz database import <table_name> - Import data from a CSV file, fully overwriting the specified table. (Use with caution!)
Configuration (config.yml)
-
min_players: Minimum players online required to start a timed quiz.
-
trigger_interval_sec: The time range (min, max) in seconds for a quiz to randomly trigger. If both values are the same, the interval is fixed.
-
answer_reveal_delay_sec: Time limit to answer a question (in seconds).
-
reward_commands: List of commands to run for a winner (e.g., ["give %player% diamond 1"]).
-
daily_reward_limit: Maximum number of rewards a player can win from timed quizzes per day.
-
player_reward_limit: Maximum number of players that can be rewarded per quiz.
-
player_QuickAnswer_limit: Maximum number of players who can be recognized for a 'Quick Answer' (must be correct).
-
Note: Rewards are given based on player_reward_limit. 'Quick Answer' players are prioritized, but if they answer wrong, the reward slot rolls down to the next correct player.
Technical Info
-
Requires: Paper (or its forks) 1.21.6+ (The new Dialog GUI feature requires 1.21.6+, though the classic chat quiz may work on 1.21+).
-
Database: Uses SQLite by default (no setup needed).
-
Dependencies: Automatically downloads the H2 database driver on first run (no manual download needed). Download speed depends on your server's network connection.
? Contact & Feedback
评论 0
登录后参与评分
还没有评论,来抢沙发吧