View source for User:Gdude2002/Starting a Server

The following explains how to start a server and connect to it. Currently, there is no way to start a multiplayer server in-game, nor is there a way to limit a server to just Steam friends.

The developers have stated that they're looking into Steam for multiplayer networking - but this may be some time coming, as they have a very long list of things to do!

For reference, the default port for Staxel is '''38465'''.

'''If you're looking to start a server, please make sure you read all relevant sections before you start!'''

= Windows =

Staxel is designed with Windows in mind, and this is the easiest platform to host a server on.

If you're inexperienced with server hosting or just want to play with your friends, this is the best option for you.

== Requirements ==

* A copy of Staxel, either on Steam or the Standalone version
* The ability to forward a port on your router (this is preferred)

If you're unable to forward ports, you may also use Hamachi. This is detailed towards the end of the Windows section.

== Starting the server with Steam ==

'''Note''': If you're using SteamCMD, skip to the next section.

Starting the server with Steam on Windows is very simple:

# Open up steam and find Staxel in your library
# Double-click on Staxel or click the play button
# Select '''"Dedicated Server"''' and click the play button

If you want to play Staxel at the same time, press the '''"Start game client with Steam"''' button now. This will open a copy of Staxel for you to play on.

For a list of settings and what they do, please see the [[#Server_Configuration|Server Configuration]] section.

== Starting the server without Steam ==

Starting the server with the Standalone version of Staxel is very simple:

# Open up the Staxel launcher
# Click on the '''"Server"''' button

If you want to play Staxel at the same time, press the '''"Start game client"''' button now. This will open a copy of Staxel for you to play on.

For a list of settings and what they do, please see the [[#Server_Configuration|Server Configuration]] section.

== Starting the server with the command-line ==

If you're working remotely, don't have a screen, or just don't want to use your mouse, you can also start the server from the command-line.

'''This is a more advanced technique''' - if you're not confident with your skills on the command-line, it's recommended that you choose one of the first two methods.

# Open up a copy of Powershell, or the Windows command prompt (<code>cmd</code>)
# Use <code>cd</code> to find your way to wherever you have Staxel installed
# Once you've found Staxel's install folder, <code>cd</code> into the <code>bin</code> folder
# Run <code>Staxel.Server.exe</code> and the server will start in the command-prompt

'''Please note''': This method will not allow you to configure the server with the Server Wizard. Details on how to configure your server this way can be found in the [[#Server_Configuration|Server Configuration]] section.

== Installing the server using SteamCMD ==

If you have a dedicated Windows server, you can simply install and use Steam as you would at home. However, if you'd rather not run Steam all the time, you may prefer to work with SteamCMD instead.

'''This is a more advanced technique''' - if you're not confident with your skills on the command-line, it's recommended that you choose one of the first two methods. In fact, if you don't specifically need SteamCMD, please don't use it.

SteamCMD is a command-line application, which allows you to download and install games and game servers from Steam. If you're planning to do this, you may prefer to set up a separate Steam account with only Staxel on it, as you're going to have to save the password to your Steam account on the server if you want to make updates quicker.

'''Note''': This guide assumes that you're installing SteamCMD to <code>C:\steam\steamcmd</code> and storing your games in <code>C:\steam\games</code>. If this isn't the case, remember to modify the paths below!

In short, here's what you'll need to do:

# Download a copy of SteamCMD to your computer and extract it
# Set up a couple of scripts to make your life easier
# Update and login with SteamCMD
# Download Staxel
# Run the server using the methods explained previously

If you need more detailed instructions:

# Download SteamCMD from [https://steamcdn-a.akamaihd.net/client/installer/steamcmd.zip this link] and extract <code>steamcmd.exe</code> to <code>C:\steam\steamcmd</code>.
# Add <code>C:\steam</code> to your system's <code>PATH</code>
#* Open '''This PC''' (or '''My Computer''' on earlier versions of Windows)
#* Right-click a blank section of the window and select '''Properties'''
#* Select '''Advanced System Settings''', and then select the '''Advanced''' tab in the window that appears
#* Click the '''Environment Variables''' button, select the <code>PATH</code> entry in the '''System Variables''' section, and hit '''Edit'''
#** On newer versions of Windows: Hit the '''Add''' button, type <code>C:\steam</code> into the box it gives you and click OK
#** On older versions of Windows: Add the following text to the value: <code>;C:\steam</code> and click OK - don't forget the semicolon!
#* Click OK and close the windows you just opened
# Create a file named <code>steam.bat</code> in <code>C:\steam</code> and insert [https://gist.github.com/gdude2002/17be96da179d6a63ccb3264f62451802 the contents of this file]
# Open a command prompt or Powershell, type <code>steam</code> and hit enter - this will download Steam and you will be presented with a <code>Steam&gt;</code> prompt
# Use <code>login account_name password</code> to log into your Steam account - follow the instructions given to authenticate with Steam Guard or 2-factor as necessary
# Type <code>quit</code> and hit enter to close SteamCMD
# Create a file named <code>update_staxel.bat</code> in <code>C:\steam</code> and insert [https://gist.github.com/gdude2002/51c0f78e8ba3132c39698ad438d53499 the contents of this file]
# Replace <code>ACCOUNT_NAME</code> and <code>PASSWORD</code> in the file with your Steam account name and password
# Go back to your command prompt or Powershell window, type <code>update_staxel</code> and hit enter - this will download and install Staxel in <code>C:\steam\games\staxel</code>
# Open <code>C:\steam\games\staxel\_CommonRedist</code> and install each of the requirements - if you're not planning to actually run the game, then you will not need to install DirectX, but do install everything else
# Once these are all installed, you're ready to go - See [[#Starting_the_server_without_Steam|Starting the server without Steam]] or [[#Starting_the_server_with_the_command-line|Starting the server with the command-line]] for information on running the server
# If you want to update the server at any point, simply stop it and run <code>update_staxel</code> in a command prompt or Powershell again

== Hamachi ==

'''Please note''': Hamachi does impact the performance of your network, and may result in lag for your players. Please only use it as a last resort.

<sup>''Many thanks to Edy Nelson for writing [https://steamcommunity.com/sharedfiles/filedetails/?id=1279024136 the original guide] for this''</sup>

If you're planning to do this, make sure your server is '''not set to Public mode'''.

# Install Hamachi from [https://www.vpn.net/ this page], and make sure anyone that wants to play also installs it
# Open a network, or "VPN tunnel"
# Give your friends the name of the network, and the password if you set one
# Set up your server as explained in the above sections
# Give your friends the IPv4 address assigned to you by Hamachi
#* You can right-click your name in Hamachi and click on '''"Copy IPv4 Address"'''
# Have your friends connect to the address you just sent them

Hamachi can be quite temperamental - it may be advantageous to use something more complicated (for example, Zero Tier One) if you have problems with it.

= Linux =

While the Staxel server does not have official Linux support, it is possible to at least get the server to run on Linux.

'''Please note:''' This is an unsupported setup. There may be stability issues. Additionally, the server will run slower than it would under Windows.

'''This is only recommended for advanced users!'''

This guide assumes that you're using Arch Linux, and that you know what you're doing - however, the instructions should also work for other Linux distributions.

== Requirements ==

# The <code>wine</code> package (on Arch, this is in the [https://wiki.archlinux.org/index.php/Multilib Multilib repository])
# The <code>wine-mono</code> package
# A decently fast machine - the server is quite intensive on CPU, and Wine only makes things slower
# If you're using Steam directly, you may want to use <code>winetricks</code> to install it

=== Setting up your environment ===

It's recommended that you run the server in 64-bit mode. While you will see some warnings about 32-bit libraries not working correctly, things should function just fine.

This guide assumes that you're using the default <code>WINEPREFIX</code> (which is <code>~/.wine</code>) and that you are not forcing it into 32-bit mode with the <code>WINEARCH</code> environment variable.

# Open a terminal - this guide assumes you're using <code>bash</code> as your shell, so adapt the commands as needed if you're not
# Run <code>wine cfg</code> - this will set up your Wine prefix and open the configuration tool, which you can close once it appears

== Installing Staxel with Steam ==

# Install Steam using Wine - you can do this using <code>winetricks</code>, which has Steam under the "Install an application" section
# Open Steam and install Staxel in the usual way
# Move to the [[#Starting_the_server|Starting the server]] section

== Installing the Standalone version of Staxel ==

# Outside of wine, download your Standalone copy of Staxel
# Copy it to a folder within <code>~/.wine/drive_c/</code>
# Use Wine to install Staxel, you can use <code>winefile</code> to do this
# Start up the Staxel launcher and make sure it's up to date
# Move to the [[#Starting_the_server|Starting the server]] section

== Installing Staxel with SteamCMD ==

If you're working on a "headless" machine - for example, a machine without a screen of it own, or a remote machine that you connect to with SSH - '''this is the method you want'''.

# Install SteamCMD using your package manager (On arch, it's available from the AUR)
# Open a terminal and run <code>sudo steamcmd +quit</code> (use <code>su -c "steamcmd +quit"</code> if you don't have sudo set up)
#* We do this to update SteamCMD, only root is able to do this
# Run <code>steamcmd +login ACCOUNT_NAME PASSWORD +quit</code> to login to your Steam account
#* Replace <code>ACCOUNT_NAME</code> and <code>PASSWORD</code> with your Steam login username and password
# Create a file named <code>update_staxel.sh</code> and insert the contents of [https://gist.github.com/gdude2002/abc19a51b6ac012c34985afc5d6ea4aa this file]
# Run <code>chmod +x update_staxel.sh</code> to mark the script you just made as executable
# Run <code>./update_staxel.sh</code> and SteamCMD will download and install Staxel in <code>C:\staxel</code> on your Wine drive
# Move to the [[#Starting_the_server|Starting the server]] section

== Starting the server ==

# Take note of where you installed Staxel
#* If you installed with Steam as detailed above, it will be in <code>C:\Program Files (x86)\Steam\steamapps\common\Staxel</code> on your Wine drive
#* If you installed the Standalone version of Staxel, by default it installs to <code>C:\Program Files (x86)\Staxel</code>
#* If you installed with SteamCMD as detailed above, it will be in <code>C:\staxel</code> on your Wine drive
# To run the server, use <code>wine "path_to_staxel\bin\Staxel.Server.exe"</code>, replacing <code>path_to_staxel</code> with wherever you installed Staxel to
#* Remember, when you run things with Wine, you need to refer to them as they would be on Windows, not the direct path you'd use on Linux

'''Please note''': This method will not allow you to configure the server with the Server Wizard. Details on how to configure your server this way can be found in the [[#Server_Configuration|Server Configuration]] section.

= Server Configuration =

For reference, the default port for Staxel is '''38465'''.

There are two ways to configure and run your server, and the one you end up with will depend on the server setup method you followed above.

== Configuring with the Server Wizard ==

The Server Wizard is the recommended way to run a server on Windows. You will be presented with a window which offers a set of configuration options. Below is an explanation of each option:

* '''Public''': Enabling this will show your server on the public server list. If you don't want strangers joining your server, keep this disabled, or set a password
** If you're using Hamachi or another virtual LAN solution, make sure this option is disabled, or players won't be able to connect
* '''Creative Mode''': You can enable or disable Creative Mode here. There are three options:
** '''On''' will force Creative Mdoe to be turned on
** '''Off'' will force Creative Mode to be turned off
** '''Keep Server Setting''' will check the world for the last value of the Creative Mode setting, and use that
* '''Server Name''': The name of your server on the public server list - if you've turned off the Public option, this will be unavailable
* '''Port''': The port to listen for connections on - this defaults to 38465, and you shouldn't need to change it under normal circumstances
* '''Password''': If you want to prevent people from connecting without a password, you can enter that password here
* '''Allow unauthenticated players''': If you enable this, players that are playing the game in offline mode may connect to the server. This will be greyed out if the server is public. '''It's not recommended that you enable this as it can make your server insecure'''
* '''Attempt automatic UPnP portforwarding''': If your router supports UPnP port-forwarding, this option will attempt to save you some time and have the server forward the port automatically. Unfortunately, this won't work on a majority of routers
* '''StorageName''': Set this to the name of your world, and don't forget it! If you only ever intend to run a single world on your server, you can leave this blank

You can test your port forwarding settings by clicking the '''"Test Port"''' button and waiting for a moment. The box to the right of the button will contain the result of this test. If the test fails, then nobody will be able to connect to your server from machines not on your network!

Once you've verified that your port forwarding is working, take note of the '''"Your External Server Address"''' box. This contains the IP address that players can use to connect to your server - this IP will correspond with the IP of the machine you're running the server on.

Note: If you have a dynamic IP address, the address that players need to connect to will change. You can deal with that using a dynamic DNS service, such as '''no-ip.net'''. This will give you a domain name instead of an IP address - simply give that domain name to your players.

Those of you with a static IP address can use a domain name pointed to that address as normal.

Once you've finished configuring your server in the server wizard as shown above, you're ready to get started! Click the '''"Start Server"'' button and the server will start up in a new window.

== Configuring from the command-line ==

Configuring your server from the command-line requires you to supply a set of command-line arguments whenever you start up the server. They correspond with the settings found in the Server Wizard above, so look at that section for detailed information on what these settings do.

* '''--public=(false|true)''': Disable or enable public mode
* '''--local=(false|true)''': Unknown at this time
* '''--name=serverName''': Set the server name, used when public mode is <code>true</code>
* '''--password=password''': Set a server password, used on connection
* '''--port=38465''': Set the server port to listen for connections on
* '''--interface=0.0.0.0''': If you need to listen on a specific interface, you can supply it here - '''Advanced users only!'''
* '''--storage=localStorageName''': Set the name of the world to use here
* '''--creative=(false|true)''': Force Creative Mode to be turned on or off
* '''--upnp=(false|true)''': Set whether to attempt to use UPnP Port Forwarding
* '''--weakAuthentication=(false|true)''': Set whether to allow unauthenticated users to connect

Remember '''you do not have to supply every option''' - you can just supply what you need, and the rest will be defaulted.

== Working with mods ==

Mods are available to use in multiplayer. If you're using mods, then you will also need to install them on the server - You can use the Staxel mod manager in the usual way to do this.

While mods may be downloaded from the server, only cosmetic mods may be obtained in this way at the moment. If you're using a mod that includes any code, you'll need to have each of your users install that mod themselves. Steam Workshop is great for this!

If you installed your server without Steam, you can try [http://steamworkshopdownloader.com/ Steam Workshop Downloader] for downloading Workshop mods.

= Server Administration =

When your server has been started, don't announce it right away - make sure you connect to the server before anyone else. The reason for this is that the first person to join the server becomes the administrator. Administrators are the only players to get access to Farm Fan's tutorial - everyone else is given a pet kit and 800 petals to buy their own tools.

== Admin commands ==

Administrators also get access to a set of admin commands:

* '''/fly''' - Enable flight
* '''/op username''' - Give someone else admin access
* '''/noclip''' - Enables flight and allows you to fly through the ground and other solid objects
* '''/tp player_1 player_2''' Teleport ''player_1'' to ''player_2''
* '''/givepetals''' - Spawn in some extra money for a player
* '''/stealpetals''' - Take away money from a player

== Stopping the server ==

When you're done with the server for now or just want to update it, simply press <code>CTRL + C</code> with the server terminal open. This will shut down the server. Please be patient, as the server will take a few moments to save everything!