Skip to content

Installation

Jump to bottom
Zaldaryon edited this page Jul 6, 2026 · 20 revisions

Installation

Optimum ships as source. You download the source, run the build script for your platform, and the build produces a ready-to-run client on your machine. The build downloads the official Vintage Story client from Anego on your machine and applies the Optimum patches on top, so nothing copyrighted is redistributed.

Requirements

  • .NET 10 SDK
  • git, curl, python3, perl
  • bash (Linux and macOS have it; on Windows use the PowerShell script or installer below)

Download the Source

Grab the source archive for the latest release from the Releases page (the Source code (zip) or Source code (tar.gz) link), then extract it. You can also clone the repository directly:

git clone https://github.com/Zaldaryon/Optimum.git
cd Optimum

Windows (GUI Installer)

The release includes a GUI installer that handles the full pipeline: prerequisite checks, decompile, patch, build, package, and install with registry entry and optional desktop/Start Menu shortcuts.

  1. Download Source code (zip) from Releases.
  2. Extract the zip.
  3. Double-click install-windows.cmd to launch the installer.
  4. Accept the license agreement, click Install, and wait for the build to complete.
  5. Launch Optimum from the desktop shortcut or Start Menu.

Windows (Manual)

  1. Open the extracted folder in PowerShell.
  2. Run the build script: 
    powershell -ExecutionPolicy Bypass -File build-windows.ps1
  3. The script bootstraps, builds, and packages Optimum-v0.2.3-win-x64/. Run Optimum.exe from that folder.

Linux

  1. Open a terminal in the extracted folder.
  2. Run the build script: 
    ./build-linux.sh
  3. The script produces Optimum-v0.2.3-linux-x64/. Run ./Optimum from inside it.

macOS

  1. Open a terminal in the extracted folder.
  2. Run the build script: 
    ./build-macos.sh
  3. The script produces Optimum.app. Drag it into your Applications folder.

The first build downloads the official client (~570-610 MB) and takes a few minutes. The client launches with your existing account and data, no migration needed.

Data Path

Optimum uses your standard Vintage Story data path by default. Your existing worlds, servers, and settings carry over with zero migration. To use a separate data path, launch with --dataPath "/path/to/data".

This is Not a Mod

Do not place Optimum files in your Mods folder. Optimum is a standalone client that replaces the engine DLLs. It runs as its own application alongside (or instead of) the vanilla client.

For the full build process and Makefile targets, see Building from Source.

Clone this wiki locally