How To Add A Workshop Scenario To Your Empyrion Server

Scenarios are the main way to mod Empyrion: Galactic Survival. They add community-made galaxies, game modes and content to your server. This guide shows you how to install a Steam Workshop scenario by uploading it manually.

⚠️ Important Warning: Always make sure your server is completely stopped on your MintServers panel before uploading files or changing settings.

    📁 server (your server's root directory)
            📁 Content
                    📁 Scenarios
                            📁 YourScenarioName (Upload your renamed scenario folder here)

Step 1: Download The Scenario

Open the scenario's page on the Steam Workshop and click Subscribe.
Wait for Steam to finish downloading it, then open the folder where Steam stores Empyrion Workshop items on your computer. On Windows, the default location is:
```
C:\Program Files (x86)\Steam\steamapps\workshop\content\383120\
```
Inside, you will find a folder named after the scenario's Workshop ID (a long number). This is the folder you need.

Step 2: Upload The Scenario To Your Server

Scenarios are often large, so we recommend uploading them over SFTP instead of the panel's file manager. Your login details are on the SFTP Details tab of your panel, and our SFTP guide shows you how to connect.

Log into your MintServers panel and click the Stop button.
Connect to your server with your SFTP client.
Navigate to the Content/Scenarios folder.
Upload the scenario folder into it.
Rename the uploaded folder from its Workshop ID to the scenario's name, for example MyScenario. Remember the name exactly as written, because you will need it in the next step.

⚠️ Do Not Skip The Rename: If the folder keeps its Workshop ID as its name, the scenario can get stuck in a loading loop and never start properly.

Start Your Empyrion - Galactic Survival ServerUnlimited RAM · Unlimited slots · From $9.99/month

Start My Server

Step 3: Set The Scenario In Your Settings

Go back to your MintServers panel and open the Game Settings tab.
Find the Custom Scenario field (it currently says Default Multiplayer) and replace it with the exact name of the folder you uploaded.
If you are switching to a new scenario, change the Save Name to something new. This starts a fresh save instead of loading your old world.
Save your changes.
Go to the Console tab and click Start.

To go back to the normal game later, set Custom Scenario back to Default Multiplayer. For more information on what each option does, see our Server Configuration guide for Empyrion.

💡 Easy Anti-Cheat
Some scenarios recommend playing with Easy Anti-Cheat turned off. Whatever the scenario needs, the EAC setting on your server and your game must match. See our Join Server guide for Empyrion for how to change it in the game.

🛠️ Troubleshooting Scenario Issues

Scenario does not load: Check that the Custom Scenario value matches the folder name exactly, including capitalization, and that the folder sits directly inside Content/Scenarios.
Stuck in a loading loop: Make sure you renamed the folder from its Workshop ID.
Still loading your old world: Change the Save Name to start a fresh save for the new scenario.

Your custom scenario is ready to explore! If it still will not load, no worries! Just open a support ticket and our team will take a look.

Start Your Own Empyrion - Galactic Survival Server

Build and explore in a true space sandbox 24/7 Expert Support Swap between 60 games at any time