Empyrion - Galactic Survival

Empyrion - Galactic Survival

118 ratings
Project Eden Configuration Guide A12
By ravien_ff
The configuration guide to Project Eden, a custom scenario for Empyrion - Galactic Survival
This guide explains how to install the Project Eden scenario on a dedicated server or to customize it for your own needs.

Please note that I cannot offer much support in setting up a dedicated server or editing scenario files beyond what is already listed in this guide.
I suggest checking out the official forums or the official discord if you have general questions on setting up servers or customizing scenarios.
2
   
Award
Favorite
Favorited
Unfavorite
About Project Eden
Project Eden is a lore friendly, PvE exploration scenario currently in development intended for single player or small group play. It is compatible with public online play but you will want to configure your game options for it.
This scenario aims at slowing down the mid and end game progression for those who want a longer play through with more of a focus on open ended exploration instead of linear progression.

Setup for Single Player and COOP
Simply subscribe to the scenario on the Workshop.
Restart your game if it was already running and let Steam download the scenario.
Then start a new game as single player or coop, select scenarios, then select Project Eden.
For coop you might need to first start it as single player, then quit and resume the save game as coop.

Set up your game difficulty options as desired, and then select your starting planet.
You can cycle through the starting planets by left or right clicking on the name of the starting planet in the upper right. The description and estimated difficulty of the starting planet will be displayed in the box in the bottom center.

Give it a few minutes to load the game and you're good to go. If running a COOP server it may take a few more minutes.
Note that COOP uses more system resources and at least 16gb of memory will be required.

Setup for Dedicated Servers

The scenario may not load properly if you skip the below steps!
These steps are used when first setting up a server OR when updating the scenario on the server.

IMPORTANT STEPS:
  1. When transferring the scenario files to your server via FTP, set the transfer mode to "binary" in your FTP client to avoid various errors with custom models and effects.

  2. After copying the scenario files RENAME them to be something other than the default numerical Steam ID.

  3. Never change the scenario name in an existing save game. Use the same folder name for the scenario when updating the scenario.

  4. You cannot change the scenario used for existing save games. You must start a new save game if you want to use a different scenario.

  5. The scenario does not get automatically updated on your server. You must manually copy the scenario files over again from your PC to your server if you want to update the scenario. Before reporting any issue, triple check that you followed all steps and that the scenario build listed on the loading screen matches the one in the update notes on the workshop.



Simply subscribe to the scenario on the Workshop.
Let Steam download the scenario.

After subscribing to the scenario, go to your Steam's Empyrion Workshop folder, usually located here:
SteamLibrary\steamapps\workshop\content\383120
Find the folder called 2464519802 and copy it. (If using Reforged Eden search for 2550354956 instead)

Go to your dedicated server's main Content/Scenarios folder and paste that 2276751921 folder in there.
>>> IMPORTANT STEP <<< Rename the folder that you copied over. If you leave it as the default name of 2464519802 it will not function correctly. Give it a new name.


Open the gameoptions.yaml file under that folder and set up your initial game options for a new game under the mp section as desired. By default Project Eden's options are already optimized for coop or private group PvE play.
Once a save game is started, you will need to edit the gameoptions.yaml under that save game instead.
It's recommended to keep anti-grief distances to 0, as the anti-grief zones can prevent custom asteroids from being mined.

Set the scenario name in dedicated.yaml to point to that folder you copied over.
Note that you will need to repeat this process anytime you want to update the scenario on your server and that some changes won't apply to an existing save game.
>>> IMPORTANT STEP <<< In your dedicated.yaml file for your server, set the TimeoutBootingPfServer to 2000. This will fix most warp issues.


Follow this guide on how to continue setting up your dedicated server.
I recommend using EAH (Empyrion Admin Helper) and seeing either the Empyrion Official Forums[empyriononline.com] or joining the Empyrion Discord[discord.com] for any assistance or questions in setting up a server as I cannot offer much support in setting up a server

Difficulty settings and game options are stored in gameoptions.yaml.
Server configuration settings are stored in dedicated.yaml.
Do not use any file called "dedicated_config.yaml". This is the incorrect file for proper setup of your server.

Note that if you are using a rented host to run your server, their setup and options may vary. Speak with customer support for your specific host for details.



To update the scenario on a server:
Repeat the above steps to copy the scenario files from your workshop folder to the server again, overwriting files if prompted.
MAKE SURE TO FOLLOW THE IMPORTANT STEPS AT THE START OF THIS SECTION ABOVE WHEN UPDATING YOUR SERVER.


