🎓 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 reload command
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
  }
]

answer is the zero-based index of the correct option
Use /quizsurvival reload to 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.

quizsurvival