Skip to content

How to install Mods on your Avorion Server

Avorion servers can automatically download and install mods directly from the Steam Workshop.

This is the recommended method by the developers for installing mods since the server and clients will automatically install and update any mods from the Steam Workshop. Mods not on the Steam Workshop can be used but must be manually installed and updated.

Installing Steam Workshop Mods

Installing Steam workshop mods on your Avorion server is done by creating and editing a file called modconfig.lua in your galaxy. This file must be created or uploaded to your server’s Avorion (or your custom galaxy name) folder. If you have not started the server at least once, you will not see the Avorion folder yet.

In the modconfig.lua you will list the Workshop ID numbers for each mod, and the server will use that list to download and update your mods.

Mods will be automatically downloaded to a folder name workshop in your Avorion or custom galaxy named folder. The folders and files shown in the screenshot below will be made automatically by the game when it downloads all your mods listed in modconfig.lua. Inside the workshop folder mods are stored in the content folder inside a folder named 445220. This is the application ID in Steam for Avorion. All the numbered folders inside 445220 are mods downloaded from Steam Workshop.

Creating the Mod Config File

  1. Select your galaxy in /galaxy/Avorion (or your custom galaxy name)
  2. Click the New File button in the top left of the File Manager.
  3. Copy and paste the content below as your starting point in that file.
modLocation = ""
forceEnabling = false

mods =
{
	{workshopid = ""},
}

allowed =
{
}

4. The section that will need to be updated with your mods is the mods = 5. You will need to add each mod to your modconfig.lua per the example below:

mods =
{
	{workshopid = "2884880231"},
        {workshopid = "2854314758"},
	{workshopid = "2888955026"}
}

6. Make sure the last** workshopid****line does not have a comma.** 7. Click Create File and name the file modconfig.lua 8. Open the Console page and restart your server to install your mods.