TriviaTreasure! A Quiz Plugin to Bring Fun to Your Chat » Custom Rewards » Menus & More! - TriviaTreasure! 趣味问答插件

欢迎来到 TriviaTreasure！这是一款充满趣味的聊天问答游戏，旨在考验玩家的知识储备，同时带来欢乐。通过游戏内菜单，你可以轻松创建自定义问题和答案，让游戏内容独一无二。为获胜者设置奖励，甚至安排定时自动开启游戏，一切尽在掌握。

💡核心特色

• 自定义问答：通过直观的菜单创建和管理问题，支持为每个问题设置多个正确答案。
• 灵活奖励系统：为第一名、第二名、第三名以及每轮优胜者设置物品、金钱、经验或执行命令作为奖励。
• 多种开始方式：可通过菜单、命令 /trivia start 或预设的定时任务开始游戏。
• 定时游戏：可设置游戏自动定期开启，并设定在线玩家数量要求。
• 多语言与颜色支持：通过编辑 messages.yml 文件自定义消息内容和颜色（支持 & 颜色代码和 [#ABCDEF] 格式的十六进制代码）。
• 数据统计：追踪玩家的获胜次数、参与场次、获得的总金钱和经验。
• 插件集成：支持 PlaceholderAPI 和 Vault API（用于发放金钱奖励）。

🎮命令与权限

管理员命令 (需 `trivia.admin` 权限)

• /trivia - 打开游戏主菜单。
• /trivia start [轮数] - 快速开始一场问答游戏（默认10轮）。
• /trivia stop - 立即停止当前正在进行的游戏。
• /trivia skip - 跳过当前正在提问的问题。
• /trivia version - 显示插件版本、API 版本和作者信息。
• /trivia reload - 重载插件配置文件。

玩家命令 (需 `trivia.player` 权限)

• /trivia stats - 查看个人统计数据（获胜次数、获得金钱/经验等）。
• /trivia schedule - 查看下一场定时游戏的等待时间（如果已启用）。
• /trivia help - 显示游戏内命令帮助。

🔧如何开始游戏

创建问题与答案

• 使用 /trivia 打开菜单。
• 点击绿宝石图标创建新问题。
• 在聊天栏中输入问题内容，然后输入一个或多个正确答案（用逗号分隔）。

设置奖励

• 在主菜单中进入“奖励”设置。
• 将奖励物品拖入对应的位置槽（第一名、第二名、第三名、每轮奖励）。
• 配置额外的金钱奖励、经验奖励或自定义命令。
• 退出菜单以自动保存设置。

启动游戏

游戏有三种开始方式

• 通过菜单：在菜单中调整设置后启动。
• 通过命令：使用 /trivia start [轮数]。
• 定时启动：在配置中启用定时游戏并设置间隔时间。

游戏开始后，屏幕顶部会显示进度条。问题将逐轮在聊天中显示，首位答对的玩家赢得该轮。最终赢得最多轮次的玩家获胜并获得奖励。

✨定时游戏

要启用自动定时游戏，请在配置文件中进行以下设置

• 将 Scheduled games 设置为 true。
• 设置 Scheduled games interval（游戏间隔时间，单位为分钟）。
• 设置 Scheduled games minimum players（游戏开始所需的最低在线玩家数）。

玩家可使用 /trivia schedule 命令查看下一场游戏的时间。

❓插件集成与数据

PlaceholderAPI 占位符

如果安装了 PlaceholderAPI，可使用以下占位符：

• %trivia_game_wins_first% - 玩家获得第一名的次数。
• %trivia_game_wins_second% - 玩家获得第二名的次数。
• %trivia_game_wins_third% - 玩家获得第三名的次数。
• %trivia_game_participation% - 玩家参与的游戏场数。
• %trivia_round_wins% - 玩家答对的题目总数。
• %trivia_money_won% - 玩家从游戏中获得的总金钱。
• %trivia_experience_won% - 玩家从游戏中获得的总经验。
• %trivia_game_in_progress% - 当前是否有游戏正在进行（true/false）。
• %trivia_next_game% - 距离下一场定时游戏的时间。

Vault API

• 如需设置金钱奖励，必须安装 Vault 及其经济插件。

bStats

• 本插件使用 bStats 收集匿名使用数据。统计数据可在此查看：https://bstats.org/plugin/bukkit/TriviaGUI/7912

⭐兼容性说明

• 原生版本：适用于 Spigot 1.17（/trivia version 中显示），已在 Spigot 1.18 中测试。
• Java 版本：插件使用 Java 17 编译，但很可能兼容 Java 11。

Trivia 插件

Trivia 是一个为 Minecraft 服务器设计的趣味问答插件，旨在通过互动问题为玩家带来娱乐和挑战。它支持自定义问题、多种游戏模式，并提供丰富的配置选项，适合各类服务器使用。

💡功能特性

• 自定义问题：通过配置文件轻松添加、编辑或删除问题。
• 多种游戏模式：
• 快速问答：玩家在聊天框中输入答案。
• GUI 模式：玩家通过点击图形界面选项来回答问题。
• 可配置的奖励与惩罚：可为正确和错误的答案设置不同的经济奖励或惩罚。
• 多语言支持：内置多种语言文件，方便国际化。
• 问题分类：支持将问题分组到不同类别，便于管理。
• 排行榜系统：记录玩家的答题正确率与积分。
• 管理员工具：提供方便的命令来管理问题和游戏进程。

🎮命令与权限

玩家命令

• /trivia - 开始一轮新的问答游戏。
• /trivia help - 显示帮助信息。
• /trivia top - 显示答题排行榜。

管理员命令

• /trivia reload - 重载插件配置和问题文件。
• /trivia add <问题> | <答案1>, <答案2>, ... | <类别> - 添加一个新问题。
• /trivia remove <问题ID> - 根据ID删除一个问题。
• /trivia list [页码] - 列出所有问题。

主要权限节点

• trivia.play - 允许玩家参与问答游戏。（默认拥有）
• trivia.admin - 允许使用所有管理命令。
• trivia.bypass.cooldown - 绕过游戏冷却时间。

🔧安装与配置

安装步骤

• 确保服务器运行 Spigot 1.16.5 或更高版本。
• 将下载的 Trivia.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 首次运行后，插件会在 plugins/Trivia 目录下生成配置文件。

基础配置

编辑 config.yml 文件以调整核心设置：

• game.duration: 每道题的答题时间（秒）。
• game.cooldown: 游戏轮次之间的冷却时间（秒）。
• reward.correct: 答对时给予的经济奖励金额。
• reward.incorrect: 答错时的经济惩罚金额（可设为负数作为惩罚）。
• messages.prefix: 插件消息的前缀。

添加问题

问题存储在 questions.yml 文件中。您可以直接编辑此文件，或使用 /trivia add 命令来添加。

每个问题的格式如下

example-question-id:
  question: "Minecraft中哪种矿石需要用铁镐或更高级的镐采集？"
  answers:
  - "钻石"
  - "红石"
  - "绿宝石"
  category: "minecraft"

✨依赖项

• 必需：本插件需要 Vault 插件以提供经济奖励系统支持。
• 推荐：使用 PlaceholderAPI 以在其他插件中显示排行榜变量。

❓常见问题

• 如何更改语言？

在 config.yml 中设置 language: zh_CN（或其他语言代码），并确保 plugins/Trivia/languages 文件夹中存在对应的语言文件。

• 问题没有加载？

请检查 questions.yml 文件的格式是否正确（YAML语法），并使用 /trivia reload 重载。

• 经济奖励没有生效？

请确保已安装 Vault 插件及一个兼容的经济系统（如 EssentialsX）。

• 如何备份我的问题？

直接复制 plugins/Trivia/questions.yml 文件即可。

⭐支持与贡献

如果您遇到问题或有功能建议，欢迎在项目的 GitHub Issues 页面提交反馈。

开发者也可以 Fork 本仓库并提交 Pull Request 来贡献代码。