Reducing star count for multiplayer performance:
ONLY PLAYERS EXPERIENCED WITH FILE EDITING SHOULD ATTEMPT TO CHANGE THE STAR COUNT. DOING SO INCORRECTLY MAY CORRUPT YOUR SAVE GAME PERMANETLY.

Directions for reducing the star count of the galaxy to help with long term server stability and save game size.
The more playfields are generated, the more data is kept in the save game and the larger the database grows.
This can cause issues on larger servers the longer the save game is run.
Reducing the star count will lower the total number of playfields in the galaxy which may help, but it is not a guarantee.
Not useful for smaller servers or single player where you will simply never generate most of the star systems anyway.

Notepad++ or equivalent text editor is recommended!

TO PREVIEW YOUR CHANGES IN A TEST GAME:
1: Start a new test save game using the scenario.
2: While still running the game, alt-tab out and go to your save game's Content/Configuration folder in file explorer.
For example: Empyrion - Galactic Survival\Saves\Games\NewGame\Content\Configuration
3: Open up GalaxyConfig.ecf and change the StarCount to whatever min and max values you want to try then save the file.
4: Tab back to the game and open the console and type (without the quotes) "galaxy".
5: Open the galaxy map and look at how the galaxy appears.
6: Repeat until you're satisfied with the galaxy star count.
7: Take note of the average warp distance between the stars. You may need to increase the warp drive range so players do not get stuck.


TO CHANGE THE STAR COUNT:
1: After copying the scenario files to your server, but before starting the save game for the first time, open up the GalaxyConfig.ecf file in the scenario files you just copied over.
The file is under Content\Configuration in the scenario.
2: Change the StarCount values to whatever min and max value you want. The game will generate a galaxy with a total number of stars between those two values.
For example: StarCount: "28000, 30000"
3: Save and close the file, then start a new save game on the server. The new galaxy will have the star count specified.
NOTE: Never change the galaxy config file under the save game folder for any existing save game as it can corrupt the database of that save. Always use a throwaway test save to preview changes to the galaxy config before starting your save game.


TO CHANGE THE WARP DRIVE RANGE:
1: Open up either the Config_PE.ecf or Config_RE.ecf files under the Content/Configuration folder in the scenario. Config_PE is for Project Eden and Config_RE is for Reforged Eden. DO NOT USE THE WRONG FILE FOR YOUR SCENARIO.
2: Change the RangeLY value to whatever you want for each warp drive type.
Note: Do not set any warp drive to longer than a 100ly range, as this will let players bypass the ancient warp gate and warp directly to the decay star cluster.
Note2: Remember that the basic warp drive gets up to +50ly range from navigational data, while the advanced warp drive gets +100ly range from navigational data.
3: Save the file as Config.ecf in the Content/Configuration folder.
4: Scenario updates shouldn't remove your changes.
WARNING: The Config.ecf file is no longer supported by the developers. In the future you may have to make the warp drive changes directly to the BlocksConfig.ecf file and therefor will need to redo your changes each time you update the scenario.


In-game scenario settings
There are new scenario settings available in-game for servers. These settings can affect things such as whether keys get used up, if players can buy ingots from refineries, etc. You can use this in single player as well if you want.

Admin access to the server is required:
First, only those with server admin access can access these console commands.
Attempting to use these commands without the proper admin access can result in automatic temporary or permanent bans from a server.


To access the Project Eden Admin Control:
Use console command "give item Token 6000" (without the quotes).
Go to any UCH Research Vessel and use godmode to access the terminal attached to the left side of the warp drive. Or spawn the Project Eden Admin Control blueprint using the sbp command.
Talk to the terminal while the admin access token is in your inventory. Godmode is required to be active for this step. Do not use godmode invisible.
Change the settings that you want to.
Trash the token when done.


Changing the access code:
If you want to change the access code that allows access to the admin config, edit the Dialogues.ecf file found in the configuration folder for the scenario.
Open the file and search for Admin Control.
Go to the line that says this:
NextIf_1: "HasItem('Token', 1, 6000)"
Change the 6000 to any number between 2000 and 5000.
This will be the new code you use with the give item command described above.
You can then tell specific server admins this code so they can access the admin controls. Only admins who know the code will be able to change scenario settings.


These settings use the dialog system to store a global variable in the database for your save game. Settings should be persistent within a save game, but will need to be re-applied when starting a new save game.
The scenario is by default optimized for single player or coop. These settings can increase the amount of time it can take to reach the very end game content in the scenario which might be better for servers.
Local copies and customization
If you wish to further customize the scenario with your own changes or custom config mods, or play it offline, or resolve co-op issues, you will also have to create a local copy of the scenario.

