Mods / Waxlight Launcher

Tags:
User interface UI
Authors:
AmadoMuerte, gasada
Side:
Both
Created:
Aug 3rd at 2:52 AM
Last modified:
9 hours ago
Downloads:
256
For testers:
waxlight-0.3.7.zip

Vintage Story Launcher

Waxlight Launcher

Manage game versions, mods, accounts and isolated setups from one launcher — without rebuilding folders by hand.

Linux & Windows Multiple instances Integrated mods Backups & recovery
Your setups stay separate

Independent Instances

Keep vanilla, multiplayer, modded and experimental setups isolated. Each instance has its own version, mods, config, account and launch settings.

Undo bad changes

Backups & Smart Recovery

Create snapshots manually or let Waxlight protect an instance before important changes. After a failed launch, restore the last working setup.

No manual archives

Integrated Mod Manager

Search, inspect, download, install, enable, disable and remove mods directly in Waxlight. Required dependencies can be installed automatically.

Build modpacks faster

Batch Mod Installation

Select multiple mods and install them together into an existing or new instance instead of repeating the same flow one mod at a time.

Keep old and new versions

Game Version Management

Install different Vintage Story releases side by side and assign the version you need to each instance.

Your disk, your choice

Custom Data Location

Choose where Waxlight stores game versions, mods and instance data — useful for secondary drives and small system disks.

Accounts
Multiple accounts

Choose the right Vintage Story account for each instance.

Statistics
Playtime & launches

Track playtime per instance, total playtime and recent sessions.

Maintenance
Mod cache cleanup

Remove unused downloaded mod files and reclaim disk space.

Updates
Stable & Prerelease

Choose between stable builds and the newest prerelease features.

Simple by design

From install to play, without the folder mess

Waxlight keeps the boring setup work out of the way. Build an isolated game setup, add what you need and launch it from one place.

⚡ Ready in a few steps
01
+

Create an instance

Give your setup a name and keep its game files, mods, config and account isolated from everything else.

02
VS

Pick a game version

Install and switch Vintage Story versions without replacing your main game installation or rebuilding folders manually.

03
◆

Add your mods

Search, install and manage mods directly in Waxlight, including dependencies and batch installation.

04
▶

Launch & keep playing

Start the game, track playtime and use backups or recovery if an update or mod change breaks your setup.

No manual folder juggling Separate modded setups Easy rollback Built for Linux & Windows

Download Waxlight

Get the latest Linux or Windows build from GitHub Releases.

Download latest release

Support Development

If Waxlight saves you time, you can support continued development with a small tip.

Open source: GitHub10 interface languagesIndependent community project; not affiliated with Vintage Story developers.

Mod Version Downloads Released Changelog Download
0.3.7 10 9 hours ago waxlight-0.3.7.zip

What's Changed

  • Fixed a critical startup issue that caused Waxlight to get stuck on the loading screen for some users after updating from previous versions.

Full Changelog: v0.3.6...v0.3.7

0.3.6 22 21 hours ago Release Retracted

Retraction Reason:

Errors when opening the launcher for older users

Changelog:

What's New
⚡ Optimum Support — Waxlight can now launch instances using an existing Optimum installation. Optimum can be detected automatically or selected manually, and Waxlight checks that it matches the Vintage Story version used by the instance before launching.
🎮 Per-Instance Game Client — individual instances can now use either the standard Vintage Story client or Optimum while keeping the same mods, saves, settings and launch arguments. Existing instances continue using Vanilla by default.
🪟 Fixed Windows Installation Cancellation — cancelling a Vintage Story installation on Windows now correctly stops the installer process instead of potentially leaving it running in the background.
🐛 Various fixes and stability improvements.

0.3.5 34 3 days ago waxlight-0.3.5.zip

Waxlight Launcher v0.3.5

What's New

🌐 Public Server Browser
Browse public Vintage Story servers directly in Waxlight, view details, save favorites, and connect using any instance.

❤️ Favorite Servers
Save servers together with your preferred instance for quick reconnects.

🖱️ Mouse Back/Forward Navigation
Side mouse buttons now work throughout the launcher for easier navigation.

🔑 Improved Credential Store Handling
Waxlight no longer becomes unusable when the system credential store is locked or unavailable. It can start normally and retry access later.

📦 Better Instance Package Imports
Imports now appear in Operations with live progress and can be cancelled safely.

🐛 Fixes & Stability Improvements
Various fixes for mods, imports, launching, and general launcher stability.

Enjoy the game! ❤️

Code Signing

Windows builds are currently unsigned.

See the Waxlight Code Signing Policy for verification information.

0.3.4 41 Aug 9th at 11:21 AM waxlight-0.3.4.zip

✨ What's New

💾 Instance Backups
Create and restore snapshots of your instances.

🛡️ Automatic Safety Backups
Waxlight creates restore points before important changes.

🔄 Smart Recovery
Restore the last working setup after a failed game launch.

📦 Batch Mod Installation
Install multiple mods at once into a new or existing instance.

🧹 Mod Cache Cleanup
Remove unused mod files and free up disk space.

🐛 Better Error Reporting
Improved crash detection and troubleshooting.

✨ Plus various fixes and stability improvements.

0.3.3 28 Aug 7th at 5:42 PM waxlight-0.3.3.zip

What's Changed

0.3.0 25 Aug 6th at 2:03 PM waxlight-0.3.0.zip

Waxlight Launcher 0.3.0

A major update focused on instance management, mod updates, and data portability.

What’s New

  • Added support for choosing and safely moving the launcher data directory.

  • Added instance import and export using .waxlight packages.

  • Added instance cloning.

  • Добавлено автоматическое обнаружение и установка обновлений модов.

  • Добавлена фильтрация по тегам ModDB в каталог модов.

  • Добавлены локализованные имена по умолчанию для новых экземпляров.

  • Улучшены журналы запуска и информация для устранения неполадок.

  • Исправлена ошибка при открытии каталогов экземпляров в системном файловом менеджере.

  • Улучшен интерфейс обновления модов и общая стабильность.

  • Добавлены дополнительные проверки безопасности для импортируемых и экспортируемых данных экземпляров.

Full Changelog: v0.2.1...v0.3.0

0.2.1 8 Aug 6th at 2:19 AM Release Retracted

Retraction Reason:

deprecated

Changelog:

- Fix linux auto update

- UI improvement

0.2.0 10 Aug 5th at 3:49 PM Release Retracted

Retraction Reason:

deprecated

Changelog:

What’s New

 

  • Added support for 10 interface languages.

  • Added automatic launcher updates with Stable and Prerelease channels.

  • Added automatic installation of required mod dependencies.

  • Fixed manually installed mods not appearing in the instance mod directory.

  • Fixed mod descriptions disappearing from the mod list after filtering.

  • Improved Windows update reliability and security.

  • Fixed Linux credential storage integration.

  • Added proper application icons for Linux and Windows builds.

  • Improved settings persistence, release builds, and overall stability.


    Please create an issue for every bug you find.

0.1.4 49 Aug 3rd at 8:53 PM Release Retracted

Retraction Reason:

deprecated

Changelog:

What's Changed

  • Added full internationalization support using i18next.

  • Added Russian interface translation.

  • Added language selection in Settings with instant switching.

  • The selected language is now saved and restored after restart.

  • Added separate English and Russian README files.

  • Added translation validation and documentation for contributors.

  • Removed hardcoded interface text and prepared the project for adding more languages.

0.1.3 24 Aug 3rd at 1:22 PM Release Retracted

Retraction Reason:

deprecated

Changelog:

Waxlight Launcher 0.1.3

  • Improved Vintage Story authentication response handling.
  • Added safer authentication diagnostics without exposing sensitive data.
  • Fixed Windows SQLite support by enabling CGO in release builds.
  • Fixed automatic Linux and Windows builds in GitHub Actions.
  • Added automated cross-platform release packaging and checksums.
  • Improved release checks, tests and vulnerability scanning.
0.1.2 Aug 3rd at 3:03 AM Release Retracted

Retraction Reason:

no work version

Changelog:

The first public release of Waxlight Launcher, a modern launcher for Vintage Story.

  • Create and manage separate game instances.
  • Search for and install mods directly from the launcher.
  • Support for multiple accounts with quick switching.
  • Select game versions and configure individual launch settings.
  • Track playtime for each instance and overall.
  • Support for Windows and Linux.
  • Improved interface and various bug fixes.

Waxlight Launcher is under active development, with more features and improvements planned for future releases.

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

ProrokFYNTK, 6 days ago

Hello, some feedback: it would be very helpful to be able to open the folder of a selected instance, from within the launcher, for example to change something in the mod config folder.

I have not found any option in the launcher that would let me open instance folder, nor the mod config folder, and finding the right folder manually inside appdata/roaming/waxlight proved to be difficult, because instance folders seem to be named with hex sequence 

