Skip to content

hlahtoo/gamification

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

62 Commits
 
 
 
 
 
 

Repository files navigation

GoA: Gamification of Algorithms

An immersive 3D dungeon-themed exploration game where players solve interactive algorithm challenges to unlock the treasure chamber. Designed to help students learn complex algorithms through engaging visuals, real-time feedback, and intelligent gameplay.

🔗 Live at: https://gamification-7j06.onrender.com/

📋 Table of Contents

Overview

GoA Overview

GoA combines educational content and interactive gameplay into a fully immersive 3D world. Players explore a dungeon, solve challenges based on algorithms like Heapsort, Kruskal, and Prim, and receive real-time feedback on their learning journey. Perfect for students and classrooms aiming to enhance their understanding of algorithms in a visual, hands-on way.

Core Features

  • 3D Dungeon Exploration Gameplay
    Navigate through algorithm-based rooms and unlock the treasure by solving challenges.

  • Walk-through Interactive Tutorials
    Step-by-step tutorials for learning graph and sorting algorithms interactively.

  • Real-Time Feedback System
    Detects user mistakes and provides specific feedback based on algorithm logic.

  • Scoring, Lives & Leaderboard System
    Engaging game mechanics with scores, lives, and a competitive leaderboard.

  • Training & Regular Modes
    Practice freely in training mode or test your knowledge in regular mode.

  • Instructor Dashboard & Analytics
    View student performance per game or as a class, filterable by game or individual progress.

Screenshots / Demo

  • Homepage GoA Homepage
  • Sign In/ Sign Up Sign in/Signup
  • Instructor Dashboard 1 Dashboard_1
  • Instructor Dashboard 2 Dashboard_2
  • Main Entrance of 3D Dungeon Exploration Dungeon Exploration_1
  • 3D Dungeon Treasure Gate Dungeon Exploration_2
  • Heapsort Algorithm Gameplay Heapsort Gameplay
  • Kruskal Algorithm Gameplay Kruskal Gameplay
  • Prim Algorithm Gameplay Prim Gameplay

Technology Stack

Area Technologies
Frontend HTML, CSS, JavaScript, Three.js
3D Models Blender
Backend Node.js, Express.js
Database MongoDB
Game Engine Custom built with Three.js
Data Analysis Custom dashboard with filtering

Installation & Setup

Clone the repository

git clone https://github.com/yourusername/GoA
cd Gamification/Backend

Install dependencies

npm install

Set environment variables

Create a .env file in the root directory and add:

DATABASE="your-mongodb-connection-string"
DATABASE_PASSWORD="your-database-password"
PORT=3000

Start the server

cd front
npm install
npm run build
cd ..
npm start

Then navigate to http://localhost:3000 in your browser.

License

MIT © Hla Htoo

Connect with Me

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors