VulkanStory 0.1.5

For Vintage Story 1.22.7 on Windows x64.

Changes since 0.1.4

Mod compatibility

• Added a shared GL-to-Vulkan compatibility layer for mods that call OpenTK or native OpenGL directly. Supported calls now use the Vulkan renderer instead of causing the mod to be refused, fixing the cascading missing-behavior/item-loading crash reported in #12.
• Corrected graphics-call scanning for generic OpenTK memory overloads, native procedure lookups and non-graphics calls such as OpenAL loading.
• Added mod-created framebuffer support, independent read/draw targets, attachment queries, draw-buffer routing, framebuffer copies and nearest/linear blits. Copies retain mip levels, layers, clipping and scissor behavior.
• Added mutable 2D and 3D texture definitions, subimage uploads, pixel pack/unpack buffers and pixel-store layouts. Independently sized/formatted mip levels and zero-sized definitions retain their GL meaning; base/max levels, mip generation and sampling completeness are preserved.
• Added shared renderbuffers, multisampling, color/depth/stencil transfers, masked and scissored clears, stencil operations, indexed blending and color masks. Multisample mirroring preserves individual samples; depth and stencil transfers preserve the untouched aspect.
• Corrected sRGB draws, clears, texture uploads, readback and copies, including operations performed outside a display frame.
• Added shared shader/program uniform queries and updates, vertex-array state, array draws, clipping planes, polygon offset, GPU timing/occlusion queries and completion waits.
• Added native GL procedure routing with the correct pointer/string ABI, including mods that load their own native rendering libraries.
• Added GLFW compatibility for mod-created windows and contexts, including secondary-window rendering and input, monitor/display queries and window lifecycle handling.
• Fixed shader resource bindings and translation of geometry-stage resources and arrays whose sizes use declared integer constants.
• Improved shared mesh and shader handling for mod rendering while retaining the game's resource identities.

Rendering, upscaling and overlays

• Fixed upscaling paths that could leave the jittered, unupscaled scene visible instead of the reconstructed image.
• Corrected DLSS initialization and shutdown when super resolution and frame generation share the same NVIDIA runtime.
• Fixed RTSS compatibility in frame-generation and presentation paths. Overlay synchronization and presentation lifetimes are handled by the renderer; RTSS settings and profiles do not need changing.
• Corrected FSR frame-generation presentation, resize/recreation and resource teardown, and bundled the corresponding FidelityFX and Streamline runtime corrections.
• Fixed excessive memory allocation during texture-atlas self-composition, including large clothing/skin atlases associated with the crash in #10. Feedback copies are limited to the region being sampled.
• Fixed texture-transfer synchronization, framebuffer interpretation changes and GPU-safe retirement of mod-created resources.
• Corrected GTAO foliage normals to use geometric surface orientation rather than decorative leaf normals.
• Improved native crash and hang diagnostics, including thread and module information for stalled rendering paths.

OpenXR

• Corrected the eye-image acquire, wait, render and release lifecycle and session teardown.
• Use runtime-recommended eye resolution independently of desktop resizing or minimization.
• Added compatible RGBA/BGRA sRGB eye-image selection and corrected color transfer.
• Submit headset frames before the desktop mirror, so desktop presentation does not hold up headset submission.
• Corrected predicted frame timing, reference-space changes and head-locked menu placement.
• Keep headset rendering active through desktop focus/minimize changes and retain desktop renderer settings when returning from VR.

Known issues

• RainReflections in Simple Water Tweaks 1.3.0 cannot patch PrismForge 0.1.0's replacement final shader and disables its effect. This is a conflict between those mods' shader sources. PrismForge's HDR code also targets Vintage Story 1.22.5 and does not apply on 1.22.7.
• Intermittent loss of temporal reconstruction and high memory use/stalls during some framebuffer rebuilds remain tracked in the roadmap.
• OpenXR remains an early integration. Motion-controller gameplay, complete VR HUD/input, per-eye temporal reconstruction and ray tracing are not included in this release.

Download and installation

• VulkanStory-win-x64.zip — full client runtime. Close the game before installing or updating. Extract it beside Vintagestory.exe, preserving the folder layout. For an existing installation, the included VulkanStory/tools/deploy-runtime.ps1 updater preserves owned configuration and creates a backup.
• VulkanStory-Installer-0.1.5.zip — small installer mod for fresh installations. Place it in a Mods folder; it downloads the full runtime and requests a restart after installation. Use the full runtime/updater for existing installations.
• VulkanStory-Input-Companion.zip — optional dedicated-server companion for negotiated controller movement. The full client package already includes it for singleplayer.
• SHA256SUMS.txt and archives.json — download checksums.

The reported mod pack and its dependencies are not bundled with VulkanStory.

Full source comparison: v0.1.4…v0.1.5

VulkanStory 0.1.4

For Vintage Story 1.22.7 on Windows x64.

• Fixed the AMD startup crash caused by Windows rejecting a driver context restore. Hardware stack protection stays enabled.
• Added automatic reports for native and managed crashes, saved under %LOCALAPPDATA%\VulkanStory\Crashes.
• Fixed mod shader sources, includes and managed dependency loading.
• Corrected motion history for animated entities, rigid entities and inventory items sharing the same mesh.
• Fixed map rendering after shader reload and improved cleanup when leaving a world.

Download VulkanStory-win-x64.zip for the full runtime. Close the game before installing or updating, then extract it beside Vintagestory.exe, keeping the folder layout.

VulkanStory-Installer-0.1.4.zip is the small installer mod for fresh installations. VulkanStory-Input-Companion.zip is optional for dedicated servers.

AMD startup compatibility fix

AMD startup compatibility fix for #7.

Windows was rejecting a context restore in AMD's Vulkan driver. I changed startup to use compatible continuation validation for affected AMD launches while keeping hardware shadow-stack protection enabled.

Extract the ZIP into the game directory beside Vintagestory.exe, replacing the existing files, and start normally. Affected launches restart automatically once before the menu. Crash reports remain enabled.

AMD startup crash — debug build

Debug build for the AMD startup crash in #7.

I added automatic crash reporting. After a crash, it creates a report ZIP in %LOCALAPPDATA%\VulkanStory\Crashes with the available native crash details, managed exceptions, logs, settings and driver information.

Close the game, extract the client ZIP into the game directory beside Vintagestory.exe, replace the existing files and start the game normally.

VulkanStory 0.1.3

Two fixes for the Options menu:

• Fixed the Graphics settings crash caused by an invalid saved dropdown selection. Existing graphics settings are preserved.
• Fixed scrolling so labels, controls and backgrounds move together and stay clipped to the panel.

For Vintage Story 1.22.7, Windows x64.

For a fresh installation, put VulkanStory-Installer-0.1.3.zip in Mods, enter a world and choose Install. You can also extract VulkanStory-win-x64.zip beside Vintagestory.exe.

For an existing installation, close the game, extract the client ZIP to a temporary folder and use its VulkanStory/tools/deploy-runtime.ps1. Follow VulkanStory/README.txt; the updater preserves settings and creates a backup.

VulkanStory-Input-Companion.zip is optional for dedicated servers. Single-player includes the companion in the client ZIP.

VulkanStory 0.1.2

This update gives shader compilation more stack space during startup.

It also includes:

• A small installer mod that downloads the runtime after entering a world.
• Earlier merging of dropped items and live particle density and limits on the Performance page.
• Initial OpenXR stereo rendering with tracked headset views and a desktop mirror. Enable it on the Device page, then restart.
• Player and technical guides.

For Vintage Story 1.22.7, Windows x64.

For a fresh installation, put VulkanStory-Installer-0.1.2.zip in Mods, enter a world and choose Install. You can also extract VulkanStory-win-x64.zip beside Vintagestory.exe.

