Vintage Story Mod Installation

Vintage Story Mod Installation - База знаний

This guide covers how to install, manage, and remove mods on your Vintage Story dedicated server. For initial server setup and configuration, see Vintage Story Server Setup Guide. For admin commands and permissions, see Vintage Story Admin Commands.

Server Panel: All server management is done through GPanel at gpanel.legionhosting.net. Use the File Manager or SFTP to upload mod files.

Downloading Mods

Vintage Story has an active modding community. Mods are distributed as .zip or .cs files.

Browse the official mod database at mods.vintagestory.at.
Find the mod you want and check that it is compatible with your server's Vintage Story version and that it supports server-side use.
Download the mod file (typically a .zip file).

Installing Mods

Stop the server from the GPanel Console tab.
Open the Files tab in GPanel and navigate to the Mods/ directory in your server root.
Upload the mod .zip file directly into the Mods/ directory. Do not extract the zip file -- Vintage Story reads mods from zip archives.
Start the server. The console output will show which mods were loaded. Check for any errors related to your newly added mod.

Client-side mods required: Many Vintage Story mods require players to install the same mod on their client. If a mod adds new blocks, items, or mechanics, players without the mod will not be able to join or will experience issues. Communicate required mods to your players before they connect.

Check version compatibility before installing. Mods built for one version of Vintage Story may not work on another. Always verify that the mod version matches your server's game version. Installing incompatible mods can prevent the server from starting.

Removing Mods

Stop the server.
Navigate to the Mods/ directory in the GPanel file manager.
Delete the mod file you want to remove.
Start the server. Note that removing a mod that added blocks or items to your world may cause those objects to disappear or be replaced with error placeholders.

Version Pinning for Modded Servers

If you are running mods, it is strongly recommended to pin your server to a specific game version to prevent automatic updates from breaking mod compatibility. Set the RELEASE_VERSION startup variable in GPanel to the exact version number you want (e.g. 1.19.8) instead of latest. See the Vintage Story Server Setup Guide for details on version management.

Need Help?

If you run into an issue not covered in this guide, open a support ticket and include your server's IP address, a description of the problem, and any relevant console output from GPanel.

Vintage Story Mod Installation - База знаний

Поддержка

Категории

Vintage Story Mod Installation