mirror of
https://github.com/valentderah/totk-pc-recomp.git
synced 2026-11-18 20:15:56 +00:00
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
17 KiB
17 KiB
Third-party notices
Code copied or adapted from another project is listed here with its source, the exact commit, its license, and the files it went into. Each copied file keeps its original copyright header.
| Component | Source and commit | License | Used in |
|---|---|---|---|
| MacNativeGames extraction scripts and verification hashes | https://github.com/ly05010419/MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11, Copyright (c) 2026 MacNativeGames contributors |
MIT | tools/vendor/macnativegames/ (unmodified), tools/data/expected-v*.json |
| LAS Recomp lifter, code generator, FP/SIMD lowering, CPU headers and differential tests | https://github.com/peiikai/LASRecomp @ da35b83a9611d046a9a681aae668d7085954d37f, Copyright (c) 2026 Peiikai |
MIT | recomp/lifter.py, recomp/simd_c.py, recomp/nso.py, recomp/gen.py, recomp/module.py, tests/jumptables_check.py, runtime/cpu.h, runtime/simd.h, runtime/simd_fp.h, tests/diff/ |
| LAS Recomp host runtime: NSO loader, host-function table, guest-space reservation and re-execution, guest thread start | https://github.com/peiikai/LASRecomp @ da35b83a9611d046a9a681aae668d7085954d37f, Copyright (c) 2026 Peiikai |
MIT | runtime/loader.c, runtime/hostfn.c, runtime/memory.c; runtime/kernel.c, runtime/boot.c; runtime/vk_device.c, runtime/gfx_window.c, runtime/tex_astc.c (runtime/nvn/astc.c; its decode ported to GLSL in runtime/shaders/astc_decode.comp, compiled into runtime/astc_decode_spv.h, and its tables copied into runtime/vk_astc.c), runtime/vk_formats.c (format table of runtime/nvn/vulkan/textures.c), runtime/vk_memory.c (page write generations of runtime/nvn/vulkan/exec.c, deferred destruction of textures.c), runtime/vk_texture.c (image creation, uploads and samplers of runtime/nvn/vulkan/textures.c), runtime/vk_sync.c (timeline submissions and waits of runtime/nvn/vulkan/exec.c), runtime/vk_pipeline.c (blend, compare and stencil mappings, vertex format table with its 3-component fallback and pipeline cache file of runtime/nvn/vulkan/exec.c and device.c), runtime/vk_exec.c (pass begin and end, scissor clip and attachment clears of runtime/nvn/vulkan/exec.c), runtime/vk_exec_xfer.c (copies of runtime/nvn/vulkan/exec.c), runtime/vk_exec_draw.c (uniform buffer spans, texture and sampler descriptors and dispatch flow of runtime/nvn/vulkan/exec.c); in-game menu: runtime/ui/menu.cpp (Dear ImGui Vulkan set-up of runtime/nvn/vulkan/imgui_glue.cpp) |
| MacNativeGames TotK host runtime: dynamic linking, identity check, module permissions, guest memory and SVCs, threads, IPC, audio renderer, system services, RomFS and save storage, boot sequence | https://github.com/ly05010419/MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (games/totk/runtime/, games/totk/scripts/prepare_runtime.py), Copyright (c) 2026 MacNativeGames contributors |
MIT | runtime/loader.c, runtime/memory.c; runtime/kernel.c, runtime/svc.c, runtime/ipc.c, runtime/ipc.h, runtime/audren.c, runtime/audren.h, runtime/audio_mixer.c, runtime/audio_effects.c, runtime/audio_effects.h, runtime/audio_reverb.c, runtime/audio_reverb.h (SDL3 output replaces CoreAudio), runtime/ov_system.c (also shared_font.c: the BFTTF layout behind nn::pl), runtime/ov_input.c (also hid_feedback.c: vibration and six-axis handles and calls), runtime/motion_fusion.c (six-axis fusion of motion_fusion.c), runtime/ov_media.c (hardware Opus decoder over libopus), runtime/swkbd_win.c (swkbd_host.c: ShowKeyboardArg offsets, UTF-8/UTF-16 conversion, disabled-key filter, result codes; Win32 window replaces the macOS text bar), runtime/ov_gfx.c, runtime/romfs.c, runtime/romfs_path.h, runtime/fs_host.c, runtime/fs.h, runtime/boot.c; runtime/gfx_window.c |
| MacNativeGames TotK frame-rate patches: 60 fps present-interval controller, real-time frame step and its present sampling, hair and cloth clock, trampoline slow-motion check (instruction words and 1.2.1 sites), player position chain; quick-menu capture background RomFS overlay | https://github.com/ly05010419/MacNativeGames @ ebe621de99bfc48f3c42f2d2aa73e04fbcc6eae2 (games/totk/runtime/game_patches.c, game_version.h, world_survey.c, games/totk/scripts/make_romfs_patches.py), Copyright (c) 2026 MacNativeGames contributors |
MIT | runtime/frame_rate.c, recomp/patches-v121.txt, tools/make_romfs_patches.py |
| MacNativeGames TotK virtual-core preemption: asynchronous preemption of an owner in top-level game code, priority inheritance through guest mutexes, the SDK's preemption-disable protocol (TLR+0x100/+0x102, SVC 0x36), the core-wait diagnostics | https://github.com/ly05010419/MacNativeGames @ 33e8fa83052ea1ae09a3583137008e9797e12950 (games/totk/runtime/threads.c, commits 8bf0893 and 19730cd), Copyright (c) 2026 MacNativeGames contributors |
MIT | runtime/kernel.c (SuspendThread and a register-saving stub replace SIGUSR2), runtime/hostfn.c, runtime/svc.c (host depth) |
MacNativeGames RomFS index builder (TOTKRFS1 layout) |
https://github.com/ly05010419/MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (games/totk/scripts/prepare_romfs_backend.py), Copyright (c) 2026 MacNativeGames contributors |
MIT | tools/romfs_index.py |
d2r-mobile host thread environment (TLR, TLS, thread object), the origin of MacNativeGames' thread layer; d2r-mobile NVN host object layouts, command record format and NVN front end, as adapted for TotK in MacNativeGames' d2r_gfx copy |
https://github.com/jhaizhou-ops/d2r-mobile @ 53e7c5bb9ca3ea53e2160005be8fbe920cd9cb53 (dm/host/thread.c, dm/host/hle_thread.c); the NVN layouts and front end via https://github.com/ly05010419/MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (games/totk/third_party/d2r_gfx/gfx/nvn/nvn_obj.h, the two types of nvn_tex.h, hle_nvn.c, totk_nvn_ext.c, nvn_impl.h, nvn_hmap.h, nvn_pool_index.h, the request checks and mapping semantics of totk_vpool.c, the generation stamps of nvn_dirty.c, texture mirroring and texel copies of nvn_mtl.m; licence in games/totk/third_party/d2r_gfx/LICENSE), Copyright (c) 2026 jhaizhou |
MIT | runtime/kernel.c; runtime/nvn_obj.h; runtime/nvn_api.h, runtime/nvn_api_core.c, runtime/nvn_hmap.h, runtime/nvn_pool_index.h; runtime/nvn_api_obj.c (also nvn_pace.h); runtime/nvn_api_cmd.c, runtime/nvn_ext.c; runtime/vk_memory.c, runtime/vk_texture.c; runtime/vk_sync.c (side effects written after GPU completion, hle_nvn.c); runtime/vk_pipeline.c (pipeline key and state mapping of nvn_mtl.m pso_key_fill / pso_desc, its vfmt vertex formats and the missing-varying fix-up of msl_varyings); runtime/vk_exec.c, runtime/vk_exec.h (op loop, pure-state ops and state defaults of nvn_mtl.m mtl_exec / state_op / state_reset); runtime/vk_exec_xfer.c (copy, clear, event, counter and conditional-render semantics of nvn_mtl.m copy_t2b / copy_b2t / copy_t2t / clear_tex / cond_eval); runtime/vk_exec_draw.c (bind ops, draw and dispatch flow, vertex streams of nvn_mtl.m state_op / bind_vertex_streams / draw_inner / dispatch) |
nxnative NVN front end (d2r-mobile's successor): texture view depth-stencil mode bits, stencil-view rule, Downsample and indirect draw and dispatch records |
https://github.com/seedds/nxnative @ d5b380b3a80495609c2e751bb994911a638935ad (dm/gfx/nvn/hle_nvn.c, nvn_obj.h, nvn_mtl.m), Copyright (c) 2026 jhaizhou |
MIT | runtime/nvn_obj.h, runtime/nvn_ext.c, runtime/nvn_api_cmd.c, runtime/vk_exec_draw.c |
| NVN type definitions reconstructed from Darksiders II DWARF information, with MacNativeGames' TotK size annotations | h1k421, via https://github.com/ly05010419/MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (games/totk/third_party/d2r_gfx/gfx/nvn/include/nvn.h), Copyright (c) 2020 h1k421 |
MIT | runtime/nvn.h (unmodified) |
| Ryujinx.Audio voice state and effects, as ported in MacNativeGames' audio renderer | https://github.com/Ryujinx/Ryujinx, via MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (games/totk/runtime/audio_renderer.c, audio_effects.c, audio_reverb.c; licence text in games/totk/third_party/licenses/Ryujinx-Audio.txt), Copyright (c) Ryujinx Team and Contributors |
MIT | runtime/audren.c |
REA agent skill reverse-engineer-anything |
https://github.com/morluto/rea @ 799e8265b254e225dc1dabdd25e56f0ab7f86bd3, Copyright (c) 2026 morluto |
MIT | .claude/skills/reverse-engineer-anything/, .agents/skills/reverse-engineer-anything/ (pinned in .claude/skills/skills-lock.json) |
Ryujinx shader translator 1.3.2 (Ryujinx.Graphics.Shader, Spv.Generator, Ryujinx.Common) with MacNativeGames' four optimizer patches and totk_xlate tool |
https://github.com/Ryujinx/Ryujinx, via MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (vendor/ryujinx, games/totk/tools/totk_xlate/), Copyright (c) Ryujinx Team and Contributors; tool Copyright (c) 2026 jhaizhou |
MIT | tools/vendor/ryujinx/ (unmodified), tools/xlate/, runtime/gfx_shader.c (job layout from tools/shader_census.py; c2 handle ranges of totk_xlate/Service.cs for the reflection), runtime/vk_pipeline.c (the translator's set/binding and support-buffer conventions) |
deko3d block-linear image layout, as ported in MacNativeGames' nvn_tex.c (Apple parts dropped, layout math unchanged; licence text in games/totk/third_party/d2r_gfx/LICENSE.deko3d, reproduced in the file header) |
https://github.com/devkitPro/deko3d (source/dk_image.cpp), via MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (games/totk/third_party/d2r_gfx/gfx/nvn/nvn_tex.c, nvn_tex.h), Copyright (C) 2018-2020 fincs |
zlib | runtime/nvn_tex.c, runtime/nvn_tex.h |
| MacNativeGames texture auto-layout goldens (40 original-SDK size and block-height cases) | https://github.com/ly05010419/MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (games/totk/tests/texture_auto_layout/probe.c), Copyright (c) 2026 jhaizhou |
MIT | runtime/nvn_tex_probe.c; runtime/nvn_probe.c (four of the cases, through the procs) |
MacNativeGames block-linear deswizzler (address function; copy loop split out as tex_bl_copy) |
https://github.com/ly05010419/MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (games/totk/third_party/d2r_gfx/gfx/tex/nvn_deswizzle.c), Copyright (c) 2026 jhaizhou |
MIT | runtime/tex_deswizzle.c, runtime/tex.h |
SDL 3.4.18, dynamic link, SDL3.dll copied next to totk.exe. Developer builds use the MSYS2 build (mingw-w64-ucrt-x86_64-sdl3, which imports libiconv-2.dll, LGPL-2.1, unmodified, copied beside it); the installer release ships the upstream release SDL3-3.4.18-win32-x64.zip, which imports no libiconv |
https://libsdl.org, Copyright (c) 1997-2026 Sam Lantinga | zlib | runtime/input_win.c (gamepad input, rumble, gyro and accelerometer) |
libopus (MSYS2 mingw-w64-ucrt-x86_64-opus), dynamic link, libopus-0.dll copied next to totk.exe |
https://opus-codec.org, Copyright (c) 2001-2023 Xiph.Org, Skype Limited, Octasic, Jean-Marc Valin, Timothy B. Terriberry, CSIRO, Gregory Maxwell, Mark Borgerding, Erik de Castro Lopo, Mozilla, Amazon | BSD-3-Clause | runtime/ov_media.c (nn::codec hardware Opus decoder) |
| Dear ImGui 1.91.9 (core and Vulkan back end, unmodified), as vendored by LAS Recomp | https://github.com/ocornut/imgui, via https://github.com/peiikai/LASRecomp @ da35b83a9611d046a9a681aae668d7085954d37f (third_party/imgui/), Copyright (c) 2014-2025 Omar Cornut |
MIT | runtime/third_party/imgui/ (compiled into totk.exe for the in-game menu, runtime/ui/) |
| SavageWindRecomp settings menu: two-pane option rows (row look, left / right stepping, hold speed-up, description pane), the menu style and tab bar | https://github.com/Revivedx/SavageWindRecomp @ 575ad88e02f9a89a9a885d90039d48af33c982f4 (runtime/ui/option_rows.mm, runtime/ui/menu.mm), Copyright (c) 2026 Revivedx and the Savage Wind Recomp contributors, Copyright (c) 2026 Peiikai |
MIT | runtime/ui/option_rows.cpp, runtime/ui/option_rows.h, runtime/ui/menu.cpp |
Roboto Medium font (Dear ImGui's misc/fonts/Roboto-Medium.ttf, unmodified) |
https://fonts.google.com/specimen/Roboto, via https://github.com/peiikai/LASRecomp @ da35b83a9611d046a9a681aae668d7085954d37f (third_party/imgui/misc/fonts/), Copyright 2011 Google Inc. |
Apache-2.0 | runtime/ui/fonts/Roboto-Medium.ttf (licence text in runtime/ui/fonts/LICENSE-Roboto.txt), embedded by runtime/ui/menu.cpp |
Vulkan Memory Allocator 3.4.0 (MSYS2 mingw-w64-ucrt-x86_64-vulkan-memory-allocator), header-only, compiled into totk.exe |
https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator, Copyright (c) 2017-2026 Advanced Micro Devices, Inc. | MIT | runtime/vk_vma.cpp (the allocator behind runtime/vk_memory.c) |
MacNativeGames host movie decoder (movie::Decoder for VP9 over libvpx: entry list, buffer and event semantics, NV12 output format, PTS pacing) |
https://github.com/ly05010419/MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (games/totk/runtime/movie_host.c, movie_host.h), Copyright (c) 2026 MacNativeGames contributors |
MIT | runtime/ov_movie.c, runtime/movie.h |
libvpx 1.17.0 (MSYS2 mingw-w64-ucrt-x86_64-libvpx), static link (libvpx.a), no DLL shipped; the release notices must carry its BSD licence text and the WebM Project's PATENTS grant |
https://chromium.googlesource.com/webm/libvpx, Copyright (c) 2010, The WebM Project authors | BSD-3-Clause | runtime/ov_movie.c (VP9 decoding of the Event/Movie WebM files) |
Build-time tools (not distributed)
These tools run on the developer's or player's machine during the build. They are not part of this repository or of any release.
| Tool | Source | License | Purpose |
|---|---|---|---|
| hactool (the installer release ships it, see below) | https://github.com/SciresM/hactool @ 1d64a83450e025622f3468c28fc4164dad2c5ef6, with patches from MacNativeGames |
ISC | NCA and update container extraction |
| Capstone | https://www.capstone-engine.org | BSD-3-Clause | ARM64 disassembly for analysis |
| Unicorn | https://www.unicorn-engine.org | GPL-2.0 (Python bindings BSD) | Differential testing of the lifter; never linked into the game |
Distributed in the installer release
tools/make_release.py assembles these into the release folder of docs/installer.md. Versions and sha256 of every download are pinned in that script; licence texts are in the folder's licenses/ and in each component's own folder.
| Component | Source | License | Where in the release |
|---|---|---|---|
CPython 3.14.9 embeddable package, with tkinter and Tcl/Tk 9.0.4 taken from the python.org 3.14.9 installer's component MSI (unpacked, never run); includes vcruntime140*.dll (Microsoft, redistributable with Python), OpenSSL, libffi, SQLite, zlib, libtommath |
https://www.python.org/downloads/release/python-3149/ | PSF-2.0 (Tcl/Tk: Tcl/Tk licence, BSD-style) | python/ |
| numpy 2.5.4 (with its bundled OpenBLAS), lz4 4.4.5, cryptography 50.0.2 (with its bundled OpenSSL), cffi 2.1.1, pycparser 3.11 | PyPI binary wheels, pins in tools/requirements-installer.txt |
BSD-3-Clause; lz4 BSD-3-Clause; cryptography Apache-2.0 OR BSD-3-Clause; cffi MIT; pycparser BSD-3-Clause | python/Lib/site-packages/ |
| llvm-mingw 20261020 (LLVM/Clang/LLD 23, mingw-w64, libc++, libunwind, compiler-rt), x86_64 subset | https://github.com/mstorsjo/llvm-mingw/releases/tag/20261020 | Apache-2.0 with LLVM exception; mingw-w64 ZPL-2.1/BSD/public domain; libc++ and libunwind Apache-2.0 with LLVM exception and MIT/UIUC; winpthreads MIT | llvm/ |
SDL 3.4.18 upstream Windows release (SDL3.dll) and mingw development package (headers, libSDL3.dll.a) |
https://github.com/libsdl-org/SDL/releases/tag/release-3.4.18 | zlib | bin/SDL3.dll, runtime/deps/ |
libopus 1.6.1 (MSYS2 mingw-w64-ucrt-x86_64-opus 1.6.1-2; libopus-0.dll imports only KERNEL32 and the UCRT api-ms-win-crt DLLs), headers and import library |
https://repo.msys2.org/mingw/ucrt64/ | BSD-3-Clause | bin/libopus-0.dll, runtime/deps/ |
libvpx 1.17.0 (MSYS2 mingw-w64-ucrt-x86_64-libvpx 1.17.0-1), headers and static library compiled into totk.exe; libvpx-LICENSE.txt and libvpx-PATENTS.txt come from the v1.17.0 source tag |
https://github.com/webmproject/libvpx | BSD-3-Clause with the WebM patent grant | runtime/deps/, licenses/ |
Vulkan-Headers and Vulkan-Loader 1.4.363.0 (MSYS2 packages; headers and libvulkan-1.dll.a only, no loader DLL) |
https://github.com/KhronosGroup | Apache-2.0 OR MIT | runtime/deps/ |
| Vulkan Memory Allocator 3.4.0 (MSYS2 package), header | https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator | MIT | runtime/deps/ |
Ninja 1.13.2 (ninja-win.zip) |
https://github.com/ninja-build/ninja/releases/tag/v1.13.2 | Apache-2.0 | bin/ninja.exe |
hactool (SciresM @ 1d64a83450e025622f3468c28fc4164dad2c5ef6 plus MacNativeGames' portable-patches.diff: MNG_TITLE_KEYS and a relaxed BKTR size check; our unicode-patches.diff: an embedded manifest that makes UTF-8 the process code page), built with MSYS2 UCRT64 gcc; imports only KERNEL32 and the UCRT |
https://github.com/SciresM/hactool | ISC | bin/hactool.exe |
totk_xlate.exe (Ryujinx shader translator, NativeAOT build of tools/xlate/, see the Ryujinx row above) |
built by tools/build_xlate.py |
MIT | bin/totk_xlate.exe |
| MacNativeGames shader variant list | https://github.com/ly05010419/MacNativeGames @ b75be8cfa704df3701e86130c8ced268e79d6b11 (games/totk/assets/shader_list.tsv), Copyright (c) 2026 MacNativeGames contributors |
MIT | data/shader_list.tsv |