https://github.com/digitalegesellschaft/workadventure-map-bitwaescherei
Bitwäscherei map for WorkAdventure
https://github.com/digitalegesellschaft/workadventure-map-bitwaescherei
Last synced: 5 months ago
JSON representation
Bitwäscherei map for WorkAdventure
- Host: GitHub
- URL: https://github.com/digitalegesellschaft/workadventure-map-bitwaescherei
- Owner: DigitaleGesellschaft
- Created: 2020-11-13T16:20:50.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-12-30T14:32:06.000Z (over 4 years ago)
- Last Synced: 2024-07-31T22:44:01.396Z (almost 2 years ago)
- Language: HTML
- Size: 101 MB
- Stars: 6
- Watchers: 8
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# WorkAdventure Map Starter Kit
This is a copy of a [starter kit](https://github.com/thecodingmachine/workadventure-map-starter-kit) to help you build your own map for [WorkAdventure](https://workadventu.re).
Additional tilesets are from the [chaosz0ne](https://github.com/chaosz0ne/shared).
## 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)
## Customizing your map
Your map is already 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](#loading-the-map-in-tiled).
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
The sample map is in the file `map.json`.
You can load this file in [Tiled](https://www.mapeditor.org/).
Now, it's up to you to edit the map and write your own map.
Some resources regarding Tiled:
- [Tiled documentation](https://doc.mapeditor.org/en/stable/manual/introduction/)
- [Tiled video tutorials](https://www.gamefromscratch.com/post/2015/10/14/Tiled-Map-Editor-Tutorial-Series.aspx)
### 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](https://github.com/thecodingmachine/workadventure/#designing-a-map).
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