StudyQuest: The Educational Role-Playing Game

Turn any subject into an epic RPG adventure powered by Baidu ERNIE AI. Study Math, Physics, Chemistry and English through quests, duels and personalized AI tutoring.

Comment

Inspiration

I've always hated studying. Not because I'm lazy — but because every study app feels exactly the same. Flashcards. Pomodoro timers. Chat with AI. Repeat.

Then one night I was playing a video game and thought: "Why can't studying feel exactly like this?"

That single question became StudyQuest.

I wanted to build something that made students WANT to open the app every day — not because they have to study, but because they genuinely want to fight the next dragon, unlock the next title, beat their friend in a real-time duel, or open a Mystery Box.

Every other educational app asks: "How can I help you study?"

StudyQuest asks: "How do I make you WANT to study?"

What it does

StudyQuest is the world's first Educational RPG — where studying IS the game.

⚔️ RPG Adventure Mode Students fight through a 10-question battle map with enemy HP bars, countdown timers, screen shake on wrong answers and combo multipliers. Every correct answer deals damage to the enemy. Reach the Victory Tower to unlock a chest with diamonds and medals.

🧠 Famous AI Professors Learn directly from Einstein, Newton, Marie Curie, Euler and Gauss — each powered by AI with their own unique personality and teaching style.

🐆 Leo AI Tutor A leopard-themed tutor powered by Groq (Llama 3.3 70B) that answers any question on any subject in under one second.

📄 PDF Analyzer Upload any PDF and get an instant AI-generated summary, key concepts, practice quiz and flashcards — automatically in under 30 seconds.

⚗️ Math Transmutation Engine A 3-phase learning system — Phase 1 assembles formulas like a puzzle with a live sandbox, Phase 2 is step-by-step guided training with owl tutor Sage, Phase 3 is a final boss battle against enemies like "Hypotenusus the Dread."

⚔️ Duel Mode Challenge AI opponents from Goblin Scout to Einstein Bot across 4 difficulty levels with 96 unique questions.

🎮 Real-Time Multiplayer Battle friends live using Supabase Realtime synchronization.

📚 Study Rooms Live group chat rooms where students discuss topics together in real time.

🖊️ Interactive Whiteboard Draw, take notes and chat with Leo AI directly on the board. Export your work as PDF.

🇯🇵 Japanese Writing Practice Trace Hiragana, Katakana and Kanji N5 characters with stroke evaluation. Build complete sentences step by step.

📊 Progress Tracker Visual XP graph, streak counter, missions completed and mastery level percentage — all in one dashboard.

📅 Study Schedule Plan your entire week, add personal notes and photos per day. Fully personalizable study planner.

🔥 Focus Streak Multiplier Answer fast and correctly to activate Flow State (x2 XP) or Unstoppable Mode (x3 XP) with fire animations.

💡 XP Hint System Spend XP to get AI hints mid-question. Strategic choice: save XP for the ranking or spend it to protect your streak.

🎭 RPG Skill Tree 3 specialized XP bars — Logic, Eloquence and Alchemy. Each subject feeds a different skill. Unlock your academic player class.

💎 Diamond Economy Complete adventures to earn diamonds. Spend them on Mystery Boxes, XP Boosts, exclusive titles, streak shields and the legendary Time Freeze Clock that slows your battle countdown to half speed.

🏆 Global Leaderboard Real-time world rankings updated with every adventure. Weekly competitions award gold, silver and bronze medals displayed permanently on each student's profile.

🌸 Language Practice Bots Practice Japanese with Hana, Chinese with Mei and English with Tall — each with 3 difficulty levels and real conversation practice.

🌍 Available in 8 languages English, Spanish, Portuguese, Chinese, Japanese, Korean, German and French.

40+ features built entirely with MeDo.

How we built it

StudyQuest was built entirely through conversation with MeDo — no manual coding at any point.

Every component, every feature, every database table and every AI integration was created by describing what I wanted and letting MeDo generate the complete full-stack code.

Tech Stack:

  • Frontend: React 18 + TypeScript + Vite
  • Backend: Supabase (Auth, Postgres, Realtime)
  • AI Generation: Baidu ERNIE for unique RPG story generation per topic
  • AI Tutoring: Claude API for Famous Professors and Sage tutor
  • AI Speed: Groq Llama 3.3 70B for Leo
  • Auth: Google OAuth via Supabase
  • PDF Processing: PDF.js + Groq API
  • Deployment: MeDo full-stack hosting

