# How to Add Steam Workshop Mods to Your Avorion Server (/docs/avorion/mod-setup)



import { Step, Steps } from 'fumadocs-ui/components/steps';

Avorion mods are configured via `modconfig.lua` in your galaxy folder. Workshop mods auto-download on server start.

Adding Mods [#adding-mods]

1. Find the mod on the [Steam Workshop for Avorion](https://steamcommunity.com/app/445220/workshop/)
2. Copy the **Workshop ID** from the URL (the number at the end)
3. Stop your server
4. In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Files**
5. Open `modconfig.lua` in your galaxy folder
6. Add the mod to the `mods` table:

```lua
mods = {
    {workshopid = "1819452708"},
    {workshopid = "1751636748"},
}
```

7. Save and start your server

modconfig.lua Format [#modconfiglua-format]

```lua
modLocation = ""
forceEnabling = false

mods = {
    {workshopid = "1819452708"},
}

allowed = {
    {id = ""},
}
```

| Setting         | Description                                 |
| --------------- | ------------------------------------------- |
| `modLocation`   | Leave empty for default                     |
| `forceEnabling` | `true` = clients must have all mods to join |
| `mods`          | Server-side mods listed by Workshop ID      |
| `allowed`       | Client-side only mods (UI mods, etc.)       |

Auto-Download [#auto-download]

* Workshop mods **auto-download** on server startup
* Clients connecting also **auto-download** required mods without needing to subscribe
* Mods auto-update when the server restarts

Removing Mods [#removing-mods]

Delete the mod's `{workshopid = "..."}` line from `modconfig.lua` and restart.

Related Guides [#related-guides]

* [Server Configuration](/docs/avorion/server-config)