Automated Installation - optiscaler/OptiScaler GitHub Wiki

[!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

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 (both require Fakenvapi), and especially if the game has only DLSS

[!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.
  • Now only selecting No to DLSS Inputs should modify Optiscaler.ini and change Dxgi=auto to Dxgi=false.
  • 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.
  • If you get Access denied error during the install, just manually rename the OptiScaler.dll, it's a permissions issue regarding your game folder.

[!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

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

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.

[!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:

[!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

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

[!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 (from 0.7.7 nightlies)
  • dbghelp.dll (from 0.7.7 nightlies)
  • version.dll
  • wininet.dll
  • winhttp.dll
  • OptiScaler.asi (needs Ultimate ASI Loader x64 or similar)

[!NOTE]

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

Installation