BG3UpscalerProxy

IMPORTANT: this project is archived. For Vulkan, use bg3fgvk instead.

bg3fgvk (Nexus Mods) is the successor for Vulkan: free and open-source DLSS Frame Generation (x2 / x3 / x4) that needs no PureDark purchase and no modified Script Extender, and works with the stock BG3SE and MCM. Everything below about the PureDark-based Vulkan setup is kept for reference only and is no longer maintained.

DX11 / FSR users: nothing changes for you. The old version that supports DX11 and FSR (no MCM menu) stays available, see OLD VERSION COMPATIBLE WITH DX11 AND/OR FSR below.

Latest Version DLSS FG ONLY

Download .dll from link and follow readme here below

Overview

A modified Script Extender that enables compatibility with DLSS FG from PureDark.

Screenshots

Mod Configuration Menu (requires Script Extender) Working with Upscaler(top-left corner)

Features

• Enables simultaneous use of PureDark's FG upscaler, Bg3 Script Extender and compatible mods
• Enables MCM menu with DLSS FG
• Only is compatible with Vulkan

Prerequisites

• You must purchase the original BG3 upscaler injection from PureDark's Patreon
• You need the BG3 Script Extender installed and used once
• This only works with Baldur's Gate 3 on PC
• Use Vulkan - Enable VSync and normal DLSS in BG3 Video settings

Installation

1. Purchase and activate DLSS FG from PureDark's Patreon
2. Rename PureDark's DLSS FG version.dll to upscaler.dll in your Baldur's Gate 3 bin folde
3. Copy the BG3ScriptExtender.dll from the releases page to folder containing the latest version folder of Script Extender (i.e C:\Users\User\AppData\Local\BG3ScriptExtender\ScriptExtender\27.... (highest number is good number)
4. Replace PureDark's Streamline folder with the one from the releases page

Important:

• Only works for Nvidia GPUs series 4000/5000 because of DLSS4 MFG support
• Only Vulkan

Note: You still need to purchase PureDark's plugin for authentication.

Authentication

Frame generation is the paid part of PureDark's mod and is gated behind a subscriber authentication check. Upscaling works without it; frame generation silently does nothing.

The most reliable way to authenticate is to run PureDark's standalone auth tool (patreon.exe), which is posted in the #upscaler-support area of PureDark's Discord and is available to active subscribers. It is not redistributed here — get it from PureDark directly. Run it once before launching the game; it authenticates your Patreon session, after which the mod unlocks frame generation on subsequent launches.

The relevant settings live in bin\mods\BG3Upscaler.ini:

[Frame Generation]
mDLSSGMode = 2       # 0 = Off, 1 = On, 2 = Auto
mDLSSGFrames = 4     # multi-frame generation: x2 / x3 / x4
mDLSSGEnabled = true # must be true

[Hotkeys]
mToggleFrameGen = 624  # 624 = Numpad *, toggles FG in-game

Troubleshooting

Frame generation never engages

The failure is completely silent, so use bin\mods\BG3Upscaler.log rather than guessing. A working run creates two NGX features:

hk_NVSDK_NGX_VULKAN_CreateFeature FeatureID 1     <- DLSS upscaling
hk_NVSDK_NGX_VULKAN_CreateFeature FeatureID <n>   <- frame generation

If you only ever see FeatureID 1, frame generation is not running. Note that DLSS-G is supported on this system appears either way — that line only reports hardware capability, not that FG is active.

Work through these in order:

1. Is the plugin actually installed? bin\mods\UpscalerBasePlugin\ must contain PureDark's plugin binary alongside the Streamline\ subfolder. A partial install where only Streamline\ was copied leaves every Streamline DLL present and correct while nothing drives them — the log will report DLSS-G as supported and then never attempt it.
2. Are you authenticated? See the Authentication section above.
3. Is FG enabled in the ini? mDLSSGEnabled = true, and try mDLSSGMode = 1 (explicit On) rather than 2 (Auto), which can gate FG behind a framerate threshold.
4. Change one thing at a time. If BG3Upscaler.log is byte-for-byte identical between runs, whatever you changed is not reaching the mod — check the earlier steps rather than changing more settings.

Known Issues

• MCM Menu Flickering: The Mod Configuration Menu will flicker and will be harder than usual to use
• You might have to switch between Fullscreen and Fullscreen borderless for the MCM menu to appear

OLD VERSION COMPATIBLE WITH DX11 AND/OR FSR (NO MCM Menu)

FOLLOW THE README ON LINK: https://github.com/thierbig/BG3UpscalerProxy/releases/tag/3.0

Credits

• Original upscaler injection by PureDark
• Script Extender by Norbyte

Codebase

Code hosted on this repo corresponds to release older 3.0. Release 4.0 auto builds BG3ScriptExtender.dll from my SE fork: https://github.com/thierbig/bg3se-upscaler.

License

This project is licensed under the MIT License - see the LICENSE file for details.