mapserver/doc/dev.md
2021-04-12 13:07:17 +02:00

79 lines
1.6 KiB
Markdown

# System overview
<img src="./Overview.png">
# Build dependencies
## Basic
* go >= 1.11
* make
## With crosscompiling (optional)
Either apt-get:
* gcc-mingw-w64
* gcc-5-arm-linux-gnueabihf
* gcc-i686-linux-gnu
Or use the docker-builder image in `/docker-builder`
# Development setup
Working directory: `./server`
## Preparing the files and map
Copy your `map.sqlite` into the working directory if you want to test with
a sqlite map database
### world.mt
You need a `world.mt` too in order to make the connection to the database.
In the sqlite case:
```
gameid = minetest
backend = sqlite3
creative_mode = false
enable_damage = false
player_backend = files
```
For postgres:
```
gameid = minetest
backend = postgresql
creative_mode = true
enable_damage = true
player_backend = postgresql
pgsql_connection = host=localhost port=5432 user=postgres password=enter dbname=postgres
pgsql_player_connection = host=localhost port=5432 user=postgres password=enter dbname=postgres
```
## Running the server
* Create a `mapserver.json` with `go run . -createconfig`
* Change the value `webdev` in the `mapserver.json` to `true`
* Start the server with `go run .` or with debug output: `go run . -debug`
* The web files in `public/` can now be changed on the fly without restarting the server
# All platform build
Prerequisites:
* docker
* make
Building:
* Run `make clean all` to build for all supported targets
The artifacts should now be in the `output` directory
# Release build
Prerequisites:
* docker
* make
Building:
* Run `make all VERSION=X.Y.Z` in the root directory