AMD FSR3.1 - FSR 4.1 - DLSS5 NR

.github/workflows/linux-appimage.yml

@@ -84,9 +84,19 @@ jobs:
             { echo "the profile did not download: built without it"; exit 0; }
           ls -la work work/image
 
+      # (the back end this AppImage carries is built with DLSS compiled in: NVIDIA's SDK fetched here by scripts/ngx_sdk.py
+      #  (headers and libnvsdk_ngx.a, under NVIDIA's license), never committed. The DLSS *runtime*
+      #  (libnvidia-ngx-dlss.so) is NVIDIA's to ship and is still not included -- a player who wants DLSS puts it in the
+      #  game's ngx folder, and readme.md says so. Without this the released build offers FSR and nothing else.)
+      - name: NVIDIA's DLSS SDK (headers and libnvsdk_ngx.a)
+        run: python3 -I scripts/ngx_sdk.py --platform linux --build-only --accept-nvidia-license "$RUNNER_TEMP/ngx-sdk"
+
       - name: AppImage
+        env:
+          HOOKSHOT_NGX_SDK: ${{ runner.temp }}/ngx-sdk
         run: scripts/linux/appimage.sh
 
+
       - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: Hookshot-linux-x86_64

.github/workflows/release.yml

@@ -56,8 +56,12 @@ jobs:
       # RELEASE_TOKEN is a fine-grained personal access token with contents: write. It is preferred over GITHUB_TOKEN
       # because a tag pushed by GITHUB_TOKEN does not start the workflows that publish the release.
       # Without the secret, run them by hand and attach their artifacts.
