workadventure/README.md

113 lines
2.6 KiB
Markdown
Raw Normal View History

2020-04-04 16:05:31 +02:00
![](https://github.com/thecodingmachine/workadventure/workflows/Continuous%20Integration/badge.svg)
2020-04-03 14:59:24 +02:00
# Work Adventure
## Work in progress
Work Adventure is a web-based collaborative workspace for small to medium teams (2-100 people) presented in the form of a
16-bit video game.
In Work Adventure, you can move around your office and talk to your colleagues (using a video-chat feature that is
triggered when you move next to a colleague).
## Getting started
Install Docker.
Run:
```
docker-compose up
```
The environment will start.
You should now be able to browse to http://workadventure.localhost/ and see the application.
Note: on some OSes, you will need to add this line to your `/etc/hosts` file:
**/etc/hosts**
```
workadventure.localhost 127.0.0.1
```
2020-04-15 23:10:12 +02:00
## Designing a map
If you want to design your own map, you can use [Tiled](https://www.mapeditor.org/).
A few things to notice:
- your map can have as many layers as your want
- your map MUST contain a layer named "floorLayer" of type "objectgroup" that represents the layer on which characters will be drawn.
![](doc/images/tiled_screenshot_1.png)
2020-04-04 13:18:45 +02:00
### MacOS developers, your environment with Vagrant
If you are using MacOS, you can increase Docker performance using Vagrant. If you want more explanations, you can read [this medium article](https://medium.com/better-programming/vagrant-to-increase-docker-performance-with-macos-25b354b0c65c).
#### Prerequisites
- VirtualBox* 5.x Latest version https://www.virtualbox.org/wiki/Downloads
- Vagrant 2.2.7 Latest version https://www.vagrantup.com/downloads.html
2020-04-04 13:18:45 +02:00
#### First steps
Create a config file `Vagrantfile` from `Vagrantfile.template`
```bash
cp Vagrantfile.template Vagrantfile
2020-04-04 13:18:45 +02:00
```
In `Vagrantfile`, update `VM_HOST_PATH` with the local project path of your machine.
```
#VM_HOST_PATH# => your local machine path to the project
```
(run `pwd` and copy the path in this variable)
To start your VM Vagrant, run:
```bash
Vagrant up
2020-04-04 13:18:45 +02:00
```
To connect to your VM, run:
```bash
Vagrant ssh
2020-04-04 13:18:45 +02:00
```
To start project environment, run
```bash
docker-compose up
2020-04-04 13:18:45 +02:00
```
You environment runs in you VM Vagrant. When you want stop your VM, you can run:
````bash
Vagrant halt
````
2020-04-04 13:18:45 +02:00
If you want to destroy, you can run
2020-04-04 13:18:45 +02:00
````bash
Vagrant destroy
````
2020-04-04 13:18:45 +02:00
#### Available commands
* `Vagrant up`: start your VM Vagrant.
* `Vagrant reload`: reload your VM Vagrant when you change Vagrantfile.
* `Vagrant ssh`: connect on your VM Vagrant.
* `Vagrant halt`: stop your VM Vagrant.
* `Vagrant destroy`: delete your VM Vagrant.
## Features developed
2020-04-15 23:10:12 +02:00
You have more details of features developed in back [README.md](./back/README.md).