Skip to content

VulkanStory 0.1.0 (development build)

Pre-release
Pre-release

Choose a tag to compare

@NightHammer1000 NightHammer1000 released this 09 Oct 21:21
· 447 commits to rewrite since this release

VulkanStory replaces Vintage Story's OpenGL renderer with Vulkan and its window and input layer with SDL3, and adds modern upscaling, frame generation and low-latency modes. It installs next to the official game; nothing in the game itself is modified.

Development build for Vintage Story 1.22.7, Windows x64. Expect rough edges; see Known issues.

Features

Rendering

  • Native Vulkan 1.3 renderer with a frame graph, bindless textures and a persistent pipeline cache
  • Temporal anti-aliasing with adjustable sharpening and texture mip bias
  • Render scale from 25 % to 100 %
  • Ambient occlusion: vanilla SSAO or GTAO, with Low / Medium / High / Ultra presets

Upscaling: pick one in the regular Options menu

  • NVIDIA DLSS: Native AA, Quality, Balanced, Performance, Ultra Performance
  • AMD FSR 3.1 and AMD FSR 4
  • Intel XeSS, including Ultra Quality and Ultra Quality+
  • Falls back automatically if your GPU doesn't support the selected upscaler

Frame generation

  • DLSS Frame Generation, up to 6× multi-frame generation on supported RTX GPUs
  • FSR 3 Frame Generation
  • XeSS Frame Generation

Low latency

  • Off / On / Boost, backed by NVIDIA Reflex (with PC Latency stats), AMD Anti-Lag or Intel XeLL depending on your GPU

Window and input (SDL3)

  • Proper high-DPI windowing, borderless and fullscreen modes, raw mouse input
  • Full gamepad support: per-controller remapping, a radial menu, on-screen button glyphs and analog movement
  • Touch input

For other mods

  • Extension points for adding render passes to the Vulkan renderer

Requirements

  • Vintage Story 1.22.7 (other versions are refused)
  • Windows 10/11 x64 and a GPU with Vulkan 1.3 drivers
  • Some vendor features need matching hardware: DLSS and DLSS-G need an NVIDIA RTX GPU, and XeSS-FG needs a supported Intel Arc GPU. FSR 3.1, FSR 4 and XeSS upscaling run on GPUs from all vendors.

Install

  1. Close the game.
  2. Extract VulkanStory-win-x64.zip into the folder that contains Vintagestory.exe, keeping the folder layout.
  3. Start the game with your normal shortcut.

All settings are in the regular Options menu. In game, .vulkanstory status shows the active renderer, upscaler and frame generation; .vulkanstory controller opens controller remapping.

To turn it off temporarily, set Enabled=0 in VulkanStory/loader.ini. Updating and clean removal are described in VulkanStory/README.txt inside the ZIP.

VulkanStory-Input-Companion.zip is optional and only for dedicated servers: it lets controller players move at analog speed. Single-player already includes it; without it, servers just use normal on/off movement.

Known issues

  • Geometry edges against the sky can visibly jitter with TAA and FSR upscaling.
  • Linux is not supported in this build.

Please report problems with %LOCALAPPDATA%\VulkanStory\Logs\bootstrap-*.jsonl and the game's Logs/client-main.log attached.

Checksums (SHA-256)

D1230CF82CC5B7806A0FB97B3C81C450DD45A204D0B9BC967E7038D2F05BE071  VulkanStory-win-x64.zip
42E20DEB7DA09C9D3D946C3333800048C232CDD454EB7191FCA5D047246E211B  VulkanStory-Input-Companion.zip