Difference between revisions of "Administration tips"
(Add instructions for how to update the server) |
(add how to reset and remove passwords) |
||
| (3 intermediate revisions by one other user not shown) | |||
| Line 2: | Line 2: | ||
== Stop the 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, | + | 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 == | == Restart the server == | ||
| Line 9: | Line 9: | ||
== Add admins == | == Add admins == | ||
You can make yourself or other players admins, which gives them some [[command list#admin commands|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 command list|server console command]]. | You can make yourself or other players admins, which gives them some [[command list#admin commands|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 command list|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 [[server config|autologin]]. | ||
== Change server settings == | == Change server settings == | ||
| Line 23: | Line 31: | ||
== Add Matrix bridge == | == Add Matrix bridge == | ||
| − | + | Follow the instructions at [[Bridging to Matrix]]. | |
Latest revision as of 07:50, 9 July 2024
There are some interesting additional things you can do with your AAGRINDER server.
Contents
Stop the server[edit]
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[edit]
You stop the server with the stop command, then start it again.
Add admins[edit]
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[edit]
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[edit]
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[edit]
There are a bunch of settings that might be useful. I recommend looking at server settings.
Make terrain special[edit]
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[edit]
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[edit]
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[edit]
Follow the instructions at Bridging to Matrix.
