Setting up a server

Currently, there are only instructions for setting up a server on Linux. Feel free to add instructions for other platforms.

For additional details, see administration tips.

Setting up an AAGRINDER server on Linux

You'll need these things installed:

• git
• g++
• Node.js
• npm
• MySQL (not mandatory)

If you're going to use MySQL, set up your database. It is needed for storing account data. Helpful commands:

$ mysql -u root -p
> create database aagrinder;
> create user 'maze'@'localhost' identified by 'some_password';
> grant all privileges on aagrinder.* to 'maze'@'localhost';
> flush privileges;
> quit

Then, acquire the AAGRINDER server software:

$ git clone https://gitlab.com/MRAAGH/aagrinder.git
$ cd aagrinder
$ npm install

You also need the AAGRINDER terrain generator (compiled from source):

$ git clone https://gitlab.com/MRAAGH/aagrinder-terrain.git
$ cd aagrinder-terrain
$ make

The directory aagrinder-terrain should be inside the directory aagrinder.

Move back to the directory aagrinder, then start the server:

$ cd ..
$ npm start

A server-properties.json file will be created. In that file, you set the database name, host, user and password. Then restart the server.

Now, anyone who can access your computer via internet can easily connect to your aagrinder server.

Running server without MySQL

WARNING: if you run a server without a database, players will not be able to protect their accounts with passwords. If you are going to play alone or only on the local network, this could be totally fine. More about insecure mode

Open your server-properties.json file. Change "insecure_mode":false to "insecure_mode":true. Then restart the server.