[general]
name=02GeoQuest - Playable Map Studio
qgisMinimumVersion=3.34
qgisMaximumVersion=4.99
description=Turn any vector layer into a polished geography game, classroom challenge or public-engagement quest.
version=1.2.1
author=Yusuf Eminoglu
email=yusuf.eminoglu@deu.edu.tr

about=02GeoQuest transforms ordinary QGIS vector layers into playful, useful challenges. Play Map Hunt directly on the QGIS canvas, compare attribute values, estimate distances, recognise polygon silhouettes, and test geodetic bearings in Compass Quest. Build mixed quests, import/export Quest Packs, keep local scoreboards, generate printable Achievement Certificates, and export standalone privacy-friendly HTML games that run fully offline. No account, API key, server or pip dependency is required. Developed with feedback from educational workflows at Dokuz Eylul University, Department of City and Regional Planning. Online User Manual & Documentation: https://yusufeminoglu.github.io/zero2geoquest/ | If you find this plugin helpful, please consider starring the repository on GitHub (https://github.com/YusufEminoglu/zero2geoquest)!

tracker=https://github.com/YusufEminoglu/zero2geoquest/issues
repository=https://github.com/YusufEminoglu/zero2geoquest
homepage=https://yusufeminoglu.github.io/zero2geoquest/

category=Vector
tags=game,education,quiz,geography,engagement,classroom,offline,html,planx
icon=icons/icon.png

experimental=False
deprecated=False
hasProcessingProvider=no
license=GPL-3

changelog=
    1.2.1 - Hub Metadata Compatibility:
        Fixed: Removed a literal percent character from plugin metadata so QGIS Hub can parse and validate the release package.
    1.2.0 - Reliable Quest Packs & Balanced Play:
        Fixed: Imported and built-in Quest Packs now launch from their own records instead of being overwritten by the selected QGIS layer.
        Added: Shuffle-bag mode rotation presents every selected mode before repeating one and avoids consecutive repeats.
        Added: Strict portable-pack validation for modes, difficulty, WGS84 coordinates, finite values, duplicate ids, playability, file size and record count.
        Added: Atomic Quest Pack saves and collision-free portable ids for mixed-layer exports.
        Fixed: Score closeness multipliers are bounded to prevent malformed inputs from inflating scores.
        Improved: Challenge fallback tries each selected mode exactly once and reports a useful failure reason.
    1.1.1 - Ranking Mode Usability & Reordering Controls:
        Added: Move Up (⬆️) and Move Down (⬇️) buttons for reliable, accessible ranking reordering alongside drag-and-drop.
        Added: Dynamic rank badge indicators (🥇 1st Highest, 🥈 2nd, 🥉 3rd, 🔻 4th Lowest) updating live as items are sorted.
        Fixed: Enhanced submit ranking handler with clean UserRole data mapping, preventing text truncation or missing items.
    1.1.0 - Major feature update:
        Added: 9th game mode "Compass Quest" calculating forward geodetic azimuths and cardinal bearings.
        Added: Quest Pack import/export system (.json) with 3 built-in starter packs (World Capitals, European Landmarks, Global Megacities).
        Added: Geographic Intelligence Certificate HTML export with score badges and rank titles.
        Added: Expanded standalone HTML export supporting Compass Quest, dark mode, and certificate summary.
    1.0.3 - Palette-aware adaptive theme.
        Changed: replace the hardcoded stylesheet and inline colour literals with palette-derived tokens so the dock stays readable under QGIS light, dark and high-contrast themes. The dock now listens for PaletteChange and re-applies the theme automatically.
    1.0.2 - Fix: ensure all eight game modes appear when their data requirements are met. Fix: ordering mode displays correct ranking answer. Fix: lives counter no longer goes negative. Fix: HTML export includes all eligible modes.
    1.0.1 - Documentation: add README with quick-start and mode descriptions.
    1.0.0 - Production release: eight polished game modes (Map Hunt, Value Duel, Distance Guess, Know the Shape, Attribute Guess, Ranking, Nearest Neighbour, Blind Zoom), difficulty levels with countdown timer, joker system, class profiles, leaderboard, and standalone offline HTML export.
    0.9.0 - Complete alpha: four game modes, quest builder, canvas interaction, scoring, leaderboard, bilingual UI and standalone offline HTML export.
