Difference between revisions of "Setting up a server"

From AAGRINDER wiki
Jump to navigationJump to search
m (better username example)
(Remove database dependency)
Line 11: Line 11:
 
* [https://nodejs.org/en/ Node.js]
 
* [https://nodejs.org/en/ Node.js]
 
* [https://www.npmjs.com/get-npm npm]
 
* [https://www.npmjs.com/get-npm npm]
−
* [https://www.mysql.com/ MySQL] (not mandatory)
 
  
−
If you're going to use MySQL,
+
Acquire the AAGRINDER server software:
−
[https://www.digitalocean.com/community/tutorials/how-to-install-mysql-on-ubuntu-14-04 set up]
 
−
your database.
 
−
It is needed for storing account data.
 
−
Helpful commands:
 
−
<pre>
 
−
$ mysql -u root -p
 
−
> create database aagrinder;
 
−
> create user 'aagrinder_user'@'localhost' identified by 'some_password';
 
−
> grant all privileges on aagrinder.* to 'aagrinder_user'@'localhost';
 
−
> flush privileges;
 
−
> quit
 
−
</pre>
 
−
 
 
−
Then, acquire the AAGRINDER server software:
 
 
<pre>
 
<pre>
 
$ git clone https://gitlab.com/MRAAGH/aagrinder.git
 
$ git clone https://gitlab.com/MRAAGH/aagrinder.git
Line 50: Line 35:
  
  
−
A [[server properties|server-properties.json]] file will be created.
+
A [[server properties|config.json]] file will be created.
−
In that file, you set the database name, host, user and password.
+
You can change the server configuration, although the defaults should already be functional.
−
Then [[administration tips#restart the server|restart the server]].
 
  
 
Now, anyone who can [[wikipedia:port forwarding|access your computer]] via internet can easily connect to your aagrinder server.
 
Now, anyone who can [[wikipedia:port forwarding|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. [[Running in insecure mode|More about insecure mode]]
 
−
 
−
Open your server-properties.json file.
 
−
Change "insecure_mode":false to "insecure_mode":true.
 
−
Then [[administration tips#restart the server|restart the server]].
 

Revision as of 20:56, 14 August 2022

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:

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 config.json file will be created. You can change the server configuration, although the defaults should already be functional.

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

Retrieved from "https://wiki.aagrinder.xyz/index.php?title=Setting_up_a_server&oldid=44805"