Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Tags
Creators
Details
🎓 Quiz Survival
Minecraft Fabric Mod | 1.21.11
Who says playing Minecraft is just playing games?
Want to chop a tree? Answer a question first. Mine ores? Answer first. Fight mobs? Answer first. Even jumping requires a quiz.
When Minecraft meets quizzes, everything changes. The question bank is fully open — it ships with Minecraft trivia by default, but you can swap it out for advanced math, physics, English, history — anything you want to learn. Play and learn at the same time. Want to play? Then answer correctly first.
This isn't just a mod. It's a game-driven learning system.
✨ Features
🔨 Full Action Interception
- Chopping — Cutting trees triggers a quiz
- Mining — Mining ores, stone, and dirt each have separate categories
- Combat — Both melee and ranged attacks trigger quizzes; damage is only dealt after a correct answer
- Jumping — Even jumping requires a quiz
- Interaction — Opening crafting tables, chests, furnaces, etc. requires a quiz
⚔️ Combat System
- When attacking a mob, all nearby monsters are frozen so you can answer safely
- Damage is calculated based on mob HP tier (small mobs = one-shot, medium = half HP, boss = fixed damage)
- Ranged attacks (bow/crossbow) deal 50% of melee damage (configurable)
- Wrong answer = mobs unfreeze + health penalty; Creepers ignite on wrong answer!
- PvP quiz duels supported — attacking another player triggers a quiz too
📊 Quiz Mechanics
- 200+ questions covering Minecraft knowledge: mining, combat, enchanting, brewing, redstone, biomes, and more
- Non-repeating questions; deck reshuffles when all questions are used
- Correct answers grant free action charges (tracked per category)
- Wrong answers deal escalating damage (formula:
min(max, base^consecutive_errors)) - Countdown timer with progress bar; auto-submits wrong answer at 0
🎨 User Interface
- Quiz screen with category label, damage warning, and countdown progress bar
- HUD overlay showing remaining free action charges per category
- Sound effects for correct/wrong answers
⚙️ Fully Configurable
- All parameters adjustable via JSON config — no recompilation needed
- Hot-reload with
/quizsurvival reloadcommand - Customizable block categories, combat exclusions, damage multipliers, and more
- External JSON question bank — add/modify questions freely
🌐 Multi-Language Support
- Built-in Chinese and English question banks (200+ questions each)
- Switch language in-game with
/quizsurvival lang <zh|en> - All UI text, HUD, chat messages, and config comments are bilingual
🔒 Multiplayer Safe
- All state is isolated per player UUID
- ConcurrentHashMap ensures thread safety
- Reference-counted mob freezing prevents premature unfreeze in multiplayer
📦 Installation
- Install Fabric Loader (1.21.11)
- Install Fabric API (0.140.2+)
- Place the mod JAR in
.minecraft/mods/ - Launch the game — config files and question bank are auto-generated on first run
🎮 Commands
All commands use the unified /quizsurvival root:
| Command | Permission | Description |
|---|---|---|
/quizsurvival |
Everyone | Show command help |
/quizsurvival reload |
OP | Hot-reload config and question bank |
/quizsurvival stats [player] |
Everyone | View quiz statistics (total/correct/wrong/accuracy) |
/quizsurvival time <seconds> |
OP | Change quiz time limit (0 = unlimited) |
/quizsurvival lang <zh|en> |
OP | Switch question language |
📁 Configuration
Path: config/quizsurvival/quizsurvival_config.json
{
"questionLanguage": "zh", // zh=Chinese, en=English
"freeActionCount": 5, // Free actions granted per correct answer
"freezeRadius": 32, // Mob freeze radius during combat (blocks)
"quizTimeLimit": 30, // Countdown in seconds, 0 = unlimited
"wrongDamageBase": 2.0, // Wrong answer damage base
"wrongDamageMax": 20.0, // Wrong answer damage cap
"smallMobHpThreshold": 20, // Small mob HP threshold
"mediumMobHpThreshold": 100, // Medium mob / Boss HP threshold
"meleeDamageSmall": 10.0, // Small mob damage multiplier (one-shot)
"meleeDamageMedium": 0.5, // Medium mob damage multiplier (half HP)
"meleeDamageBoss": 20.0, // Boss fixed damage
"rangedDamageRatio": 0.5 // Ranged damage ratio (vs melee)
}
All config comments are bilingual (Chinese/English). Delete the config file and restart to regenerate defaults.
📝 Custom Questions
Path: config/quizsurvival/quiz_questions_zh.json (Chinese) or quiz_questions_en.json (English)
[
{
"question": "What is the lowest Y level where diamonds can generate?",
"options": ["-64", "0", "16", "32"],
"answer": 0
}
]
answeris the zero-based index of the correct option- Use
/quizsurvival reloadto hot-reload after editing — no restart needed - Switch language with
/quizsurvival lang <zh|en>— missing question bank files are auto-generated
💡 Not Just Minecraft Trivia
The default question bank covers Minecraft knowledge, but the JSON format means you can use any content:
| Use Case | Question Bank |
|---|---|
| 🎓 Student Review | Calculus, physics formulas, chemistry equations |
| 🌍 Language Learning | English vocabulary, grammar, translations |
| 📚 Exam Prep | Driver's license, standardized test prep |
| 🏫 Classroom | Teachers create custom quizzes, students learn while playing |
| 🎮 Server Events | Custom trivia contests for your server community |
Just edit the JSON file — 4 options, 1 answer. No programming required.
An Advanced Math question bank (50 questions) is included as a sample in the optional_question_banks/ directory:
optional_question_banks/
├── quiz_questions_zh.json ← Chinese math questions
└── quiz_questions_en.json ← English math questions
To use: copy directly to config/quizsurvival/ to replace the default files, then /quizsurvival reload.
📣 Answer Feedback
Quiz results appear in real-time in the chat:
| Situation | Message Example |
|---|---|
| ✅ Correct | §a✔ Correct! 5 free actions granted! |
| ✅ Combat Correct | §a✔ Correct! Melee dealt 20 damage! (0 left) |
| ❌ Wrong | §c✘ Wrong! -2 HP! (18 left) |
| ❌ Combat Wrong | §c✘ Wrong! Mobs unfrozen! -4 HP! |
| 💀 Creeper Wrong | §c✘ Wrong! Creeper ignited! RUN! |
| ⏰ Timeout | §c✘ Time's up! -2 HP! |
🎯 Tips & Strategy
- Answer correctly — Each correct answer grants 5 free actions = extended freedom
- Don't streak wrong — Wrong answer damage escalates (2→4→8→16→20 cap)
- Watch out for Creepers — Wrong answer on a Creeper = instant ignition. Use ranged attacks!
- Don't wait for timeout — Guess if unsure, timeout counts as wrong too
- Ranged = half damage — Bows are safer but deal only 50% of melee damage
❓ FAQ
Q: Questions too hard/easy?
A: Edit quiz_questions_zh.json or quiz_questions_en.json with your own questions, then /quizreload.
Q: How to disable quizzes for a specific action? A: Set free action count to a very large number (e.g. 99999) — effectively disables it.
Q: Does it work on servers? A: Yes! Both client and server need the mod installed. All player states are isolated.
Q: What happens when the timer hits 0? A: Auto-judged as wrong answer — health penalty + next question (combat mode also unfreezes mobs).
Q: Compatible with other mods? A: Compatible with most Fabric mods. Uses standard event APIs, no core overwrites.