CryoFall/Server/Setup: Difference between revisions

From AtomicTorchWiki
No edit summary
Line 65: Line 65:


6000 is the default port but you can change it in the Data/SettingsServer.xml file.
6000 is the default port but you can change it in the Data/SettingsServer.xml file.
== Server update ==
When we're releasing a new version of the game server, you need to follow these steps to update it:
# Ensure you've installed ".NET Core Runtime" (version 3.1 or any higher) https://dotnet.microsoft.com/download/dotnet-core/3.1
# Ensure you've made a backup of the "Data" folder inside the game server installation.
# Download the new version of the server and overwrite your current installation with it (you can find the actual download link above in the "Installation" section).
# Important: please [b]overwrite[/b] both Binaries and Core folders!
# Please [b]delete[/b] the "Data/Saves" subfolder. The savegames are [b]incompatible[/b] with the current version.
# Save and start the server as usual.
# Stop the server.
# Open the "Data/ServerSettings.xml" file with a text editor.
# Find the value <server_operators_list> and change it to include your nickname.
# Check server rate in the "Data/ServerRates.config" there are many new rates such as crafting speed and farm plants growth speed! Please read how to properly adjust them, there are some important changes in the current version.
# Save everything and start the server as usual.


== Server commands ==
== Server commands ==

Revision as of 01:23, 19 December 2019

Game server rent service

If you don't want to hassle with the game server setup, you can rent your own CryoFall server from PingPerfect now.
They have locations all over the world, just visit them to get yours ΓÇö PingPerfect.com (this is our referral link).

Requirements

Hardware requirements


(for up to about 100 players online) 2-core CPU 1.6-2 GHz, 1.5 GB RAM, 5-10 Mbit/s connection.
(for up to about 200 players online) 2-core CPU 2-2.4 GHz, 2 GB RAM, 10-20 Mbit/s connection.
Usually, VPS (virtual machines) hosting such as Vultr.com (this is our referral link as we're using this company services to host our own servers) is sufficient for hosting a game server. Using 1-core machines is not recommended as the game requires a secondary CPU to ensure smooth performance without hiccups during intensive background operations (such as world snapshot saving). Using more than a 2-core machine for a single game server hosting is redundant as the game cannot utilize more than two cores due to sequential execution of the game simulation (except physics and networking).

Software (system) requirements

The server could run on Windows, Linux, and Mac.
You need to have .NET Core Runtime 3.1 (or any higher) installed. It's supported for the many operating systems and installation is very quick.
To install .NET Core Runtime 3.1 please visit Microsoft .NET Core Downloads and select .NET Core Runtime Installer for your operating system. Follow the installation steps to set up the game server.

Installation

How to host your own server:

  1. Make sure to read server requirements section above and install the required software before attempting to run the server
    (especially you need to install .NET Core Runtime as described there).
  2. Download the game server runtime from SERVER DOWNLOAD LINK and extract it.
  3. IMPORTANT: please ensure there are no space chars in the path to the extracted server location.
  4. The server package is including everything necessary to run the game server (not only executable but also "Core" folder containing the game scripts in a packaged zip archive named "Core.cpk"). The executable is located in the subfolder: "Binaries/Server". Launch the command line (or PowerShell in Windows) and navigate to this folder (hint: in Windows you can simply SHIFT + Right-click on the "Server" folder in Explorer and select "Open PowerShell window here").
  5. Start the server executable first time with loadOrNew flag. The server will start and create the game world.
    dotnet CryoFall_Server.dll loadOrNew
  6. Stop the server. To do so enter command below and press Enter key.
    stop 0
  7. The server will save and quit. Now you have the "SettingsServer.xml" and "ModsConfig.xml" files.
  8. Now you need to navigate to the subfolder "Data" (in the root of the server folder, not in the "Binaries/Server") and modify "SettingsServer.xml" to set the unique server name, description, welcome_message, make it public if needed, set other settings, etc (there are XML comments explaining every setting so it should be straightforward).
  9. While you're still editing "SettingsServer.xml" file, please find the value <server_operators_list> and change it to include your nickname! Otherwise, you will be unable to access your server console from the game.
  10. If you want to have a custom server icon, please replace the ServerIcon.png file in the "Data" subfolder. The icon image file requirements: PNG24 format, 256x256 size, up to 100 KB.

In SettingsServer.xml, do not modify misc and network parts! It may cause malfunction if something is set in a way it is not intended to be.

You may, however, modify <server> part at your own risk. There you can set up some server configurations that would affect gameplay.

Note: if you are interested in hosting public server make sure to edit <is_public_server> and set the value from 0 to 1. This will make your server accessible publicly. Also make sure your router is configured correctly (port forwarding) to enable other people to connect to your machine from outside. But ideally you should use dedicated server hardware to host public servers.

Important (for Windows): you need to allow the dotnet process in the Windows Firewall settings - if the Firewall access request was not shown automatically by Windows you can add the C:\Program Files\dotnet\dotnet.exe file into Firewall whitelist. To to this, open Windows Start menu and search for "Allow an app through Windows Firewall" -> button "Allow another app".

Starting the server:

  1. Launch the command line (we recommending PowerShell in Windows) and navigate to this folder (hint: in Windows you can simply SHIFT + Right-click on the "Server" folder in Explorer and select "Open PowerShell window here").
  2. Start the server executable with load flag.
    dotnet CryoFall_Server.dll load
  3. Stop your server by typing command below and pressing Enter key (it will save the world before stopping).
    stop 60 The shutdown message text goes here

(Where 60 is the shutdown delay (in seconds) so the connected players will have some time to find a safe location)

Please note that typing this message is really hard as the console is updating regularly! The best way is to simply copy-paste from the text editor the whole command text into the game console window (hint: you can paste in PowerShell by simply pressing the right mouse button) and pressing Enter key.

You can always wipe the world by launching the game with new flag:

dotnet CryoFall_Server.dll new

Currently, we don't support the savegame migration between the major game versions (if there are changes to the game data serialization scheme). We plan to implement the proper data migration feature ASAP.

Connecting to the server:

If you want to connect to your local game server, simply add SERVERS->Custom list as localhost

To connect to the public server you need to navigate to SERVERS->Community servers list (please note that this might not work if you host this server on the same PC as the client, read below).

If you're attempting to host your server on a home computer and other players cannot connect to it, you need to manually forward the port UDP 6000 on your home router to your local IP address (the game has the auto port forwarding feature but it often fails due to the difference in UPnP implementation on many routers).

Please note that if you're running a game server on the same PC as the game client, you might be unable to connect to the game server from the Community servers list on that PC due to NAT routing even with the proper port forwarding. In that case, simply add your server into the client custom servers list by providing its address as localhost:6000 and connect to it directly.

Connecting to the private servers requires adding it via the Custom servers menu.

6000 is the default port but you can change it in the Data/SettingsServer.xml file.

Server update

When we're releasing a new version of the game server, you need to follow these steps to update it:

  1. Ensure you've installed ".NET Core Runtime" (version 3.1 or any higher) https://dotnet.microsoft.com/download/dotnet-core/3.1
  2. Ensure you've made a backup of the "Data" folder inside the game server installation.
  3. Download the new version of the server and overwrite your current installation with it (you can find the actual download link above in the "Installation" section).
  4. Important: please [b]overwrite[/b] both Binaries and Core folders!
  5. Please [b]delete[/b] the "Data/Saves" subfolder. The savegames are [b]incompatible[/b] with the current version.
  6. Save and start the server as usual.
  7. Stop the server.
  8. Open the "Data/ServerSettings.xml" file with a text editor.
  9. Find the value <server_operators_list> and change it to include your nickname.
  10. Check server rate in the "Data/ServerRates.config" there are many new rates such as crafting speed and farm plants growth speed! Please read how to properly adjust them, there are some important changes in the current version.
  11. Save everything and start the server as usual.

Server commands

  1. Ensure you're the server operator (you've edited the ServerSettings.xml file and added yourself into the server_operators_list).
  2. Connect to your game server.
  3. The game console can be toggled by pressing ~ (the key on the left from 1 key) like in old-school games (you can change the key binding for console in the controls options).
  4. Please add / (slash) prefix to the server commands you want to execute.
  5. You can use Tab key to fill autocomplete, and you can use arrow Up/Down keys to navigate the suggestions list.