ProrokFYNTK, 6 days ago (modified 6 days ago)
@gasada: Hi.In the current version of the launcher, you need to select a instance and click the "Open Directory" button.

Hey, I just noticed that, no idea how I missed it LOL.
Anyway thank you!

Getsune, Aug 9th at 1:39 PM

Any chance to add a checkmark to updating mod? some mods have 2 versions that add, change or disable features the ability to choice what to update would be great, also update mods from the mod tab can be useful,  amazing mod so far works great on linux but i had to install dotnet runtime to make it launch the game.

og_dexto, Aug 9th at 12:12 PM

I haven't tried this mod yet, but this idea has been in my head as something I hope the devs will add, a mod and version managing launcher. 

This is very brilliant and I love that you are working on this. Thank you!

AmadoMuerte , Aug 9th at 12:45 PM
@og_dexto: I haven't tried this mod yet, but this idea has been in my head as something I hope the devs will add, a mod and version managing launcher. This is very brilliant and I love that you are working on this. Thank you!

Thank you so much! ❤️
That’s exactly what I’m aiming for with Waxlight — making mod and version management as simple and convenient as possible. There’s still a lot I want to improve, so feedback like this really means a lot!

Calminaion, Aug 8th at 7:05 AM

Really like the design and has good features. One issue I am having is I am using the portable version, it loaded fine at first but now I can only get it open bu using run as admin.

2026-08-08 08:00:45.129 | WARN  | credential store write failed error=Not enough memory resources are available to process this command.
2026-08-08 08:00:45.130 | ERROR | Failed to bootstrap the launcher error=native credential store is unavailable or locked; unlock it and retry: credential store unavailable: native credential store operation failed

AmadoMuerte , Aug 8th at 7:41 AM
@Calminaion: Really like the design and has good features. One issue I am having is I am using the portable version, it loaded fine at first but now I can only get it open bu using run as admin.2026-08-08 08:00:45.129 | WARN | credential store write failed error=Not e

This looks like an issue with Windows Credential Manager rather than Waxlight itself. It may be full or temporarily unavailable.

Could you try running in powershell:
cmdkey /generic:WaxlightCredentialTest /user:test /pass:test

If you get the same “Not enough memory resources” error, please check Control Panel → Credential Manager → Windows Credentials and remove any old/unnecessary credentials, then restart Windows and try Waxlight again

rhino1998, Aug 7th at 4:30 PM

Can the mod list game version selector also have a relaxed setting (IE 1.22.x instead of specifically 1.22.6)?

ElizTriad, Aug 7th at 12:14 AM (modified Aug 7th at 12:15 AM)

The launcher looks promising!
Can you make mods manually added to the catalog be detected as downloaded and allow them to be updated through the launcher?
And import all mods from a specific catalog at once.

gasada, Aug 7th at 1:03 AM
@ElizTriad: The launcher looks promising!Can you make mods manually added to the catalog be detected as downloaded and allow them to be updated through the launcher?And import all mods from a specific catalog at once.

Thanks, we're really glad you like it!

That's a good idea. we'll try to implement it soon.

We'll work on making it easier to download multiple mods in the launcher.

The ability to export and import modpacks has already been implemented.

Giffel, Aug 6th at 2:44 PM


Slight issue. You can't press download if the list of versions a mod supports is too long.

gasada, Aug 6th at 4:28 PM
@Giffel: Slight issue. You can't press download if the list of versions a mod supports is too long.

We’ve fixed the issue, and the fix will be included in the next update, which should be available soon.

Thank you for using our launcher and helping us make it better!)

GamerGoblin, Aug 6th at 1:24 AM

Not sure whats going on - just downloaded a single mod, and now it will not let me download any more through the browser. Any way I can get the logs for you for that?

AmadoMuerte , Aug 6th at 2:15 AM
@AmadoMuerte: Do you mean one-click installation via the browser?

I doubt it will work correctly via the launcher; the launcher has its own mod catalog with a download feature for that purpose.

Giffel, Aug 6th at 9:45 PM (modified Aug 6th at 9:48 PM)
@AmadoMuerte: I doubt it will work correctly via the launcher; the launcher has its own mod catalog with a download feature for that purpose.

I think this is what he is talking about. Some mods simply cannot be downloaded.

Also doesn't download "Forgotten Armory: Chinese Dynasties". Those are the two i have found.

gasada, Aug 7th at 1:24 AM (modified Aug 7th at 10:16 PM)
@Giffel: I think this is what he is talking about. Some mods simply cannot be downloaded.Also doesn't download "Forgotten Armory: Chinese Dynasties". Those are the two i have found.