After subscribing to the scenario, go to your Steam's Empyrion Workshop folder, usually located here:
SteamLibrary\steamapps\workshop\content\383120
Find the appropriate folder for the scenario:
Project Eden 1.5: 2464519802
Reforged Eden 1.5: 2550354956
Project Eden 1.4 (obsolete): 2276751921
Reforged Eden 1.4 (obsolete): 2154284616

Single Player: Right click on Empyrion in your Steam Library, select Properties, then Local Files. Click Browse Local Files.
Go to Empyrion - Galactic Survival/Content/Scenarios and paste that folder in there.

Dedicated Servers: Go to your server's main Content/Scenarios folder and paste that folder in there.

>>> IMPORTANT STEP <<< Rename the folder that you copied over. If you leave it as the default name of random numbers it will not function correctly. Give it a new name. For this example we'll use Project Eden as the new folder name.


Use this new folder to make your edits to Project Eden, install custom config mods, or you can pull out playfields or blueprints for use in your own servers or scenarios.
Note that you will need to repeat this process anytime you want to update your local copy of the scenario.


All content in the scenario is free to use within Empyrion in your own scenarios or servers. All I ask is that you please credit myself and any original authors for the content that you use.
If you are publishing a modified version of the scenario please use a different preview image.


Making Playfields PvP
These directions are given for using Notepad++, but any editor with a replace in files function will work.
All edits are CASE SENSITIVE and require EXACT SYNTAX. Some edits will require a NEW SAVE GAME. Edit at your own risk.


By default all playfields in Project Eden are set to PvE.
If you simply want to enable global PvP for all playfields:
Edit the gameoptions.yaml file and set ForcePvP: True.

If you want to give playfields a chance to be PvP:
Go to the Project Eden/Content/Playfields folder and open the playfield_dynamic.yaml or space_dynamic.yaml file in any of the non-starter playfield folders (for example Alien) using Notepad++.

Open the find menu (CTRL-F).
Click on Find in Files.
Under the Directory click the icon with the 3 dots (...) to open the browser.
Make sure it has the main Project Eden/Content/Playfields folder selected and NOT just one of the subfolders.


Editing PvP chance for non-starting playfields:
Under the Find What, put this:
PvPProb: 0 #Normal
Under the Replace With, put this:
PvPProb: 0.5 #Normal
Then press Replace in Files.
(In this example it will give every non-starter playfield a 50% chance to be PvP. You can use any chance from 0 to 1. 0.3 will be a 30% chance, etc).


Editing PvP chance for starting playfields:
Under the Find What, put this:
PvPProb: 0 #Starter
Under the Replace With, put this:
PvPProb: 0.5 #Starter
Then press Replace in Files.

Changing Ore Deposits from SSOR Nuggets to Voxel
These directions are given for using Notepad++, but any editor with a replace in files function will work.
All edits are CASE SENSITIVE and require EXACT SYNTAX. Some edits will require a NEW SAVE GAME. Edit at your own risk.


By default all planets use SSOR underground nugget style deposits in Project Eden. These require use of an ore scanner to see underground but have a chance to bug out and be empty. If you wish to change them all into the standard voxel type ore deposits, follow these directions.


Changing SSOR to Voxel:
There will still be a handful of special deposits on a couple of planets that will use a SSOR nugget style deposit but this will change 95% of them.
Go to the Project Eden/Content/Playfields folder and open the playfield_static.yaml file in any of the playfield folders (for example Alien) using Notepad++.

Open the find menu (CTRL-F).
Click on Find in Files.
Under the Directory click the icon with the 3 dots (...) to open the browser.
Make sure it has the main Project Eden/Content/Playfields folder selected and NOT just one of the subfolders.


Step 1:
Under the Find What, put this:
DistTypeCylinder:
Under the Replace With, put this:
#DistTypeCylinder:
Then press Replace in Files.


Step 2:
Under the Find What, put this:
MaxRadius:
Under the Replace With, put this:
#MaxRadius:
Then press Replace in Files.


Step 3:
Under the Find What, put this:
YVariance:
Under the Replace With, put this:
#YVariance:
Then press Replace in Files.



Known Issues:
Some ore deposits are balanced around a custom SSOR size and shape but will turn into spherical blobs when converted into voxel deposits.
Some ore deposits might be missing their ore textures and will use the default silver colored texture instead. I'll try to add back the textures for all affected planets.
Autominers will never deplete voxel deposits regardless of autominer depletion settings.

Changing preview images for servers
Empyrion 1.3 adds the SharedData folder, allowing things like custom item icons or loading screenshots to be included with a scenario.
As a server, you can edit or replace the preview images players see for each starting planet when they first join your server.
This might be a useful area to add more info about your specific server's setup such as starting planet wipes, server rules, etc.

The images are stored under the scenario in the SharedData/Content/Extras/PreviewPics section.
Simply edit or replace each image in the folder. Each starting planet as its own preview image.

You can also edit the loading screen tips under the LoadingScreenshots folder. Add your custom tips in the Notes.txt file as a new line and they will randomly display for players while they are connecting to your server. You can also add images here as well.
Credits and Acknowledgments
Custom models, icons, music, and other assets included with the scenario may be covered under third party license agreements.
  • You should not redistribute or use these assets outside of the game or in your own projects. You should not modify them or use them for profit.
  • You may use these on your servers as part of the scenario, but you are not authorized to sell access to in-game items on your server that use these assets for real world money or otherwise restrict access to specific items that use these assets for real world money.
  • Restricting access to your entire server based on whitelists, Patreon subscriptions, etc is okay.
  • I claim no ownership of any asset that was created by a third party.
I have to put these rules in place to protect both the intellectual property of the authors and other players. I do not claim ownership or authority or make any legally binding claim, this is just a general disclaimer for the layperson. Don't be a jerk. Respect the intellectual property of others.

This scenario uses many assets created by various authors from the Unity store and elsewhere. All credit for their designs goes to the original authors.

Big thanks to @verteks.visuals[www.instagram.com] for creating the UCH Research Vessel briefing room looping video and UCHN ship name signs.
Thanks to D34DP5YCH0 for new Hydroponics Bays icons.

Music courtesy of:


I have made a collection of workshop blueprints that were adapted for use in this scenario. The collection is not a complete list as some blueprints are not from the workshop. Additional credits are below:

The following authors should be credited for some of the content included with this scenario:

  • Needleship - Gas Giants
  • Monroe - Monroe's Planet Pack I
  • Tellrog - TheDeep

  • Indigo Synn - LCD Screens Set 1

  • Mythra13: NASA Space Shuttle
  • Fractalite: Various
  • Ravis: Biolab Pandora
  • Krenios: Antenna
  • Mishgun-907: Angara-1 Rocket
  • BURG: Buran
  • Darok Phoenix: BA-MINING-TOWER
  • Warped Realities: Destroyed Dome
  • Kentaki: C&C GDI Air Base
  • Burrbrusk: Dome of the Colony
  • Myrmidon: Cerberus-NG MK 3 edit (original by Jrandal), Anax LC, Poseidon's Trident MK II
  • Robot Shark: Various
  • Brimstone: Various
  • Krabbenfischer Paul
  • oojimaflip: Various
  • Maratoder: UEC Factory Base
  • Rustimus: Remote Mining Outpost
  • Ashrai: Basecamp Alpha
  • zaphodikus: ZA-OmicronBase
  • Taun Hawk - Advanced Drill Platform
  • Volendrung - Stone Sentinels
  • Eliteace - Highrise Construction
  • Ramachandra - Various POI
  • liftallthepizzas - Broken-Cylinder
  • TwilightDragon & Damonicus1986 - Mithra derelic Base
  • Codswallop - Alien Nexus
  • FuzzBuzzPutty - Various POIs
  • Devanow - Zig Patrol Vessel (original by Piddlefeet)
  • Star_Lord_Sajuuk - Blackstone Pyramid https://steamcommunity.com/sharedfiles/filedetails/?id=1569423657
  • Sabaithal - VOID POIs
  • Ambiguous Pirate - Destroyed Large Shipyard
  • Wraithworks - Various POIs
  • TubbaWabba - Sssssnake Temple
  • 123 - CAS Hammer Light Mining CV
  • cgpost1959 - Chinook G2-7.25-CGP
  • Dan Bolo - HUBO HM-174
  • celewin - Mine-eleven
  • urialia - LEV-A23 Horizon
  • Ret0rus - Patsux MD291
  • Matti - Bullwark Freighter "Vingilot"
  • Ivo Shandor - Refinery
  • ZoulouAlpha - Legendary Pentaxid (BA)
  • sulusdacor - NPCstuff 3 - crawler - BA
  • Siege - Alien Cruiser, Alien Marauder
  • Titka - Infested alien ship
  • T.A.A.G™Vader® - Alien Invader - Conversion
  • NeoFix - CV AKX-YY Alien Cruiser
  • Kaeser - Xen'uan Carrier
  • Steph - Multiple City Ruin Blueprints https://steamcommunity.com/id/Shyxxxtina/myworkshopfiles/
  • D00mnoodle - Theta Space Station (A9 updated)
  • JR3050T - BA T12 ProcessingStation
  • Na-Palm - Offworld Farm
  • michaelhartman89 - Various city buildings
  • Blaine - Mosquito Fighter
  • Siege Inc - Abandoned Atlas Mine
  • Man_From_Mars - Black Pyramid.
  • Ravis - Glacial Ice planet
  • Pear78 - Pears-BA-SkybreachFallen, Pears-BA-UC_dayz_POI
  • Vollinger - Facility O-9
