QuizCraft-pro

QuizCraft-pro — 增强版

一款将生存玩法转化为英语词汇学习体验的 Minecraft Fabric 模组
挖矿、战斗、钓鱼、合成、睡觉——同时积累你的英语词汇量

---

Fork 自 Asphocarp/QuizCraft 原作者：Asphocarp | 采用 AGPL-3.0 许可

本增强版新增了成就系统、多场景触发、统计面板、睡眠答题等功能。

---

📖 概述

QuizCraft 是一款 Minecraft Fabric 1.20.1 模组，将英语词汇学习融入生存玩法。玩家在挖矿、战斗、钓鱼、开箱、合成和睡觉时会遇到答题。答对获得奖励；答错受到惩罚——让词汇学习成为游戏沉浸式体验的一部分。

支持 18 本词汇书，涵盖 CET-4/6、雅思、托福、专四/专八及考研英语等主要英语水平测试。

---

✨ 功能特性

🎮 多场景答题触发

触发场景	说明	配置项
⛏️ 挖矿	破坏矿石块时触发答题	treeQuizChance
⚔️ 战斗	攻击实体时触发答题	attackCooldownSeconds
🎣 钓鱼	钓到鱼之前触发答题	fishingQuizEnabled
📦 开箱	打开结构宝箱时触发答题	chestQuizEnabled
🔨 合成	取出合成产物时触发答题	craftingQuizChance
👹 Boss 战	Boss 战期间定时触发——答对获得增益，答错获得减益	bossQuizIntervalSeconds
🛏️ 睡眠答题	夜晚尝试睡觉时触发答题	sleepQuizCooldownSeconds

📊 成就与等级系统

• 10 个等级：通过经验值从「初学者」晋升到「传说」
• 19 个成就：涵盖普通、稀有、史诗和传说品质
• 称号系统：通过成就解锁称号，在头顶展示
• 3 标签统计面板：概览 / 错题本 / 成就（按 N 键打开）

📚 智能词汇引擎

• 18 本词汇书：CET-4/6、雅思、托福、专四/专八、考研等
• 智能选词：优先选择未掌握和常错单词
• 错题本：自动记录答错的单词，用于间隔重复
• 掌握系统：连续答对 3 次即标记为已掌握
• 进度持久化：所有学习数据自动保存

⚡ 难度与惩罚系统

难度	答对奖励	答错惩罚
🟢 简单（≤4 个字符）	+5 XP	虚弱 5 秒
🟡 中等（5-7 个字符）	+10 XP	虚弱 10 秒 + 缓慢 5 秒
🔴 困难（≥8 个字符）	+20 XP	虚弱 15 秒 + 缓慢 10 秒 + 挖掘疲劳 5 秒

• 连击加成：连续答对 5 题以上 XP ×1.5，连续 10 题以上 XP ×2.0
• Boss 战增益/减益：答对获得 60 秒力量/抗性提升/生命恢复/速度；答错获得 60 秒虚弱/缓慢/挖掘疲劳

🔧 管理功能

• 图形化配置面板：使用 /quizconfig 或按 M 键打开可视化设置
  • OP 玩家可以编辑所有配置选项
  • 非 OP 玩家只能查看而无法编辑（控件置灰）
  • 可滚动查看所有设置
  • 下拉菜单选择词汇书，显示全部 18 本词汇书
• 热切换词汇书：无需重启服务器
• 服务器广播：成就解锁时向全服公告
• 完整中文本地化

---

🚀 安装

环境要求

• Minecraft 1.20.1
• Fabric Loader ≥ 0.14.21
• Fabric API
• Java ≥ 17

安装步骤

1. 安装 Fabric Loader
2. 下载 Fabric API 并放入 mods 文件夹
3. 下载本模组的 .jar 文件并放入 mods 文件夹
4. 启动游戏

---

🎮 使用方法

按键绑定

按键	操作
1-4	选择答题答案
C	取消当前答题（视为答错）
N	打开统计面板（统计 / 错题本 / 成就）
M	打开服务器配置面板

命令

命令	说明
/quiz stats	打开统计面板
/quizconfig	打开图形化配置面板（OP 可编辑）

服务器配置

服务器配置保存在 quiz_craft.server.properties 中：

# 通用设置
quizEnabled=true              # 总开关
currentBookId=1               # 当前词汇书 (1-18)
highlightColor=16735263       # 高亮颜色（十六进制）
quizTimeoutSeconds=15         # 答题超时（秒）
attackCooldownSeconds=5       # 攻击答题冷却（秒）
触发场景
treeQuizEnabled=true          # 砍树答题
treeQuizChance=100            # 触发概率 (%)
fishingQuizEnabled=true       # 钓鱼答题
chestQuizEnabled=true         # 开箱答题
craftingQuizEnabled=true      # 合成答题
craftingQuizChance=20         # 触发概率 (%)
bossQuizEnabled=true          # Boss 战答题
bossQuizIntervalSeconds=30    # Boss 答题间隔（秒）
sleepQuizEnabled=true         # 睡眠答题
sleepQuizCooldownSeconds=10   # 答错冷却（秒）

💡 提示：OP 玩家可以在游戏内使用 /quizconfig 或按 M 键打开图形化配置面板。

---

📁 词汇书

ID	词书名	词汇量
1	CET-4 核心词汇	4000+
2	CET-4 必背 2000 词	2000
3	CET-6 核心词汇	6000+
4	CET-6 高频词汇	3000+
5	考研英语词汇	5500+
6	考研英语核心词汇	3000+
7	雅思核心词汇	3000+
8	雅思词汇	5000+
9	托福核心词汇	4000+
10	托福词汇	8000+
11	托福核心词汇（精简版）	2000+
12	专四词汇	8000+
13	专四核心词汇（精简版）	3000+
14	专八词汇	10000+
15	CET-4 短语核心	500+
16	CET-6 核心词汇（精简版）	3000+
17	考研核心词汇（精简版）	2000+
18	雅思核心词汇（精简版）	2000+

---

🔨 从源码构建

# 克隆仓库
git clone https://github.com/1940787338/QuizCraft-pro.git
cd QuizCraft-pro
构建
./gradlew build
输出的 JAR 文件位于 build/libs/

---

📜 致谢

本项目基于以下开源项目构建：

项目	作者	许可
QuizCraft	Asphocarp	AGPL-3.0

特别感谢原作者 Asphocarp 创建了 QuizCraft 的核心框架，包括 ping 系统、答题引擎、词汇书系统以及其他基础功能。

---

📄 许可

本项目基于 AGPL-3.0 许可发布，遵循原项目的许可条款。

---

⭐ 如果你觉得这个项目有帮助，请给它一个 Star！