Skip to content

Repository files navigation

02GeoQuest — Playable Map Studio

Documentation

Turn any QGIS vector dataset into an interactive geography game, teaching activity, data-familiarisation exercise, or public engagement quest.


📖 Documentation

Comprehensive Academic Reference Manual — complete documentation of every feature, parameter, and workflow. Hosted on GitHub Pages.

🎮 What You Can Play (8 Modes)

  • 📍 Map Hunt: Find requested features directly on the live QGIS map canvas.
  • ⚖️ Value Duel: Compare two features to determine which has the larger numeric value or area.
  • 📏 Distance Guess: Estimate the geographic distance between two places.
  • 🧩 Know the Shape: Identify a feature from its antialiased polygon silhouette.
  • 🎯 Attribute Guess: Estimate a numeric attribute using a slider control.
  • 📊 Ranking: Order 3–4 features from highest to lowest value via drag-and-drop.
  • 🧭 Nearest Neighbour: Determine which feature is geographically closest to a reference location.
  • 🔍 Blind Zoom: Identify a feature when the map canvas automatically zooms to it.

⚡ Game Features & Rules

  • Difficulty Levels: Easy (60s timer, 3 choices), Medium (30s timer, 4 choices), and Hard (15s timer, 6 choices).
  • Joker System: Use up to 3 jokers per quest (Eliminate options, Value Range Hint, or Map Region Hint).
  • Multi-Layer Mixing: Combine two vector layers into a single mixed quest.
  • Streak & Speed Bonuses: Build multiplier streaks (🔥 ×3+) for high score bonuses.
  • Visual Feedback: Live canvas highlighting, pulse effects, and interactive feedback.

🎓 Class Mode & Student Profiles

  • Student Profiles: Create and manage profiles with customizable avatars.
  • Session History: Track individual quiz scores, accuracy percentages, and completion times.
  • CSV Export: Export all classroom session records to a structured .csv report.

🌐 Serverless Web Export

Export any quest into a single, self-contained HTML file:

  • Offline & Private: Zero external network calls, zero CDNs, no tracking, works completely offline.
  • Responsive & Dark Mode: Built-in dark mode toggle, smooth animations, and progress indicator dots.

🚀 Quick Start

  1. Open 02GeoQuest from its QGIS toolbar button.
  2. Select your vector layer(s) and readable label/numeric fields.
  3. Choose your difficulty level, game modes, and quest rules.
  4. Click Start the quest to play in QGIS, or Export standalone HTML to share.

🔒 Privacy & Compatibility

  • Runs 100% locally inside QGIS (QGIS 3.34 – 4.x).
  • Requires no third-party Python packages.
  • Dual Qt 5/6 & PyQt 5/6 compatibility.

📜 License

GPL-3.0-or-later. Copyright © 2026 Yusuf Eminoglu.

About

Turn QGIS vector layers into playful map challenges and offline web quests

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages