Mods / VS Launcher

Tags:
Utility Other
Author:
XurxoMF
Side:
Client
Created:
Dec 7th 2024 at 4:44 PM
Last modified:
Aug 5th 2025 at 8:28 AM
Downloads:
11911
Follow Unfollow 410
For testers:
READ_ME_HOW_TO_DOWNLOAD.zip

Welcome to VS Launcher

VS Launcher is the unoficial launcher for Vintage Story.

With this launcher you can easily install multiple version of Vintage Story, create multiple installations with diferent configs, mods, worlds, etc... with just a few clicks!

Currently working on both Windows and Linux but I'll try to make it work on MacOS too, it should work, but I can't test it.


Most important features

Install multiple Vintage Story version with one click.
Ceate multiple Installations (data paths) with one click to have different mods, worlds and so on on each one.
Make manual and automatic backups of your installations to not loose any of your worlds or configs if something breaks.
There are a lot of languages you can choose to use on VS Launcher.
Automatically update VS Launcher when you open it if there is a new update available.
Install, update and uninstall Mods easily.
And many more things.


How can I download VS Launcher?

You can find a guide explaining how to download it on this link: How to install VS Launcher

How do I use VS Launcher?

We've made a little tutorial en how to download VS Launcher here: How to use VS Launcher

Can I translate VS Launcher to another language?

Yes, thanks to i18n you can translate it to any language. Here is the guide: How to translate VS Launcher

Where can I ask something, report bugs or make suggestions?

If you want to report a bug, please, use the GitHub Issues tab. If it's a suggestion, please, use our Discord Server. If you need help, ask on the comments or on our Discord Server.

I want a launcher but I don't like VS Launcher!

There is another amazing launcher called MVL. You can check it out and try it here: https://mods.vintagestory.at/mvl

Mod Version Downloads Released Changelog Download
1.5.8 5622 Aug 5th 2025 at 8:27 AM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.5.8-setup.exe
Linux AppImage vs-launcher-1.5.8.AppImage
Linux Flatpak vs-launcher-1.5.8.flatpak
Linux DEB vs-launcher-1.5.8.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak, RPM and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automatically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

JAF, aka, just another fix.

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed/Updated

Nothing

๐ŸŸ  Fixed

  • Mod Version and Tag filters on Windows โ™ป๏ธ I fixed them for Linux on 1.5.6 but they were broken on Windows too.

๐Ÿ”ด Removed

Nothing

1.5.7 77 Aug 4th 2025 at 11:33 AM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.5.7-setup.exe
Linux AppImage vs-launcher-1.5.7.AppImage
Linux Flatpak vs-launcher-1.5.7.flatpak
Linux DEB vs-launcher-1.5.7.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak, RPM and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automatically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

Added a new language, fixed some en-US keys and hopefully added AUR. I've to test it after uploading this to GitHub.

Changelog

๐ŸŸข Added

  • ะฃะบั€ะฐั—ะฝััŒะบะฐ (uk-UA) ๐Ÿ‡บ๐Ÿ‡ฆ Thanks to rXelelo
  • ENV to disable automatic updates You can now run VS Launcher with the UPDATE=false ENV variable to disable updates. This will be used on AUR.

๐ŸŸก Changed/Updated

Nothingv

๐ŸŸ  Fixed

  • English (en-US) ๐Ÿ‡บ๐Ÿ‡ธ A few wrong words on some keys.

๐Ÿ”ด Removed

Nothing

1.5.6 92 Aug 2nd 2025 at 12:03 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.5.6-setup.exe
Linux AppImage vs-launcher-1.5.6.AppImage
Linux Flatpak vs-launcher-1.5.6.flatpak
Linux DEB vs-launcher-1.5.6.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak, RPM and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automatically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

HeadlessUI broke some drop downs... and I uploaded 1.5.6 on the perfect time!

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed/Updated

Nothing

๐ŸŸ  Fixed

  • Mod Version and Tag filters ๐Ÿ”„ There was a bug on HeadlessUI that prevented the user from selecting any option on some of the drop downs.

๐Ÿ”ด Removed

Nothing

1.5.5 146 Jul 27th 2025 at 7:59 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.5.5-setup.exe
Linux AppImage vs-launcher-1.5.5.AppImage
Linux Flatpak vs-launcher-1.5.5.flatpak
Linux DEB vs-launcher-1.5.5.deb

โš ๏ธ RPM was removed because of a new incompatibility with electron-builder. I've tried to fix it for like 10 hours today but it's not something I can fix. Sorry for those using that build but you'll have to migrate to AppImage ๐Ÿ˜ญ

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak, RPM and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automatically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

A few small fixes and changes. Nothing impresive.

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed/Updated

  • Updated russian ๐Ÿ‡ท๐Ÿ‡บ Thanks to p1cnic!

๐ŸŸ  Fixed

  • Mod Version filter ๐Ÿ”„ A change on the ModDB API was showing the version reversed. Now it shows correctly.
    Also the error when filtering by version was fixed. This was an API issue. Thanks Rennorb!

๐Ÿ”ด Removed

Nothing

1.5.4 543 Jun 1st 2025 at 10:43 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.5.4-setup.exe
Linux AppImage vs-launcher-1.5.4.AppImage
Linux Flatpak vs-launcher-1.5.4.flatpak
Linux DEB vs-launcher-1.5.4.deb
Linux RPM vs-launcher-1.5.4.rpm

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak, RPM and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automatically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

Another small fix to fix a similar issue as on 1.5.3.

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed/Updated

Nothing

๐ŸŸ  Fixed

  • Mod version comparator ๐Ÿ”„ Same thing as on 1.5.3 bot on the install mod popup.

๐Ÿ”ด Removed

Nothing

1.5.3 119 Jun 1st 2025 at 1:15 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.5.3-setup.exe
Linux AppImage vs-launcher-1.5.3.AppImage
Linux Flatpak vs-launcher-1.5.3.flatpak
Linux DEB vs-launcher-1.5.3.deb
Linux RPM vs-launcher-1.5.3.rpm

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak, RPM and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automatically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

Updated Portuguese localization and fixed a bug caused by an Anego change to the ModDB API.

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed/Updated

  • Updated localizations ๐ŸŒ Portuguese ๐Ÿ‡ต๐Ÿ‡น by Bruno Cabrita

๐ŸŸ  Fixed

  • Mod version comparator ๐Ÿ”„ Anego changed the ModDB API and broke the mod versions comparator so mods where showing compatible versions as incompatible.

๐Ÿ”ด Removed

Nothing

1.5.2 196 May 23rd 2025 at 6:36 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.5.2-setup.exe
Linux AppImage vs-launcher-1.5.2.AppImage
Linux Flatpak vs-launcher-1.5.2.flatpak
Linux DEB vs-launcher-1.5.2.deb
Linux RPM vs-launcher-1.5.2.rpm

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak, RPM and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automatically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

Updated Italian localization. That's it.

I'll not update VS Launcher anymore. I'm working on Rustory aka VS Launcher 2.0 full-free-time.
It'll take me a few months to have it completed but it'll allow me to do some crazy stuff.
I want to change a lot of things that VS Launcher does wrong and were planned on a wrong way from the start so...

It'll take a lot of time but good news:

  • MacOS compiler is ready so it'll have MacOS build.
  • Flathub will be available too.
  • Flatpak issue with .NET and dependencies will be solved too so it'll work everywhere.
  • A lot of new options will be available like color themes, native notifications, VS servers, modpacks, open on system start, hide to tray, ~5mb weight, 80 to 90% less resources usage on some systems...
  • Easier to use Inatallation/Version system.
  • Automatic importer from VS Launcher so you can migrate to it easily.
  • Infinite more things.

Join our Discord at https://discord.gg/ZvB55s4 to get updates on Rustory development every week.

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed/Updated

  • Updated localizations ๐ŸŒ Italian ๐Ÿ‡ฎ๐Ÿ‡น by Pingoda

๐ŸŸ  Fixed

Nothing

๐Ÿ”ด Removed

Nothing

1.5.1 219 May 10th 2025 at 6:53 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.5.1-setup.exe
Linux AppImage vs-launcher-1.5.1.AppImage
Linux Flatpak vs-launcher-1.5.1.flatpak
Linux DEB vs-launcher-1.5.1.deb
Linux RPM vs-launcher-1.5.1.rpm

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak, RPM and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automatically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

This update is nothing special, it's just a bug fixing update.

Changelog

๐ŸŸข Added

  • Open Mods folder button ๐Ÿ“‚ Added a button to open the Mods folder on the Manage Mods page.

๐ŸŸก Changed/Updated

  • Updated localizations ๐ŸŒ French ๐Ÿ‡ซ๐Ÿ‡ท by LorIlcs

๐ŸŸ  Fixed

  • Clear filters button ๐Ÿงผ Some filters where not restored to default values when using this button on the Mods page.
  • Installed Mod checker โœ… Fixed an issue showing some mods as not installed when they are installed.
  • Delete Mod popup not closing ๐Ÿ—‘๏ธ The delete Mod popup wasn't closing after the Mod was deleted.
  • Change file permissions 7๏ธโƒฃ Fixed an issue preventing the permissions change.

๐Ÿ”ด Removed

Nothing

1.5.0 333 May 3rd 2025 at 6:21 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.5.0-setup.exe
Linux AppImage vs-launcher-1.5.0.AppImage
Linux Flatpak vs-launcher-1.5.0.flatpak
Linux DEB vs-launcher-1.5.0.deb
Linux RPM vs-launcher-1.5.0.rpm

 

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak, RPM and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automatically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

It's been a long time since the last update. I had almost no time to code during the last month but now I'm back!

Now that most of the main features of a launcher are implemented it was time to add the most requested feature: Automatic Mod updates!

On this first part there's a button on the Manage Mods page to update all the mods with available updates on that installation. If there are no bug reports with this new feature during the next week I'll release the part 2 that'll include the Installations configs to automatically update the mods before playing.

This update comes with A LOT of performance improvements, QOL features and UI changes! Check the changelog for more info.

Also, we've reached a new record in downloads! 1.4.3 was downloaded 2150+ times! That's insane! Thanks a lot everyone for using VS Launcher โค๏ธ

Changelog

๐ŸŸข Added

  • Mass Mod update button โฌ‡๏ธ Now you can update all the mods with available updates with a single button on the Manage Mods page! This will update ONLY the mods with compatible updates. On the next update I'll add an option to update the ones with incompatible updates too.
  • Navigation bar ๐Ÿ—บ๏ธ Now, most pages have a navigation bar with some buttons to go back, reload the content, scroll to top, breadcrumbs to easily navigate through routes...
  • Confirmation log out popup โŒ Added a popup before logging out in case you clicked the log out button by accident.
  • Remember window position ๐ŸชŸ Suggestion #65 Now, when you open VS Launcher, it'll be opened with the same size(width and height) and position(x and y) it had when it was closed. If it was maximized it'll be opened maximized too.
  • Info & Help page โ„น๏ธ Added a new page with important links and info. Moved the top buttons(Discord, Guides, Issues...) to this page. Added a new Contributors button. Added a Debug info section with important information and a link to the logs for users to easily report bugs.
  • Dropdown sections โฌ Added a new dropdown component and changed form sections to use it. All the pages with forms now use this component so users can hide the sections they don't need. Some of the section will now be closed by default.
  • Close prevented notifications ๐Ÿ”” Suggestion #87 VS Launcher can't be closed while you play, download something or have any task in progress(backups for example). Now, if you try to close it while you can't, a notifications will be shown.
  • Installed mods filter โœ… Suggestion #90 Now you can filter mods by All, Installed and Not installed in the Mods page. Also, installed mods will be shown with an orange background.
  • UI scaling ๐Ÿ“ Suggestion #92 You can now change the UI scaling on the Config page. You can choose among 50%, 75%, 100% (default), 125% and 150%.
  • RPM installer ๐Ÿง Discussions suggestion Now you can download VS Launcher a .rpm to easily install it on Fedora and other distros.

๐ŸŸก Changed/Updated

  • Folder characters ๐Ÿ“‚ Suggestion #81 When you change the name on the Add Installation page for example, the default folder name will be changed to match the Installation name. Some special characters are not compatible with file systems so they are removed. Now only the special characters will be removed so you can use ´_^ and so on.
  • Mods page performance ๐Ÿ”ง Improved the performance on the Mods page by removing tags and changing some UI elements. This lowered the usage on that page from 10% CPU to 5% CPU and from 700MB RAM to 400MB RAM. That page does a lot of checks and renders a lot of things so the resource usage is relatively high. This doesn't happen on any other page.
  • Moved language selector ๐ŸŒ The language dropdown was moved from the left menu to the config page.
  • Config page link โš™๏ธ Config page link was moved from the button at the top of the left menu to a regular link like Home, Installations, Versions...
  • UI improvements ๐ŸŒŸ Improved the visuals on some UI components.
  • Updated localizations ๐ŸŒ Spanish ๐Ÿ‡ช๐Ÿ‡ธ, Polish ๐Ÿ‡ต๐Ÿ‡ฑ by Zsuatem and French ๐Ÿ‡ซ๐Ÿ‡ท by SkyFoxCoder Also fixed English ๐Ÿ‡บ๐Ÿ‡ธ by SkyFoxCoder

๐ŸŸ  Fixed

  • JavaScript HTTP2 error ๐Ÿšซ Hopefully fixed an error when fetching mods from the ModDB API.
  • Log in ๐Ÿ‘ค Fixed the log in popup so if you try to log in with invalid credentials you can edit them and try again. If the log in failed, inputs remained disabled.
  • Wrong logs ๐Ÿ“œ Some logs were being wrote to an incorrect file and folder. Now they will be written to the correct file.

๐Ÿ”ด Removed

  • Removed Catalan as the translator masked us to do so.
1.4.3 360 Mar 29th 2025 at 10:36 AM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.4.3-setup.exe
Linux AppImage vs-launcher-1.4.3.AppImage
Linux Flatpak vs-launcher-1.4.3.flatpak
Linux DEB vs-launcher-1.4.3.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

This update is small. Just a little important feature preventing some Linux users from playing.

Changelog

๐ŸŸข Added

  • Installation ENV variables ๐Ÿ’ป You can now set custom ENV variables for each Installation. This is especially useful for Linux users. It was added to solve some issues preventing the game from running on some computers.

๐ŸŸก Changed/Updated

  • de-DE ๐Ÿ‡ฉ๐Ÿ‡ช and pl-PL ๐Ÿ‡ต๐Ÿ‡ฑ Updated Polish and German localizations thanks to @BradyThe and @zsuatem on #86 and #88

๐ŸŸ  Fixed

  • Visual bugs ๐Ÿ› Fixed a few visual bugs with some components and so on.
  • en-EN ๐Ÿ‡บ๐Ÿ‡ธ Fixed some keys on english thanks to @BradyThe on #88
1.4.2 213 Mar 19th 2025 at 7:24 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.4.2-setup.exe
Linux AppImage vs-launcher-1.4.2.AppImage
Linux Flatpak vs-launcher-1.4.2.flatpak
Linux DEB vs-launcher-1.4.2.deb

๐Ÿ’กIf you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

Sorry for breaking the last update.

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed/Updated

Nothing

๐ŸŸ  Fixed

  • Mod icons Mod icons not showing on the Manage Mods page.
1.4.1 74 Mar 19th 2025 at 6:52 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.4.1-setup.exe
Linux AppImage vs-launcher-1.4.1.AppImage
Linux Flatpak vs-launcher-1.4.1.flatpak
Linux DEB vs-launcher-1.4.1.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

I've had almost no time to code this week but I found a really important issue causing the launcher to crash some times.

This update have almost no content, that's why is not uploaded as 1.5.0 xD

It includes a few things I already has finished so... enjoy them.

Changelog

๐ŸŸข Added

  • Installation icons ๐Ÿ–ผ๏ธ
    You can now set an icon for each Installation to make them easily recognizable. You can also add your own custom icons from your computer(only png). On the next update I'll add a way to remove custom icons... I had no time to do it, sorry.

๐ŸŸก Changed/Updated

  • Mod icon positioning โ†•๏ธ
    Changed the mod icons page to fit the new ModDB icons format.
  • Localization ๐ŸŒ
    Updated spanish. Updates french by @SkyFoxCoder #76 and #78

๐ŸŸ  Fixed

  • Launcher closing with active tasks ๐Ÿšซ
    Some times the launcher was letting you close it while a download, extraction, backup... was active making it crash and messing things.
  • Install mod popup animation ๐ŸชŸ
    The Install mod popup had no animation on closing. This is now fixed.
  • Localization ๐ŸŒ
    Fixed some english ๐Ÿ‡บ๐Ÿ‡ธ keys (Thx to @SkyFoxCoder #76).
1.4.0 240 Mar 10th 2025 at 6:22 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.4.0-setup.exe
Linux AppImage vs-launcher-1.4.0.AppImage
Linux Flatpak vs-launcher-1.4.0.flatpak
Linux DEB vs-launcher-1.4.0.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

One of the most requested features of VS Launcher was an automatic login system so you wouldn't have to log in manually every time you change Installations.

This is now a reality thanks to scgm0!! He used reverse engineering to check how Vintage Story manages the account login to use it on MVL and he told me how that works so, star the MVL repository and git it a try! It's a really good launcher with a lot of cool things.

The account system on VS Launcher is pretty simple, click a button, enter your credentials and press login! MVS allows you to save multiple accounts and to use offline accounts(you can play single player only for free with this mode) but I'll not implement those because scgm0 spend his time investigating how to login and I want that feature to be like an "exclusive" feature of MVL.

Again, thanks a lot scgm0 โค๏ธ

This version also comes with a few small additions, fixes and changes but it's not the greatest thing.

I've spent this weekend working on the new VS Launcher API. This one comes with an automatic importer for Vintage Story version and some Discord commands to check the API state and content. Check it out on our Discord server https://discord.gg/RtWpYBRRUz


imaxe

With this said, let's check all the news:

Changelog

๐ŸŸข Added

  • Account system ๐Ÿ‘ค
    Log in on VS Launcher and let it log in for you on Vintage Story... no more re-logging every time you change Installation.
  • New API ๐Ÿ–ฅ๏ธ #71
    Automatic VS Version imports, Discord commands, SHA256 to verify downloads...
  • Backups compression level ๐Ÿ“ฆ #60
    Now you can choose the compression level of backups. Higher levels take more time to backup but they will weight less. This is a per-installation setting.
    Thanks a lot to @TipsyTheCat for the Pull Request #63 with some of the code for this addition.
  • mesa_glthread option ๐Ÿ†™
    Now you can enable mesa_glthread=true to boost the performance on some Linux systems.
  • Added Hungarian(hu-HU) localization ๐Ÿ‡ญ๐Ÿ‡บ by @Magyar on Discord

๐ŸŸก Changed/Updated

  • Concepts ๐Ÿ“–
    Changed Versions (Vintage Story versions) to VS Versions to avoid confusions with Mod Versions.
  • Buttons โธ๏ธ
    Changed buttons to have a background like form inputs and changed the icon colors to make them easily recognizable.
  • Delete mods while playing ๐Ÿ—‘๏ธ #66
    Removed limitation while deleting mods so you can delete them while playing.
  • French localization ๐Ÿ‡ซ๐Ÿ‡ท by @LorIlcs
  • Polish localization ๐Ÿ‡ต๐Ÿ‡ฑ by @zsuatem
  • Portuguese localization ๐Ÿ‡ต๐Ÿ‡น by @bruno-cabrita

๐ŸŸ  Fixed

  • Localization ๐ŸŒ
    Fixed a few localization issues on multiple languages.
  • Click notification to update ๐Ÿ”„
    When a new VS Launcher update is available it should let you click on it to restart and update the launcher but this was not working. On the next updates it should work.
  • Installation Backups list ๐Ÿ—’๏ธ
    Fixed styles on Installation Backups list page.
1.3.2 262 Feb 27th 2025 at 12:23 AM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.3.2-setup.exe
Linux AppImage vs-launcher-1.3.2.AppImage
Linux Flatpak vs-launcher-1.3.2.flatpak
Linux DEB vs-launcher-1.3.2.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

If a mod has a wrong Semantic Versioning format the mods page crashed...

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed/Updated

Nothing

๐ŸŸ  Fixed

  • Crash on mods page ๐Ÿ“‚
    If a mod has a wrong Semantic Versioning format the mods page crashed...
1.3.1 78 Feb 26th 2025 at 11:52 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.3.1-setup.exe
Linux AppImage vs-launcher-1.3.1.AppImage
Linux Flatpak vs-launcher-1.3.1.flatpak
Linux DEB vs-launcher-1.3.1.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

If the ModDB threw and error the mods page crashed... I can't test ModDB API errors xD

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed/Updated

Nothing

๐ŸŸ  Fixed

  • Crash on mods page ๐Ÿ“‚
    If the ModDB threw and error the mods page crashed... I can't test ModDB API errors xD
1.3.0 84 Feb 26th 2025 at 10:12 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.3.0-setup.exe
Linux AppImage vs-launcher-1.3.0.AppImage
Linux Flatpak vs-launcher-1.3.0.flatpak
Linux DEB vs-launcher-1.3.0.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

VS Launcher is growing faster than I expected. Only the last release, 1.2.3, got almost 900 downloads ONLY on the 1.2.3 release! It's amazing!
Because of this I decided to completely refresh the UI and UX of VS Launcher to make it easier to use, more intuitive, less buggy and more beautiful ๐Ÿ’

When I started this project I had a UI design idea I wanted to implement and it was glassmorphism. Some of you may remember this as I said it a few times on the Discord mod post.
The problem with this is Chromium... If you stack more than 1 layer of backdrop blur it glitches a lot making the background almost black.

But I found a solution to this so now, after more than a hundred hours of work on the last 2 weeks, I'm ready to present you the new Health Update!!!

This update comes with a lot of big and small changes that makes VS Launcher better than ever!
New UI, UX improvements, bug fixes, new features... cool features... AMAZING features!
There are no new main features but half of the Automatic Mod Updater Update is already implemented and usable! You can't automatically update mods but you'll see what I mean on the next changelog.

MVL author contacted me a week ago and we'll colaborate to make migrating from one launcher to another as easy as possible and make modpacks compatible between them.
You'll be able to export a VS Launcher modpack and import it on MVL and vice versa.
I've added a link to MVL on the top of VS Launcher and the ModDB webpage in case you want to check it out!

Changelog

๐ŸŸข Added

  • Complete new UI ๐ŸชŸ VS Launcher has changed from gray colors, buttons and shadows to a fully glassy effect UI! This is called glassmorphism and it's one of my favorite styles for websites and apps and now it's fully working on VS Launcher too.
  • New animations ๐Ÿƒ๐Ÿผ‍โ™€๏ธ VS Launcher felt old with no animations and I wanted it to feel more modern or futuristic and animations and perfect for this! Now there are animations when you switch pages, open drop-downs, load items on list... everywhere!
  • Favorite mods โญ Now you can mark as favorite all the mods you want like on the ModDB. There is a filter to show only favorite mods and your filters will apply to this fav-only list too.
  • New logo/icon ๐Ÿ–ผ๏ธ VS Launcher was using the Vintage Story logo and I wanted to change it. Now that the UI changed I changed everything, logo included. Hope you like it. I'm not the best designer ๐Ÿ”ฅ
  • Mod updates notifications โซ When you open VS Launcher or change the selected installation it'll check for updates on the selected one and show a notification if there are some. Click on that notification so see them.
  • Mods with updates sections ๐Ÿ—„๏ธ On the Installation Mods page you'll now have mods separated on categories and sorted alphabetically on each one.
    • Mods with errors ๐ŸŸฅ This mods threw some errors when trying to identify them.
    • Mods with updates ๐ŸŸฉ This mods have some updates that are at least 95% compatible with the Vintage Story Version you've selected on that Installation.
      This mods have the tag of your VS Version or exact VS Version.
      VS: 1.19.5 + Mod tag: 1.19.X = Mod with updates
    • Mods with "not compatible" updates ๐ŸŸจ This mods have some updates but they are 90% NOT compatible with the Vintage Story Version you've selected on that Installation. This mods have new versions uploaded but no tags of your VS Version VS: 1.20.4 + Mod tag: 1.18.X = Mod with not compatible updates.
    • The rest of the mods
  • Tags and side(server, client...) Mod filters ๐Ÿ”
  • Selected installation actions on the left menu โฏ๏ธ Now, on the left menu, you'll have some buttons to make backups, go to manage mods/add/edit Installation if you've one selected on the drop-down.
  • Last time and total time played ๐Ÿ•“ Installation will now register when was the last time you played it and how much time you spent playing on it.
    It'll save those when you close the game so if your PC crashes or turns off mid-play it'll not register it.
  • Italian translation ๐Ÿ‡ฎ๐Ÿ‡น by @Pingoda

๐ŸŸก Changed/Updated

  • Mods order โฌ‡๏ธ Now the installation mods page will sort mods alphabetically.
  • Selected installation changing ๐Ÿ–ฑ๏ธ Now if you create a new installation and you had none created it'll select it on the left menu drop-down automatically.
    Same thing if you delete the selected one. It'll select another one automatically.
  • Reduced minimum window size ๐Ÿ–ฅ๏ธ This is for users with small screens. It'll "break" some pages distribution if you change it to minimum.
  • Mods list order saving ๐Ÿง  Now if you change the display order on the Mods page it'll remember it even if you close the app. Select the order you want and it'll use that until you change it.
  • VS Launcher directly selector on Windows ๐Ÿ“‚ Now the .exe Windows installer let's you choose where to install it.
  • New logging system ๐Ÿ“‘ Now there are 5 different log files. Info, Warnings, Errors, Debug and Verbose. Each one will have more detailed info.
    I've also changed all the logs to be more specific and show where the problem is to identify the bug easily.
  • Installation folder created automatically ๐Ÿ“ Now, when you add a new Installation it'll automatically create the selected folder if it doesn't exists. This is to prevent the "That folder doesn't exist" when opening the folder, making a backup or anything.
  • Warn on folder selection โš ๏ธ Now, if you select a folder with something inside as backups folder, installation folder or version folder, it'll show you a warning to check it out before proceeding. To avoid issues...
  • Versions are now sorted from newer to older ๐Ÿ†• This applies on Version page, Installation version table...
  • Optimized mod detection โžฟ
  • Optimized and improved mod counting ๐Ÿ”ข
  • Improved code structure โŒจ๏ธ Separated code to reusable components, removed unused code...
  • French translation ๐Ÿ‡ซ๐Ÿ‡ท by @LorIlcs
  • Spanish translation ๐Ÿ‡ช๐Ÿ‡ธ by me
  • Migrated to TailwindCSS v4 4๏ธโƒฃ

๐ŸŸ  Fixed

  • Changing backups folder ๐Ÿ“‚
    On the settings page, if you wanted to change the backups folder, it was impossible.
  • Crash on mods page โ›” If you tried to open the install mod/mod versions popup with no installation selected the launcher crashed showing a gray screen.
  • Tables, forms, popups, buttons, drop-downs... ๐ŸŒ Most of these components had some visual bugs like scrollbars appearing and disappearing, mouse not changing to pointer/arrow, incorrect styles... now they are all fixed.
  • Duplicated mods on list ๐Ÿ‘ฅ If you had the same mod with a different zip name on the same Installation it showed it a loot of times. Now it'll only show it one time per zip.
1.2.3 296 Feb 18th 2025 at 6:13 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.2.3-setup.exe
Linux AppImage vs-launcher-1.2.3.AppImage
Linux Flatpak vs-launcher-1.2.3.flatpak
Linux DEB vs-launcher-1.2.3.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

Small bugfix for windows users.

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed

Nothing

๐ŸŸ  Fixed

  • Mods could not be deleted
    On Windows, after VS Launcher imported the installed mods, you could not delete them. You had to close VS Launcher to delete them. #47
1.2.2 89 Feb 18th 2025 at 5:28 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.2.2-setup.exe
Linux AppImage vs-launcher-1.2.2.AppImage
Linux Flatpak vs-launcher-1.2.2.flatpak
Linux DEB vs-launcher-1.2.2.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

A lot of people reported bugs yesterday. Thanks a lot dear players, you helped me a lot finding the issue by sending me the logs and mods you were using.

Mods that had an invalid JSON format on the modinfo.json were causing VS Launcher to crash and show no mods on the Manage Mods page. This is now fixed.

I've also added a better error handling, notifications if any mod throws and error, separate those mods with errors to a new list on top of the Manage Mods page so you can easily report them...

If you want to know all the changes theck the list below.

Changelog

๐ŸŸข Added

  • Mod loading errors notification Now, if a mod throws an error while trying to load it, it'll show a warning notification so you know something happend.
  • List of mods with errors On the Manage Mods page you can now see new list with the mods that threw an error. This list will only be shown if there are mods with errors.

๐ŸŸก Changed

  • Link to the ModDB mods page On the List Mods page, if you clicked on the mod image, the mod's moddb webpage was open. Some users reported this was confusing so I moved the link to a button on the middle of the image while hovering it. If you click anywhere else it'll just open the Mod Versions popup.

๐ŸŸ  Fixed

  • Errors while lading mods
    Some mods were throwing errors as we said before. I've changed JSON parsing to JSON5 to fix most of the errors. Some mods still fail to load but I've tested it with 120 mods and only 1 failed... always the same one tho.
1.2.1 120 Feb 17th 2025 at 10:40 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.2.1-setup.exe
Linux AppImage vs-launcher-1.2.1.AppImage
Linux Flatpak vs-launcher-1.2.1.flatpak
Linux DEB vs-launcher-1.2.1.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

Little patch to fix a few important bugs.

Changelog

๐ŸŸข Added

Nothing

๐ŸŸก Changed

Nothing

๐ŸŸ  Fixed

  • Error on Mods related pages
    If a mod had an invalid property or the zip file was corrupted the mods relates pages threw an error.
  • Backup restoration errors Sometimes when restoring a backup it would give an error. This was happening when the last entry extracted was a folder. Now it's fixed.
1.2.0 116 Feb 17th 2025 at 5:10 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.2.0-setup.exe
Linux AppImage vs-launcher-1.2.0.AppImage
Linux Flatpak vs-launcher-1.2.0.flatpak
Linux DEB vs-launcher-1.2.0.deb

๐Ÿ’ก If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

โš ๏ธ Flatpak option will not install .NET, mono and OpenAL automátically so if you have an immutable distro it'll not work. The game will not launch. I'm trying to fix this but it'll take time.

Description

It's here! The Mod Manager Update is ready!!!!

As I said some time ago on the ModDB comments, discord... this is the first part of the Mod Manager Update.

You can now search, install, update and uninstall mods from your Installations with just 2 clicks.

I'll update the guide today to include a guide on how to install and manage your mods.

Changelog

๐ŸŸข Added

  • Mods page Finally, after some updates, the Mods page is finally completed!
    You can now search mods by text(title, description...), author and versions.
    You can also order them by tending, follows, update date, release date... a lot of options.
  • Install mods On the Mods page you can click on any mod you want to open the versions list.
    There you'll be able to install the mod on the installation you've selected on the left menu.
    Download/Update button can have 3 different colors:
    • ๐ŸŸฅ = Not compatible If the mod version has no tag equal to your version it'll be tagged as not compatible. Some mod versions may still work tho. Mod 1.19.X | Installation 1.20.X
    • ๐ŸŸจ = Should be compatible If the mod version doesn't have the tag from your exact version and patch but has a tag from the same version it'll be tagged as should be compatible. This ones will works almost all the time as no major changes are made between patches but they can fail some times. Mod 1.20.X | Installation 1.20.4
    • ๐ŸŸฉ = 100% Compatible If the mod version has the same tag from your exact version and patch it'll be tagged as 100% compatible as the mod author has tagged it as compatible. This ones should work always. Mod 1.20.4 | Installation 1.20.4
  • Update and Uninstall mods On the Installations page you'll have a โš™๏ธ button on each Installation. If you click it a mod list page will be open.
    There you'll be able to uninstall and update your installed mods.
    If you open the update popup the colors will be the same as on the Mods page.
  • Open mod on the ModDB On the Mods page, if you click a mod's image, it'll not open the versions popup but it'll open the mod on the ModDB on your default browser.
  • Added pl-PL localization by @RunoHawk
  • Discord server We've created a Discord server fro updates, bug reports, help... you can join on the links from the top of the launcher or on the ModDB link.

๐ŸŸก Changed

  • Updated pt-PT localization by @bruno-cabrita

๐ŸŸ  Fixed

  • Close popups flash
    When closing a popup the background blur disappeared but then re-appeared for a few ms making a little flash light.
  • Backup restoration errors Sometimes when restoring a backup it would give an error. This was happening when the last entry extracted was a folder. Now it's fixed.
1.1.1 286 Feb 3rd 2025 at 9:26 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Type Download Link
Windows EXE vs-launcher-1.1.1-setup.exe
Linux AppImage vs-launcher-1.1.1.AppImage
Linux Flatpak vs-launcher-1.1.1.flatpak
Linux DEB vs-launcher-1.1.1.deb

If you already have it installed with EXE or AppImage you don't need it, it'll auto update when you open the launcher!
Flatpak and DEB need a manual update.

IMPORTANT

If you were using AppImage and you change to Flatpak you'll have to move the config file to a new location. This is only needed the first time because Flatpak encapsulates the app on the install directory.

Check out this guide to know how to do it: https://vsldocs.xurxomf.xyz/get-started/installation/linux#migrating-from-appimage-to-flatpak

Description

This is a small update. Almost nothing new. It was just a little preparation for the Mod Manager Update.

This update comes with .deb and .flatpak support!!! A lot of you asked for this.

Changelog

๐ŸŸข Added

  • .deb and .flatpak For those that don't like AppImage. But remeber, this new formats are NOT COMPATIBLE with automatic updates so you'll have to download and install new updates manually. Flatpak will be uploaded to Flathub so you'll be able to update it using your packet manager.
  • Mods count Now you'll be able to see how many mods are on the Mods folder of each installation. This is a simple aproach that will be changed on the Mod Manager Update but having 0 mods everywhere was ugly.
  • New guide Now if you open the guide link you'll see the new improved guides!

๐ŸŸก Changed

  • Fake form inputs Now they use inputs with the readonly property.
  • Moved config to the feature folder

๐ŸŸ  Fixed

Nothing here, no bugs found.

 

1.1.0 310 Jan 26th 2025 at 12:13 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Download Link
Windows vs-launcher-1.1.0-setup.exe
Linux vs-launcher-1.1.0.AppImage

If you already have it installed you don't need it, it'll auto update when you open the launcher!

Description

Another 3 weeks since the last update! I know it's taking more time that I thought but I also want to enjoy life, hang out with my friends, loose my sanity playing League of Legends... you know, not everything is working ๐Ÿ˜„

A little resume of this update... create, delete and restore Installation backups and edit start params! That's it, it may seem not too much but it is. I've fixed some other little things.

Also I'll update the guide in a few hours to explain how to make backups, delete them, configure them...

The next update will be small. I'll add a few little features and changed requested by you my loved VS Launcher enjoyers.
After that I'll start with the first part of the mods update. This one should be easy... I hope. And after that I'll start with the second part of the mods update, the auto-updater, the hardest part here.

Changelog

๐ŸŸข Added

  • Manual backups with a single click. Go to the Installations page and click backup!
  • Automatic backups before starting an Installation. Edit the Installations to enable this feature!
  • Delete backups... that's it, you can delete them.
  • Restore backups with one click. Go to the Installations page, click the three dots button on the installation you want and restore the backup you need.
  • Limit backups. If you only want 5 backups at a time edit the Installation and set the limit to 5. Old backups will be automatically deleted.
  • Start params to customize what the game does when you play an installation!
  • No more playing screen! I've changed the way VS Launcher manages the states of Versions and Installations so now you can play one Installation while downloading mods on another one, installing new versions or just exploring the launcher. It'll now let you edit/delete/backup... things that you're using. If you're playing 1.19.8 you'll not be able to delete it...
  • Donate button! This is not something you'll use to be happy but to make me happy! Just a link to my ko-fi page for those that want to donate. I'm spending to much time on this project for you to use for free so... donations are cool โค๏ธ
  • nl-NL localization by Dennisjeee. Thx a lot for contributing!
  • Form categories. Most forms fields will now be grouped by type.

๐ŸŸก Changed

  • Updated de-DE localization by GrimFred
  • Added compression task with progress updates and so on. Like download and extract bot to compress as .zip.
  • Changed look for a version page. Reordered fields.
  • Changed tables, forms and lists to components so I can reuse them anywhere.
  • Some more technical changes that users will not notice on daily use so... I'll not list them all xD

๐ŸŸ  Fixed

  • Redirections after most interactions.
    If you created or edited an Installation, installed a Version, etc. you were not redirected to the previous page... not you'll be redirected.
    After adding an installation for example you'll be redirected to the Installations page.
1.0.0 382 Jan 4th 2025 at 11:32 AM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Download Link
Windows vs-launcher-1.0.0-setup.exe
Linux vs-launcher-1.0.0.AppImage

If you already have it installed you don't need it, it'll auto update when you open the launcher!

Description

It's been 3 weeks since the last release but we already have a fully stable version! (I hope without bugs, at least I didn't find any)

This new version doesn't bring too many new things but it does bring a lot of performance improvements, interface redesigns, and yes, I said not too many but there is some new stuff.

This release may seem small as there are not too many feature changes, new things and bug fixes but behind the scenes a lot has changed.

It is now much easier to add, modify and implement new features.
For those who want to translate the launcher into their language it is easier than ever.
There have been many performance improvements as the previous versions were a test to see if the project was worth it or not (it is... a lot).

From now on I will be developing new features and improvements like the ones in the roadmap.

Changelog

๐ŸŸข Added

  • New config page with, for now on, 2 new configs.
  • New tasks menu where you'll be able to check the status of the active and finished tasks like downloads, extractions and so on.
  • New installations page to manage your installations easily. No more buttons on the left menu!
  • New little loader on start so the app have enough time to load and don't see white screens, missing images and so on.

๐ŸŸก Changed

  • Asynchronous downloads and extractions. This ones will run on the background and you'll be able to check the status on the tasks menu.
    Also they are now managed by a separated worker thread so you can make other things while this tasks are running.
  • Changed version and installation management.
    Now, to edit, delete or open the folder of any version or installation you don't need to select it and go to the bottom of the page to click the button you need. Now there are buttons on each version and installation, just press the one you need and that's it. Also changed the install version and add/edit installation to pages instead of popups.
  • Important links in all pages.
    Now, the important links from the top of the Main page are now on the top of all pages so you can access them easily.
  • Improved dropdowns, inputs and buttons. Now, all the dropdowns are fully animated, can be closed clicking outside them and have a better positioning. Button and inputs have title and placeholder everywhere, some of them were missing before.
  • New translation interface and guide. For those that wanted to translate VS Launcher to their preferred language now it's easier than ever with the GUI. There is a guide here: https://github.com/XurxoMF/vs-launcher/wiki/How-to-translate-VS-Launcher

๐ŸŸ  Fixed

  • App unusable while downloading, extracting, deleting... Now you can use the app while this tasks are running and it'll not freeze the launcher all the time on slow computers.
0.0.5 346 Dec 17th 2024 at 8:54 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Download Link
Windows vs-launcher-0.0.5-setup.exe
Linux vs-launcher-0.0.5.AppImage

If you already have it installed you don't need it, it'll auto update when you open the launcher!

Description

Yes, that was fast, the last release was only 1 hour ago... not enough testing I suppose.

Changelog

  • Fixed: cs localization not working.
  • Fixed: Lang menu not showing anything if the selected localization is not present.
0.0.4 208 Dec 17th 2024 at 7:51 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it - How to download

OS Download Link
Windows vs-launcher-0.0.4-setup.exe
Linux vs-launcher-0.0.4.AppImage

If you already have it installed you don't need it, it'll auto update when you open the launcher!

Description

Finally, after a bussy week, I managed to get VS Launcher working on Linux!
Now you can do the same things as in Windows! Install Game Versions, create Installations, play the game...

I wanted to add a way to automatically install .NET, mono-complete and other dependencies but I can't do it. Linux has so many different distros and the process is not the same for all of them. I'll try to implement this feature on future releases but only for some distros like Ubuntu, Linux Mint, Arch Linux... the most used ones but for now on you've to install all this dependencied manually.
You can check a little guide on how to download this dependencies here

Changelog

  • Added: German localization. Thx @BradyThe ^^
  • Added: Czech localization. Thx @DejFidOFF ^^
  • Added: Linux support!
  • Added: Logs to the auto-updater.
  • Changed: string router to path.join() routes for compatibility.
  • Changed: Improved game version detection by using the -v param running Vintage Story.
0.0.3 350 Dec 12th 2024 at 3:10 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it

If you already have it installed you don't need it, it'll auto update when you open the launcher!

OS Download Link
Windows vs-launcher-0.0.3-setup.exe

Changelog

Another little bug fixing update

  • Added: French localization. Thx @lorilcs ^^
  • Fixed: An issue with the credits on languages menu showing the selected language credits in all languages.
  • Fixed: When searching for an already installed version you could click the add button all the times you wanted adding that version multiple times.
  • Changed: A little optimization to the search version funcion now returning only the version
  • Changed: Now you can edit the detected version when searching for an already installed one. Why? When selecting a 1.20.0-rc.1 it'll add it as 1.20.0 bc the -rc.X and -pre.X are not shown on the .exe so I can't get the exact version. Now you can manually edit that.

For translators

There is a new key. Make a PR or send it translated on Discord and I'll add the translation on the next update ^^ Also credits are now on the i18n file.

0.0.2 220 Dec 10th 2024 at 11:52 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it

If you already have it installed you don't need it, it'll auto update when you open the launcher!

OS Download Link
Windows vs-launcher-0.0.2-setup.exe

Changelog

Little update with some minor changes and bugfixes:

  • Added: A few descriptions on some menus with links to the page to continue. (Link to versions page on new installation if there are no versions for example)
  • Added: A new menu at the top of the Home page with links to usefull pages and VS Launcher version.
  • Added: A button to add an already installed game version to the list os versions. If you had the game already installed now you can select that folder and avoid installing it again.
  • Changed: Font family is now ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;. I think this one matchest a bit more the Launcher style.
  • Changed: Home page redesign, just to make it look better.
  • Changed: Notifications colors. Same colors but not that bright.
  • Fixed: Windows error when pressing the open folder on a installation with no folder created.
  • Fixed: Deffault -> Default on the language menu.
  • Fixed: When pressing select folder on the install version section and pressing cancel on the file explorer window it was emptying the folder input making it crash during installation.
  • Fixed: Buttons with overflowing text.

Other changes outside the launcher

Now we have a wiki and a forum with different sections, guides(I'll make more this week), chats and so on.

0.0.1 237 Dec 9th 2024 at 9:36 PM READ_ME_HOW_TO_DOWNLOAD.zip

Download it

If you already have it installed you don't need it, it'll auto update when you open the launcher!

OS Download Link
Windows vs-launcher-0.0.1-setup.exe

Changelog

Coding, testing, coding, testing, coding... yeah enough, let's try this thing.

Download from GitHub

ModDB has an upload limit of 48MB so you'll have to download it from here:

https://github.com/XurxoMF/vs-launcher/releases/download/0.0.1/vs-launcher-0.0.1-setup.exe

You'll only need to download it once, it'll autoupdate when you open it if there is any new version!

Wellcome to the VS Launcher Alpha 1!!!!

This version contains the features listed below:

- Version management with only 2 clicks
- Installations management easier than ever
- Launching the game from the app
- Translations (English USA and Spanish for now on)
- Launcher auto-updates so you don't have to manually download new versions of the launcher, it'll do it automatically when you start the launcher
- Notifications system to keep you updated about the state of your actions with the launcher
- Logging sistem for me, if you have any issue let me know and send me the C:\USers\YouUserName\AppData\Roaming\VSLauncher\logs\main.log ^^

Mods page and news page will be available on the next updates, for now on you can download mods as always, you've a folder button on the left menu to open Data folder on your windows explorer.

Report any bug you find on GitHub, Discord or here, on the ModDB!


294 Comments (oldest first | newest first) (threaded | flat)

XurxoMF , May 9th at 1:19 PM

Log out and in on VS Launcher and problem solved purple8cloud

NarielV, 1 day ago
@XurxoMF: Log out and in on VS Launcher and problem solved purple8cloud

I thought you gave up on this since I havent seen it update so I have been keeping my own version running with some adjustments like an RSS feed for the main page a darker look I cant wait to see what you are working on buddy also I have resolved the dotnet issue by making it automatically download the dependencies if they arent installed problem I have not figured how to do that with mono.

purple8cloud, May 9th at 7:27 AM

need to login every time when start game

XurxoMF , Apr 29th at 9:22 PM

The new one will be VS Launcher with more features , a new UI and a lot of fixes... you'll love it too. In fact, you'll be able to import everything from VS Launcher to Rustory with a an automated process. Airz

Airz, Apr 29th at 1:57 PM

truly heart breaking that the current VS launcher that ive gotten addicted to now will no longer be at its prime. Hopefully this new one brings even better. Good luck with your journey for the new one! I am excited for the mac version tho since I have both windows and a mac i like to play on. so being able to update mods will be nice.

XurxoMF , Apr 28th at 8:20 PM

Jena_Thornwyrd Hiii! Right now I'm working on a new improved launcher so I'm not updating VS Launcher anymore, only to fix extrmely important things. You can make some PRs if you want but people will have to build the version by themselves.

I've almost no time due to my job atm so I can't keep up with every project and VS Launcher has a lot of issues so I'd rather finish the new one than fixin this one as most things would need a complete rewrite.

If you need more info join our Discord! There you can find an announcement from some time ago where I explained everything.

Thank you for the intrest and hope to see you on the new launcher! You can contribute to that one once it's finished!

Jena_Thornwyrd, Apr 28th at 5:17 PM

XurxoMF just a lil 👋 I love and use your project, I've noticed the CONTRIBUTING.md and CODE_OF_CONDUCT.md… I promise nothing, MDD is a bitch, but I'll try to help.

XurxoMF , Apr 27th at 8:31 AM

It's working and still maintained, just not been updated. I'm working on a newer, improved and MacOS ready launcher. If you want, join our Discord server to get notified when the alpha/beta is released. Xplosionist

Xplosionist, Apr 26th at 5:17 PM

Long time since this has updated?  Or maybe that's bad data here at modDB alone.
I am on a mac, and interested in this.  I can help with testing if you are interested, let me know.

opaliris, Apr 25th at 8:18 PM

If there isn't already some kind of way to do this, it would be nice if we could add cmd arguments for the executable, or even better, select the specific executable we want to run when we hit play. Currently, I cannot even launch 1.22 without using a workaround .bat file

Airz, Apr 24th at 9:58 PM

TheCusp I am having the same issue, it isnt this. its 100% the mods. What I am doing which now i gotta redo for 1.22 since i did in 1.22RC.10. GO into the actual Game, Then go into mods and disable all, then do 5 at a time enabling them. Ive discovered quit a few mods now that make this issue occur. while most of them will still load the game after a short period, Ive found like 1 or 2 that just break the game. then I made a google doc and have slip the mods between, working, blank, blank (Not working)/ and errors. Aka ones that make an error show up when loading the game but it still loads. So I'd try that first. once you have them all done you can either find solutions, make reports, or do what i do and the ones that do cause only visual bugs. I just ignore them and ill just make the world.

 

XurxoMF , Apr 24th at 6:20 PM

That's a game/mod issue not VS Launcher related. You'll get better answers on the official Discord server of the game ^^ TheCusp

TheCusp, Apr 24th at 2:24 AM

I'm not tech savvy at all so this is probably a me problem, but when I launch 1.22.0 through the launcher with up to date mods, I cannot load new worlds. I can create/customize one, but when the world goes to load and generate, the loading box is blank and stays blank. any help?

Jarulf, Apr 23rd at 8:57 AM (modified Apr 23rd at 9:15 AM)

I'm on Debian Trixie and seem to have the same, or a similar issue as AnusVietnam, though this is my first install of the launcher. I have both 1.21.7 and 1.22.0 set up and both launch correctly from the terminal. Seems to be a .NET thing. It's installed by script in /lib/dotnet and confirmed by 'echo  $DOTNET_ROOT' . Did you guys figure out the problem?

Spoil

2026-04-23 10:01:49.266] [verbose] [back] [ipc] [ipc/handlers/gameHandlers.ts] [EXECUTE_GAME] You must install .NET to run this application.

App: /home/brosen/Spel/Vintage Story/VSLGameVersions/1.22.0/Vintagestory
Architecture: x64
App host version: 10.0.2
.NET location: Not found

The following locations were searched:
Application directory:
/home/brosen/Spel/Vintage Story/VSLGameVersions/1.22.0/
Environment variable:
DOTNET_ROOT_X64 = <not set>
DOTNET_ROOT = <not set>
Registered location:
/etc/dotnet/install_location_x64 = <not set>
Default location:
/usr/share/dotnet

 

Edit: The default location for .NET, as you can see in the log above is /usr/share/dotnet but that was empty. So I just removed that directory and made a symlink to /lib/dotnet and now both versions of the game launch

 

Now I just have to move my save from the old flatpak installation. Somehow. :-)

CedarHawk, Apr 22nd at 10:25 PM

I haven't been playing long and this is my first comment on a mod, but I just wanted to say that this is phenomenal. It's made dealing with different versions of the game and different servers so much more seamless. Thank you so much for your work on this project. 

momerathe, Apr 22nd at 12:43 PM

In the process of upgrading to 1.22, it would be super-useful to see the red/amber/green status of a mod from the installation>mods screen, so that we can track the progress as our modlist gets updated over time. 

following on from this it would also be really useful to be able to enable and disable mods from the launcher (like you can in Prism). 

Kainda, Apr 10th at 4:37 AM

MemeTherapy Roger. Thank you so much!

MemeTherapy, Apr 8th at 1:02 PM

Kainda since you installed it from the AUR then you should be able to update it in Distroshelf by clicking "upgrade container" or just use the shortcut Ctrl+Shift+U.

I'd like to caution you that while Distrobox does keep files separate from the base system, it lacks Flatpak's level of sandboxing.

Kainda, 6 hours ago
@MemeTherapy: Kainda since you installed it from the AUR then you should be able to update it in Distroshelf by clicking "upgrade container" or just use the shortcut Ctrl+Shift+U. I'd like to caution you that while Distrobox does keep files separate from the base syste

So long as they are separate enough that I can tell at a glance which file belongs where (wether its a host os home file or a distrobox home file), you wont see me complaining.

Though I did have to tinker a bit to get distrobox to only look add/change files in the custom home folder. For some reason, distroshelf does not allow it by default (even if the option is checked)

Kainda, Apr 7th at 4:23 PM (modified Apr 22nd at 8:22 AM)

Hello. I recently shifted to Bazzite OS and wanted to share how some very helpful seniors at the Universal Blue discord helped me setup VS-Launcher in Distroshelf.

Just to clarify, Bazzite is an immutable Linux OS, meaning you cannot install any programs that arent appimages or flatpaks (the main reason being programs in these forms dont mess with the rest of the OS). VS Launcher can be installed directly in Bazzite, but problems occur when you try to run the game through it. Vintage Story NEEDs .net runtime dependencies, which are NOT available in flatpak/appimage form.

For cases like these, Bazzite also has Distroshelf. Its like Virtual Machine manager, only it creates very lean vms of other linux distros in containers (areas sectioned away from the rest of the OS). So to setup VS-Launcher, we setup an Arch Distrobox (aka Arch OS VM) to install both VS-Launcher and the required dependencies (Thank you XurxoMF for the one line setup for Arch systems, Noobs like me just had trouble everywhere else 😭)

PS: Can someone explain how to update VS-Launcher when its setup this way please?

 

Instructions

 

01. Setup an Arch distrobox in the Distroshelf program (Comes built-in Bazzite. Choose the Arch:latest image. All Options default)

 

02. Install yay (Readme: https://github.com/jguer/yay). Yay lets you download the binaries of programs from the AUR (a repository of Arch Programs) and build/install them.
      Use the following commands:
     

      Installation: sudo pacman -S --needed git base-devel && git clone https://aur.archlinux.org/yay-bin.git && cd yay-bin && makepkg -si

      One time setup:
            a. yay -Y --gendb
            b. yay -Syu --devel
            c. yay -Y --devel --save

 

03. Use Yay to install VS-Launcher: yay -S vs-launcher
      There will two options during installation. For the first one, choose [A]ll, for the second one, choose [N]one

04. Install .net 10 dependencies:

sudo pacman -S aspnet-runtime-10.0

 

VS-launcher has now been installed. Enjoy 🙂

MemeTherapy, Apr 6th at 5:26 PM (modified Apr 8th at 1:04 PM)

For folks using the Flatpak version here is a workaround that requires no installation of dependencies (at least on Bazzite). You must have the Flatpak versions of Vintage Story and VS Launcher. You will teach VS Launcher to borrow the .NET library that comes bundled with the official Vintage Story flatpak.

Create symlinks between the Launcher and Vintage Story:
ln -sfn "$HOME./local/share/flatpak/app/at.vintagestory.VintageStory/x86_64/stable/active/files/lib/dotnet" "$HOME/.var/app/xyz.xurxomf.vslauncher/data/dotnet" && ln -sfn "$HOME/.var/app/at.vintagestory.VintageStory/config/VintagestoryData/" "$HOME/.var/app/xyz.xurxomf.vslauncher/config/VSLInstallations/Vanilla/"

Grant flatpak permissions and set .NET variable
flatpak override --user --env=DOTNET_ROOT=/var/data/dotnet --filesystem="$HOME/.local/share/flatpak/app/at.vintagestory.VintageStory/x86_64/stable/active/files/lib/dotnet:ro" --filesystem="$HOME/.var/app/at.vintagestory.VintageStory/config/VintagestoryData:rw"

No need to install .NET or manually update it.

XurxoMF , Mar 31st at 9:37 AM

AnusVietnam check the logs for VS Launcher and the Installation you're having issues launching. ~/.config/VSLauncher/Logs and the logs on the Installation folder, this one may change.

If you want, join our Discord and send me the logs there so I can help you, here on the ModDB is a pain as there are no notifications or anything...

AngusVietnam, Mar 31st at 9:31 AM

Really nice mod, excited about this for the multiple installations feature. I am having a strange issue where I can't launch the games through the launcher though.
I am playing on Linux Mint 22.3 and using the 1.5.8 app image. When I first ran the program I was able to set up the installations and then launch either 1.21.6 or 1.22-rc6. I say either because my system had some difficulties with .net 8 and .net 10 - which I got figured out.
However, once I was able to get both net 8 and net 10 to be registered, I could no longer click the 'play' button on your launcher. Now I have to enter this in terminal 'cd ~/.config/VSLGameVersion/1.2x' and use ./Vintagestory to launch the game. I'm bummed out because I loved the feature where I could see playtime on the launcher.

Do you have any idea what may be causing this, or how to fix it? Thanks!

XurxoMF , Mar 24th at 3:14 PM

I've answered you on Discord. Probably the ModDB was down or restarting. It's working fine here

0w0, Mar 24th at 11:47 AM (modified Mar 24th at 11:49 AM)

Hello My VS Launcher boots up but I'm not getting any modlist for it (download/downloaded). Eventually I end up with a Java Script error.  What do I need to do to fix please?

VS Launcher Version - v1.5.8

OS Type - win32

XurxoMF , Mar 18th at 11:12 AM

Glad to hear that! ❤️

Mongster, Mar 17th at 9:31 PM

It seems to be functioning a lot better now!

XurxoMF , Mar 11th at 1:57 PM

DarkThoughts yes, it's 1 to 10, 0 is not a valid value. If you don't want backup's just don't enable the automatic backups and don't make any manual ones.

DarkThoughts, Mar 10th at 6:26 PM

Since they released an unstable flatpak branch I wanted to add another installation for it, but noticed that the backup amount range is either wrong or badly worded. It says it has to be between 0 and 10, but it seems to mean you have to choose a number from 1 to 9? Because I could not get it to accept 0 as a value, saying I have to fill out all fields first whenever I tried.

XurxoMF , Mar 10th at 3:33 PM

bastets_yarn Anego updates Inno Setup and broke the version importer so the API crashed when it tried to import 1.22.0-rc.2.
It's now fixed and working again. https://upkuma.xurxomf.xyz/status/vs-launcher.

bastets_yarn, Mar 10th at 1:49 PM (modified Mar 10th at 1:49 PM)

I keep getting a spinning wheel of death and nothing is loading? I can't even make a new install because it wont let me access the game versions. The video at the front is also refusing to load.

XurxoMF , Mar 9th at 5:47 PM

beebor you probably copy-pasted the contents of the Installation from another Installation. Edit the clientsettings.json adn serversettings.json inside the INstallation and delete/edit the mods paths.

Mongster The dowload may fail for multiple reason like temporary internet loss, overload on my network because a lot of users are downloading versions... I've downloaded 10-12 versions and no issues so... I don't know what it is exactly.

Mongster, Mar 8th at 11:54 PM (modified Mar 9th at 12:02 AM)

Downloading versions also seems to be busted. I get a little progress on downloading 1.21.6 before it totally freezes. 

 

Edit: after about ten restarts I got it to work; the actual download is very fast, but just seems to fail often. Mods work fine for me.

beebor, Mar 8th at 5:28 PM

been having an issue with the launcher today.... i am downloading mods, and it says that they are added on the mod list, but when i check the mod folder, it is empty. perhaps the paths got messed up during the installations. but i cant find them anywhere... something is odd and im not sure where, could you perhaps have any solution? i have to install them but manually again

XurxoMF , Mar 4th at 10:49 PM

ptrk it could be possible but some settings names change between version breaking it. If there was a way to make it "unbreakable" I could do it but this was already been discussed multiple times. If you manage to make an script that works on every version of the game let me know and I can link your project on the VS Launcher Guide so other can find your tool.

ptrk, Mar 4th at 9:58 PM

XurxoMF Gotcha, that's too bad, but makes sense. Would it be possible to have a launcher-based settings/keybind page that could inject the desired settings into each install's settings? I might look into making a script for myself, so long as it doesn't break an install

XurxoMF , Mar 4th at 10:54 AM

There is no feature like that for a reason. Vintage Story saves paths like worlds, mods folders and so on on the settings file + each version the file changes a bit or a lot so there is no way to do what you say.
You can copy/paste the clientsettings.json file when you create a new Installation but you have to manually edit it and remove paths and so on so the game works correctly. ptrk

ptrk, Mar 3rd at 8:23 AM

Would it be possible to get some kind of symlink setup for our settings files? It's really annoying having to go through to rebind all my keys for preferred settings. I'll probably be making a symlink file myself from now on, but it would be a really helpful feature.

XurxoMF , Feb 25th at 11:24 AM

Glad it worked ^^ Laguna

To create a new Installation using another one as base, you can do what you said. Create a new B Installation on VS Launcher, copy-paste everything from A to B and then edit the clientsettings.json and serversettings.json on B to remove the Mods paths. (The game save paths there for no reason) Sprezzo

Laguna, Feb 22nd at 6:51 PM

XurxoMF That was it! I logged out and logged back in, and now it doesn't seem to ask for my email and password every time I start the game. Thank you so much!

Sprezzo, Feb 22nd at 6:01 PM

Hey I'm testing the launcher for the first time and i set up my already existing installation (which i'll call A from now on), i want to create a second installation (from now on called B) using the A installation as a base.


Should i copy everything from: C:\Users\user\AppData\Roaming\VintagestoryData (this is where A is)

and paste in a folder in C:\Users\user\AppData\Roaming\B?

 

Am i getting this right? Your guide is well done but it doesn't seem to cover how to set up multiple installations, maybe i'm overlooking something.

XurxoMF , Feb 22nd at 5:00 PM

Did you logged out on VS Launcher? You need to log out on your name on the left menu and then log in again. Maybe you did but it's working fine for me and my friends so it looks like an issue with your account/instance/installation... something like that Laguna

Laguna, Feb 20th at 9:02 PM

XurxoMF

It's still not working. I even uninstalled the game and the launcher, and reinstalled them. I've recorded a video so you can see for yourself; I don't know how to fix this.

 

XurxoMF , Feb 20th at 3:33 PM

Laguna your session expired. Log out and in again on VS Launcher and it'll be working again.

Laguna, Feb 20th at 10:40 AM
Hi everyone. I have a question that's been happening for a while. Is it normal that every time I launch Vintage Story from the launcher I have to enter my email and password to log in to the game? Before, I only had to enter it once and it was saved, right?

I don't know how to fix this. Thanks!
DarkThoughts, Feb 11th at 10:36 PM

Yeah, sorry I don't use / support the whole Discord garbage.
Sad to hear. I guess I'll have to look for alternative mod managers.

XurxoMF , Feb 11th at 9:32 PM

Kaisei https://vsldocs.xurxomf.xyz/get-started/usage/game-client/vintage-story-is-already-installed that's the guide for what you need.

DarkThoughts https://discord.gg/Bk8RsBRx check out the latest announcement. Development of all my projects is now stopped because of the lack of time and movitivation due to recent events. I'll take note in case I continue working on the future ^^

To clarify, development is stopped but all of the projects will still work for a loooong time. I'll make updates with patches so they keep working but I'll not add any new content/feature.

DarkThoughts, Feb 11th at 7:49 PM

Small feature request:
When a installed mod has no moddb page, highlight it in the instance's mod page. It may be an outsourced mod from a third party site, but it may also be a mod that the author deleted. I just had the latter happening and found a practically ancient mod purely by luck of me scrolling tediously through my in game mod list to tidy things up. Took me even a while to find the nonexistent modpage it was associated with originally because of stupid name mismatches. With 100-200 mods this becomes quite hard to track.

Kaisei, Feb 10th at 3:51 PM

I already have an installed instance of VS established I don't want to make a new instance using the launcher how do I go about this?

XurxoMF , Feb 7th at 10:13 AM

You've to download it on the Versions page first. Phant0mCobra

Preview version are not imported becasue Anego doesn't provide a way to check if a new one was released and download it. Just .rc and stable version are imported. You can manually download .pre versions, install them and add them using the 🔍 button on the Versions page. Shinji170981

Shinji170981, Feb 6th at 11:33 AM

With the announcement of 1.22, the client probably needs an update, to display the 1.22. pre-1, right?
Just asking for clarification, so no pressure :)

Phant0mCobra, Feb 2nd at 11:04 PM

Version 1.21.6 is not showing up at all. Can't update to it and cannot create a new installation with that version. It just doesn't show up

XurxoMF , Jan 18th at 10:02 AM

In some extremely rare cases VS Launcher looses the config for some reason. As you said, adding Installations back selecting the same folder works fine.

The starred mods are config too so... yes, they're lost.

This is something I fixed on Rustory but I'm not having time to finish it so... I don't know when I'll release it.

berserkus, Jan 18th at 3:53 AM (modified Jan 18th at 4:19 AM)

Today when I opened the launcher it no longer detected my installations or retained any data on the mods I starred. I didn't change anything afaik and the folders for the installations are still intact on my PC. Any idea of what could cause this or if there's a way to restore it?

 

edit: making a new installation and setting it to a pre-existing installation's data folder seems to work, shame about the starred mods though.

XurxoMF , Jan 3rd at 2:06 AM

Vahn_DRG if you edited the 2 jsons on the folder you used on the Installation it should detect the mods correctly... not sure what can it be

Vahn_DRG, Jan 2nd at 9:26 PM

I did get it to work with a new installation, buuut it's not detecting any of my existing mods. I have edited the two jsons as well.

I put the VintageStory data in my /home/{user}/Games/VintageStory/VintagestoryData/, with mods being /home/{user}/Games/VintageStory/VintagestoryData/Mods

I have both the unzipped, and zipped versions of the mods. 

XurxoMF , Jan 2nd at 9:09 PM (modified Jan 2nd at 9:11 PM)

Vahn_DRG VS Launcher doesn't work with Flatpak versions of Vintage Story.

You need to locally install .NET 5, 7 or 8 depending on the version you want to play and then install Vintage Story using VS Launcher or downloading the .tar.gz from the client area.

If you dowloaded it manually from the Client Area you need to add it using the 🔍 button on the Versions page and then add the Installation selecting that version or the one you installed using VS Launcher.

 

Also, I recommend you creating a new Installation using VS Launcher and then moving the VintagestoryData contents to the Installation folder editing the .json files as mentioned here: https://vsldocs.xurxomf.xyz/get-started/usage/game-client/vintage-story-is-already-installed#update-modpaths-and-modpaths

 

Vahn_DRG, Jan 2nd at 8:53 PM (modified Jan 2nd at 8:53 PM)

I can't get this to work with my existing installation on Linux. I point it to the data folder in .config, but it's not detecting a game version. Do I need to "install" a game version first? I have the Flatpak version of VS.

gNecrOz, Jan 1st at 6:40 PM

XurxoMF Okay, as long as I am not too crazy haha

 

I still love this launcher <3 I guess then that would be my "feature" request haha

Hope your new year, however you celebrate, was a good one ^_^

XurxoMF , Dec 31st 2025 at 5:13 PM

gNecrOz there is not right now sadly

Legentus some users already asker for it. Maybe on the future.

Legentus, Dec 31st 2025 at 3:39 AM

Great program, but really need a "search" function for mod configuration page. Thanks!

gNecrOz, Dec 31st 2025 at 12:33 AM

I might be missing the feature but, 

is there a way to "Block" a mod from updating with the update all?

 

Most land form or world gen mods you don't want to update, in my case, I am on 1.21.5,

I do not want my server to update intersting ore generation

for now I have them update all and then roll back the mod, just curious if I am the dumb

and missed a way to this to be done by the launcher.

XurxoMF , Dec 19th 2025 at 3:35 PM

I've a Ryzen 5 5500 and no issues at all. 400MB RAM and 0.5 to 2 % CPU usage.

It has no 3D at all... probably Chromium is enabling 3D for... idk... whataver reason.

I know it's not the best app in terms of performance, that's why I wanted to make Rustory (v2) with Tauri.

The problem is compatiblity. Tauri uses the default webkit and on Windows it's cool because it uses half the resources as Electron but on Linux it doesn't work 1/2 of the times... WebKitGTK things.

Maybe on the future I can improve performance but right now?? Impossible using something like Electron/Tauri... and if course I'll not learn a desktop GUI framework like "Godot" or something like that for a free project I made for fun xD

Resume: Sadly I can't do anything about it right now. With the hide to tray I've implemented on Rustory I'll probably be able to reduce resource usage while playing but... couldn't test it yet.

AlphaRay, Dec 19th 2025 at 11:11 AM

Yesterday i had performance issues (i was on my netbook with just a Ryzen 5600U):   VS Launcher used 3D mode of gpu (why???) and  this between 2 and >10% (!!) of the whole gpu while playing game.  And you can't shut it down...It refuses to close because the game is running. And if you shut it down via Task Manager, it restarts immediately.   I think that the higher use of dwm.exe is probably also due to this.

I do not see any 3d stuff here on gui + just deactivate hardware acceleration for gui rendering, so the gpu is not touched.
This have a big impact on performance on lower systems like this one.

image

AlphaRay, Dec 15th 2025 at 11:32 AM

Something like this for installed mods with delete icon,  as rough preview:

AlphaRay, Dec 15th 2025 at 11:16 AM (modified Dec 15th 2025 at 11:23 AM)


XurxoMF  Thank you! :)

Meanwhile i found this too..the icons are confusing, because normally wrench means "settings" or "options" -> so what is pencil her.  But right, the mods are a part of configuration - this page is mostly for updates, so i would expect here arrow(s) in circle icon
Update Icon SVG Vector & PNG Free Download | UXWing


3.  Now i see the yellow for installed mods...It's so subtle that I never noticed it. Maybe set the background transparency to 0 here so that it really stands out? Or add a yellow border around the box? (2-3 pixels wide)

It would be nice to have here a delete button  (so yellow + delete button maybe on bottom right of the image?), because in the mod-configpage there is no search.  I've "only" 155 mods at the moment..and it's already here hard to find a specific one if you want to remove it.  Sometimes i see here a mod here:   "aah..yeah..this was stupid - let delete"...and then you have first to find it on the other page to delete it - even though you already have it right in front of you

6.  yep..seen this too.  I think i copied ancient tools in here and the manager installed one...strange:   two times exact the same version...is shown as this in game too. The zip is named different



EDIT:
The yellow background of installed mods is really hard to see...especially when mod is green/yellow in logo background...   The blurred background of the editor itself is green-yellow..that's why the yellow of the box "disappears"


My suggestion:  blue..but still with less transparancy + additional border around the complete box


XurxoMF , Dec 13th 2025 at 10:09 AM

Oh, sorry, you need F12 to open dev tools! Attac_Mage

Attac_Mage, Dec 12th 2025 at 10:11 PM (modified Dec 12th 2025 at 10:12 PM)

Yeah, cloned the repo already since I wanna look into it. 

I can open dev tools on my base install just fine, though. Is that not normal? It's just CTRL+Shift+I and that should work on most electron apps.

I know it's not really something you can deal with so it's all good, just wanted to have some info on this page if anyone else has the same issue in the future. 

XurxoMF , Dec 12th 2025 at 2:05 PM

There is no way to open dev tools I think. Only on dev mode but you'll need to clone the repository, install node and all the dependencies and run it as dev.

If version downloads are not working neither then it's probably what you said, a IPS issue, VPN, proxy... something network related.

It's the first time this happens. Some times mods fail to download because if the ModDB API being slow or something and version downloads are slow for a few users and we still don't know why that happens... only 2 or 3 users reported it...

I'ld love to help but it's not something I can really test. If you can, join our discord server and send me the VS Launcher logs there.

Another option if you know how to is to do what I meantioned before... install node, clone the repo, install packages and run as dev. There you'll be able to see the console for both the frontend and backend.

The thing is, backend errors are alway logged to the files and frontend errors do the same thing most of the times. Unless it's a crash... then it'll close the app but this never happend so...

Attac_Mage

Attac_Mage, Dec 12th 2025 at 8:15 AM (modified Dec 12th 2025 at 8:18 AM)

Was trying to look into it a bit more and interestingly enough he can't even open the dev tools. Do you have any CLI args that can be passed to the app that you know of? His computer's a bit wacky since it won't even launch through cmd and instead has a cache access error so I probably couldn't use it anyways, but it'd be nice to know.

Mods and such do still load in after waiting ~2-3 minutes and can be downloaded (but downloads are no longer near-instant and now take in the double digits of seconds). Trying to download a VS version failed every time but was inconsistent as to when it would fail (some near instantly while one took at least 5 minutes), and also took longer to download than normal. 

 

I'm assuming it's something to do with his router/ISP as it hasn't resolved after a few days (and a reinstall with all files wiped for everything VS related as far as I know) so I'll have him mess around with that a bit maybe. He can still launch the game and host, at the very least, so it's all fine for now. 

Attac_Mage, Dec 10th 2025 at 8:56 PM

All good. Just find it funny that it really doesn't like certain people even after restarts. 

XurxoMF , Dec 10th 2025 at 2:11 PM

If you mean the

A Javascript error occured in the main process

Uncaught exception:

Error: net::ERR_HTTP2_PROTOCOL_ERROR

at SimpleURLLoaderWrapper.<anonymous> (node:electron/js2c/browser_init:2:114978)
at SimpleURLLoaderWrapper.emit (node:events:519:28)

error then it's not a cache thing. It's just the ModDB API being silly for a while.

It'll stop showing up after some time... I can't do anything about it, the request fails because the ModDB API returns something invalid for some reason. Attac_Mage

Attac_Mage, Dec 10th 2025 at 4:48 AM

My buddy had the bug that genji mentioned and while he can still launch the game it crashes the client on world load. Would this happen because of a temp/cache file being stored somewhere? If so, how could you go about deleting it?

XurxoMF , Dec 8th 2025 at 10:34 AM

Hiii! I'll explain some of the things you say here and how I'll solve them:

1. VS Launcher filters using the official ModDB API wich, as you can see, filters for description too. On Rustory I'll filter locally so I'll be able to add 2 different filters, title and description search.
1.1. I thought about this and I'll try to do so every idk, 30 minutes or 1 hour.
2. On the Installations page there is a 🔧 icon where you can manage the mods for that Installation. Then at the top there's a update all button. If you click it it'll update all the green mods on thet page.
3. This is already implemented. The mods you've installed are yellow. Select the Installation you want to install to and filter ftom on the left menu.
4. On Rustory there will be a page for each mod so instead of opening the popup to install it it'll open the mod page inside the launcher. There you'll be able to see description, versions, images... everything.. even comments I think.
5. On the same page mentioned on the point 2. There is a 🗑 button for each mod.
6. Mods palced manually will be counted after restarting the launcher. It looks for mods on startup and every time you open the manage mods or mods page. Open those pages or restart the launcher to list them.

Here is a guide on how to use it: https://vsldocs.xurxomf.xyz/get-started/usage/game-client

Hope this helps ^^ AlphaRay

AlphaRay, Dec 8th 2025 at 10:19 AM (modified Dec 8th 2025 at 10:19 AM)

Thx for this nice launcher!!  Here some suggestions and small problems i have found in first days of use:



1.  Could you check the search funtion?   Just test with e.g. "tweaks" (searched for dana tweaks)...  There are always soo many results which have nothing to do with the search keyword.
I think this is, because you search in descriptions too - the listigin should start with mods which have the keyword in name and than in description.


It would be nice if the launcher checks from time to time (when running) if there are new mods + auto-download them...like Steam does.


2.  is there an update mods all function?  See nothing about updates - manually checking +150 mods one by one if there is an update is horror  :D

3.  add an icon on right top of every mod which is actually used by selected installation...so you don't click a mod the xx time to install it and checking that this is already installed

4.  Could you add the base description of the mod on the download page?  You always have to open the mod in browser to see what it really does - a short descrption (modinfo.json, if there is one) would be nice to have  :)

5.  DELETING OF MODS - maybe i'm blind..but i do not found an option to delete a mod.   And:  manually deleted mods do not update in launcher!  They still "exist" here + are counted in

6.  same for manually installed mods -> every mod i put manually in mods folder of the installation is NOT counted/listed

XurxoMF , Dec 6th 2025 at 8:10 PM

I mean, if you prefer to do that just do it...

If you copy-pasted the contents from a folder to another manually is not VS Launcher fault... create the Intstallation usiung VS Launcher or follow the guide to migrate from another folder/computer...

If you want to do whatever you want however you want then don't use it, it's that simple.

If I buy a sports car and try to offroad I'll break it and is that a company problem? No... use it the way is meant to be used.

A lot of things can be improved and are been improved on the V2 version but right now it helps with A LOT of things like session management, easy mod management and updates, easy game updates... Mansen

Mansen, Dec 6th 2025 at 6:56 PM

I mean... if you're telling people to edit text files to change settings in the launcher, then one might as well just use a simple shortcut with arguments at that point.

XurxoMF , Nov 26th 2025 at 2:36 PM (modified Nov 26th 2025 at 2:36 PM)

Mansen Mods will be downloaded inside the Installation folder inside the Mods folder. You can add multiple folders on the clientsettings.json and sercverconfig.json on each Installation to load mods from multiple sources but VS Launcher will always download them on the Mods folder.

About the AppData folder... you can change the defult folder on the config + change the folder per-instance when you create it... you can save both versions and instances were you want.

About the tray icon, I know and it's already implemented and working on Rustory (VS Launcher 2.0).

 

j0h_ That's because you copy-pasted the contents from one Installation to another. The game saves the mods folder on the clientsettings.json and serverconfig.json so VS Laauncher is downloading and managing mods on the Installation mods folder but the game is using the old Mods folder. Edit those files and change the path to use the correct folders. Not a VS Launcher issue... it's not recomended to copy filder over Instances. Also fixed on Rustory.

j0h_, Nov 26th 2025 at 12:23 PM

i have mods that were deleted via launcher and still show in-game. and added mods WILL NOT show in-game. ive reloaded mods, and opened the folder and regardless of whats in the folder, no changes are being made to my game mods.

Mansen, Nov 26th 2025 at 9:42 AM

Great on paper, less so in practice.

Seemingly no way to define a mods folder for each installation, only a data folder. I want my installs to be fully portable and not be in appdata at all.
Also no option to minimize the launcher to the tray icon area, once the game is launched - Kind of an eyesore to constantly alt-tab into the launcher, without being able to dismiss it.

XurxoMF , Nov 22nd 2025 at 9:07 AM

1. You're using the incorrect account. There is a client area account and a game account. You need the gme account.
2. You tried too many times and now your account is locked.

It works perfectly fine. The only time as issue showed up was because of those 2 things.
Try again tomorrow, maybe you are locked. GawdAwful

GawdAwful, Nov 21st 2025 at 10:58 PM

log in just doesn't work for me. Idk if I missed some update somewhere, but rip. Definitely the correct info, just can't log in. First it was saying incorrect info. Now the logging in message just hangs and nothing else ever happens.

XurxoMF , Nov 12th 2025 at 1:54 PM

Almost 10k downloads (https://tooomm.github.io/github-release-stats/?username=XurxoMF&repository=vs-launcher) and it's the first time someone tells me this.

It's 100% secure, you can check the full code on GitHub if you want. Tuenbb

Tuenbb, Nov 12th 2025 at 1:21 PM

Windows Defender tells me it's a virus

genjitalis, Nov 8th 2025 at 10:46 PM

That's good to know! So far, my launcher has returned to normal after a day or so, but if the issue still persists I'll pop into your Discord and send the files your way. Thank you so much for explaining what was going on! XurxoMF

 

XurxoMF , Nov 8th 2025 at 3:18 PM

Sorry for that! I'll update it asap 777cass

777cass, Nov 8th 2025 at 11:22 AM

Please update the Linux guide to download NET 8 instead of NET 7, I had to dig everywhere to figure out why my game wasnt launching when I could have simply updated the NET version :')

 

XurxoMF , Nov 7th 2025 at 6:21 PM

This happens sometimes when a resource is not accesible on the internet like the ModDB API, VS Launcher API...

It's not usual but it was an Electron error. It doesn't allowed us to handle it correctly.

It'll not mess up anything but it'll show up for a while probably. It should stop when the required service starts working again.

genjitalis if it doesn't stop showing today let me know on Discord please! Send me the log files.

genjitalis, Nov 7th 2025 at 3:51 AM

Hiya! Not sure if this is a user error or what, but when loading up my VS launcher and waiting a few moments, this error pops up and I'm unsure what's causing it. After it pops up the launcher freezes and becomes completely inaccessible. I've restarted the application as well as my own desktop several times to no avail, its so far not messed with any of my files and only seems to be mildly irritating. If a fresh install of VS launcher is needed I'll see if that works, but for now I'm leaving this comment as a heads up of what I'm facing. If more info is needed let me know, thank you!

" A Javascript error occured in the main process

Uncaught exception:

Error: net::ERR_HTTP2_PROTOCOL_ERROR

at SimpleURLLoaderWrapper.<anonymous> (node:electron/js2c/browser_init:2:114978)
at SimpleURLLoaderWrapper.emit (node:events:519:28) "

XurxoMF , Nov 4th 2025 at 5:15 PM

Hiii! Not on VS Launcher.

This is already planned for Rustory (VS Launcher 2.0). I'll try to finish this one on December as I'll have no job that month. FireVentus

FireVentus, Nov 4th 2025 at 4:32 PM

Is there any way to mark mods to prevent them from being update? Sometimes there's an update that I don't want to do because it's a pre or test version update that causes crashes.

XurxoMF , Oct 26th 2025 at 7:37 PM

API is back up again! Sorry for the downtime

rayray, Oct 26th 2025 at 5:14 PM

Thanks for the update got it working 

XurxoMF , Oct 26th 2025 at 8:09 AM (modified Oct 26th 2025 at 5:38 PM)

rayray The API is down because I'm updating the server. I've posted an announcement on our Discord server. It should start working again today.

Shunte Version are automatically added when Anego releases it. Install it on the Versions page once the API is up again.

rayray, Oct 25th 2025 at 5:54 PM

HOW TO CHANGE VERSION

Shunte, Oct 9th 2025 at 1:53 AM

I wanted to make an installation instance for 1.21.4 but I only getting options for 1.20 and 1.21.1. Will 1.21.4 be added as an option?

XurxoMF , Oct 6th 2025 at 5:27 PM (modified Oct 6th 2025 at 5:28 PM)

Mods MUST go on the Installation mods folder. If they show up on VS Launcher but not ingame it's because you copy-pasted the Installation contents from another folder and the game saves the first Mods path on the clientsettings.json and serversettings.json.

Edit those files and remove the Mods paths inside or edit them to match the new folder. Destiny_Fuker

Destiny_Fuker, Oct 6th 2025 at 1:45 PM (modified Oct 6th 2025 at 1:53 PM)

Love the ease and style of the launcher so far! One small issue ive been having tho.

Downloading a new version and adding mods, wether from the launcher menu or in game through modDB link they show up in the version folder in VSLInstallations but not in game. But downloading the mods on my original VS folder then copying files from VSdata to the Installations version folder then has them show up in game? 

Same with deleting a mod from the version folder after copying mods over, they no longer show in the folder or launcher but are still in the game.

Edit: Creating a new fresh version I can then add/remove fine, might just be an issue since I copied my data over from original VSdata folder to carry over saves and such?

XurxoMF , Sep 28th 2025 at 2:13 PM

Log out and log in again Lucian_Fallen

You session expired probably

Lucian_Fallen, Sep 28th 2025 at 10:10 AM

I log in the launcher and still I have to login in the game😭

Tyrnn, Sep 25th 2025 at 6:36 PM

XurxoMF I'll have to try the relog and see. I'm logged in at the Launcher, but it still pushes me to log in when the game program opens. I'll see if it works for me then update here.

XurxoMF , Sep 25th 2025 at 5:50 PM

Tyrnn Vintage Story saves the session every time you log in. If you log in on another Installation or another PC it'll revoke the old session. You can log in on the top left button on VS Launcher and this will manage the sessión fro you and use that one on every single Installation. If it's not loggin in log out and in again, you may have logged in on another PC and revoked that session.

Tyrnn, Sep 25th 2025 at 4:50 PM

Does anyone know why it makes me log in every single time I click "play"? It's getting annoying lol

B0bb0, Sep 15th 2025 at 5:19 PM

Thanks for your reply XurxoMF

XurxoMF , Sep 15th 2025 at 1:36 PM

Hiii! Thank you so much for sharing your ideas! Let me explain why I can and can't do it xD B0bb0

  1. Currently I can't get favourites from the ModDB for a few reasons:
    1. The API doesn't let us query favourites.
    2. The login on VS Launcher is for the game, not the ModDB.
  2. On VS Launcher, favourites are stored on the config.json inside the AppData\Roaming\VSLauncher folder. Right now you can copy-paste the favourite mod codes and paste them on another user/pc config file but it's not possible from the launcher.

 

And now answers to how I'll handle this on Rustory (VS Launcher 2.0)

  1. Rennorb is improving the ModDB and it's API and I suppose, if it was not already implemented in the last weeks, a way to login and add/remove favourites from the ModDB using the API. When this option is ready I'll implement a login with the ModDB account to manage favourites, comments and many other things. The Mods page will be fully interactive for make it easier.
  2. I'll implement a way to export/import favourite mods, modpacks, instances... almost everything.
B0bb0, Sep 14th 2025 at 7:53 PM

Hello, this launcher is awesome.  I have two ideas I would like you to ponder.  They based on trying to convince family and friends to install and use it.

 

1) Can you read the favorites from the ModDB on the initial sign-in to set them in VSLauncher?

 

2) I did a cursory look for where favorites are stored... I am guessing it in the SQLite DB.  Could you create a Mod favorite export/import function so people can share their favorites to new VS players?

 

Thanks for your work and your consideration!

XurxoMF , Sep 13th 2025 at 11:39 PM

The mod update toggle is planned for Rustory (VS Launcher 2.0).

You can already add favourites on the Mods page.

Mods and Manage Mods pages will be unified on Rustory (VS Launcher 2.0) so it'll be there.

Thanks a lot! Hope you enjoy it ❤️ Spyke1021

Spyke1021, Sep 13th 2025 at 9:10 PM

Any chance we can get a toggle for mods so we can turn off mods that don't work after an update, but we don't want to delete so they aren't lost or a way to add favorites from the mod list? A search bar on the installed mod list couldn't hurt, too. Other than that, it's a perfect tool to make modding and updating easy!

XurxoMF , Sep 9th 2025 at 1:37 PM

Default folders are under AppData\Roaming and they're: VSLGameVersions, VSLInstallation and VSLBackups

Example: C:\Users\YourName\AppData\Roaming\VSLBackups

Also, send me the launcher logs under thr VSLauncher\Logs folder in AppData. There should not be any errors unless you selected a drive and then removed it...

Tyrnn

Tyrnn, Sep 9th 2025 at 2:20 AM

What are the default folder locations for the Config Menu? I changed mine preemptively, and now I seem to run into erros on the extraction of files.

XurxoMF

XurxoMF , Sep 7th 2025 at 8:01 AM

Thanks a lot for the suggestion! I'll add that feature on Rustory (VS Launcher 2.0).

It'll also show progress bars on the Instance, not only on the menu :) CherryRook

CherryRook, Sep 6th 2025 at 11:56 PM (modified Sep 6th 2025 at 11:57 PM)

Fantastic launcher, clean and simple ui and powerful for managing multiple installations and all your mods. Easy to use, simple to understand, 11/10!!!

Only one suggestion i have if i may, it sometimes is hard to tell when the launcher is done doing backups. I have been using it for a while and only now i noticed that the progress notifications get automatically moved to the "events" tab (idk what to really call it, ESL moment, but i mean the button next to where you log into your VS account). Now to my suggestion: It would be nice if things like backup notifications were "sticky" and be able to optionally dismiss them into this tab instead of them disappearing after a few seconds automatically. 

Otherwhise nothing else really to add, fantastic launcher as i already said. Wish i had this sooner because it makes managing everything really a lot simpler

XurxoMF , Aug 28th 2025 at 4:44 PM

Thank you so much for your kind workds ❤️

Kattifnatt, Aug 28th 2025 at 4:43 PM

Thank you so much for this fantastic launcher. Have been using it since the release of VS 1.20 and it's working wonderfully. Never had a single issue. Amazing work!

XurxoMF , Aug 26th 2025 at 1:22 PM

Ohhh ok, another user wanted something similar. Yes, it's planned for Rustory (VS Launcher 2.0) slartibartfast

slartibartfast, Aug 25th 2025 at 7:50 PM

@XurxoMF,

feral gamemode is program that can be installed on linux that games can use the tweaks varios system functions to enhance gaming performence.

if there was an option to pass 'gamemoderun' prefixing what ever you use when calling VS and its following commands then it would enable gamemode when your launcher starts a VS instance.

The command option the launcher currently has passes commands postfix

So prefix command option would be very useful.

 

XurxoMF , Aug 25th 2025 at 5:20 PM

Thanks a lot for the king workds! What is feral gamemode? slartibartfast 

 

Thank you so much for both the guide and the king words! I'll add this to the docs when I have some time ^^ Corgi12

Corgi12, Aug 24th 2025 at 11:39 PM (modified Aug 24th 2025 at 11:46 PM)

If you're having trouble running an instance with dotnet runtime 7.0 on Fedora when following the guide, then you might not have it installed in the correct directory. The guide wants you to install the runtime in the /usr/lib/dotnet directory. I noticed in the debug log for the AppImage that it is looking for the install in the /usr/lib64/dotnet directory.

 

So all you need to do to install it in the correct directory is run the command with the updated directory.

Spoiler
sudo ./dotnet-install.sh --channel 7.0 --install-dir /usr/lib64/dotnet

Making sure to replace "/usr/lib/dotnet" with "/usr/lib64/dotnet".

 

After that I was able to launch the instance no problem. And for whatever reason it ran a lot better than the official flatpak for me. Great job guys!

slartibartfast, Aug 24th 2025 at 10:41 PM

Pretty awesome. 

Is there a way to launch instances with feral gamemode ?

XurxoMF , Aug 13th 2025 at 8:38 AM (modified Aug 13th 2025 at 8:38 AM)

It'll sepparate the mods in 3 groups:
💚 -> Mods with updates compatible with your game version. If you're on 1.20.12 this mods will have a 1.20.12 tag.
💛-> Mods with incompatible updates. If you're on 1.20.12 this mods will have a 1.21.0 tag for example.
🖤-> Mods with no updates. You've the latest version of the mod.

https://vsldocs.xurxomf.xyz/get-started/usage/game-client/install-manage-mods#updating-mods that's the guide. There's a vído showing what I mean.

Emu3008

Emu3008, Aug 13th 2025 at 7:49 AM

will the launcher always update mods to their latest release (regardless of the game version needed being higher), or is it capped by the launcher to whatever your installation is

Birdnerd3241, Aug 12th 2025 at 6:43 PM

Nice, thank you!

XurxoMF , Aug 12th 2025 at 8:12 AM

Edit the %AppData/VSLauncher/config.json on Windows or ~/.config/VSLauncher/config.json on Linux and edit the Installation you need ^^ Check the image: https://cloud.xurxomf.xyz/s/gJCJ

There is no way tyo edit this using the UI right now. Birdnerd3241

Birdnerd3241, Aug 12th 2025 at 6:07 AM (modified Aug 12th 2025 at 6:08 AM)

Is there a way to edit the amount of time in an installation? I want it to show the proper amount of time I have ingame.

Love the launcher btw, makes managing mods SO much easier :D

XurxoMF , Aug 2nd 2025 at 2:35 PM

Thanks a lot for your words ❤️

Travisplo, Jul 31st 2025 at 4:25 AM

I have to say, I love this. Thank you so much for making it, it feels so smooth and intuitive to use.

XurxoMF , Jul 28th 2025 at 5:08 PM

I've changed nothing from 1.5.4 to 1.5.5, only a .reverse() on the versions dropdown and a new .json with the ru-RU locale. That sounds like you've copy-pasted the clientsettings.json from another location so the launcher is using the Mods folder inside the Installation but the game it's using the one defined on the clientsettings.json. Kalonie

 

It was suggested a few times and it's something I've in mind for Rustory(VS Launcher 2.0). DarkThoughts

DarkThoughts, Jul 28th 2025 at 2:05 PM

Not sure if someone suggested it already but I think an update toggle or checkbox (as long as it remembers its state) would be nice, in order to exclude certain mods from the "update all" button.

Kalonie Just tried downgrading a mod through VS Launcher and it showed the downgraded version in the game. If you're on a case sensitive OS like Linux I'd make sure you don't have a second mod / Mod folder or something.

Damage_Zedd, Jul 28th 2025 at 5:07 AM

im not experiencing that issue

Kalonie, Jul 28th 2025 at 1:46 AM

potential issue with 1.5.5, i dont know if im doing something wrong of if its the launcher but my game wont apply any changes i make to it. example: i deleted metal cooking pots and added culinary artilery. I hit play and the game opens but metal cooking pots is still in the mod list and culinary isnt. i open the mod folder and pots is gone, culinary is there. i reload the launcher and the game, doesnt fix it. i delete and reinstall the mod, nope. 

Not a big problem for me as ill just downgrade back to 1.5.4 but i figured you should know. its like the game isnt reacting to changes made to its mod folder with 1.5.5 and is going off of whatever mods where installed using 1.5.4.

XurxoMF , Jul 22nd 2025 at 4:48 PM

It happens hahahah I'll improve that on Rustory.

ManaWei, Jul 22nd 2025 at 3:35 PM