druz.777, Spanj, MajorLeeStoned & skyelan, AkevaBanshee, Shandril, CuriousMind, TheMaverick150, Mereel [GER], sfx, Aslantis ✞, Dagrôs, Procyon Lotor, styLmntz, Steel Dragon, tweaksource, piddlefoot, filbertfarmer, Bucco, icewolfen, groberts, Anubis09, ArtemisRouge, Lttetak, Resurgam7, Procyon Lotor, CheekyShenanigans, DarkestWarrior, Don2K7, Garaman, Stan, StrifeA, Pear, Sulusdacor, Vollinger, Filbertfarmer.

D34DP5YCH0 for new loading screens, Hydroponics Bays icons, and posters.
BattlestormTitan, MaverickJay69, AkevaBanshee, and Hitsuju for posters.
JarvisGB, Garaman, Geoffman72, Pantheis, PxxLz, Slappy_Nuts, Stan, WesternDevil, Akeva, Samsquatch, thescripthd, for loading screenshots. (Please let me know if I missed you!)
byo13 for scrap traders.
Dogmeat for new custom models used in Reforged Galaxy/Reforged Eden (SV food processor, constructors).
A special thanks to RexXxus for the development and continued support of the eWPDA and eWCCT tools and Vermillion for his help with the configs and his amazing work on Reforged.

If I have missed anyone please let me know.

Image credits:


Credit for Eden_HematiteOre.png: Robert M. Lavinsky
Source: https://commons.wikimedia.org/wiki/File:Quartz-Hematite-113680.jpg
Licensed under Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0) https://creativecommons.org/licenses/by-sa/3.0/deed.en
Edited to remove background.

Credit for Eden_IlmeniteOre.png: Robert M. Lavinsky
Source: https://commons.wikimedia.org/wiki/File:Ilmenite-155036.jpg
Licensed under Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0) https://creativecommons.org/licenses/by-sa/3.0/deed.en
Edited to remove background.

Credit for Eden_ChromiteOre.png: Robert M. Lavinsky
Source: https://commons.wikimedia.org/wiki/File:Chromite-468934.jpg
Licensed under Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0) https://creativecommons.org/licenses/by-sa/3.0/deed.en
Edited to remove background.

Credit for Eden_PyrolusiteOre.png:
Credit: U.S. Geological Survey
Department of the Interior/USGS
U.S. Geological Survey/photo by Unknown
Source: https://commons.wikimedia.org/wiki/File:Pyrolusite_-_USGS_ID_Stose,_GW_1425.jpg
Edited to remove background.
< >
82 Comments
Drakaus May 8 @ 10:29am 
where does one copy the 255 folder to ?
Beltor Apr 18 @ 6:51pm 
A recommended note for this guide: There is a difference between 'Notepad++' and 'Notepad'. Notepad can't be used to make the edit "Changing Ore Deposits from SSOR Nuggets to Voxel", you must use Notepad++.
BlackCat Apr 17 @ 11:10am 
Is there any way I can make mod local language?:steamhappy:
Sordros Mar 31 @ 9:16pm 
tried following these instructions for setting up my own server ongportal but am having issues as i apparently have done something wrong
ravien_ff  [author] Jan 24 @ 1:23pm 
Oh yes I love that base! It's possible another person had uploaded a modified version of it.
Added your upload to the collection for credit now!
Ixx Jan 24 @ 1:13pm 
I Found a space base in the game that i posted a few years back, "BA_11.x_Raitaru" had made into this scenario as a Polaris manufacturing plant of sorts. It's of course inspired by the Raitaru Industrial complex in EVE. I don't even care it's not listed in the credits, just finding in game made my day =)
ravien_ff  [author] Jan 1 @ 1:08pm 
That is set on the playfield files. So more advanced than this guide covers.
drm9900 Jan 1 @ 11:42am 
How can I modify the brightness at night?
MoonshineBandit Nov 7, 2021 @ 12:30pm 
how do I make reputations like R.E.?
Sentient_Worm Sep 4, 2021 @ 6:37pm 
Thanks