Vintage Story Launcher

Vintage Story Launcher (Dev)

Platform Status

• Linux: Supported and tested on Ubuntu 20.04+, Debian 11+, Fedora 38+.
• Windows: Builds currently unavailable. Windows support is planned for a future release.

Overview

The Vintage Story Launcher is an unofficial, feature‑rich companion app that helps you manage game versions, isolated play instances, and mods with ease. The interface is built in Godot for a thematic, game‑like feel, while core operations are implemented in Rust (via GDExtension) for speed, safety, and reliability.

Key Features

• Multi‑Instance Management: Create fully separate installations for different worlds, servers, or mod sets—ideal for testing or keeping survival and creative gameplay isolated.
• Per‑Instance Version Control: Download and switch game versions per instance. Quickly match server versions or run older mods without disrupting your main setup.
• Integrated Mod Manager: Enable/disable mods per instance. The launcher handles file organisation so you can focus on play, not folders.
• News Feed: See official Vintage Story updates directly on the home screen.
• *Thematic UI: A handcrafted interface designed to feel like a natural extension of the game.

Install Instructions

1. Install Git (required to run the installer script).
2. Download the release archive and extract it.
3. Linux:
   • Open a terminal in the folder containing install.sh and run:
     chmod +x ./install.sh then ./install.sh
   • Alternatively, set the file as executable from your file manager and double‑click it.
4. Windows: When Windows builds are available, run install.sh using Git Bash.
5. Follow the on‑screen prompts. Once installed, launch from your application menu.

Support Development

Backup Instructions (v0.9.0+)

Recommendation: Always back up your data before testing new launchers or major updates.

For v0.9.0 and above, back up your instances directory.

Linux

• Terminal:
  cp -r ~/.local/share/VintageStoryLauncher/instances/ ~/Desktop/
  Replace ~/Desktop/ with your preferred backup destination.
• File Manager: Navigate to ~/.local/share/VintageStoryLauncher/, copy the instances folder, and paste it into your backup location.

Windows

• Windows builds are not yet available; no backup is required at this time. This section will be updated when a Windows release is published.

Legacy Backup (pre‑v0.9.0)

If you are using a version older than v0.9.0, back up your VintageStoryData directory.

Linux

• Terminal:
  cp -r ~/.config/VintageStoryData/ ~/Desktop/
• File Manager: Go to ~/.config/, copy VintageStoryData, and paste it into your backup location.

Windows

• Windows builds are not yet available; this section will be updated for Windows when releases are ready.

Report Issues

Found a problem? Please use the GitHub Issue Tracker (link above) so I can address the issue efficiently. Include as much detail as possible:

• App Version
• OS (and Distro/DE on Linux)
• Issue Description
• Steps to Reproduce
• Log File (paste text or attach the file)