+      # --repository-url is the repository this run belongs to, not the one package.json names. On the upstream
+      # repository the two are the same string and this changes nothing; on a fork they are not, and without it
+      # semantic-release compares the fork's main against *upstream's*, decides it is "behind the remote one", and
+      # publishes nothing while still reporting success. A fork releases its own work.
       - name: semantic-release
         if: steps.first.outputs.released == 'true'
         env:
           GITHUB_TOKEN: ${{ secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
-        run: npx semantic-release
+        run: npx semantic-release --repository-url "${{ github.server_url }}/${{ github.repository }}.git"

.github/workflows/source-regressions.yml

@@ -56,7 +56,7 @@ jobs:
         run: python -m pip install --disable-pip-version-check --no-deps zstandard==0.25.0
       - name: Compilers and the SPIR-V validator
         if: runner.os == 'Linux'
-        run: sudo apt-get update && sudo apt-get install -y g++ clang spirv-tools
+        run: sudo apt-get update && sudo apt-get install -y g++ clang spirv-tools glslang-tools
 
       # (the steps below all run when one before them failed, so one run shows every failure)
       - name: Check Windows native source regressions

.github/workflows/windows-builder.yml

@@ -30,6 +30,8 @@ jobs:
     name: Hookshot Builder package and setup
     # (builder-parts holds the installer's parts: no package there)
     if: github.ref_name != 'builder-parts'
+    # (hookshot) the package carries the renderer the vulkan job built (tools/prebuilt), so it waits for it
+    needs: vulkan
     runs-on: windows-2022
     timeout-minutes: 30
     steps:
@@ -99,7 +101,7 @@ jobs:
         working-directory: builder/setup
         run: |
           "$LLVM_MINGW/bin/x86_64-w64-mingw32-windres" setup.rc -O coff -o "$RUNNER_TEMP/setup_rc.o"
-          "$LLVM_MINGW/bin/x86_64-w64-mingw32-clang" -O2 -mwindows -municode setup.c "$RUNNER_TEMP/setup_rc.o" \
+          "$LLVM_MINGW/bin/x86_64-w64-mingw32-clang" -O2 -mwindows -municode -DHOOKSHOT_REPOSITORY="\"$GITHUB_REPOSITORY\"" setup.c "$RUNNER_TEMP/setup_rc.o" \
             -lwinhttp -lbcrypt -lcomctl32 -lshell32 -lole32 -Wl,--dependent-load-flag=0x800 \
             -o "$RUNNER_TEMP/HookshotBuilder-Setup.exe"
           ls -l "$RUNNER_TEMP/HookshotBuilder-Setup.exe"
@@ -109,10 +111,35 @@ jobs:
           dotnet publish builder/HookshotBuilder/HookshotBuilder.csproj --configuration Release
           -p:Version="$VERSION" -p:NuGetAudit=false --output "$RUNNER_TEMP/publish"
 
+      # (hookshot) the renderer built with NVIDIA DLSS, DLSS 5 neural rendering and AMD FSR 4 compiled in
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: hookshot_vk-windows
+          path: ${{ runner.temp }}/vk
+      # (hookshot) AMD's FSR runtime: the loader, the upscaler and frame generation, signed by AMD and MIT-licensed in
+      #  FSR SDK 2.4 (its docs/license.md lists Kits/FidelityFX/signedbin under MIT). gpu/vk/vk_ffx.cpp loads it from
+      #  beside the game; nx2/make_game.py puts it there
+      - name: AMD's FSR runtime (FSR SDK v2.4.0)
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          repository: GPUOpen-LibrariesAndSDKs/FidelityFX-SDK
+          ref: 7539ae8b6568ad29ed78a753404351daf3b5cca7 # v2.4.0
+          path: _amd
+          persist-credentials: false
+          sparse-checkout: |
+            Kits/FidelityFX/signedbin
+          sparse-checkout-cone-mode: true
+      - name: AMD's FSR runtime, with its notice
+        run: |
+          mkdir -p "$RUNNER_TEMP/amd-fsr"
+          cp _amd/Kits/FidelityFX/signedbin/amd_fidelityfx_*_vk.dll "$RUNNER_TEMP/amd-fsr/"
+          cp third_party/ffx-api/LICENSE.txt "$RUNNER_TEMP/amd-fsr/LICENSE.txt"
+          ls -l "$RUNNER_TEMP/amd-fsr"
       - name: Package folder
         run: >-
           python -I scripts/release_parts.py package "$RUNNER_TEMP/package"
           --publish "$RUNNER_TEMP/publish" --setup "$RUNNER_TEMP/HookshotBuilder-Setup.exe" ${PREVIOUS:+--list "$PREVIOUS"}
+          --vk "$RUNNER_TEMP/vk/hookshot_vk.dll" --amd-fsr "$RUNNER_TEMP/amd-fsr" --repository "$GITHUB_REPOSITORY"
 
       - name: Setup parts
         run: |
@@ -177,14 +204,36 @@ jobs:
       - name: llvm-mingw
         run: echo "HOOKSHOT_MINGW=$(python -I scripts/release_parts.py llvm-mingw "$RUNNER_TEMP/llvm")" >> "$GITHUB_ENV"
       # (as scripts/linux/appimage.sh builds Linux's: the back end alone, no lift, no game)
+      # (hookshot) built with NVIDIA DLSS compiled in, as vulkan-dlss.yml builds it: NVIDIA's SDK fetched here by
+      #  scripts/ngx_sdk.py (headers and the static library, under NVIDIA's license), never committed. NVIDIA's runtime
+      #  (nvngx_dlss.dll) is theirs to ship and is not included -- readme.md tells a player where to put it. This DLL is
+      #  what the release's Builder installs (nx2/make_game.py prebuilt_renderer): a renderer compiled on the player's
+      #  PC has none of NVIDIA's SDKs, and the Insert menu then offers none of DLSS, its frame generation or NR.
+      - name: NVIDIA's DLSS SDK (headers and nvsdk_ngx_s.lib)
+        run: python -I scripts/ngx_sdk.py --platform windows --build-only --accept-nvidia-license "$RUNNER_TEMP/ngx-sdk"
+      # (DLSS 5 neural rendering: only NVIDIA Streamline's MIT-licensed headers, fetched here and never
+      #  committed, found at the tree root by nx2/build.py streamline_sdk_path. Nothing is linked from it --
+      #  sl.interposer.dll and the sl.* plugins are the player's own files, loaded at run time. v2.14.1 is the
+      #  first public tag that carries kFeatureDLSS_NR at all, so this tag is a floor, not a preference.)
+      - name: Check out NVIDIA Streamline's headers (DLSS 5 neural rendering)
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          repository: NVIDIA-RTX/Streamline
+          ref: 625db07d4bca5abc67d781c42af7e7fb0761f1b6 # v2.14.16
+          path: streamline-sdk
       - name: hookshot_vk.dll
         env:
           RX_VK_ONLY: '1'
           RX_RELEASE: '1'
         run: |
-          OOT_WORK="$RUNNER_TEMP/vk-work" RX_CPM="$GITHUB_WORKSPACE/_deps/cpm" \
-            python -I nx2/build.py --standalone --jobs "$NUMBER_OF_PROCESSORS"
+          OOT_WORK="$RUNNER_TEMP/vk-work" RX_CPM="$GITHUB_WORKSPACE/_deps/cpm" HOOKSHOT_NGX_SDK="$RUNNER_TEMP/ngx-sdk" \
+            python -I nx2/build.py --standalone --jobs "$NUMBER_OF_PROCESSORS" | tee "$RUNNER_TEMP/vk-build.log"
+          test "${PIPESTATUS[0]}" -eq 0
           ls -l "$RUNNER_TEMP/vk-work/sa/build/hookshot_vk.dll"
+          # (a release must carry what it says: a renderer without DLSS or neural rendering compiled in fails here,
+          #  not on a player's PC as rows missing from the Insert menu)
+          grep -q "vk: DLSS (NGX): compiled in" "$RUNNER_TEMP/vk-build.log"
+          grep -q "vk: DLSS 5 neural rendering (Streamline): compiled in" "$RUNNER_TEMP/vk-build.log"
       - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: hookshot_vk-windows

.gitignore

@@ -35,5 +35,9 @@ __pycache__/
 build-linux/
 *.so
 
+# NVIDIA's DLSS SDK, fetched at build time and never committed (docs/upscaling.md)
+/streamline-sdk/
+# the release tooling's packages (package.json is release-only; npm install makes this)
+/node_modules/
 # ---- NVIDIA's DLSS SDK (scripts/ngx_sdk.py): NVIDIA's files, never committed ----
 ngx-sdk/

.releaserc.json

@@ -11,7 +11,25 @@
     [
       "@semantic-release/commit-analyzer",
       {
-        "preset": "conventionalcommits"
+        "preset": "conventionalcommits",
+        "releaseRules": [
+          {
+            "breaking": true,
+            "release": "major"
+          },
+          {
+            "type": "feat",
+            "release": "patch"
+          },
+          {
+            "type": "fix",
+            "release": "patch"
+          },
+          {
+            "type": "perf",
+            "release": "patch"
+          }
+        ]
       }
     ],
     [

builder/HookshotBuilder/MainWindow.xaml.cs

@@ -1115,7 +1115,7 @@ void Repair(object sender, RoutedEventArgs e)
             Application.Current.Shutdown();
             return;
         }
-        Process.Start(new ProcessStartInfo("https://github.com/NotRexed/Hookshot/releases/latest") { UseShellExecute = true });
+        Process.Start(new ProcessStartInfo("https://github.com/" + Repository.Name + "/releases/latest") { UseShellExecute = true });
     }
 
     // ================= the update (Updater.cs): the game started this app with --update <folder> =================

builder/HookshotBuilder/Repository.cs

@@ -0,0 +1,28 @@
+using System;
+using System.IO;
+using System.Text.RegularExpressions;
+
+/// (hookshot) The GitHub repository releases come from, as owner/name: tools/repository.txt, written when the release is
+/// packaged from the repository its CI ran in (scripts/release_parts.py package), else NotRexed/Hookshot. A fork's Builder
+/// then updates from the fork. nx2/version.py repository() is the same rule for the game's own update check.
+static class Repository
+{
+    const string Default = "NotRexed/Hookshot";
+    static readonly Lazy<string> name = new(Read);
+    public static string Name => name.Value;
+
+    static string Read()
+    {
+        try
+        {
+            var path = Path.Combine(AppContext.BaseDirectory, "tools", "repository.txt");
+            if (File.Exists(path))
+            {
+                var line = File.ReadAllText(path).Trim();
+                if (Regex.IsMatch(line, "^[A-Za-z0-9-]+/[A-Za-z0-9._-]+$")) return line;
+            }
+        }
+        catch (Exception) { }   // (an unreadable file is the default, not a failed update check)
+        return Default;
+    }
+}

builder/HookshotBuilder/Updater.cs

@@ -13,7 +13,7 @@ namespace HookshotBuilder;
 /// folder keeps).
 static class Updater
 {
-    const string Latest = "https://api.github.com/repos/NotRexed/Hookshot/releases/latest";
+    static string Latest => "https://api.github.com/repos/" + Repository.Name + "/releases/latest";
     const string Asset = "HookshotBuilder.zip";
     const string SetupAsset = "HookshotBuilder.exe";            // (the setup, builder/setup/setup.c: a release holds it and its list)
     const string SetupList = "hookshot-setup.txt";              // (scripts/make_setup_parts.py)
@@ -62,7 +62,7 @@ public static void FromCommandLine(MainWindow w)
         {
             try
             {
-                var list = await http.GetStringAsync("https://github.com/NotRexed/Hookshot/releases/latest/download/" + SetupList);
+                var list = await http.GetStringAsync("https://github.com/" + Repository.Name + "/releases/latest/download/" + SetupList);
                 foreach (var line in list.Split('\n'))
                     if (line.StartsWith("tag ")) return line[4..].Trim();
             }

builder/linux/linux_update.py

@@ -21,8 +21,26 @@
 import zipfile
 
 LIST_NAME = "hookshot-linux.txt"
-LATEST_LIST = "https://github.com/NotRexed/Hookshot/releases/latest/download/" + LIST_NAME
-LATEST_API = "https://api.github.com/repos/NotRexed/Hookshot/releases/latest"
+
+
+def _repository():
+    """(hookshot) owner/name of the repository releases come from: repository.txt in the AppImage's tools (written by
+    scripts/linux/appimage.sh from the repository its CI ran in), else NotRexed/Hookshot. nx2/version.py's rule"""
+    import re
+    here = os.environ.get("HOOKSHOT_TOOLS") or os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..")
+    try:
+        with open(os.path.join(here, "repository.txt"), encoding="utf-8") as f:
+            name = f.readline().strip()
+        if re.fullmatch(r"[A-Za-z0-9-]+/[A-Za-z0-9._-]+", name):
+            return name
+    except OSError:
+        pass
+    return "NotRexed/Hookshot"
+
+
+REPOSITORY = _repository()
+LATEST_LIST = "https://github.com/%s/releases/latest/download/%s" % (REPOSITORY, LIST_NAME)
+LATEST_API = "https://api.github.com/repos/%s/releases/latest" % REPOSITORY
 
 
 class Part(object):

builder/setup/setup.c

@@ -442,14 +442,21 @@ static void wanted_tag(char *out, size_t n) {
 /* (an update to a named release reads THAT release's list: the latest/download link can answer with the release before it for a
    while after a publish, and the setup then installed the old version again and started it with --fetched, which builds without
    checking: players pressed Update and stayed on v2.0.3, 2026-11-08) */
+/* (hookshot) the repository the setup installs from, owner/name: given by CI (.github/workflows/windows-builder.yml) from the
+   repository it builds in, so a fork's setup installs the fork's release */
+#ifndef HOOKSHOT_REPOSITORY
+#define HOOKSHOT_REPOSITORY "NotRexed/Hookshot"
+#endif
+#define HOOKSHOT_WIDEN2(s) L##s
+#define HOOKSHOT_WIDEN(s) HOOKSHOT_WIDEN2(s)
 static const char *manifest_url(void) {
     static char u[1024];
     const char *e = getenv("HOOKSHOT_SETUP_LIST");
     char tag[128];
     wanted_tag(tag, sizeof tag);
     if (e && *e) snprintf(u, sizeof u, "%s", e);
-    else if (tag[0]) snprintf(u, sizeof u, "https://github.com/NotRexed/Hookshot/releases/download/%s/hookshot-setup.txt", tag);
-    else snprintf(u, sizeof u, "%s", "https://github.com/NotRexed/Hookshot/releases/latest/download/hookshot-setup.txt");
+    else if (tag[0]) snprintf(u, sizeof u, "https://github.com/" HOOKSHOT_REPOSITORY "/releases/download/%s/hookshot-setup.txt", tag);
+    else snprintf(u, sizeof u, "%s", "https://github.com/" HOOKSHOT_REPOSITORY "/releases/latest/download/hookshot-setup.txt");
     return u;
 }
 
@@ -506,7 +513,7 @@ static DWORD WINAPI work(LPVOID unused) {
     if (!ok)
         fail(g_http_status == 404
                  ? L"The latest Hookshot release has no setup files yet. Download HookshotBuilder.zip from the releases page for now: "
-                   L"https://github.com/NotRexed/Hookshot/releases/latest"
+                   L"https://github.com/" HOOKSHOT_WIDEN(HOOKSHOT_REPOSITORY) L"/releases/latest"
              : g_http_status ? L"GitHub's download servers are failing right now (an error 500 or above, tried 8 times over 3 minutes). "
                                L"This is on GitHub's side: try again in a few minutes, or later today."
                              : L"Could not reach GitHub to get the Hookshot Builder. Check your internet connection and try again.");