How grownplanet/mmm_geo_quest works
GeoQuest is a word-seeded walking game: the player enters a word and difficulty, the computer derives a destination in Ghent, obtains a walking route, and sends successive route points to an Arduino navigator over MQTT. The navigator is intended to guide the player and report locations so the computer can advance the route and announce completion. The computer workflow is visible in the sampled Python; Arduino internals were not sampled, so those capabilities and links are based on README documentation.
Main entry points: main.py MQTT client · navigator.ino Navigator firmware
Components 13
Computer game
- Game interface
computer/main.py - Word destination
computer/main.py - Route progress
computer/main.py - Game completion
computer/main.py
Route planning
- Walking route
computer/main.py - Difficulty waypoints
computer/main.py
MQTT communication
- MQTT client
computer/main.py - Location messages
computer/main.py
Arduino navigator
- Navigator firmware
arduino/navigator/navigator.ino - Direction display
arduino/navigator/navigator.ino
Other components
- Player
- Mapbox Directions
- MQTT broker
Connections 17
- Player → Game interface: enters game
computer/main.py - Game interface → Word destination: derives destination
computer/main.py - Game interface → Difficulty waypoints: selects difficulty
computer/main.py - Game interface → Walking route: requests route
README.md - Walking route → Mapbox Directions: requests directions
computer/main.py - Walking route → Difficulty waypoints: reduces route points
computer/main.py - Game interface → MQTT client: starts MQTT
computer/main.py - MQTT client → MQTT broker: connects
computer/main.py - MQTT broker → MQTT client: delivers messages
README.md - MQTT client → Location messages: queues locations
computer/main.py - Location messages → Route progress: supplies current location
computer/main.py - Route progress → MQTT client: publishes next point
computer/main.py - Route progress → Game completion: detects arrival
computer/main.py - Game completion → MQTT client: publishes LAST
computer/main.py - MQTT client → Navigator firmware: sends route points
README.md - Navigator firmware → MQTT client: reports location
README.md - Navigator firmware → Direction display: shows direction
README.md