This interactive map for Equinox: Homecoming is a community-driven project – created and maintained by players, for players. Try it out here!
The following features are fully implemented and available in the live version:
- Toggle marker categories on/off via click in the menu
- Search for markers using the search bar
- Click a search result to fly to that marker on the map
- Click a marker to open a popup with additional information
- Bookmark markers directly from the search results or within popups
- View only your bookmarked markers via the Bookmarks tab
We are committed to maintaining this project long-term. Our immediate goals include:
- Add remaining markers (e.g., weekly, side and main quests)
- Plot the course of the race when opening the popup
- Display a short visual tutorial when first visiting the app
- Refactor and abstracting code for future expansion
- Implement caching & efficient bandwidth usage
Have feedback, found a bug, or have a feature request? Fill out this Google Form or open an issue on GitHub.
The project is currently running on free plans. The serverless Next.js frontend is hosted on Vercel, and the map tiles are stored in a Cloudflare R2 bucket.
This is a collaborative community effort, with data sourced by players exploring the game. We've implemented a development mode, accessible at equinoxmap.app/dev. Clicking on the map in this mode spawns a marker and copies a template to the clipboard.
All markers are first added to /public/markers in the data branch. They are then processed if necessary and ultimately merged into the main branch via a pull request. A GitHub workflow resets the data branch to match the current main state. At build time, a script merges, validates, and converts marker data to GeoJSON for use with MapLibre GL.
Marker positions are stored in Cartesian coordinates (in meters), independent of any specific geographic projection. During the build process, these coordinates are converted to Web Mercator according to the transformation rules defined in map.json. This decouples the raw data from the runtime map projection, making it easier to adapt or scale in the future.
While a purely Cartesian system would be ideal for a flat game map, MapLibre GL currently requires geographic coordinates in Web Mercator projection.
Icons are processed using a script prior to deployment. The script optionally crops the input image, resizes it, and exports it to WebP format at a specified quality setting.
npm run build:prepare -- <img> <quality> <cropX> <cropY> <size>To prepare a large map image for use with MapLibre GL, run the script scripts/tile.sh:
sh tile.sh <source-img>This script adds transparent padding, centers the image, and generates tiles. It also prints a partial map.json configuration to the console.
Thanks to the separation between raw marker data and the runtime projection, you won’t need to adjust marker coordinates or apply runtime shifts when padding, shifting or scaling the map image, unless the source image itself changes. All coordinates are resolved at build time.
Since launch, the project has seen 3'540 unique visitors and 327'750 total requests, aggregated across all months. These statistics are provided by Cloudflare.
July 2025
Unique Visitors: 1'530
Total Requests: 130'770
June 2025
Unique Visitors: 2'010
Total Requests: 196'980
This project wouldn’t be possible without the tireless efforts of the following individuals – and of course, Blue Scarab Entertainment, the studio behind Equinox: Homecoming:
- CookieFox: Reported missing and incorrect locations, helped gather clothing and tack data, and tracked reputation gains for weekly quests initially.
- dreamfarer: Leads overall concept, planning, communications, software engineering, DevOps, and data processing.
- Laika: Created the original resource map in image form.
- Onyx: Provided the artefact locations.
- Snowhawk: Maintains a comprehensive Google Sheet tracking characters, quests, deliveries, clothing, tack, and more.
- Sugertoxity: Helped plan the overall concept, communications and early location data sourcing and processing.
- Yumemi: Submitted missing locations.
- zaaap!: Produced a video showcase of the interactive map.
- ☾ * 𝔉𝔢𝔢𝔩𝔦 ༓ ☽: Submitted a missing location.