TEKKEN 7 MOTION BRIDGE — NO NR
Version 0.1.0 / experimental

Native engine motion vectors and depth for FSR 3.1 upscaling and FSR Frame
Generation through OptiScaler F5. The game's HUD is composed separately over
generated frames. Insert opens OptiScaler. Neural Rendering is disabled.

LINUX / STEAM + PROTON — RECOMMENDED INSTALL

1. Close Tekken 7. Extract this ZIP anywhere and open a terminal in that folder.
2. Run: bash INSTALL.sh
3. In Steam > Tekken 7 > Properties > Launch Options, paste:

   DISABLE_LSFGVK=1 WINEDLLOVERRIDES="winmm=n,b" %command% -nod3d9ex

Start the game and press Insert. No separate ASI loader or manual INI editing
is needed. Python 3.9+ and Internet access are required by the installer.
It locates Steam libraries, downloads the pinned F5 v0.1.38 ZIP (~139 MiB),
verifies SHA-256 and extracts only the AMD runtime, loader and licence files.
It installs its own ASI folder; existing NR/other F5 plugins are not selected.
It enables TAA. Existing Rendering Scale values from 25% to below 100% are
kept; otherwise 67% is selected. Resolution and aspect-ratio settings are kept.

If you already have custom Steam launch options, keep them and merge winmm=n,b
into the existing WINEDLLOVERRIDES. Remove any external frame-generation wrapper
from this game's launch command before testing this FG path.

IF THE GAME IS NOT FOUND

  bash INSTALL.sh --game "/path/to/steamapps/common/TEKKEN 7"

OFFLINE INSTALL / DOWNLOAD BLOCKED

Download v0.1.38-Optiscaler-F5.zip from:
https://github.com/janblade/OptiScaler-F5-DLSSNR-Multipass/releases/tag/v0.1.38
Then run:

  bash INSTALL.sh --f5-archive "/path/to/v0.1.38-Optiscaler-F5.zip"

The ZIP must match the manifest checksum. Do not substitute another F5 version:
the Proton Insert-menu compatibility fix is tied to this tested build.

WINDOWS / MANUAL INSTALL — NOT QUALIFIED ON WINDOWS

The automated, tested path is Linux + Proton. For a manual installation:
1. Install F5 v0.1.38 beside TekkenGame/Binaries/Win64/TekkenGame-Win64-Shipping.exe
   as winmm.dll, with its AMD FidelityFX runtime in the OptiScaler subfolder.
2. Copy this package's TekkenGame folder into the TEKKEN 7 game root. The supplied
   OptiScaler.ini is a complete fresh-install preset: back up an existing one
   before replacing it. It selects only Tekken7MotionBridge/plugins.
3. Enable Temporal AA and set Rendering Scale below 100% in the game. If TAA
   needs an Engine.ini setting, add to its [/Script/Engine.RendererSettings]:
   r.DefaultFeature.AntiAliasing=2
   r.PostProcessAAQuality=4
   r.TemporalAASamples=16
Restart the game. Windows/RTX/DLSS SR require separate testing. No NVIDIA DLL
is supplied. This release uses FSR SR + FSR FG by default.

USE

Insert: open/close OptiScaler. The shipped profile uses native DX11 FSR 3.1 SR,
FG Input = Upscaler, FG Output = FSR FG. Keep async FG and FFX input detours off.
Rendering Scale is the source-resolution control: at 1920x800, 50% means
960x400 -> 1920x800. 67% is a less aggressive starting point.
The game still controls simulation speed and its source-frame limit. Generated
frames improve presentation; they do not make the game simulate more often.
External frame interpolation should be disabled when using this FG path.

VERIFY / TROUBLESHOOT

Tekken7MotionBridge.log is beside the shipping EXE. "NGX native engine input"
shows source/output dimensions. "HUD FSR FG" should show increasing generated
and generated_with_ui values with failures=0 during gameplay.
OptiScaler.log identifies the actual F5 version and loader. For an Insert issue,
check "F5 Proton DX11/DX12 overlay routing fixed" in the bridge log and verify
the Steam winmm override. Restart after installation.
If the game was never launched, the installer may not find its settings folder;
enable TAA and set Rendering Scale manually after the first launch.

UNINSTALL (AUTOMATED INSTALLS)

Close the game. In this extracted package folder run:

  bash UNINSTALL.sh

Original files are restored from Tekken7MotionBridge-backups/NoNR-* beside the
EXE. Later edits to unrelated INI keys and resolution are preserved. Files
modified after installation are kept instead of silently replaced. Backups
remain available. Remove the Steam winmm override if no other mod needs it.
Manual installations must be removed manually using your own backups.

SCOPE

Qualified in offline/training on AMD Ryzen Z1 Extreme / RADV, Linux + Proton
CachyOS, at 1280x720 and 1920x800. Unknown EXE/UI shaders, HDR, async FG, other
GPU/driver combinations and online play are not qualified. No universal FPS
increase or fixed 60->120 result is promised.

This No NR package includes no NR ASI, model weights, ReShade or XeFG runtime.
F5 itself is a general-purpose upstream dependency with NR code; this profile
disables that feature and the installer never installs NR models or forwarders.
The game executable, archives and save data are not patched by this installer.

Source is supplied as a separate Nexus source download. Third-party credits,
licences and upstream links are in THIRD-PARTY.txt and the licence files.
