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

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.

XurxoMF

thank you

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.

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

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

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

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...

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.)

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

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.

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

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. 

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

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 ?

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 😥

ZippyWonderdust

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

XurxoMF

Maybe it's worth mentioning?

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.

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

XurxoMF Windows 11, 64 bit

What's your operating system? CoffeeToffee

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.

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

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

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

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.

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

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.

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

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?

Thanks a lot ❤️

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

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

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

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

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

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.

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.

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.

i would like an option to disable the launchers auto update

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

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

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 ^^

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.

Hello,

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

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

thanks again for this great launcher

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

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.

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

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.

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

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.

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

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.

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

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?

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

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

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.

XurxoMF I put them in pastebin.

https://pastebin.com/JyA8MG5A

https://pastebin.com/0qBn0xXb

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

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.

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.

Th3Dilli

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

I think the launcher deserves some attention anyway.

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.

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.

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.

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.

Thx a lot ^^

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

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 :)

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.

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.

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

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.

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

XurxoMF

That does not work with the Flatpak version.

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

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.

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

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.

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

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.

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

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

This is awesome, thanks for all the good work.

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.

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 ^^

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.

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.

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

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.

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

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

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

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!

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

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

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

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 :)

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...

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.

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

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.

❤️

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

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

XurxoMF

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

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.

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.

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 ^^

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.

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

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.

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

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.

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

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

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.

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

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!

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

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.

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

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.

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 ^^

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.

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.

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

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.

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

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

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

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

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

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

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?

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. 

Any support for command line arguments upcoming? 

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.

THANK YOU.

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

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.

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

DarkThoughts https://mods.vintagestory.at/modsupdater
https://mods.vintagestory.at/modsupdaterforlinux

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

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.

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

Does this support Linux?

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

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

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.

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..

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 ^^

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!

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

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

good start, but need to work on that..