You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Thomas Lindner 3c8a0a4b7f fix some layer/collision bugs 5 months ago
.github/workflows Initial commit 1 year ago
docs Initial commit 1 year ago
music Add toilet flushing 1 year ago
quest add nop slide quest 5 months ago
tiles embed tilesets from world-tiles 5 months ago
tutorial Generated html from tutorial markdown 1 year ago
world-tiles@e480e21223 update world-tiles and lobby exit url 5 months ago
.gitmodules add exit to lounge 5 months ago
README.md Initial commit 1 year ago
basement.json fix some layer/collision bugs 5 months ago
first-floor.json fix some layer/collision bugs 5 months ago
heizhaus-basement.tmx fix some layer/collision bugs 5 months ago
heizhaus-first-floor.tmx fix some layer/collision bugs 5 months ago
heizhaus.tmx fix some layer/collision bugs 5 months ago
index.html Initial commit 1 year ago
main.json fix some layer/collision bugs 5 months ago
mapcleanup.py embed tilesets from world-tiles 5 months ago

README.md

WorkAdventure Map Starter Kit

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

Tools you will need

In order to build your own map for WorkAdventure, you need:

  • the Tiled editor software
  • "tiles" (i.e. images) to create your map (this starter kit provides a good default tileset for offices)
  • a web-server to serve your map (this starter kit proposes to use Github static pages as a web-server which is both free and performant)

Getting started

On the Github repository page, click the "Use this template" button. You will be prompted to enter a repository name for your map.

Be sure to keep the repository "Public".

In your newly created repository, click on the Settings tab and scroll down to the GitHub Pages section. Then select the gh-pages branch.

Wait a few minutes a Github will deploy a new website with the content of the repository. The address of the website is visible in the "GitHub Pages" section.

Click on the link. You should be redirected directly to WorkAdventure, on your map!

Customizing your map

Your map is now up and online. You need to customize it.

Cloning the map

Start by cloning the map. If you are used to Git and GitHub, simply clone the map to your computer using your preferred tool and jump to the next chapter.

If you are new to Git, cloning the map means downloading the map to your computer. To do this, you will need Git, or a Git compatible tool. Our advice is to use GitHub Desktop.

TODO: test and continue

Loading the map in Tiled

The sample map is in the file map.json. You can load this file in Tiled.

Now, it's up to you to edit the map and write your own map.

Some resources regarding Tiled:

About WorkAdventu.re maps

In order to design a map that will be readable by WorkAdventure, you will have to respect some constraints.

In particular, you will need to:

  • set a start position for the players
  • configure the "floor layer" (so that WorkAdventure can correctly display characters above the floor, but under the ceiling)
  • eventually, you can place exits that link to other maps

All this is described in the WorkAdventure documentation. Please be sure to check it out.

Pushing the map

When your changes are ready, you need to "commit" and "push" the changes back to GitHub. Just wait a few minutes, and your map will be propagated automatically to the GitHub pages web-server.

TODO: describe how to push