LetMeAsk

一个 Minecraft 服务器抢答活动插件，定时在聊天栏出题，玩家抢答可获得金币奖励。

功能特性

• 定时自动出题：按照配置间隔自动发布题目
• 答题超时：超时无人答对时自动公布答案并出下一题
• 经济系统集成：支持 Vault 经济插件，自动扣款/发放奖励
• 模糊匹配：答案支持容错匹配（拼写相似度可配置）
• 人机验证：答题过快或连续答对过多时触发 HumanVerify 验证
• 答对特效：答对者收到 Title 标题，全服播放升级音效（均可在 celebrate 下配置开关）
• 灵活配置：支持玩家名、UUID、服务器账户、LittleSkin 等支付方式

注意: 人机验证需要依赖HumanVerify插件。如果没有它，人机验证功能将无法使用，但是基本功能不会影响。

环境要求

依赖	类型	版本
Paper/Spigot	必需	1.20.4+
Vault	推荐	-
HumanVerify	可选	-
CMI	可选	-

安装

1. 下载 LetMeAsk-1.1.0.jar
2. 将 JAR 文件放入服务器 plugins/ 目录
3. 重启服务器
4. 编辑 plugins/LetMeAsk/base.yml 和 questions.yml 进行配置

命令

命令	权限	说明
/letmeask 或 /letmeask help（简写 /lma）	全员	帮助菜单（管理员额外显示管理命令）
/letmeask top [数量]	全员	答题排行榜（默认前 10，最多 20）
/letmeask stats [玩家名]	全员	查看答题统计（默认查自己）
/letmeask status	全员	查看插件状态
/letmeask start	letmeask.admin	启动定时出题
/letmeask stop	letmeask.admin	停止定时出题
/letmeask question [force]	letmeask.admin	手动发布新题目
/letmeask reload	letmeask.admin	重载配置文件

所有子命令均支持简写 /lma（如 /lma top、/lma stats）。 排行榜也会每小时在游戏内全局广播一次。

配置

base.yml

# 扣款玩家（支持: 玩家名、UUID、littleskin:xxx、Server/Console）
payer: Server

# 每题奖励金额
reward: 50.0

# 自动出题间隔（秒）
question-interval-seconds: 60

# 答题超时时间（秒），超时后公布答案并出下一题（0=禁用）
question-timeout-seconds: 30

# 回答用时阈值（秒，支持小数），过快触发人机验证
anti-bot-threshold-seconds: 1

# 连续答对次数阈值，达到触发人机验证（0=禁用）
anti-bot-correct-answer-threshold: 3

# 连击统计时间窗口（秒），超时未答对则连击清零
anti-bot-streak-window-seconds: 300

# 人机验证超时（秒），回调长时间未返回时自动解锁并作废本轮
verify-timeout-seconds: 120

# 答案模糊匹配阈值（0-1，越高越严格；1.0=精确匹配）
fuzzy-similarity-threshold: 0.75

# 答对庆祝：Title 只发给答对者，音效全服可听（sound=none 关闭音效）
celebrate:
  enabled: true
  title: "&6&l答对了！"
  subtitle: "&e+{reward} 金币"
  sound: ENTITY_PLAYER_LEVELUP
  volume: 1.0
  pitch: 1.0

# 消息前缀
messages:
  prefix: "&6[教育部]"

questions.yml

# 纯字符串格式：题目=答案（多答案用 | 分隔，答对任一即可）
# map 格式：{q, a, weight}，权重越大越容易被抽中（默认 1）
questions:
  - "中国首都=北京"
  - "2+2=4"
  - "香蕉是什么颜色=黄色|黄"
  - {q: "太阳系最大的行星是什么", a: "木星|Jupiter", weight: 2}

统计数据保存在 plugins/LetMeAsk/stats.yml（累计出题/答对数、每人答对次数与奖金）。

构建

使用 Maven（推荐）：

mvn clean package

或使用 Gradle（依赖 libs/ 目录下的本地 jar，可离线构建）：

gradle build

版本管理

版本号唯一来源是 pom.xml 的 <revision>，plugin.yml 与产物 jar 名构建时自动跟随，发版只改这一处：

mvn clean package -Drevision=1.2.0

CI 每次构建会自动追加 commit 短哈希（如 1.1.0-a1b2c3d），latest release 永远是最新构建。

许可证

MIT License