Yeah that's the problem, it doens't work.. I am logged in on the launcher, but I still have to enter login credentials..
I haven't thought to try relog on the launcher, I'll try that.. could be an update issue since it was working fine before the last launcher update.. 

 

[EDIT]: And ofc that was just the thing to do to fix it.. I feel a little silly now XD

XurxoMF , Jul 20th 2025 at 7:49 AM

You've a log in button on VS Launcher. Log in there and it'll manage sessions automatically. ManaWei

ManaWei, Jul 20th 2025 at 7:40 AM

Eeh.. having to type in login credentials every time you start up the game is a bit annoying.. minor, but still.. 

XurxoMF , Jul 16th 2025 at 1:28 PM

Can you join our discord? The link is on the info page on VS launcher. It works for me. Join Discord and send me the logs on %AppData%/Roaming/VSLauincher/Logs.

If you don't want to join Discord, send them on the official Vinatge Story Discord, on the Mods forum, on the VS Launcher post. Tsukasa

Tsukasa, Jul 15th 2025 at 11:10 PM

XurxoMF tyvm, now it show the game versions, but get an error downloading, no matter the version I try

XurxoMF , Jul 15th 2025 at 4:09 PM

It's fixed now Tsukasa

Tsukasa, Jul 14th 2025 at 11:41 PM

Vs version not showing the versions to install it stuck with the spining loader

XurxoMF , Jun 21st 2025 at 3:02 PM

Sometmes the session may expire but vs launcher does not detect that. Just log out and in again venfaaniik

venfaaniik, Jun 21st 2025 at 10:37 AM

Great launcher! Very useful for having separate mods for separate saves. 💯

Once I launch the game (the same installation as the last time), it always asks for cresendials even though I'm logged in on the launcher itself, is this intended? It's just a minor annoyance.

WolfWarrior, Jun 20th 2025 at 7:10 PM

XurxoMF

thank you

XurxoMF , Jun 20th 2025 at 4:34 PM

WolfWarrior it does for rc and stables, pre versions are not automatically imported as those are not added to the versions json provided by anego so I've no way to automatically import those versions.

On the future I'll add some manual import feature on the API so I can import those versions easily.

For now on you can download and install the version manually and import it using the 🔍 button the Versions page.

WolfWarrior, Jun 20th 2025 at 6:37 AM

It doesn't seem to recognize there is a new vs version? 

Whickle, Jun 16th 2025 at 5:49 AM

This is essential, especially since I can keep my VS installations nice and tidy.

Entity, Jun 12th 2025 at 8:20 PM

this is great for keeping all of my mods up to date, thanks for making this!

XurxoMF , Jun 4th 2025 at 1:48 PM

ANultimatum The update notification is broken due to an electron-updater bug. I can't fix it right now. If you close the launcher when the notification shows up it'll start updating right away and it'll finish updating on a few seconds. About the error while updating it can be for 3 things: 1. You installed it on a folder where it doesn't have the required permissions(the folder of another user for example) 2. Having the installations inside the same folder may be part of the problem but it should not. 3. You're out of free space on the drive you're using. About the ignore mod update, ths will be added on Rustory (VS Launcher 2.0).

 

propaneko It should work on steam deck. If the game is not showing up after clicking the Play button check the game logs on the Installation folder. Maybe you don't have .NET or something installed.Check out this guide: https://vsldocs.xurxomf.xyz/get-started/installation/linux#steamos

 

EnderWarlock What you describe with a port to a new version downloading the old version, this is not an VS Launcher issue but a mod issue. VS Launcher uses the modid to recognice and download mods. If the port uses the same modid as the original mod VS Launcher will find the original mod first and because of that, it'll get updates from that one. I can't do anythign about that with the current ModDB API. About the Installations using mods from another Installation, you probably copy-pasted the contents of this ones and, most important, you copy-pasted the clientsettings.json and serversettings.json. This 2 files contain a reference to the mods folder. If you copy-paste this files it'll load the mods from the other Installation... just edit those files and change the folders to match the new Installation mods folder. Again, not a VS Launcher issue so I can't do much about it, idk why the game saves the base mods folder path on the config files...

EnderWarlock, Jun 3rd 2025 at 11:48 PM

Looks great and the UI is easy to use and understand, but I am having problems with mods that are not in the mod folder being loaded, and the wrong mods being downloaded. For example, I would download the 1.20 fork of Femininity, but it would download the original old version instead, which is listed on an entirely different page (not consistintly either.) Another example would be it loading up a mix of mods from seperate instances, rather than only the mods for a given instance. Both these situations cause crashes and bugs that do not occur when loading the same mods in a standard non-launcher instillation.

Holds a lot of potential and really excited for when it gets to a reliable state, but it's not quite there yet. (On Windows 11 if that helps with replicating the bug; cannot get consistant replications myself, but rather get a different variation of the two above examples with each attempt.)

propaneko, Jun 3rd 2025 at 10:02 AM

Is there a chance for support on steam deck? I was trying to use AppImage the launcher itself works but I cant start any instance

ANultimatum, Jun 2nd 2025 at 3:45 PM

Love this launcher but recently it's been a bit annoying trying to update. The launcher downloads the update then says click here to restart the client and install the update. I click there...

Nothing happens...I wait. Nothing happens... I close the launcher and it starts installing it? Is it supposed to close itself? Am I supposed to restart it? Then the installer asks permission to start, i hit yes aaaand...

Wait a bit. Then get an error that the installer could not uninstall the old installation...What gives? Is it because I put the VSLInstallation and Version folders in the VS Launcher folder itself? I dont want 20 different folders on my drive for the VSL...

Also while I'm whining, would it not be wise to make a "Ignore New Updates" checkbox for mods that need to stay in specific versions? Idk, I have OCD so seeing mods that I need to stay certain versions constantly telling me theres a new update annoy me.

Great job so far, hope this grows into an official part of the game, the launcher otherwise is great! Cheers.

XurxoMF , May 26th 2025 at 6:18 PM

It should work fine. I'll need beta testers so if you want, join our discord to get access to the beta ^^

eerino, May 25th 2025 at 12:17 PM

I really hope you getting this working on MacOs! I used windows forever but my pc died a few years ago and the new Mac Mini was so cheap and something finally affordable to me. <3 Good luck! Wish I could help. 

XurxoMF , May 25th 2025 at 7:45 AM

This is already planned for Rustory. As I said on the latest changelog I'll not work on VS Launcher anymore as I'm working full-free-time on Rustory(VS Launcher 2.0) Willownezz

Willownezz, May 24th 2025 at 1:50 AM

cant live without this laucher anymore Lol, I was also wondering if in the page where you update mods the button for 'update all' is very handy, but sometimes there are some mods that cant be updated because either the version doest match or there is some bug so I avoid updating them, would it be possible to add check box to 'exclude' some mods from updating but still be able to use the 'update all' button ?

XurxoMF , May 12th 2025 at 8:01 PM

Thanks a lot for that ZippyWonderdust , I did thought about that in this case! I've said that to some users but in this case, the game crashing, didn't looked like the problem. It uses to be an "I've installed a mod and it's not showing up in-game" xD

 

I'll add this on the VS Launcher Docs! frihu . Sorry for for the inconvinience, I didn't thought about this 😥

frihu, May 12th 2025 at 6:39 PM

ZippyWonderdust

Thanks for the info. Maybe the cause because i didn't change anything in clientsettings.json

XurxoMF

Maybe it's worth mentioning?

ZippyWonderdust, May 12th 2025 at 4:51 PM

Hey frihu

For some reason the game devs decided to save the full file paths to the Mods and Saves folders in clientsettings.json and serverconfig.json, rather than a relative path.  This means that you can't just copy the VintageStoryData folder to another location and have it work, unless you edit those paths.  This is not actually that hard to do; any simple text editor will work and the entries that need changing are very obvious.

If you try (like I have done in the past) to make a copy of you game installation but neglect to edit clientsettings.json and serverconfig.json, it will kind of work, but it will actually be referencing mods and saves from your original installation instead of from the newer copy.  This will break the first time you try to update any of your mods because the mod data will be split across both installations.  Something about how the game unpacks mods causes it to put some of the mod data in the new installation while leaving the rest behind in the old installation.

When this happens you can get all kinds of wierd errors that make no sense and do not indicate what the underlying problem is.

XurxoMF , May 8th 2025 at 6:42 PM

Ok, I'll check if it's a VS Launcher or if it's somethign with your system or app.

CoffeeToffee, May 8th 2025 at 4:32 PM

XurxoMF Windows 11, 64 bit

XurxoMF , May 8th 2025 at 1:04 PM

What's your operating system? CoffeeToffee

CoffeeToffee, May 8th 2025 at 1:00 PM

Weird bug im encountering is if i have the launcher open behind my game when im fullscreen, my cursor randomly vanishes until i tab out and back in, or i wave it around. If i minimize the launcher while im in full screen, this issue goes away.

XurxoMF , May 7th 2025 at 12:52 PM

Are you testing it with the exact same world? Not world settings, the old worlds you were using.

The error is becaue of a remaping. RM had a class that now doesn't exists so the gamer crashed. On a new world it'll not fail.

A lot of different things may be happening and something is not an exact 1:1 copy. If that's the case the error will show up. If you want to test it do C:\Users\YourUser\Path\To\The\Version\Vintagestory.exe --dataPath="C:\Users\YourUser\Path\To\The\Installation" and that should show the error too.

frihu

frihu, May 6th 2025 at 7:25 PM

XurxoMF
I know it shouldn't but i have 1:1 copy from normal installation and your launcher
Normal - works without errors
Launcher - errors on some mods when updating them

 

I copied 1.20.7 from %appdata% but downloaded 1.20.9 and 1.20.10
Maybe copied mods dont work with updates

XurxoMF , May 6th 2025 at 6:56 PM

The error looks like it's while using the new version on RM on an old world because of a remaping. On a new world it should not throw errors.

VS Launcher has nothing to do with the error. As I said, it's only launching the game with Vintagestory.exe --dataPath="folder"... it does nothing, mods are downloaded from the moddb... it has nothing to do with this. frihu

frihu, May 6th 2025 at 5:21 PM

XurxoMF

That error will show up even if you don't use VS Launcher.

I tested it and error didn't occur on normal installation.

XurxoMF , May 6th 2025 at 1:07 PM

VS Launcher does not modify anything on Mod loading or the game. VS Launcher just downloads the ZIP files inside the Mods folder of the Installation and that's it. That error will show up even if you don't use VS Launcher. In this case it's a Rustbound Magic issue: System.Exception: Don't know how to instantiate item of class 'ItemCreatureRM' did you forget to register a mapping? probably because of the massive update the creator did.

Contact him on the Rustbound Magic comments or his Discord mod post. frihu

frihu, May 6th 2025 at 9:16 AM

XurxoMF