Thank you for reporting this issue

This bug is currently being fixed

upd: fixed

Ultirian, Aug 5th at 11:07 AM (modified Aug 5th at 11:11 AM)

Would it be possible to make a portable version that doesn't require installation in the (C:) AppData folder? Or maybe options to adjust directory creation and download location. I couldn't find a way to switch the directory structure when generating a copied instance.

I typically try and keep as little on my c-drive as possible, so I have my modding setup on a seperate External Drive where I manage all of the different modded games I play, including modded instances. I don't even install my games or save downloads onto my c-drive and have another dedicated External HD seperate from my Modding Files. Storing the copied instances onto the c-drive currently seperates it from my whole setup with no way to adjust it, sadly, and a concern I had is that it could eventually clog up the main drive depending on how many instances a player generates, especially if that person is already modding other games and doesn't manage their files or file structure well.

I love the design and aesthetic of the Program though, so I'm looking forward to seeing more! :D

Endrid, Aug 5th at 1:25 PM
@Ultirian: Would it be possible to make a portable version that doesn't require installation in the (C:) AppData folder? Or maybe options to adjust directory creation and download location. I couldn't find a way to switch the directory structure when generating a co

I would like to 2nd this feature request of being able to change the install location or have it be portable, as well as being able to change the data destination of a modded instance.

Endrid, Aug 5th at 1:52 PM
@Endrid: I would like to 2nd this feature request of being able to change the install location or have it be portable, as well as being able to change the data destination of a modded instance.

Okay, another request. The ability to have it use an existing Vintage Story install would be nice. I can't seem to find a way to select one that I already have, only download or install from file.

AmadoMuerte , Aug 5th at 2:12 PM (modified Aug 5th at 2:16 PM)
@Endrid: Okay, another request. The ability to have it use an existing Vintage Story install would be nice. I can't seem to find a way to select one that I already have, only download or install from file.

Hey, i’ve seen your requests, and they will be implemented in the future. Regarding versions, you can upload a version via the "Versions" tab, or simply zip your game directory and submit that as a version. However, a major update is coming soon that will fix a lot of things, so I think it might be worth waiting for that release.

Ultirian, 4 days ago
@AmadoMuerte: The latest update added a feature to change the location of the launcher's data.

Thank you! It works into my setup much better now! I'm definitely enjoying it so far! :D 

AmadoMuerte , 4 days ago
@Ultirian: Thank you! It works into my setup much better now! I'm definitely enjoying it so far! :D

I'm glad you like it! Join our Discord so you don't lose track of us and can report any bugs—that way, we can fix them faster ;3

unfair555, Aug 4th at 12:37 AM

Seems very useful. I will give it a test.

AmadoMuerte , Aug 4th at 12:50 AM
@unfair555: Seems very useful. I will give it a test.

Thank you, this is very important to us. If you find any issues, you can report them here

Shoggoth228, Aug 3rd at 10:17 PM

The best launcher of the Vintage story, especially if bugs are fixed)

AmadoMuerte , Aug 3rd at 10:26 PM
@Shoggoth228: The best launcher of the Vintage story, especially if bugs are fixed)

I'll definitely fix it I've already seen your issues—thanks.

Zaelesh, Aug 3rd at 3:44 PM

Can you make this compatible with Optimum

AmadoMuerte , Aug 3rd at 7:34 PM
@Zaelesh: Can you make this compatible with Optimum

Hey, I’ll look into how this can be implemented, but I’m not promising anything yet.

Zaelesh, Aug 3rd at 8:40 PM
@AmadoMuerte: Hey, I’ll look into how this can be implemented, but I’m not promising anything yet.

Any effort would be much appreciated. This looks like a pretty well designed launcher!

AmadoMuerte , Aug 3rd at 8:54 PM
@Zaelesh: Any effort would be much appreciated. This looks like a pretty well designed launcher!

Thank you, that’s great to hear. Keep an eye out for updates; I’ll be adding an auto-update feature to the launcher soon.

AmadoMuerte , 1 day ago
@Zaelesh: Any progress towards making it compatible?

Yes, I’m working on it now

AmadoMuerte , 8 hours ago
@Zaelesh: Hurray!!

You can try this on the latest version of the launcher. I didn’t provide full support, but I made it more convenient for working with Waxlight.

AmadoMuerte , 8 hours ago
@Zaelesh: Hurray!!

You can read about how to install and use Optimum here