Guide/Setting Up Dedicated Server

```
Want to customize your solar system? Read on here: Customizing Solar Systems

```

## Where to get the dedicated server files

NOTE: As of version 4.0 you need to use the Server Tool that can be found via STEAM -> LIBRARY -> TOOLS -> Empyrion Server

If the Empyrion dedicated server does NOT show up under Tools in your Library, you can install it via SteamCMD as follows:

1. Install SteamCMD from https://developer.valvesoftware.com/wiki/SteamCMD
2. In case of the windows installation, run the steamcmd.exe that was included in the .zip download ONCE and close the CMD window after it has been installed
3. Now open a NEW console/command line prompt and navigate to the directory you installed SteamCMD (For Windows, hit the WINDOWS button on your keyboard and enter CMD -> hit enter and a Command line interface will open. Find the installation directory by going to your steamcmd directory like `"cd c:\steamcmd"` -> go to the next step!)
4. Enter the following command:

```
**`C:\steamCMD\steamcmd.exe +force_install_dir c:\steamCMD\empyrionDedicatedserver\ +login anonymous +app_update 530870 validate +quit`**

```

This will install the Empyrion Dedicated Server under the folder “Empyrion – Dedicated Server” beside the folder where steamcmd is installed. If needed you may change the folder name to your liking.

## How to start the dedicated server

Go to the folder: C:\...\Empyrion – Dedicated Server

* To start a dedicated server with rudimentary GUI: "EmpyrionDedicated.cmd"
* To start a dedicated server without GUI: "EmpyrionDedicated\_NoGraphics.cmd"

To run the server when your computer starts and you log in, create a shortcut to the .cmd file of your choosing and place that shortcut in the folder: %appdata%\Microsoft\Windows\Start Menu\Programs\Startup. Remember to enter the command *saveandexit* *0* before shutting down or logging off, or you may lose your progress!

## How to configure your server

Servers can be configured via changing the value of the **property** in **"dedicated.yaml"** in ..\Steam\SteamApps\common\Empyrion - Dedicated Server folder.

```
Each property can be disabled by putting '#' in front of the line. To enable a property, remove the #

```

## How to connect to the server console

### Telnet

Use the PuTTY terminal emulator to access your server, if telnet is enabled in the server configuration. The default port is 30004. Be advised that, while the service uses telnet, the Raw connection type should be used. Use of the Telnet connection type causes unusual issues, such as the initial input of the password will always fail.

## Server and Console commands

All of the following commands are available via Telnet and from the in-game CONSOLE to Gamemasters, Moderators and Server Admins. Where <steam-id> is listed in the following command syntax, enter either a player's Steam ID # or their player name. If the player name contains spaces, encapsulate the player's name in single quotes; e.g.: 'Player Name'

## FAQ / Q&A

### Have additional starter planets

* Stop your server
* Open the sectors.yaml
* Find the planet you would like to offer as a starter planet
* Add TRUE to the planets entry

Example

```
- Coordinates: [ 20, 0, -15 ]
  Playfields:
  - [ "0, 0, 0", "Omicron Orbit", SpaceAsteroidFieldOmicron ]
  - [ "-1200, 0, 7200", Omicron, Desert, true ]
  - [ "1500, 4000, -6500", Omicron Moon, Moon ]
```

Adding new starter planet choices will allow new players to not only have a choice at all, but also to avoid crowded starter planets like Akua. This only applies to NEW players on your server! Using FRESH START won't let the users change their starter planet.

```
Important: Not all planets are suitable for being used as a starter planet. To offer an easy start, you may want to adjust the playfield settings of an entirely new starter planet. Please refer to our Customizing\_Solar\_Systems Guide for more details!

```

### Avoid dedicated.yaml to be overwritten

**Q: My dedicated.yaml gets overwritten with each version update! What can i do?**

A:

* 1. Copy your dedicated.yaml and rename it to something like myserver\_dedicated.yaml
* 2. Open the EmpyrionDedicated.cmd (or EmpyrionDedicated\_NoGraphics.cmd if you are used to start your server without GUI) with a text-tool, like Notepad++ or Windows Editor (DO NOT USE WORD or anything similar!)
* 3. Find the line that says

*EmpyrionLauncher -startDediWithGfx* or

*EmpyrionLauncher -startDedi*

* 4. Add the parameter "-dedicated myserver\_dedicated.yaml" so it looks like this

*EmpyrionLauncher -startDediWithGfx -dedicated myserver\_dedicated.yaml* or

*EmpyrionLauncher -startDedi -dedicated myserver\_dedicated.yaml*

* 5. Use SAVE AS and rename your EmpyrionDedicated.cmd, like "EmpyrionDedicated-myserver.cmd". This will avoid that the server start batch (.cmd) gets overwritten with the next version update!
* 6. Start your server with your EmpyrionDedicated-myserver.cmd. From now on, you will start your server via your own file!

### Retrieving lost ships

(Workaround should also work for SP)

Retrieving lost ships can be achieved with a small workaround: Every ship ("entity") is saved in a distinct folder in your (single player or) server world savegame
D:\Steam\SteamApps\common\Empyrion - Galactic Survival\Saves\Games\*<game name>*\Shared

```
*<game name>* is the name of the save-game,
---For multiplayer this is set in the **GameName** prop of dedicated.yaml. The of default value is 'New Game': - { prop: GameName, value: New Game }  *(The folder can only accessed by the server hosts)*
---For single player it is the name of the game used at the time of starting the new game or at the time of renaming the save game at resume menu.

```

In the SHARED folder, you can find entries like **SV\_New\_74922**. Each of these entries has - as all windows folders have - a creation date.

If you can identify the folder of the ship that got LOST (f.ex. by asking the user when he created it), you/your player only needs to lay down a new starter block (SV for a SV and so on) and YOU, as the admin, just need to copy the four \*.area files from the lost ships folder to the newly laid down starter block ship folder (overwrite!).

Steps to follow:

1. Player places a new starter block (SV for SV, CV for CV ..)
2. Save and Exit your server (or your game if SP)
3. Copy the .area files from the lost-ships folder over to the newly created ship folder and hit yes if asked to overwrite
4. Start your server (game)

Please do NOT do this while server/game is still running, as this may cause severe issues with the playfield! Of course you need FTP access to the installation folder at your hoster if you are not the host.

### More Questions

**Q: Is it possible to add more planets to a multiplayer world?**

A: YES! You can add as many as you like. See Customizing Solar Systems for more details

**Q: My server is not visible in the server browser. What can i do?**

A1: Try to forward the port range (30000-30004) both with TCP and UDP

A2: For some routers, you need to specify the Port-forwarding for the PC where you run your server!

A3: If nothing helps, please try port forwarding 26900-26904 instead of 30000-30004 and/or try to run the server with antivirus and firewall turned off. You might need to search the web on how "port forwarding" is set up correctly with your firewall and/or router!