WorkAdventure Map Starter Kit

This is a starter kit to help you build your own map for WorkAdventure.

To understand how to use this starter kit, follow the tutorial at https://docs.workadventu.re/map-building/tiled-editor/.

Structure

We recommend following this file structure:

• public/: Static files like PDFs or audio files
• src/: Scripts files or design source files
• tilesets/: All PNG tilesets
• map.tmj: Map file
• map.png: The map thumbnail used as meta-data

If you want to use more than one map file, just add the new map file in the root folder ( we recommend creating a copy of map.tmj and editing it, in order to avoid any mistakes).

We recommend using 512x512 images for the map thumbnails.

If you are going to create custom websites to embed in the map, please reference the HTML files in the input option in vite.config.js.

Requirements

Node.js version >=17

Installation and testing

With npm installed (comes with node), run the following commands into a terminal in the root directory of the project:

npm install

Then, you can test your map by running:

npm run dev

You can also test the optimized map as it will be in production by running:

npm run build
npm run prod

Licenses

This project contains multiple licenses as follows:

• Code license (all files except those for other licenses)
• Map license (map.tmj and the map visual as well)
• Assets license (the files inside the src/assets/ folder)

About third party assets

If you add third party assets in your map, do not forget to:

1. Credit the author and license with the "tilesetCopyright" property present in the properties of each tilesets in the map.tmj file
2. Add the license text in LICENSE.assets