Administration tips

There are some interesting additional things you can do with your AAGRINDER server.

Stop the server

To save the world and stop the AAGRINDER server, focus the console where the server is running and type stop, then press enter. Alternatively, you can press press Ctrl+C, which will discard changes unless enable_autosave is true in Server settings.

Restart the server

You stop the server with the stop command, then start it again.

Add admins

You can make yourself or other players admins, which gives them some additional privileges. To do this, open the admins.txt file which was created when the server was first started. Type the names of players which you would like to make admins, one name per line. Save this file. The next time you start the server, the new admin list will take effect. If the server is already running, you can reload the admin list with an appropriate server console command.

Reset someone's password

You can use the server console command passwd to reset someone's password. For example, to set password for user maze to nGRJZ24b, type: passwd maze nGRJZ24b

Remove someone's password

For example, to remove the password of user maze, type in the server console: passwd maze ""

Warning: this will allow anyone to log in as this user, with no password required! This is only recommended for testing/debugging. Probably in combination with autologin.

Change server settings

There are a bunch of settings that might be useful. I recommend looking at server settings.

Make terrain special

Although AAGRINDER terrain already has a lot of variety in itself, you could also change the terrain generator on your server, to make it even more special! To do this, go to the aagrinder-terrain directory (folder) and open the file called parameters.cpp. You will find a long list of parameters that can be changed. After you are done playing with the numbers, save the file. Then you need to recompile the terrain generator. To do this, open a terminal in your aagrinder-terrain directory and run the make command. The new terrain generator will immediately take effect even if the AAGRINDER server is already running. Explore some new terrain to see what it's like!

Backup a world

You can find all the worlds in the saves directory (folder). Each world is saved into its own directory inside the saves directory. To back up a world or share it, zip the folder where the world is saved, then store or send the zip.

Update the server

To update your AAGRINDER server, stop the server and run git pull in the server directory. Do the same in the terrain generator directory (aagrinder-terrain). If there were changes to the terrain generator, you have to recompile it by running make. Running the newest aagrinder-terrain on branch main and the newest aagrinder on branch main is the only supported combination. RUNNING INCOMPATIBLE VERSIONS OF SERVER AND TERRAIN GENERATOR IS UNSTABLE AND MAY CORRUPT YOUR WORLD!

Add Matrix bridge

Follow the instructions at Bridging to Matrix.