Skip to content

quickstart.md

Latest commit

 

History

History
90 lines (54 loc) · 3.67 KB

quickstart.md

File metadata and controls

90 lines (54 loc) · 3.67 KB

Subspace Server .NET Quickstart

Contents

Prerequisites
Installation
Run the server
Connect to your zone
Take it further

This article provides instructions on how to quickly get Subspace Server .NET up and running from scratch.

If you already have a zone running ASSS, see Quickstart from ASSS instead for instructions on how to use your existing ASSS files.

Prerequisites

The server requires that .NET be installed. If you don't already have it, you can get it from: https://dotnet.microsoft.com.

Installation

  1. Download the latest release and extract it to the location of your choice.

  2. In the folder you extracted to, find the folder named clients. Copy Continuum.exe from your Continuum client's folder into the clients folder.

At this point, the server can technically be run and you'd be able to connect to it on port 5000. However, you'll likely want to change that.

Configure the endpoint to Listen on

Open the conf/global.conf file and find the [Listen] section. It should look something like:

[ Listen ]
Port = 5000
BindAddress =

The Port setting tells the server which UDP port to listen on for game requests. It also determines which port to listen on for ping requests, which is always implicitly the Port number + 1. Therefore, in this example, it listens for game requests on port 5000 and for ping requests on port 5001.

The BindAddress setting tells the server which IP address to listen on. By default, this setting is empty, meaning listen on all available network interfaces.

Run the server

To run the server, use the included startup script which is located in the zone's root folder.

Linux and macOS

The script is named: run-server.sh. From the shell, cd to the folder you installed the server to, and run it:

./run-server.sh

Windows

The script is named: run-server.cmd. Run it from File Explorer, or from the command line cd to the folder you installed the server to, and run it.

run-server.cmd

PowerShell

Alternatively, a PowerShell script, run-server.ps1 is also included, in case that is your preference.

./run-server.ps1

To shut the server down gracefully, use: Ctrl + C

Connect to your zone

Start the Continuum client. On the main screen, click the Zones button to open the Add/Update Zones window. Alternatively, it can be opened by navigating on the menu bar to: View --> Zones...

On the Add/Update Zones window, click the "Add Custom..." button and fill out the fields. Fill in the Zone Name with a name of your choice. Fill in the IP Address of the server. If you're running it locally, you can use 127.0.0.1 to specify localhost. The Port should be the value you configured earlier, or 5000 if you skipped that step.

Confirm you choices and your zone should appear on list and you should be able to connect to it.

Take it further

Now that you have your server running, what you do with it is up to you.

For more information about the server, see the User Manual.

Here are a few topics that might be of interest:

If you would like to learn how to create your own plugins, see the Developer Guide.