56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
# WorkAdventure Map Starter Kit
|
|
|
|
This is a starter kit to help you build your own map for [WorkAdventure](https://workadventu.re).
|
|
|
|
## Tools you will need
|
|
|
|
In order to build your own map for WorkAdventure, you need:
|
|
|
|
- the [Tiled editor](https://www.mapeditor.org/) 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](https://github.com/thecodingmachine/workadventure-map-starter-kit),
|
|
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 **master** 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](https://desktop.github.com/).
|
|
|
|
TODO: test and continue
|
|
|
|
### Loading the map in Tiled
|
|
|
|
TODO
|
|
|
|
### Pushing the map
|
|
|
|
When your changes are ready, you need to "commit" and "push" the changes back to GitHub.
|