I think there is a problem with mod loading when using launcher.
I have crashes like this
Game Version: v1.20.9 (Stable)
04.05.2025 18:42:07: Critical error occurred
Loaded Mods: aculinaryartillery@1.2.5, americanfrontiersman@1.7.1, tonwexp-neue@2.1.1, axleinblocks@1.20.1-rc.5, backpackpackpluscontinued@1.0.0, bettertraders@0.0.10, bovinae@0.2.3, buzzwords@1.7.0, caninae@1.0.32, capreolinae@1.2.8, casuariidae@1.1.2, cervinae@0.1.6, chiseltools@1.14.17, clayworks@0.4.2, cpxem@1.0.0, decor@1.3.0, dinornithidae@1.0.16, elephantidae@1.0.11, felinae@0.2.10, forestsymphony@1.0.2, HumanSkinTones@0.0.3, improvedsheep@1.0.1, iniidae@0.1.2, machairodontinae@1.0.25, manidae@1.0.15, manualdough@1.1.3, manualscraping@1.2.1, manualtoolcrafting@1.3.5, masonsdelight@1.0.2, meiolaniidae@0.1.5, millwright@1.2.0, morebanners@1.2.0, MoveLikeKaji@0.0.6, overhaullib@0.2.8, pantherinae@1.1.27, TA_plainsandvalleys@1.0.9, primitivesurvival@3.7.7, rhinocerotidae@1.0.18, royalscurtains@0.0.1, SergTweaks@1.3.2, sirenia@1.0.20, spheniscidae@1.0.11, stoneharvesting@1.0.5, swifttime@1.0.4, tailsmod@2.0.2, tprunes@1.1.1, terraprety@6.0.2, thylacinidae@0.1.2, viverridae@1.0.4, vombatidae@0.4.1, game@1.20.9, vsimgui@1.1.8, abcsredux@1.0.9, airmapfix@1.0.0, alchemy@1.6.50, offhandpenalty@1.2.1, anafkstory@0.9.5, animalcages@3.2.2, apeflowerpots@1.2.3, apegrapes@1.2.6, apelanterns@1.1.1, apewindows@1.2.0, flags@1.1.8, betterfirepit@1.1.5, betterruins@0.4.12, blobcatmod@0.1.1, canjewelry@0.4.18, carryon@1.8.0-rc.4, cartwrightscaravan@1.4.0, chestorganizer@1.2.3, colorfulcandles@1.2.3, combatoverhaul@0.3.9, commonlib@2.6.1, configlib@1.5.3, coreofarts@0.2.3, danacancook@0.2.6, danatweaks@3.4.1, decayingcreatures@0.1.5, expandedfoods@1.7.4, extrainfo@1.9.9, farseer@1.3.1, fseraph@0.2.3, foodshelves@1.6.2, fromgoldencombs@1.8.12, gridview@1.0.1, herbarium@1.4.0, immersivewoodchopping@0.8.0, immersivewoodsawing@0.2.8, improvedhandbookrecipes@1.1.3, kevinsfurniture@1.6.6, lavoisier@1.3.1, maketea@0.3.1, medievalexpansionpatch@1.0.1, moreanimals@1.4.1, ndlvillagers@1.4.0, norottinghides@1.0.0, spearexpantion@0.3.2, oneroof@1.9.3, petai@3.4.3, removeprimitivesurvivalstairs@1.0.0, rivers@4.1.0, scrollcharactercreation@1.0.1, solidirondoor@1.0.1, statushudcont@3.2.6, stirlingmotor@1.0.1, stonebakeoven@1.1.6, stonerailings@1.3.0, tabletopgames@2.10.4, tentbagreworked@3.1.1, toolsmith@1.0.13, unconscious@1.10.3, creative@1.20.9, vsinstrumentsbase@2.0.1, survival@1.20.9, wildfarmingrevival@1.3.6, xlib@0.8.16, alchemistry@1.0.2, armory@0.2.4, artofcooking@0.2.4, artofgrowing@1.1.2, cats@3.2.0, chickenpet@1.1.1, combat-overhaul-reanimated@1.0.0, drkboats@1.0.1, em@3.2.1, harepet@1.2.2, shearlib@1.1.2, stonequarry@3.4.3, vsinstruments_quackpack@1.0.2, wildcraftfruit@1.3.2, wildcrafttree@1.3.1, xskills@0.8.19, aogbreedingaddon@1.1.0, artsxskills@1.1.0, tailorsdelight@1.9.6, wool@1.6.3, dressmakers@1.5.2
System.Exception: Don't know how to instantiate item of class 'ItemCreatureRM' did you forget to register a mapping?
at Vintagestory.Common.ClassRegistry.CreateItem(String itemClass) in VintagestoryLib\Common\ClassRegistry.cs:line 332
at Vintagestory.Common.ItemTypeNet.ReadItemTypePacket(Packet_ItemType packet, IWorldAccessor world, ClassRegistry registry) in VintagestoryLib\Common\Network\ItemTypeNet.cs:line 196
at Vintagestory.Client.NoObf.ClientSystemStartup.PopulateItems(List`1 items, Int32 listSize) in VintagestoryLib\Client\Systems\Startup.cs:line 615
at Vintagestory.Client.NoObf.ClientSystemStartup.LoadItemTypes() in VintagestoryLib\Client\Systems\Startup.cs:line 424
at Vintagestory.Client.NoObf.ClientSystemStartup.HandleServerAssets_Step1() in VintagestoryLib\Client\Systems\Startup.cs:line 377
at System.Threading.QueueUserWorkItemCallback.Execute()
at System.Threading.ThreadPoolWorkQueue.Dispatch()
at System.Threading.PortableThreadPool.WorkerThread.WorkerThreadStart()

after updating rustbound magic in this case.
It is enabled in mod manager tab but not showing in Loaded Mods and i think thats why i have crash.
I have similar crashes with some other mods too.

XurxoMF , May 5th 2025 at 2:39 PM

There is an option and it's explained on the VS Launcher Docs here: https://vsldocs.xurxomf.xyz/get-started/usage/game-client/update-vintage-story

Check it out and let me know if you find any problem ❤️ SynthWave

SynthWave, May 5th 2025 at 1:26 PM

hello, i just wanted to say that your launcher is an amazing tool for playing by LAN with friends, though i wanted to ask, is there a reason why there doesnt seem to be an option to change my current installation 1.20.9 to the most recent one of 1.20.10?

XurxoMF , May 4th 2025 at 8:07 AM

Thanks a lot ❤️

Jalex, May 4th 2025 at 8:05 AM

Btw, this launcher is awesome, I really appreciate the work you've done.
it's made managing my mods so much easier. And I dont have to worry about losing my old worlds anymore because of updating to a new version or changing my mods. While forgetting to make a backup

XurxoMF , Apr 17th 2025 at 9:30 AM

You probably copy-pasted the clientsettings.json file from another Installation.

Open that file(clientsettings.json) and look for the line with the mods folder.

Change it to match the new Installation Mods folder and this will solve your problem.

If you need more help please join our Discord or contact me on the official Vintage Story Discord server mods post here: https://discordapp.com/channels/302152934249070593/1314991001571557488

Tsukasa

Tsukasa, Apr 16th 2025 at 10:20 PM

Hello, I try to open an other instance that was ready create, but not show the mods installed, but at the launcher and if i use the open mod folder button there are the mods

XurxoMF , Apr 11th 2025 at 12:53 PM

You have a button on the top left corner of the launcher with the download/extract/compress progress.

The drive you're using should not be a problem. If you can, join our support server on Discord and send me the error.log and debug.log from .../AppData/Roaming/VSLauncher/Logs to see what's happening. Kassian0x0

XurxoMF , Apr 11th 2025 at 12:50 PM

I was already thinking about adding a new button on the versions page to re-check installed version and update it on VS Launcher.

I've vacation the next week I'll try to add it so you can just update it in-game and refresh the version on VS Launcher.

EDIT: To make sure everything works as expected I suggest using VS Launcher to update Vintage Story by Installing a new version and changing it on the Installations. The other way you may have some conflicts on the future with folder or new versions been already installed(If you have 1.20.6 and 1.20.7 and then you update 1.20.6 to 1.20.7 in-game, what should VS Launcher do? Remove the one you installed bc the other one is already isntalled? Delete the already installed one and keep the one you updated in-game? It's not easy xD). Lotan

Lotan, Apr 11th 2025 at 11:21 AM

XurxoMF thanks for considering it, only other thing i would like to see is the ability to remove old VS versions without it removing the whole game install folder, as i update my game through the game itself instead of the launcher so i need to keep updating the launcher to show the latest version causing a long list of them in the VS versions tab.

Kassian0x0, Apr 10th 2025 at 9:33 PM

Would be nice to have somewhere we can see the progress of a version installing, its been half an hour for me to update from 1.20.5 to 1.20.7, and the only way to check is to hit play and see the popup that its STILL installing :(

 

Yeah not sure whats up, but it just refuses to download 1.20.7, just has a zip sitting at 0 kb even after an hour. Im on the newest launcher version, the only change is that i dont download the versions to appdata, i made a folder on my other SSD (same ssd that i have vslauncher installed on) to hold the version installs.

XurxoMF , Apr 10th 2025 at 5:01 PM

I'll think about that option on the future but for now on I can't add it. I'm adding important fixes and patches on every update, to make sure that it works as expected the latest version is required, but on the future, when the launcher is almost done, I'll proably add it.

Lotan, Apr 10th 2025 at 11:38 AM

i would like an option to disable the launchers auto update

XurxoMF , Apr 7th 2025 at 2:55 PM

Thanks a lot. I love the hear that you like it ❤️

Pontes, Apr 7th 2025 at 2:50 PM

The new version is incredible! Keep up the good work!

XurxoMF , Apr 3rd 2025 at 2:27 PM

NarielV

The last update allows users to set custom ENV variables to each Installation. What I've planned for the next update is to add a global config to set DOTNET_ROOT so VS Launcher can run the game with that one.

This should fix the issue on almost any linux distro and it'll only be required if it doesn't work for you. If it works without it it'll not be required.

 

PyK_Angelus

Another user asked for this already. It's something I want to look up on the future but this is already an in-game feature so for now on I'll focus on thing that can't be easily done in-game ^^

NarielV, Apr 1st 2025 at 10:15 PM

I tried using the ENV variables with many configurations of:

 

# Add .dotnet environment variables
export DOTNET_ROOT="$HOME/.dotnet"
export PATH="$DOTNET_ROOT:$PATH"

and it seems not to use it this is with the AppImage have not tested with Flatpak and updating the appimage resets the AppRun file so I had to re-patch my version.

PyK_Angelus, Apr 1st 2025 at 9:18 PM

Hello,

Thanks for this launcher, it would be cool to be able to activate or deactivate a mod directly from the launcher.

 

Toggle ON/OFF

 

a kind of swich to put on of the mod on the same line as the update or delete mods part of an installation.

List Mod

 

thanks again for this great launcher

XurxoMF , Apr 1st 2025 at 4:06 PM

I love tho hear that you like it ❤️

About the Server Manager, it's on the roadmap. I'm not having too much time to code right now but it's the next big feature! Alphanis

Alphanis, Mar 31st 2025 at 6:52 PM

I just downloaded and tested the launcher and I love it, as a suggestion, I think it might be interesting to put an option to install servers, similar to the ATLauncher launcher for Minecraft, where you can run and manage the server from the launcher, or leave direct access to a server from the launcher.

NarielV, Mar 22nd 2025 at 6:18 PM

XurxoMF  
Cool can't wait to see it well not true I got mine working already.

XurxoMF , Mar 22nd 2025 at 4:55 PM

It's a good sugestion but I'll not do so. VS Launcher is an independent project.

i don't want to rely on anything other than VS Launcher and VS Launcher API to avoid problems long term.

This way I can do whatever I want/need whenever I want/need.

ManaWei, Mar 22nd 2025 at 4:36 PM

Remeber me talking about a PDF generator for modlists?
You could ask to collaborate with the author of the Modupdater to just include his work in your launcher..
I think that would be a lot easier in the long run

XurxoMF , Mar 22nd 2025 at 8:29 AM

NarielV Thx a lot for that ^^

I'll make something similar to see if it works. I'll add a ENV input on the settings so you can set those ENV to use them when you run the launcher. If it works I'll release a version with that implementation, if don't I'll just add what you said to the guide on how to use VS Launcher.

NarielV, Mar 22nd 2025 at 3:52 AM

On that note can you add a dialog to close the game for handheld players not necessary but nice.

NarielV, Mar 22nd 2025 at 1:30 AM

XurxoMF

OK after a lot of testing I couldnt get the flatpak to work but I managed to get the AppImage to work simple enough all you have to do is add to the AppRun file this:

export DOTNET_ROOT="$HOME/.dotnet"
export PATH="$DOTNET_ROOT:$PATH"

under the exports and above Bin:

There is some user intervention required they do need to get the dotnet 7 runtime from microsoft and make a .dotnet file in the Home folder but that is a small price to pay for the convenience of actually being able to run it.

I reccomend adding an AppImage that is only for Bazzite instead of applying this to the current one as it will more than likely break it for others.

I have a tarball ready with the dotnet if you want to upload it.

Simpler Solution
make a bash script called run.sh that runs it with the environment variable:

#!/bin/bash

# Set the .NET runtime path
export DOTNET_ROOT="$HOME/.dotnet"
export PATH="$DOTNET_ROOT:$PATH"

# Run the AppImage
./vs-launcher-1.4.2.AppImage

NOTE!!!
It does need to be an appimage and integrated if you plan on using it on a Deck or Handheld in gaming mode.

XurxoMF , Mar 20th 2025 at 9:29 PM

I know what's happening there. I'll fix it on the next update.

To fix it just close and open the launcher again. AilurusHush

AilurusHush, Mar 20th 2025 at 8:06 PM

I was trying to log in and typed the wrong password - it gave me the warning that it was the wrong email/password - but now it's not letting me delete the text in any of the 3 fields.
Is there a way around this/a way to clear the fields?

XurxoMF , Mar 20th 2025 at 5:36 PM

I'll think about it on the future.

There will be an option to export installed mods as json to import them on another Installation or to send to a friend and install those mods with 1 click.

They'll also be compatible with MVL.

ManaWei

ManaWei, Mar 20th 2025 at 6:40 AM

The modupdater has a neat little feature that i make a good use of.. generating a PDF modlist of the mods installed..
You should make that a feature, generating a modlist for individual saves could be a thing.. if you already have that tho, i might just have missed it

XurxoMF , Mar 13th 2025 at 5:11 PM

I'm checking it... and there is no error at all... idk what's happening.

The failing mods are: plasterwashes-1.1.0, animalcages-3.2.1, hydrateordiedrate-1.9.8 and aloysiaslocustassembly-1.2.0

I tried downloading those and it works fine... the error on the files you shared is "nothing", literally "undefined"... I'll see if I find the issue.

Mollycoddle, Mar 13th 2025 at 2:53 AM
XurxoMF , Mar 12th 2025 at 1:51 PM

I'll chanhe it on the next update! I didn't thought about that but it's a true problem lol.

Thx a lot for reporting it.

EDIT: Can you send me the errors.log and debug.log from the C:/Users/YourName/AppData/Roaming/VSLauncher/Logs folder on Discord please? I want to check why it's failing downloads and fix it ^^

Mollycoddle

Mollycoddle, Mar 12th 2025 at 3:32 AM

Can you make it so that when updating mods, deleting the existing version comes after checking if the download was successful? As it is when something goes wrong I have to redownload the mod manually because the launcher just deletes the old version even if it fails.

XurxoMF , Mar 10th 2025 at 8:38 PM

The thing is VS Launcher uses the Electron base app so I can't add the .NET base app.

Also I can't use sdk-extensions, only modules...

Electron team is working on improving the flatpak compatibility but it'll take time.

DarkThoughts, Mar 10th 2025 at 8:16 PM

Th3Dilli

I'll be the one to bother then. :)

I think the launcher deserves some attention anyway.

XurxoMF , Mar 10th 2025 at 8:00 PM

DarkThoughts it's mantained by Th3Dilli if I don't remember wrong. I didn't wanted to bother them but it's not a bad idea. I'll ask him this days.

DarkThoughts, Mar 10th 2025 at 7:51 PM

XurxoMF

Btw, did you try asking the VS devs regarding the flatpak packing? I don't know which one of them maintains it but obviously for them the .net & openAL dependencies work fine. Maybe they can give you some pointers as to how to do it properly.

XurxoMF , Mar 5th 2025 at 2:11 PM

Mollycoddle please, join the Discord server https://discord.gg/RtWpYBRRUz and ping me @XurxoMF so I can help you. I can't check the moddb every 5 minutes to see if you asked something new ^^

Another option is to ask on the official Vintage Story server. Chekc the mods forum and look for the VS Launcher post. You can ask there too.

Mollycoddle, Mar 5th 2025 at 6:58 AM

I am trying to use this with an existing installation, have followed the instructions, but it doesn't want to work. Installing mods from this website only installs them in the original Vintagestorydata, AND opens the original game, not the installation selected. I have no idea what's going on, I just want to keep my damn mods.

XurxoMF , Mar 4th 2025 at 7:11 PM

Thx a lot ^^

I'll improve those things you commented on the next release. I've a few listed improvements.

Alindrome, Mar 4th 2025 at 6:58 PM

Wow, stunning interface! I'm really impressed with how smooth it feels, amazing job.

I have some minor suggestions:

  • Replace the text "Author didn't tagged it as compatible" -> "Author has not tagged this as compatible"
  • The icons for "Add a new installation" are really tiny so it's hard to make out what they do. The "Save" icon in particular threw me off for a bit because I thought it was a camera icon - Maybe consider using a plus symbol instead?

Also, it'd be really great to see a dropdown for 1.20.X format versions like there is on the mods webpage too :)

XurxoMF , Mar 2nd 2025 at 9:37 AM

Idk exactly how it'll behave, I didn't tested it. But on the Installation it should delete them and add the new ones. Not sure tho. About the Version... yes, you're right, it uses it to check if a mod version is compatible with your game version... you can install the same version you've with flatpak noty to use it but for VS Launcher to check updates.

DarkThoughts, Mar 1st 2025 at 9:03 PM

XurxoMF

Ah... I thought the Versions would be relevant for the mod versions to fetch the right ones but I guess I can just maintain a VS Launcher version that's the same version as the current flatpak version. In case you want to update the guide, the flatpak path for the data folder is: "/var/home/*****/.var/app/at.vintagestory.VintageStory/config/VintagestoryData"

Flatpaks have their own separate configs and are always a bit hidden away.

Edit: I deleted the old installation I used to paste my mods from my flatpak installation into for testing, but the folders for them, including the mods, are actualy all still there and I had to delete them manually.

XurxoMF , Mar 1st 2025 at 8:16 PM

You don't need to add the VS Version, just the VintagestoryData(Installation)... you should be able to find it at ~/.config/VintagestoryData I think... it's on the guide. You only need the version to play, and you'll not do that using VS Launcher so... DarkThoughts

DarkThoughts, Mar 1st 2025 at 7:57 PM

XurxoMF

No, I mean I cannot add the VS version for VS Launcher because of the flatpak version of VS being sandboxed in the flatpak folders. The path is something like "/var/lib/flatpak/app/at.vintagestory.VintageStory/current/active/files/extra" but it does not recognize the game version if I try to add that folder.

XurxoMF , Mar 1st 2025 at 7:49 PM

It should let you manage your mods. Not play Vintage Story using VS Launcher, for that use the flatpak Vinatage Story.

If you can't download mods neither it's strange... this only downloads the mod's zip like a browser...

DarkThoughts

DarkThoughts, Mar 1st 2025 at 7:02 PM

XurxoMF

That does not work with the Flatpak version.

XurxoMF , Mar 1st 2025 at 9:45 AM

Add the VintagestoryData folder to VS Launcher https://vsldocs.xurxomf.xyz/get-started/usage/game-client/vintage-story-is-already-installed

Then download, update or delete mods using VS Launcher and play using the flatpak install of Vintage Story. DarkThoughts

DarkThoughts, Feb 28th 2025 at 11:11 PM

XurxoMF

Syncing the mods folder from a VS Launcher instance with that of the regular / flatpak version of VS on immutable distros, so that we can update them easily from within VS Launcher.

XurxoMF , Feb 28th 2025 at 8:13 PM

What do you mean with sync both folders? The idea is to install the mods on the VintagestoryData folder directly. DarkThoughts

DarkThoughts, Feb 27th 2025 at 7:50 PM

I just did try to use a symlink to the VS Launcher Mods folder inside of the regular VintagestoryData folder, but unfortunately when trying to launch the Flatpak VS version the process crashes / exits before it even shows the client. So that workaround is unfortunately not possible for immutables either. Bummer. I guess you'd have to use something to sync both folders.

DeviousDoge, Feb 27th 2025 at 1:28 PM

I see. My bad for the silly question, thanks frens :D

DarkThoughts, Feb 27th 2025 at 11:27 AM

DeviousDoge

As said in an earlier comment, you can just copy the mods in your current VS mods folder and paste them into the new mods folder from your VS Launcher instance.

XurxoMF , Feb 27th 2025 at 7:11 AM

Thx a lot LeperLizard I hope you enjoy it! ❤️

XurxoMF , Feb 27th 2025 at 7:10 AM

https://vsldocs.xurxomf.xyz/get-started/usage/game-client/vintage-story-is-already-installed

That's the guide explaining how to import your already created installations and game versions to VS Launcher. Mods will be automatically loaded from the Mods folder(only those as .zip)

DeviousDoge

LeperLizard, Feb 27th 2025 at 4:19 AM

This is awesome, thanks for all the good work.

DeviousDoge, Feb 27th 2025 at 2:12 AM

I may be a blind moron here, but is there a way to import locally saved mods? I have ~150 in my VS install folder. I'd like to essentially migrate my "normal" VS install over to the launcher, retaining all of those mods, but from what it looks like importing of mods via that method is not possibly and I'd have to reDL them all via the launcher? Not a dealbreaker if so, just curious if I'm missing something here.

XurxoMF , Feb 27th 2025 at 12:46 AM

Cool suggestion. I'll change the mods one to Mod Version. The Version to Game Version is more complicated. I need to change it everywhere for that, even on other languages and the guide... id it's necesary I'll do it, if changing Mod Version is enough I'll keep it that way ^^

DarkThoughts, Feb 27th 2025 at 12:42 AM

Nice, seems to work well too so far!

Another minor suggestion: On the Install Mod prompt for the updates, change "Version" to "Mod Version" and "Versions" to "Game Versions". Otherwise it's a little confusing, especially if the mod has similar version numbering as the game.

Edit: Another thing I just saw. It creates a Logs as well as a logs folder, the latter only containing a main.log. If that's meant to go into the Logs folder I suggest to double check the case sensitivity in the code.

XurxoMF , Feb 27th 2025 at 12:42 AM

Error fixed on 1.3.2. Mods description will be released on the next version as I had the 1.3.2 already built and didn't wanted to delay an bug fixing important like this one for another 20-30 minutes.

The debug you sent is normal if there are no updated available.

XurxoMF , Feb 27th 2025 at 12:20 AM

Fixed on the 1.3.2 patch I'll upload in a minute. Abou the Mods page description... that's true... I'll fix it on the enxt update too.

DarkThoughts

DarkThoughts, Feb 27th 2025 at 12:10 AM

Unfortunately the new version just shows me a spinning icon when I go to the mod management of my installation. The info.log file indicates that it was succesfull though? I'll give the pastebin for it anyway.

https://pastebin.com/Rdr2iZK7

The debug.log only states one line, not sure if relevant, but it sounds like it just does not find an update for the launcher:

[2025-02-27 01:07:56.386] [debug] checkForUpdatesAndNotify called, downloadPromise is null

No error.log if I don't have the previously mentioned somewhat borked Handbook mod in the folder.

Also, the Mods button on the left says "Manage Installed Mods", but the page it leads to is for downloading mods, not those who are installed.

NarielV, Feb 24th 2025 at 8:44 AM

XurxoMF At least I got some good news for once been having a tough week cant wait to switch over.

Ragnarogk, Feb 23rd 2025 at 11:25 AM

O, ok, so with that method i can install watherver version i have locally, thanks XurxoMF

XurxoMF , Feb 22nd 2025 at 7:37 PM

Installing a version over that folder SHOULD not be a problem. It'll just add the downloaded filder on that folder but your saves and so on will still be there. Copy the Data folder somewhere, delete the version, copy the data folder there again and manually delete non-data files like assets, .exe...

I've guide on how to use VS Launcher to avoid this issues... the link to it is everywhere.

I'll try to improve the launcher to:

  1. Warn you if there are files on the folder you've selected.
  2. Check if VS is already installed and automactally add it to VS Launcher.

glism

glism, Feb 22nd 2025 at 6:00 PM

I think I messed up bad - does VS Launcher store the original \AppData\Roaming\VintagestoryData\ anywhere? I chose it as the installation path under "versions" as I assumed it would autopopulate with my save. I do see the "add installation" now.

A little feedback - it's tough to notice, especially since it's more likely that users have VS already installed before downloading this launcher. 

 

I fear I may have lost my world and current save :(

Any help appreciated! Thanks

 

edit: was able to restore from a windows backup of the folder from about 10 hours of game time prior -- much better than nothing!

XurxoMF , Feb 21st 2025 at 2:49 PM

I've not added that version to the launcher. I'll only add some pre, some rc and all the stables. I don't have enough storage for all the version on the server xD

I'll probably keep all the patches from the current and past version(1.19.0-1.19.8 and 1.20.0-1.20.X) and the last patch from older versions.

If you need to install a version that's not listed on the launcher you can download if on the official VS website aka Client Area, install it/extract it if it's a tarball and add it to the launcher with the 🔍 button on the Versions page

Ragnarogk

Ragnarogk, Feb 21st 2025 at 12:36 PM

I cant find how to install 1.20.4 rc versions. I can see it in the mod filters but not when adding a version

XurxoMF , Feb 21st 2025 at 11:57 AM

When you install VS using flatpak this one will be downloaded on a different folder.

I'm not really sure where, I suppose the same as VS Launcher with flatpak.

Check it it's at /home/username/.var/app/at.anegostudios.vintagestory or something like that.

It's not a good option to add a flatpak installed VS copy to VS Launcher. Flatpak will update VS when there is a new release and VS Launcher will not register that change.

TigerStars

TigerStars, Feb 21st 2025 at 9:24 AM

So I have VS installed through flatpak for simplicity, but now I can't figure out how to use this launcher and find the folder with the version I have. The instructions don't seem to help since it was installed through a package manager and I didn't have to extract a .tat.gz file. I've spent the last few days trying to figure it out to no avail. I even tried to download VS manually, but I'm having a hard time figuring that out. I'm not sure if this because I'm still a linux newbie and need some guidance or if they're incompatible with one being flatpak and the other an appimage. Either way, any help will be greatly appreciated :)

XurxoMF , Feb 20th 2025 at 11:12 PM

It's already planned. That's part of the automatic mod updater udpate. But this feature will be experimental. I've no way to check dependencies of mods, compatibility between them and so on...

actuallyasriel, Feb 20th 2025 at 6:30 PM

I like this a lot, it's clean and easy to use. One suggestion though; the mod update functionality is a little fiddly as it stands. A single button to update all mods would help a lot.

XurxoMF , Feb 19th 2025 at 2:01 PM

Ohhhh, ok, then it should be possible. I'll try to do so this week.

DarkThoughts, Feb 18th 2025 at 10:34 PM

XurxoMF

I've meant alphabetical order for the installed mods, not the mod list from the moddb. Right now it's hard to find a specific installed mod because it seems all kinda randomly ordered and when you have 100+ mods it gets very messy.

XurxoMF , Feb 18th 2025 at 7:34 PM

❤️

TRexTheHunter, Feb 18th 2025 at 7:21 PM

There is a MOD funcitonality everyone!!! Thanks XurxoMF !!!

XurxoMF , Feb 18th 2025 at 7:10 PM

Yes, if a key is not translated on the language you've selected it'll use the EN one. CZ it currently translated at 0%. The user that translated 0.0.1 version dissapeared. I had to change all the keys on 1.0.0 and nobody translated it again. Same for RU.

DejFidOFF

DejFidOFF, Feb 18th 2025 at 7:01 PM

XurxoMF

There is EN translation when switch to CZ (cs) translation

XurxoMF , Feb 18th 2025 at 6:53 PM

It'll remove the zip of the old version if the modid on the modinfo.json matches.

About the alphabetical order... I'll check if I can easily do that bc the ModDB offers no sorting option for that and making a sorting method for only 1 order type will requeire a lot of changes. Maybe on the future.

About the order by update available... yes, it's part of the automatic updates. For now on you can sort them by updated date. I've to implement a few little things before the automatic updates update tho.

Some users with advanced knoledge about Flatpak and Linux have suggested and are helping me with the dependency issues. If we manage to get it working I'll add it to the official .flatpak (and upload it to flathub).
The problem here is... those users that are helping me discovered a possible way to add .NET but I think there is no option for mono-complete and OpenAL... we'll check it out.

DarkThoughts, Feb 18th 2025 at 6:36 PM

No worries. I'd also suggest sorting mods alphabetically, or give sorting options including one for mods that have updates available (which should of course also be visually represented but I'm sure that's already on the roadmap). On a positive note, after pasting my regular VS instance mods over into the one from the launcher, and updated one of them, it flawlessly replaced the old one despite the name differences. I was half expecting it to just download a second copy while keeping the old version.

I didn't test it yet, but I think what could be done by immutable Linux users is to do the above and then do a symlink for that folder and put it into the regular VS Data folder. I think that should work so that the regular installation recognizes the mods there and then you can use the launcher for easier mod updating.

XurxoMF , Feb 18th 2025 at 6:12 PM

Yes, that mods zip is corruped or malformed. It's missing leading data making it impossible to read using yauzl.

That list was a fast implementation to fix issues, I'll change styles later ^^

DarkThoughts, Feb 18th 2025 at 5:39 PM

https://mods.vintagestory.at/improvedhandbookrecipes

This one is shown as a faulty mod now, I think. I assume it's the mods at the top with the slightly larger spacing between the following mods. Probably warrants a bit beter separation between that & installed mods.

XurxoMF , Feb 18th 2025 at 2:18 PM

I'm already working on a fix. Some mods have invalid key names, character and things like that and they are breaking everything.

About the zip file name, yes, the name will be <modid>-<version>... always, to prevent errors.

Thx for letting me know the mods that are breaking everything

DarkThoughts

DarkThoughts, Feb 18th 2025 at 12:58 PM

XurxoMF

Yeah I heard on the Mod Updater page the Cairns mod had an invalid one. Would definitely be nice if users could easily identify such problematic mods.

Definitely good stuff about the mod detection though. I wanted to move away from the Flatpak version since the Flathub updates tend to lag behind a couple of days most times.

Edit: I did just notice that the filenames for Primitive Survival, which I downloaded from within the launcher as a test, is different than the manually downloaded one though. The one in the launcher separates with a - while the manual one uses a _.

Edit: And when I go to installations and click on manage mods, it says "No Mods Found", even though I still got the Primitive Survival version from the launcher?

Edit: Okay, it seems certain mods break the mod page - even if you download them through the Launcher. Two I found so far are Ancient Tools & Real Grapes. Once you install them, they break the mod page until you remove them manually.

XurxoMF , Feb 17th 2025 at 11:14 PM

You can copy-paste them or download them from the ModDB directly too. VS Launcher will read the modinfo.json and use that info as you said.

Thx a lot for the suggestion with the image link. I'll change it to a button on the bottom of the mod when you hover it.

About the automatic selection... yes, I thought the same while using the launcher. The next update will be an small feature polish and I'll add a few little new things. I'll change all those things this week ^^

I also want to improve mod detection bc some mods with invalid modinfo.json and corrupted .zip file will not be detected so you can't automatically update them clicking install on a newer version for example.

DarkThoughts

DarkThoughts, Feb 17th 2025 at 9:27 PM

Yeah, unfortunate with the dependency.

Regarding the mods though, can I just copypaste my regular VS flatpak installation's mod folder into the one from a VS Launcher installation? I'd assume the launcher just cross references the modinfo.json with what's on the moddb? Or do I need to manually download each mod individually for it to properly recognize it for future updates?

Also, the mod installation from within the launcher felt a bit unintuitive with having to click on the bottom part of the mouse over description while the thumbnail opens up the mod page instead. To me at least it was not really clear without having to look at the video that the bottom part opens the version picker for the installation.

I also think, since you cannot deselect an installation in the bottom left, that it should probably autoselect the first one after you create it, instead of having to do that manually.

XurxoMF , Feb 17th 2025 at 5:52 PM

New update released. Sadly the flatpak issue on immutable distros is not fixed. I couldn't add .NET as dependency. I'll keep trying.

XurxoMF , Feb 16th 2025 at 11:34 AM

I'm already aware of that issue. I'm trying to add .NET to flatpak for Vintage Story to work with it but I'm having a hard time doing so... there is no official way to do it or at least I can't find it.

I'll keep trying. If I find a way to fix it I'll update the flatpak.

NarielV

NarielV, Feb 14th 2025 at 5:25 PM

XurxoMF im unable to start Vintage story i get no errors i just doesnt do anything outside of downloading the version. this is for flatpak.

XurxoMF , Feb 14th 2025 at 5:25 PM

I want to test a few things with the current flatpak to add dependencies so they get automatically installed with VS Launcher.

Once this is done I'll upload it to flathub so I can add the new updates when I release them ^^

Thanks a lot tho ❤️ NarielV

I'll try to have the mods update + flatpak++ + flathub upload this weekend

Junrall, Feb 4th 2025 at 12:19 AM

This will be very useful to those who want to easily sperate their modding and game play enviroments.

Once you have the mod page implemented, I'll be all over this! Looks good so far!

XurxoMF , Feb 3rd 2025 at 9:31 PM

Flatpak and DEB ready! Download them on GitHub realeases. https://vsldocs.xurxomf.xyz/get-started/installation

 

XurxoMF , Feb 1st 2025 at 10:07 AM

MacOS build will not be available for now on. I'm having a lot of problems with the VM and I can't do anything.

.flatpak and .deb have to be tested first and I can't make sure those will work. I'll try to make at least the .flatpak.

This weekend I'll post the v1.1.1 with a few small changes, most of them only visual.

The next week I'll start with the Mod Manager Update. First I'll add the manual manager to install, remove and update mods manually and after that I'll make the automatic mod updater. This one will be hard as fuck bc most mods are not properly updated like mods from the 1.18.X are working on the 1.20.X so.... idk how I'll do that.

 

NarielV, Jan 31st 2025 at 11:02 PM

@XurxoMF Awesome cant wait would make handling modpacks so much easier.

XurxoMF , Jan 26th 2025 at 12:17 PM

I'll try to make the .deb and .flatpak this week. If I can I'll upload them on the same release.

I'll also try to port it to MacOS. It should not take too much time.

 

XurxoMF , Jan 21st 2025 at 3:38 PM

TRexTheHunter thx a lot for your feedback! I'll answer your questions one by one:

  1. Game versions are downloading from my server bc VS Launcher uses .zip files to make installation as transparent ans possible so users don't have to do anyting, just press the install button. Official servers do not server .zip files, only .exe and .tar.gz + there is no API to get game versions and download files.
  2. Mods will download from the official ModDB as there is an API to get mods, versions, download links... there is no need to host them on my own server.
  3. I choosed those names to make it as similar as possible to other launchers. Versions are, literally, game versions... 1.19.8. 1.20.1... and installations is the term used on some Minecraft launchers for example to talk about different "instances" of the game. Maybe there is a better option but it'll not matter the term you use there will be someone than will prefer another ones or will get lost so... you've to learn how to use each app you download, I'll make it as easy as I can, but I can't make it perfect for everyone. If you have any suggestion let me know!
  4. The "I have already installed VS and want to use this software" and "I am starting clean and fresh, have no installs of VS and want this software to handle everything" it's a cool idea! I'll add anm index at the top of the guide with a little explanation and link to the exact videos.
  5. Once you've added an installation it'll automatically detect the installed mods, mod versions and so on (from the /Mods folder). If you install a new one(from the moddb website like always or from the VS Launcher mods tab) it'll automatically detect it.
  6. Right now I'm working on the Backups Update. Manual and automatic backups of your installations(worlds, mods, configs...). Once this one is done, I hope this week, I'll start with the basic Mod Manager update(mods tab, mod download, manual mod updates...) and once that's done I'll make the automatic mod updater.
  7. MP servers will work similar to SP installations but all-in-one. Each server will use it's own "version+installation" so you can run multiple servers with the same version at the same time. There will be a tab called Servers where you'll be able to install a new server on the version you want, configure it and then run it with a simple play button. You'll also be able to install mods on it, make backups, autoupdate mods before starting...

Again, thx a lot for the feedback and let me know how you'll name the versions and installations... if it's a good change I'll look into it ^^

 

TRexTheHunter, Jan 21st 2025 at 2:40 PM

A couple of comments so far in terms of UI and also current&future functionality of the software itself. 

I was wondering why its not querying the game updates from the VS servers, but looking for the update on your host? (Ie SalazarWindriver, Dec 27th 2024 at 4:57 PM Post)

If there is a plan to have the mods also update, would the mods have to be hosted on your personal server as well?

As of the terms used in the UI, i find it a bit confusing that "version" is used to indicate the game folder and that "installation" is used for your data folder. I'm not sure what your other translator came up with (I'm FR/EN) and wondering if you are open to suggestions. I think some people would think that the "installation" folder would be the game folder and not the data folder ( \VintageStoryData ) .

In terms of setting up the game via the videos, its quite helpfull, but you could have two options from the get go for first time users. One could be "I have already installed VS and want to use this software" and then the UI will lead you to a path with the proper videos and written documentation and buttons to click and the second one could be "I am starting clean and fresh and have no installs of VS (and mods - in the future) and want this software to handle everything". 

I imagine also that Mods would be another layer to your software and have similar UI feedback on if you already have mods installed, or if your software will offer to handle it and do the version checking and automatic install.

Looking good! Hoping you are working on mod version checking and auto download soon! Its something I keep hearing on Twitch. Also looking forward how you will handle MP servers in the future! Thanks.

XurxoMF , Jan 19th 2025 at 7:11 PM

It is I think, or maybe not idk. I can create a Flatpack but I can only upload it to GitHub for now on. It'll not be uploaded to Flathub so if you're using this one to get updates... it'll not work. NarielV

I'll try to upload it to Flathub but idk if I can.

NarielV, Jan 19th 2025 at 7:02 PM

XurxoMF That isnt an issue I have automatic updates on my Software Center

XurxoMF , Jan 19th 2025 at 9:29 AM

NarielV I can make a Flatpak and DEB compilation but Automatic Updates will not work on those. You'll have to manually update the launcher to newer versions.

I'll finish the Backups Update and upload a new version with Flatpak and DEB packages.

I'll also try to get it working on MacOS and upload a MacOS build if I can.

NarielV, Jan 18th 2025 at 12:51 PM

I play on Bazzite Linux on a handheld PC any chance for you to make a Flatpak install?

XurxoMF , Dec 27th 2024 at 5:28 PM

Oh shi... I forgot to upload it. Sorry.

The Launcher doesn't load the versions from the official server but my server as it uses a .zip and official site doesn't serve those.

I'll upload it in a few minutes dw. SalazarWindriver

SalazarWindriver, Dec 27th 2024 at 4:57 PM

It doesn't seem to show the newest version of 1.20 to download.

XurxoMF , Dec 22nd 2024 at 4:38 PM

I'll check that out, it sounds like a cool adition ^^

Trubbel, Dec 21st 2024 at 6:48 AM

Command line arguments for the client, not the launcher ( --openworld or --connect would be ideal for different installs)

DarkThoughts, Dec 20th 2024 at 5:54 PM

PonyVStudios That tool does not work unfortunately, just throws out SSL errors for every single mod.

XurxoMF , Dec 20th 2024 at 3:44 PM

SalazarWindriver not rn but some users already reported that so I'll fix it on the next update. It'll remember the last used directory for new installations and versions.

Trubbel examples?

SalazarWindriver, Dec 20th 2024 at 11:15 AM

is there a way to set it up so it always tries to install to a different location?  I keep my games on a second drive but it keeps defaulting to my C drive.  It would be nice to be able to point to an instance folder and have each install create a version folder at that location to install. 

Trubbel, Dec 18th 2024 at 11:21 PM

Any support for command line arguments upcoming? 

AzuliBluespots, Dec 18th 2024 at 6:38 PM

Moshugan
I posted some time ago on the forums instructions on how to check what version you have installed, and how to install .net7 - did you see that? Might help you.

coldwind81, Dec 18th 2024 at 6:27 PM

THANK YOU.

XurxoMF , Dec 18th 2024 at 3:12 PM

I wanted to... but I can't. Linux has a lot of different distros and, of course, installation process and support is completely different for each distro so I can't do it.

I'm planning on do it automatic on Debian distos like Ubuntu, Linux Mint... and some others like Arch Linux bc those are used by almost everyone, but I can't make it work on every distro, sorry ;-;

Moshugan

Moshugan, Dec 18th 2024 at 2:48 PM

Will this help with installing .NET 7 as well as the game? I've had a really hard time finding a way to install .NET 7 to Linux Bazzite.

XurxoMF , Dec 18th 2024 at 9:19 AM

Mod management will be the second biggest feature of VS Launcher.

The auto-update feature is something I already thought about and I want to implement it but it'll take time. This si the readmap for the mod management:

  1. List and search mods. (Mods page)
  2. Install mods. (Mod page)
  3. Uninstall mods. (I'm not sure where I'll add this)
  4. Update mods. (Manually, if you install a new version the old one will be removed)
  5. Save mods as favourite. (This ones will be shown at the top of the Mods page)
  6. Update mods automátically with a button. (Check for mod updates on a Installation and update them if there is a newer version compatible)
  7. ...

I'll try to have points 1, 2, 3, 4 and 5 working and released as alpha this year. 6, 7... will be done on January.

DarkThoughts TRexTheHunter

TRexTheHunter, Dec 17th 2024 at 10:25 PM

Good suggestion! I would gladly pay for this (or donate) to make it happen! DarkThoughts

DarkThoughts, Dec 17th 2024 at 10:08 PM

Do you plan on adding mod update management too? Because I have not played for a while and the mod page here is such a mess, because I just have 362 notifications, and rising, because it does notify you for every single version release, making it an absolute pain to update mod.

XurxoMF , Dec 11th 2024 at 1:55 PM

McJty I'm working on a Linux build. I'll try to have it working and published this weekend ^^

McJty, Dec 11th 2024 at 5:28 AM

Does this support Linux?

XurxoMF , Dec 10th 2024 at 9:46 PM

I want to release it before christmas so... 1 or 2 weeks I hope Tarbrough ^^

Tarbrough, Dec 10th 2024 at 9:36 PM

A fantastic Idea! I look forward to seeing it develop. Can't wait for the mod part however~

XurxoMF , Dec 10th 2024 at 1:23 PM

The first part, version recognition, I'll add a buton to look for an installed version so you can add it and not install it again

About the second part, when you create an installarion you can select the folder where your data was and play with that one.

You can only have one session ar the same time so if you login on another installation you'll have to login again of course. That happend without the launcher too.

DejFidOFF, Dec 10th 2024 at 9:18 AM

Program did not respect ( can´t add installed games before launcher ) and did not respect my mods directory / Vintagestorydata/mods. And of course after reinstall need to login again..

XurxoMF , Dec 10th 2024 at 1:08 AM

Hiii, I've answered on github ^^

Thx for letting me know you like it. If you want you can let me know the features you'ld like to see and I'll check them out and see what I can do ^^

techy, Dec 10th 2024 at 12:45 AM

I love this approach. It's a great way to handle some of the common issues with managing mods and maybe in the future some other things like play styles and other configs the main menu doesn't give us a way to manage today. I added  a couple of notes on github too for tech stuff. But i just wanted to say thank you for creating this here!

XurxoMF , Dec 9th 2024 at 11:45 PM

I'll add a little guide on the description to download it.

The warning message is because I've not trust certificate, it costs like 400€ to 500€ so I can't pay it lol

XurxoMF , Dec 9th 2024 at 10:52 PM

DejFidOFF I'm open to suggestions. Let me know what you think that couls be improved and I'll check it ^^

DejFidOFF, Dec 9th 2024 at 10:48 PM

good start, but need to work on that..