Development happened in 3 phases:

Phase 1 — RPG Engine Building the core adventure system where Baidu ERNIE generates unique stories for any academic topic. Adding the 10-question battle map, enemy HP bars, countdown timers, combo multipliers, screen shake and victory animations.

Phase 2 — Educational Depth Integrating Famous Professors with unique AI personalities, PDF Analyzer with automatic quiz generation, Math Transmutation Engine with 3 phases, language practice bots for Japanese, Chinese and English, Interactive Whiteboard with Leo AI and Japanese Writing Practice with stroke evaluation.

Phase 3 — Economy and Social Complete diamond economy, Diamond Shop with Mystery Boxes, exclusive titles and legendary items, RPG Skill Tree, Global Leaderboard with Supabase Realtime, weekly medal competitions, Study Rooms with live chat, Study Schedule planner and Progress Tracker dashboard.

Challenges we ran into

Challenge 1 — Making battles feel REAL Early versions had RPG elements but felt hollow. We rebuilt the adventure system multiple times — adding enemy HP bars, screen shake, countdown timers, combo multipliers and particle effects — before it finally felt like a genuine battle worth fighting.

Challenge 2 — Real-time multiplayer sync Getting two players to battle simultaneously using Supabase Realtime required multiple iterations. Any lag broke the competitive feeling completely.

Challenge 3 — PDF text extraction Groq cannot read PDF binary files directly. We implemented PDF.js to extract text page by page before sending to the AI — maintaining accuracy across different PDF formats and languages.

Challenge 4 — Balancing 40+ features With so many features, keeping the app intuitive required constant redesign. The solution was Demo Mode — which auto-fills everything and launches a complete RPG adventure in 2 seconds.

Challenge 5 — Japanese stroke evaluation Building a system that accurately evaluates handwritten Japanese character strokes on a canvas — distinguishing correct from incorrect stroke order — required significant iteration.

Challenge 6 — Knowing when to stop Every completed feature inspired three more ideas. StudyQuest became something much larger than originally planned — and every feature made it better.

Accomplishments that we're proud of

🏆 Built the world's first Educational RPG — no other app combines RPG game mechanics with serious academic content at this depth and scale.

🏆 40+ fully functional features in production — not prototypes, not mockups, real features that real students can use right now.

🏆 5 AI integrations working simultaneously — Baidu ERNIE, Claude API, Groq Llama 3.3, Supabase Realtime and Google OAuth all working seamlessly together.

🏆 Real-time multiplayer from scratch — synchronous 1v1 battles between two real players without any game engine.

🏆 PDF to complete study set in 30 seconds — summary, key concepts, practice quiz and flashcards generated automatically.

🏆 Japanese Writing Practice with stroke evaluation — trace Hiragana, Katakana and Kanji N5 with real-time feedback.

🏆 Math Transmutation Engine — a completely original 3-phase educational system. Nothing like this exists anywhere.

🏆 Built entirely by one student using only MeDo — no team, no prior professional development experience.

What we learned

We learned that gamification is not about adding points to boring content. Real gamification changes how the brain relates to learning itself.

When a student sees an enemy HP bar drop because they answered correctly — that correct answer becomes a victory. When the screen shakes because they failed — that failure becomes a real consequence worth avoiding. Emotional stakes make learning stick.

We learned that MeDo is genuinely revolutionary. Building a full-stack application with real-time databases, multiple AI integrations, OAuth authentication and production deployment — through conversation alone — would have been impossible with traditional tools for a single student.

We learned that students don't need more study tools. They need a reason to care about studying in the first place. StudyQuest solves the real problem: making students WANT to study.

What's next for StudyQuest

📱 Native Mobile App — React Native for iOS and Android with push notifications for streak reminders and challenges.

👥 Guild System — Study clans of up to 20 students competing together in team tournaments.

🎓 Teacher Dashboard — For educators to assign adventures, track progress and create custom question banks.

🏆 Tournament Mode — Weekly and monthly competitions with exclusive in-app rewards for top students.

🧠 Adaptive AI — Learns each student's weak points and automatically adjusts difficulty and recommendations over time.

🌍 Expanded Content — More subjects, more languages and school partnerships worldwide.

The vision is simple: Make every student in the world WANT to study every single day.

StudyQuest — Turn Any Subject Into An Epic Adventure.

Built with MeDo. ⚔️

BuiltWithMeDo

Built With

Share this project:

Updates