Repository navigation
VulkanStory 0.1.0 (development build)
Pre-releaseVulkanStory 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
- Close the game.
- Extract VulkanStory-win-x64.zip into the folder that contains
Vintagestory.exe, keeping the folder layout. - 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