roman/OptiScaler
Watch
1
0
Fork
You've already forked OptiScaler
 0
mirror of https://github.com/optiscaler/OptiScaler.git synced 2026-10-19 00:31:16 +00:00
Code Issues Projects Releases Packages Wiki Activity
Page: Automated Installation
Pages
Automated Installation Compatibility List Compatibility with other mods (Reshade, SpecialK) FSR4 Compatibility List Fakenvapi Frame Generation Options Home Hudfix incompatible Installation Known Issues Legacy Installation Manual Installation Nukem's dlssg‐to‐fsr3 OptiFG Simple Install Uninstallation Unreal Engine Tweaks Update OptiScaler when using DLSS Enabler Updating Optiscaler
37 Automated Installation
TheRazerMD edited this page 2026-04-13 23:24:17 +02:00
Table of contents

Caution

0a. Download the latest stable build of Optiscaler from here.

We also have the Rolling/Nightly releases which might have some newer bleeding edge things - Nightly builds

OptiScaler 0.9+ now comes bundled with latest Fakenvapi and Nukems dlssg-to-fsr3!

Example image

image

Note

If you want to send a log file, set LogLevel=0 and LogToFile=true, reproduce the issue and zip the log if it's too big.

Automated

Tip

0b. Please check the General Compatibility List first for already documented fixes and workarounds - same for FSR4 Compatibility List

1. Extract all of the Optiscaler files by the main game exe.

Important

(for Unreal Engine games, look for the win_shipping.exe in one of the subfolders, generally <path-to-game>\Game-or-Project-name\Binaries\Win64 or WinGDK\, ignore the Engine folder)

Example paths

  • Expedition 33\Sandfall\Binaries\Win64, Jedi Survivor\SwGame\Binaries\Win64
  • Cyberpunk 2077\bin\x64, HITMAN 3\Retail
  • Warhammer 40,000 DARKTIDE\binaries, The Witcher 3\bin\x64_dx12

2. Run the appropriate setup.bat script for automating the renaming process. BAT install should work for the vast majority of cases.

Tip

2a. For AMD/Intel, about using DLSS Inputs - it is necessary to select Yes if you intend to use Nukem mod, if you want Reflex->AL2 conversion, and especially if the game has only DLSS

  • Selecting No to DLSS Inputs should modify Optiscaler.ini and change Dxgi=auto to Dxgi=false.

    • This disables Dxgi spoofing

  • If AMD/Intel selected, BAT will look for OptiPatcher compatibility and will ask if you want to download it if support confirmed.

    • OptiPatcher - an Opti plugin used for unlocking DLSS/DLSS-FG inputs, avoids spoofing and performance overhead in supported games. More info available on OptiPatcher Github
      • All patches are made for the latest game version at the time of committing!
      • BAT automatically downloads the latest OptiPatcher.asi from Github, moves it to the plugins folder, and sets LoadAsiPlugins=true in OptiScaler.ini
      • (OP) in Opti Overlay title means patching is successful and game version is supported

Important

  • If you get Access denied error during the install, it's most likely a permissions issue regarding your game folder.
  • If OptiScaler.dll exists, please manually rename to a supported filename (e.g. dxgi/winmm.dll) and you are done, no need to run the setup BAT again (unless you want to disable spoofing too, for that just check above)

Note

For FSR2/3-only games that don't have DLSS (e.g. The Callisto Protocol or The Outer Worlds: Spacer's Choice Edition), you have to provide the nvngx_dlss.dll in order to use DLSS in Optiscaler - download link e.g. TechPowerUp

  • If DLSS is still crashing, try using OptiScaler as d3d12.dll

3. If the batch file wasn't successful, please check the Manual steps.

Note

  • Pressing Insert should open the Optiscaler Overlay in-game with all of the options (ShortcutKey= can be changed in the config file).

  • Pressing Page Up shows the performance stats overlay in the top left, and can be cycled between different modes with Page Down (keybinds customisable in the overlay).

  • If Opti overlay is instantly disappearing after trying Insert a few times, maybe try Alt + Insert (reported workaround for alternate keyboard layouts).

  • For some games (e.g. Dying Light 2), mouse doesn't work in the overlay, so keyboard navigation is required - Arrow keys, Tab and Space

  • Added enable/disable FG shortcut key - default is End (customisable, Keybinds in Overlay, FGShortcutKey in INI)

For more info, please check Readme - How it works?

Tip

RTSS

  • If you are using RTSS (MSI Afterburner, CapFrameX), please enable Use MS Detours API hooking in RTSS Setup/Settings (and try updating RTSS also if possible).
  • XeFG usually requires disabling Inject Reflex Markers to work properly.

image

Tip

[1] Linux users should add renamed dll to overrides:

WINEDLLOVERRIDES=dxgi=n,b %COMMAND%

Important

Please don't rename the ini file, it should stay as OptiScaler.ini.

Note

OptiScaler supports these filenames:

  • dxgi.dll
  • winmm.dll
  • d3d12.dll
  • dbghelp.dll
  • version.dll
  • wininet.dll
  • winhttp.dll
  • OptiScaler.asi (needs Ultimate ASI Loader x64 or similar)

Note

Example of correct installation

Installed

ARCHIVE

Important

  • From 0.7.8, selecting Yes to DLSS Inputs (as AMD/Intel) no longer creates a nvngx.dll, since FakeMichau managed to workaround that. One less step required now if you were doing it manually.
  • With the changes mentioned above, spoofing working properly means nvngx replacement: Exists will be mentioned in the Opti Overlay, and that's the important part, nvngx.dll: Doesn't Exist is irrelevant if nvngx replacement exists.

Tip

If AMD/Intel and DLSS inputs aren't visible even after selecting Yes during Install, game requires adding Fakenvapi

Caution

If you need Nukem or Fakenvapi, now check their respective pages:

  • d3d12.dll (from 0.7.7 nightlies)
  • dbghelp.dll (from 0.7.7 nightlies)

For AMD/Intel, it usually fails at locating the nvngx_dlss.dll (devs put it in an unexpected place). In that case, it's enough to follow Step 3 from Manual install.

Note

Example of correct AMD/Intel installation (with additional Fakenvapi and Nukem mod)

Installation