Here is the page with the server commands list: Server Commands List

Moderation (whitelist, blacklist, kicking, muting)

Server operator can access special moderation commands. To invoke these commands, please ensure you're the server operator, connect to your game server, open the console (~ key) and then you can use these commands: (replace username with the actual player nickname)

Whitelist management:

/mod.whiteList.add username

/mod.whiteList.remove username

/mod.whiteList.print

To enable whitelist:

/mod.whiteList.enabled 1

Blacklist management:

/mod.blackList.add username

/mod.blackList.remove username

/mod.blackList.print

Kicking players (temporary removing from server and blocking from connecting):

/mod.kickList.add username durationInMinutes

/mod.kickList.remove username

/mod.kickList.print

Muting players (temporary removing their ability to send messages to chat):

/mod.muteList.add username durationInMinutes

/mod.muteList.remove username

/mod.muteList.print

Server rates adjusting / Enabling PvE mode

Server rates (and PvE flag) are exposed in a separate config file. You can quickly change things like LP gain rate, increase item drops, reduce the player to player damage to zero or even increase the damage from creatures and make it really tough for the players!

To adjust the server rates, stop the server and check the file <game server>/Data/ServerRates.config

Please read carefullyΓÇöall the rates are disabled and in order to apply them you need to remove the # char at the start of the line!

For advanced modding please read modding prerequisites.

Server raiding hours (for PvP)

On PvP server, you could set up specific hours during which the raiding is possible.
By default, offline raiding protection is not enabled so players could raid other players' bases at any time.
To enable offline raiding protection, please use this in-game console command:
/admin.setRaidingWindow 4 14 1.5
In this code we're using (first number) +4 GMT/UTC timezone, (second number) hour of day when raiding is possible (value from 0 to 24), and (third number) is the duration of the raiding window (value from 0 to 24).
So the code in the example will allow raiding from 14:00 (or 2PM) for 1.5 hours.
After changing the value you could open Politics/Diplomacy menu ([P] key) and verify whether you set the correct numbers.
Please note that Politics/Diplomacy menu displaying your local time (in your PC timezone)!