Wynnteractive Map

Wynnteractive Map is a static GitHub Pages map for current Wynncraft routes, guides, discoveries, rewards, professions, travel points, and mobs.

What is here

• Fruma-era world map with pan and zoom controls
• Main and beta map surfaces
• Search, filters, found-state tracking, and theme persistence in browser storage
• Multi-stop route planning with shareable URLs
• Regional completion percentages and portable progress import/export
• Prefilled GitHub issue reports for incorrect markers
• Marker notes for quests, mini quests, discoveries, caves, dungeons, raids, boss altars, world events, lootrun camps, travel points, profession spots, and mobs
• Source links back to the related information pages and guides

Main files

• index.html: live app shell
• beta/index.html: beta app shell
• shared-map-ui.css: shared map and panel styling
• main-map-app.js: live interaction logic, marker rendering, and panel behavior
• beta/beta-map-app.js: beta interaction logic
• shared/app-utils.js: shared escaping, lookup, embed, and asset helper logic
• shared/map-tools.js: shared route planning, completion dashboard, reporting, and progress transfer tools
• data/markers.js: local marker metadata and curated overlays
• data/wiki-map-markers.js: generated live marker dataset used by the map
• data/generated-marker-supplements.js: non-destructive official/wiki coverage additions
• data/generated-marker-position-overrides.js: official coordinate corrections for named wiki markers
• data/generated-mob-markers.js: official ingredient-drop mobs and spawn locations
• data/marker-content-loader.js: lazy guide-content loader for marker categories

Quick start (local)

Clone the repo and open index.html directly in a browser — no build step required. For live-reload during development, use:

npx serve .

Run the zero-dependency project checks with:

npm run check

Refresh current marker categories and ingredient-dropping mobs with:

npm run refresh:data

The refresh combines the official map, item/drop, and territory APIs with the official wiki's MediaWiki API. Existing records are preserved when upstream no longer returns them. A scheduled workflow reruns the refresh weekly.

The check covers JavaScript syntax, JSON parsing, local HTML/module references, duplicate HTML and marker IDs, marker categories, marker coordinates, and shared utility behavior.

Contributing

Marker data lives in data/markers.js, data/wiki-map-markers.js, and generated supplement files. To add or correct a marker, edit the relevant source or generator and open a pull request. Please include the in-game coordinates and a source link.

Sources and Credits

• All core marker positions are from the official Wynncraft server marker data.
• Fast travel and Seaskipper locations are from the Wynntils project, and the Fast Travel / Seaskipper marker art is taken directly from the Wynntils resource pack.
• Official API docs: List map markers
• Official API endpoint: https://api.wynncraft.com/v3/map/locations/markers
• Primary information source: Wynncraft Wiki on wiki.gg
• Backup information source: Wynncraft Fandom
• Qira Hive guide credit: An In-Depth Guide To Fighting Qira
• Lootrun guide credit: Ultimate Wynncraft Lootrun Guide
• Profession guide credit: Zy's updated profession guide
• Code assistance: OpenAI Codex in the Codex desktop app
• Special thanks to gale_nasin for answering rule-related questions for the project.
• Special thanks to Xnova204 for making the site logo.

License

This project is licensed under the GNU AGPLv3. See LICENSE. Third-party assets and source material remain credited to their original upstream projects and authors.

Deployment

This repository deploys to GitHub Pages from main with .github/workflows/deploy-pages.yml.