For an existing installation, close the game, extract the client ZIP to a temporary folder and use its VulkanStory/tools/deploy-runtime.ps1. Follow VulkanStory/README.txt; the updater preserves settings and creates a backup.

VulkanStory-Input-Companion.zip is optional for dedicated servers. Single-player includes the companion in the client ZIP.

VulkanStory 0.1.1

First general release of VulkanStory for Vintage Story 1.22.7, Windows x64.

Included

• Vulkan renderer and SDL3 window/input integration.
• TAA, SSAO/GTAO, DLSS, FSR 3.1/4 and XeSS upscaling.
• DLSS-G, FSR 3 and XeSS frame generation, plus latency controls.
• Controller remapping, radial menu, gyro/haptics and touch support.
• Optional performance optimizations with live controls: culling, streaming, world generation, animation, lighting, inventory, physics, map caching and cloud updates.
• Performance inspection harness: .vulkanstory profile start 30, profile stop and profile status. Captures include offline flame graphs, allocation samples, system/frame timings, contention and Speedscope export.

Install or update

Close the game before installation.

For a fresh installation, extract VulkanStory-win-x64.zip beside Vintagestory.exe, preserving its folder layout. Start with the normal game shortcut. Official game assemblies are neither shipped nor modified.

For an existing installation, extract the ZIP to a temporary directory and use its VulkanStory/tools/deploy-runtime.ps1. Follow VulkanStory/README.txt; the updater preserves settings and creates a backup.

VulkanStory-Input-Companion.zip is optional for dedicated servers. Single-player includes the companion in the client ZIP.

Known issues

• Framebuffer rebuilds can cause allocation failures, severe stalls and high memory use.
• Further Vulkan correctness issues in attachment, shader translation, mod API and provider transitions remain tracked in the roadmap.

Please include Logs/client-main.log and %LOCALAPPDATA%\VulkanStory\Logs\bootstrap-*.jsonl when reporting problems.

SHA-256 checksums are supplied in SHA256SUMS.txt and archives.json.

VulkanStory 0.1.1 (development build)

Development release for Vintage Story 1.22.7, Windows x64.

Changes

• Fixed temporal instability at geometry boundaries against bare sky and clouds in native TAA and the upscalers.
• Corrected FSR 3.1 cloud history inputs and the FidelityFX Vulkan history-texture format.
• Fixed the XeSS Ultra Performance pixelation regression by keeping colour, depth, motion and jitter in one coordinate system.
• Replaced the custom allocator with Vulkan Memory Allocator 3.4.0, with heap-budget checks and GPU timeline retirement. Framebuffer memory is reserved before terrain growth; terrain pools share quad indices, and abandoned meshes are released.
• Added the FSR 4 INT8 compatibility path for NVIDIA and Intel GPUs.
• Native shaders now ship in one shaders-vk.pak container.

Install or update

For a fresh installation, close the game and extract VulkanStory-win-x64.zip beside Vintagestory.exe, preserving the folder layout. Start with the normal game shortcut. The official game assemblies are not included or modified.

For an existing VulkanStory installation, extract the new ZIP to a temporary folder and use its VulkanStory/tools/deploy-runtime.ps1; instructions are in VulkanStory/README.txt. This preserves settings and keeps a backup.

VulkanStory-Input-Companion.zip is optional for dedicated servers. Single-player already includes it.

Known issues

Please attach the game's Logs/client-main.log and %LOCALAPPDATA%\VulkanStory\Logs\bootstrap-*.jsonl when reporting problems.

SHA-256

FE8E8EA053C6558F39A4D4CD4F3D95FBBA6675223237A41558B77BEE87535345  VulkanStory-win-x64.zip
8520E314E389BBE3ADA62A1DDE49514750C87C5BCA4225A237EC5990A865B838  VulkanStory-Input-Companion.zip

VulkanStory 0.1.0 (development build)

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