# QuizCraft-pro

**Repository Path**: mo-bin/quiz-craft-pro

## Basic Information

- **Project Name**: QuizCraft-pro
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-12
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
    <img src="./images/QuizCraft-pro.png" alt="QuizCraft" width="200"/>
</p>

<h1 align="center">QuizCraft-pro — Enhanced Edition</h1>

<p align="center">
    <strong>Minecraft Fabric 英语词汇学习模组</strong><br/>
    <em>在挖矿、战斗、睡觉的冒险中，不知不觉背完四六级单词</em>
</p>

<p align="center">
    <img src="https://img.shields.io/badge/Minecraft-1.20.1-green?style=flat-square&logo=minecraft" alt="Minecraft 1.20.1"/>
    <img src="https://img.shields.io/badge/Fabric-0.91.0-blue?style=flat-square" alt="Fabric"/>
    <img src="https://img.shields.io/badge/License-AGPL--3.0-orange?style=flat-square" alt="License"/>
    <img src="https://img.shields.io/badge/Version-1.3.2-red?style=flat-square" alt="Version"/>
</p>

---

> **基于 [Asphocarp/QuizCraft](https://github.com/Asphocarp/QuizCraft) 二次开发**
> 原作者：**Asphocarp** | 原项目采用 AGPL-3.0 协议
> 本版本在原作基础上新增了成就系统、多场景触发、统计面板、睡眠答题等功能

---

## 📖 项目简介

**QuizCraft** 是一款 Minecraft Fabric 1.20.1 模组，将英语词汇学习融入游戏生存玩法。玩家在挖矿、打怪、钓鱼、开箱、合成、睡觉等游戏行为中触发答题，答对获得奖励，答错受到惩罚，在沉浸式游戏体验中高效背单词。

支持 **18 本词汇书**，覆盖 CET-4/6、考研、雅思、托福、专四/专八等主流英语考试。

<p align="center">
    <img src="./images/挖铁.png" alt="挖矿答题" width="45%"/>
    <img src="./images/打猪.png" alt="战斗答题" width="45%"/>
</p>
<p align="center">
    <img src="./images/错题本.png" alt="错题本" width="45%"/>
    <img src="./images/sleep.png" alt="睡眠答题" width="45%"/>
</p>

---

## ✨ 功能特性

### 🎮 多场景答题触发

| 触发场景    | 说明                                 | 配置项                     |
| ----------- | ------------------------------------ | -------------------------- |
| ⛏️ 挖矿     | 挖掘矿石时概率触发答题               | `treeQuizChance`           |
| ⚔️ 战斗     | 攻击生物时触发答题                   | `attackCooldownSeconds`    |
| 🎣 钓鱼     | 钓鱼上钩前触发答题                   | `fishingQuizEnabled`       |
| 📦 开箱     | 打开结构宝箱前触发答题               | `chestQuizEnabled`         |
| 🔨 合成     | 取出合成结果时概率触发               | `craftingQuizChance`       |
| 👹 Boss 战  | 定时触发，答对给 Buff，答错给 Debuff | `bossQuizIntervalSeconds`  |
| 🛏️ 睡眠答题 | 夜晚睡觉前触发，答对才能入睡         | `sleepQuizCooldownSeconds` |

### 📊 成就 & 等级系统

- **10 个等级**：从「初学者」到「传说」，累计 XP 升级
- **19 个成就**：涵盖普通、稀有、史诗、传说四个稀有度
- **称号系统**：解锁成就获得称号，支持头顶显示
- **三 Tab 统计面板**：统计概览 / 错题本 / 成就列表（按 `N` 键打开）

### 📚 智能词汇引擎

- **18 本词汇书**：CET-4/6、考研、雅思、托福、专四/专八等
- **智能选词**：优先出未掌握/高频错词，已掌握单词自动跳过
- **错题本**：自动记录答错单词，支持间隔重复
- **熟练度系统**：连续答对 3 次标记为「已掌握」
- **进度持久化**：所有学习数据自动保存

### ⚡ 难度分级 & 惩罚系统

| 难度              | 答对奖励 | 答错惩罚                          |
| ----------------- | -------- | --------------------------------- |
| 🟢 简单 (≤4字母)  | +5 XP    | 虚弱 5s                           |
| 🟡 中等 (5-7字母) | +10 XP   | 虚弱 10s + 缓慢 5s                |
| 🔴 困难 (≥8字母)  | +20 XP   | 虚弱 15s + 缓慢 10s + 挖掘疲劳 5s |

- **连击加成**：连续答对 5+ 题 XP ×1.5，10+ 题 XP ×2.0
- **Boss 战 Buff/Debuff**：答对获得 60s 力量/抗性/恢复/速度，答错获得 60s 虚弱/缓慢/挖掘疲劳

### 🔧 管理功能

- **图形化配置面板**：`/quizconfig` 打开可视化设置界面
  - OP 管理员可编辑所有配置项
  - 非 OP 玩家可查看但不能编辑（控件置灰）
  - 支持滚动浏览所有设置
  - 词书下拉选择，显示全部 18 本词书
- **实时切换词书**：无需重启服务器
- **全服广播**：成就解锁时全服通知
- **中文本地化**：完整中文界面

---

## 🚀 安装

### 环境要求

- Minecraft **1.20.1**
- Fabric Loader **≥ 0.14.21**
- Fabric API
- Java **≥ 17**

### 安装步骤

1. 安装 [Fabric Loader](https://fabricmc.net/use/installer/)
2. 下载 [Fabric API](https://modrinth.com/mod/fabric-api) 放入 `mods` 文件夹
3. 下载本模组的 `.jar` 文件放入 `mods` 文件夹
4. 启动游戏即可

---

## 🎮 使用指南

### 基本操作

| 按键  | 功能                             |
| ----- | -------------------------------- |
| `1-4` | 选择答题选项                     |
| `C`   | 取消当前答题（视为答错）         |
| `N`   | 打开统计面板（统计/错题本/成就） |
| `M`   | 打开服务端配置面板               |

### 常用命令

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

### 配置文件

服务器配置保存在 `quiz_craft.server.properties`，支持以下选项：

```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` 命令打开图形化配置界面，无需手动编辑文件。

---

## 📁 词汇书列表

| 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+  |

---

## 🔨 开发构建

```bash
# 克隆仓库
git clone https://github.com/1940787338/QuizCraft-pro.git
cd QuizCraft-pro

# 构建
./gradlew build

# 生成的 JAR 文件位于 build/libs/
```

---

## 📜 致谢

本项目基于以下开源项目二次开发：

| 项目                                                | 作者          | 协议     |
| --------------------------------------------------- | ------------- | -------- |
| [QuizCraft](https://github.com/Asphocarp/QuizCraft) | **Asphocarp** | AGPL-3.0 |

感谢原作者 Asphocarp 创造了 QuizCraft 的核心框架，包括 Ping 系统、答题引擎、词汇书系统等基础功能。

---

## 📄 许可证

本项目基于 [AGPL-3.0](https://www.gnu.org/licenses/agpl-3.0.html) 协议发布，遵循原项目协议要求。

---

<p align="center">
    <em>⭐ 如果这个项目对你有帮助，请给个 Star 支持一下！</em>
</p>