maps

Validate and sync WorkAdventure maps with JSON and TypeScript workflows.

2|1|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/nf-core/hackathon-infra --skill maps-nf-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/nf-core/hackathon-infra/tree/main/.claude/skills/maps
Command: npx skills add https://github.com/nf-core/hackathon-infra --skill maps-nf-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate and sync WorkAdventure maps to prevent loading errors and keep the live environment up to date.

Core Features & Use Cases

  • JSON validation for map files
  • Sync maps to server via pre-defined scripts
  • Support for interactive zones (Jitsi rooms, silent areas)
  • TypeScript build workflow for map scripts
  • Troubleshooting guidance for common map issues

Quick Start

Edit maps/default/map.json in the local repo, ensure changes are committed, then run the sync-maps.sh script to deploy to the server.

Frequently Asked Questions about maps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate WorkAdventure map JSON files before deploying?

To validate WorkAdventure map JSON files, you must run a TypeScript build workflow to check map data and ensure interactive zones are correctly configured. This prevents loading errors and verifies map structure before syncing changes to the live server.

What is the best way to sync WorkAdventure maps to a live server?

The best way to sync WorkAdventure maps is to commit and push your local changes using a pre-sync checklist, then execute the sync-maps.sh script. This workflow ensures correct map data and stable deployments to the live environment.

Why does my WorkAdventure map fail to load after editing interactive zones?

WorkAdventure maps fail to load when interactive zones, such as Jitsi rooms or silent areas, contain invalid JSON data. You must validate the map files and run the TypeScript build workflow to identify and fix structural issues before deployment.

Do I need a TypeScript build workflow to use interactive zones in WorkAdventure?

Yes, a TypeScript build workflow is required to compile map scripts and validate interactive zones like Jitsi rooms. This process ensures your JSON map data is structurally sound and ready for a stable deployment to the server.

Can I troubleshoot common WorkAdventure map issues without a full server sync?

Yes, you can troubleshoot common WorkAdventure map issues locally by performing JSON validation on your map files and running the TypeScript build workflow. This allows you to catch loading errors and verify interactive zones before pushing changes to the live server.