Illustration for How to Install Mods on a Vintage Story Server

How to Install Mods on a Vintage Story Server

Set ModPaths, add ZIP mods and understand automatic downloads for joining players.

Vintage Story can automatically deliver server-side and universal mods to players joining a modded world. Client-only mods require installation by each player. This distinction in the Vintage Story wiki helps diagnose downloads that appear incomplete.

Add a mod to the correct directory

  1. Stop the server and back up its .vcdbs world, serverconfig.json and existing Mods directory. Make this copy before adding, removing or updating a mod.
  2. Download a .zip mod suited to your game version. Check whether it is labelled Server-side, Universal or Client-side, and read its dependencies. A client-only mod does not necessarily belong on the server.
  3. Place the ZIP in the server data directory's Mods folder. In serverconfig.json, confirm ModPaths includes that path. On Linux, the dedicated-server guide shows an explicit data path and warns you to keep the first Mods entry, which loads base game files.
  4. Restart, read logs and join with a test player. Accept the offered download for server-side and universal mods. On the client, they are stored per server in ModsByServer.

If a player still has an older version

First check that the ZIP actually changed and the server loaded it on startup. The wiki describes a rare case where an author replaces mod contents without changing the filename; a client may keep its old copy. The player can leave, remove that server's subfolder in ModsByServer, then rejoin to download mods again. Keep a world backup before removing a mod that adds items or terrain.

For server installation, see the Vintage Story dedicated-server guide. Before renting, check access to ModPaths, mods and backups in the Vintage Story offers.

Find Vintage Story hosting that supports mods

Compare offers and verify file access and world backups.

Sources: Vintage Story wiki on adding mods, dedicated-server and ModPaths guide.

Our recommendation

Ready to launch your Vintage Story server?

Here are the best Vintage Story hosting deals right now, promo codes included. Still unsure? Our quiz finds the ideal host for you in under 2 minutes.

Budget

Locust

Shockbyte

6.00€/month
-25% with code LAUNCH
Max players:4
Mods:
Yes

Compatible games

Vintage Story

Features

  • βœ“Mod support
  • βœ“DDoS Protection
  • βœ“Auto Backups
Budget

Vintage Story β€” 1 Go

WinterNode

3.56€/month
-20% with code HOSTMYGAME
Max players:Unlimited
Mods:
Yes

Specifications

RAM:1 Go

Compatible games

Vintage Story

Features

  • βœ“1 Go de RAM au minimum
  • βœ“CPU sans limite fixe, sous politique d'usage raisonnable
  • βœ“Stockage NVMe sans limite fixe, extension sur demande
  • βœ“Sauvegardes automatiques toutes les 12 heures
  • +2 more features