Repository navigation
v1.0.0 — Initial Release
🗺️ Quest-OverWorld v1.0.0 — Initial Production Release
Welcome to the initial release of Quest-OverWorld, an immersive, location-based campus exploration and live multiplayer RPG scavenger quest platform!
🌟 Key Highlights & Features
📍 1. Interactive Overworld Atlas & GPS Radar
- Live Topographical Canvas: Real-time projection of player position against physical campus waypoints.
- Dynamic Sonar & Compass Bearing: Calculates real-time distance (in meters) and cardinal direction arrow using the Haversine formula.
- Prerequisite Graph & Branching Paths: Stations declare explicit prerequisite checkpoints; a waypoint unlocks once all prerequisites are cleared, enabling multi-path branching or auto-chained sequential progression.
- Offline-Tolerant Checkpoint Scanning: Scans made without network connectivity are queued on-device and replayed in chronological order upon reconnection; cached GPS is supported with a wider verification radius (+50m buffer) when a fresh fix isn't available.
- Atmospheric Day/Night Engine: Real-time canvas tint shifts based on solar hours (Dawn, Day, Dusk, Midnight).
- Sub-meter High Precision GPS: Configurable GPS accuracy modes (
HighestvsBalancedbattery saver).
🛡️ 2. Party & Guild Hierarchy System
- 6-Character Unique Join Code: Instant party discovery and recruitment.
- Gatekeeper Admission Queue: Recruits submit entry petitions; Captains and Vice-Captains review, admit (✅), or decline (❌).
- Configurable Party Size Limits: Admin-enforced maximum team size (default 6, up to 50) validated on petition and approval.
- Three-Tier Command Hierarchy: Captains, Vice-Captains, and Adventurers with leadership succession rules.
- Party Activity Feed: In-app chronological log of team events (checkpoints cleared, bounties solved, members joining/leaving, leadership transfers).
- Achievement Badges: Auto-awarded badges recognizing milestones beyond leaderboard scores (first checkpoint clears, flawless bounty solves, nighttime expeditions, full rosters).
- Historical Quest Standings: Permanent post-quest snapshots preserving team ranks, final scores, and completion breakdowns across past expeditions.
- Level-Gated Guild Perks (1-5): Telemetry sync, XP multipliers, proximity sonars, and golden crests.
⚔️ 3. Bounty Board & Challenge Engine
- Multi-Category Quests:
PHOTO,RIDDLE,TRIVIA, andCREATIVEchallenges. - Cloud Proof Verification: Photo bounty submissions with Cloudinary CDN storage and Admin Review queue.
- Timed Attempt Scoring & Penalty Decay: Score decays across subsequent incorrect attempts, with temporary cooldown locks on repeated failures.
- Bounty & Waypoint Hints: Optional station and challenge hints purchased with team XP, protected by perk loss threshold warnings.
- Interactive QR Scanner: Camera radar featuring laser animation, auto-flashlight activation, and manual passkey fallback.
👑 4. Guild Master Console (Admin Dashboard)
- Live Event Overview: Real-time active player counts, guild rankings, and server health.
- Scheduled Quest Windows: Automated background scheduler activating and completing quests via start/end timestamps under single-active-quest constraints.
- Admin Broadcast Announcements: Time-scoped global or quest-specific announcements with optional expiration timestamps.
- Post-Event Analytics: Aggregate reporting on checkpoint clear rates, average completion times, bottleneck waypoints, and bounty difficulty drop-off.
- Player & Guild Governance: Search, promote/demote admins, ban/unban users, force-kick players, and disqualify guilds.
- Quest & Checkpoint Studio: Coordinate map picker, auto-prerequisite chaining, and high-res printable QR code generation.
📦 Assets & Installation
- Android Standalone APK: Attached below (
Quest-Overworld.apk). - Interactive Postman API Documentation: Postman Documenter