-
-
Notifications
You must be signed in to change notification settings - Fork 2
FAQ
No. Optimum is a launcher that applies engine-level optimizations via Cecil before the game starts. It's not a .dll in your Mods folder. Your existing mods load normally on top of the optimized engine.
No. Optimum is client-only and works with any server running the matching Vintage Story version.
No. The installer handles everything. Download the release, run the installer, done. Building from source is only for developers who want to modify Optimum. See Installation for user instructions, Building from Source for developer setup.
Optimum does not give gameplay advantages. It renders the same world the same way, faster. Server admins cannot detect it because it does not modify network behavior. Check your server's rules if unsure; some servers have blanket "no modified clients" policies.
Yes. Optimum uses the same data folder as vanilla. Your worlds, servers, settings, and mods carry over with zero migration. You can switch between Optimum and vanilla on the same world.
Launch with --dataPath "/path/to/data" or create a datapath.cfg file in the VS directory containing the absolute path on one line.
No. Optimum adds its own files alongside vanilla (Optimum.exe, Optimum.dll, etc.) but never modifies Vintagestory.exe, VintagestoryLib.dll, or any other vanilla file. The patched DLL lives in .optimum/cache/ — a separate location. Uninstalling Optimum restores vanilla instantly.
The cache auto-invalidates because the vanilla DLL hash changes. On the next Optimum launch, the patcher re-applies optimizations to the new DLL (~2 seconds). If the new VS version changes internals that break the patcher, Optimum falls back to launching vanilla with a warning.
The build targets x64 on Linux and Windows because Vintage Story has no official ARM client for those platforms. On ARM hardware, the x64 build runs via emulation (box64 on Linux, Windows-on-ARM). macOS Apple Silicon uses the native osx-arm64 client.
Expected for unsigned builds. Right-click the app, select Open, confirm the dialog. This happens once.
Launch Vintagestory.exe instead of Optimum.exe. Or uninstall Optimum (Programs & Features on Windows, ./scripts/uninstall.sh on Linux/macOS). Your worlds and account stay untouched.
Depends on your hardware, view distance, and scene complexity. Frame pacing improvements reduce stutter on any hardware. CPU-bound players with high entity counts benefit from the distance gates. GPU-bound players benefit from FSR and shader reductions. The .optimum status command shows per-optimization counters.
Yes. On first launch (or after a VS update), Optimum applies Cecil patches to VintagestoryLib.dll. The result is cached, so every subsequent launch is instant (<10ms overhead).
The new installer detects the legacy installation and offers to remove it. The new model installs into your existing VS directory — no separate game copy needed, no 700MB duplication.
Click Browse and manually select the folder containing Vintagestory.exe. On Linux, pass --vs-dir /path/to/vs. Common locations: %APPDATA%\Vintagestory (Windows), ~/.local/share/vintagestory (Linux), ~/Library/Application Support/vintagestory (macOS).
Yes. The source is GPL-3.0 with the Commons Clause. Pull requests are welcome. See Building from Source and CONTRIBUTING.md.
The cached DLL may be stale. Delete .optimum/cache/ in your VS directory and relaunch — Optimum will re-patch cleanly. If it persists, the Optimum version may be incompatible with your VS version. Check the Releases page for the correct version.