iChris4andClaude Opus 5
c11a7c9a61
Ported from heurazy's mario-kart-wii-VR-port. F10 > Controllers > USB wheel and pedals (also in the headset panel) picks and calibrates the steering axis and both pedals by moving them, and assigns buttons by pressing them, over raw SDL joysticks: no per-model table or gamepad mapping, and separate pedals, reversed axes and combined pedal axes all calibrate the same way. Settings live in PhysicalWheel.toml beside Config.toml; heurazy's five-button files load unchanged. The wheel is player 1's GameCube controller. In a race it owns port 0 (steering on the stick, the accelerator on A, the brake pedal braking then reversing over A and drift, the paddles on R and L), keeping only the other source's pause and item aim. In menus it adds only deliberate presses. It arms once every pedal and button is released, stays neutral in a race while its setup is incomplete, and nothing is opened until it is enabled. Optional light rumble follows the game's own, capped at 15 %. Added here: its confirm, a new back button and the steering device's first hat (D-pad) work the menus, since our VR controllers default to a Wii Remote and the wheel needs to navigate on its own. Devices SDL classifies as wheels are marked in the list. In the VR cockpit the wheel follows the hardware steering and hand steering steps aside while it drives. README documents setup and Logitech notes (G HUB, the G29's PS3 switch, shifter gears as buttons); not yet tried on a physical wheel. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
15 KiB
Third-Party Notices
WiiCompiled itself is licensed under the GNU General Public License v3.0
(see LICENSE). It incorporates, links against, or redistributes the third-party
components listed below. Each remains under its own license and copyright.
Nothing listed here is Nintendo intellectual property. This project ships no game code, assets, or data of any kind - see the README.
Bundled in this repository
aurora - MIT
Copyright (c) 2022 Luke Street.
Source: https://github.com/encounter/aurora - vendored in aurora-main/, license text at
aurora-main/LICENSE.
Aurora itself vendors:
- magic_enum 0.7.2 - MIT, Copyright (c) 2019-2021 Daniil Goncharov.
aurora-main/include/magic_enum.hpp. Source: https://github.com/Neargye/magic_enum - libogc-derived SRAM structures - zlib-style license, Copyright (c) Michael Wiedenbauer
(shagkur) and Dave Murphy (WinterMute).
aurora-main/lib/card/SRAM.hpp. Source: https://github.com/devkitPro/libogc
Dolphin Emulator data files - GPL-2.0-or-later
Copyright (c) 2003+ Dolphin Emulator Project. Source: https://github.com/dolphin-emu/dolphin - license at https://github.com/dolphin-emu/dolphin/blob/master/COPYING
Two data sets from Dolphin's Data/Sys tree are redistributed here under GPL-2.0-or-later:
| File(s) | Upstream path | Notes |
|---|---|---|
runtime/assets/dsp/dsp_coef.bin |
Data/Sys/GC/dsp_coef.bin |
Free DSP polyphase-resampling coefficient ROM written by the Dolphin team. 4096 bytes, SHA-256 D7741279C2E8EC5C5FB318F8FBDD6DE6BF583520D288E836A5383233A4238179. The runtime verifies this hash at build time. |
runtime/assets/wii/shared2/wc24/** |
Data/Sys/Wii/shared2/wc24 |
Dolphin's unmodified default WiiConnect24 bootstrap tree, used to seed a newly created per-user NAND on first run. It is byte-identical to the upstream directory. nwc24dl.bin contains Dolphin's default task list, which references Nintendo endpoints shut down in 2014; nwc24msg.cfg contains Dolphin's placeholder account fields, not a real user's account data. |
Neither contains Nintendo executable code or game assets; both are redistributed under
GPL-2.0-or-later from Dolphin's Data/Sys tree.
SHA-256 hashes for the WiiConnect24 bootstrap tree:
| File | SHA-256 |
|---|---|
runtime/assets/wii/shared2/wc24/misc.bin |
13DD5B6B2682DEFD3B23AFD8E2983D00EDC25BD4DC28A8389380DEE0EC45A4A5 |
runtime/assets/wii/shared2/wc24/nwc24dl.bin |
057B6F840C19B41CE080318BC7E717E2B910965CE72AB781A7E319017636C38E |
runtime/assets/wii/shared2/wc24/nwc24fl.bin |
ED94AF416C47ED3BC2C944EBCD1D734B8935D9697FEB0F7039D8FEA3EC514C18 |
runtime/assets/wii/shared2/wc24/nwc24fls.bin |
C3A4A5649D6ED2322A0DE98D2258B96A6A1D3C0179854FD21E9835D529736822 |
runtime/assets/wii/shared2/wc24/nwc24msg.cbk |
7AFEBF33EEB0035397CC74E15E892E700CD2903641D26562F5D46CFBB6171109 |
runtime/assets/wii/shared2/wc24/nwc24msg.cfg |
7AFEBF33EEB0035397CC74E15E892E700CD2903641D26562F5D46CFBB6171109 |
runtime/assets/wii/shared2/wc24/mbox/Readme.txt |
E5A888912968050C6C1D46D1C364C324684E1D15AAA62CFE36CF7FCE2C687B21 |
runtime/assets/wii/shared2/wc24/mbox/wc24recv.ctl |
EFA39268E7071941E4FE429D49C86D73BEE952DF95D91D7909C478DD1BC9050A |
runtime/assets/wii/shared2/wc24/mbox/wc24recv.mbx |
DD2AD8C9FB38884523459963BFAEC5D5AEAA5FD20EFCDC209764D461E690E435 |
runtime/assets/wii/shared2/wc24/mbox/wc24send.ctl |
430C3795F1A0AEB198BF626A4A2FF6D123321D453807DD7B904DC3B74DB35D13 |
runtime/assets/wii/shared2/wc24/mbox/wc24send.mbx |
C248DC031CE09F7BE1E55956B6F173E79D6A47D913C22A16593C4687325692B7 |
Dolphin was also used extensively as a behavioural reference during development of this project's hardware and IOS high-level implementations.
Dolphin Emulator Riivolution code - GPL-2.0-or-later
Copyright (c) 2021 Dolphin Emulator Project.
The runtime's Riivolution patch handling is a port of Dolphin's
Source/Core/DiscIO/RiivolutionParser.{h,cpp} and the external-path resolution rules of
Source/Core/DiscIO/RiivolutionPatcher.cpp, adapted in
runtime/include/hle/riivolution_contract.h and runtime/src/hle/storage/riivolution.cpp
(both marked SPDX-License-Identifier: GPL-2.0-or-later).
Source: https://github.com/dolphin-emu/dolphin
heurazy's mario-kart-wii-VR-port - GPL-3.0-or-later
- Source: https://github.com/heurazy/mario-kart-wii-VR-port
- Author: heurazy
- License: GNU General Public License v3.0 or later, the same license as WiiCompiled.
The VR cockpit's steering wheel and hand steering are ported from this project: the grab-and-turn
model (runtime/include/vr/steering_wheel.h), the native wheel vertex rotation
(runtime/include/vr/native_wheel_mesh.h), the level seat (runtime/include/vr/cockpit_stabilizer.h),
the runtime hand-mesh loader (runtime/include/vr/openxr_hand_mesh.h), the per-draw substitution
(aurora-main/include/aurora/native_wheel_match.hpp, aurora-main/lib/gx/native_wheel.hpp), the
cockpit overlay renderer (aurora-main/lib/gfx/cockpit.hpp), their tests, and the seat, eye and
wheel geometry and guest reads in runtime/src/vr/mkw_vr_first_person.cpp and
runtime/include/vr/mkw_vr_first_person.h. The USB wheel and pedal support is ported from it too
(runtime/include/physical_wheel.h, runtime/src/physical_wheel.cpp and their test). The files
carry that attribution in their headers.
pugixml - MIT
Copyright (c) 2006-2025 Arseny Kapoulkine.
The Riivolution XML reader uses pugixml 1.15, vendored in
runtime/third_party/pugixml from commit ee86beb30e4973f5feffe3ce63bfa4fbadf72f38.
Source and license: https://github.com/zeux/pugixml
Crypto++ 8.9.0 - Boost Software License 1.0 / public domain
Copyright (c) 1995-2019 Wei Dai and contributors.
The runtime uses Crypto++ for SHA-1 and sect233r1 ECDSA key derivation and signing. Its portable
sources are vendored in runtime/third_party/cryptopp; assembly implementations are disabled.
Source: https://github.com/weidai11/cryptopp/tree/CRYPTOPP_8_9_0. Full license text:
runtime/third_party/cryptopp/License.txt.
toml11 4.4.0 - MIT
Copyright (c) 2017 Toru Niina.
The runtime configuration reader and scalar string writer use the single-header distribution,
vendored in runtime/third_party/toml11.
Source: https://github.com/ToruNiina/toml11/tree/v4.4.0. Full license text:
runtime/third_party/toml11/LICENSE.
YamlDotNet - MIT
Copyright (c) Antoine Aubry and contributors.
Referenced by translator/src/Translator.Core. Source: https://github.com/aaubry/YamlDotNet
libco - ISC (valgrind.h: BSD-style)
Copyright byuu and the higan team.
Non-Windows builds use libco's symmetric stackful coroutines in place of Win32 Fibers for guest
OSThread scheduling (runtime/src/fiber_manager.cpp). Vendored in full (all non-Windows
CPU-architecture backends - amd64, x86, arm, aarch64, ppc, ppc64v2, plus the portable sjlj
fallback - though this project's x86_64-only target only ever compiles amd64.c) in
runtime/third_party/libco from commit e18e09d634d612a01781168ad4d76be10a7e3bad.
Source: https://github.com/higan-emu/libco. Full license text:
runtime/third_party/libco/LICENSE.
Fetched at build time and redistributed in release builds
These are pinned in aurora-main/extern/CMakeLists.txt, aurora-main/CMakeLists.txt and
aurora-main/cmake/AuroraDawnProvider.cmake. They are not stored in this repository; the build
downloads them, and release installers carry the resulting binaries. Their license texts are
included in the installer's licenses/ folder. The Windows installer bundles the pinned source
trees themselves (fetched by Launcher/Prepare-Dependencies.ps1) so end-user builds run offline.
| Component | Version | License | Upstream |
|---|---|---|---|
| Dawn (WebGPU) | v20260603.191052 prebuilt |
BSD-3-Clause | https://dawn.googlesource.com/dawn |
| Tint (part of Dawn) | with Dawn | BSD-3-Clause | https://dawn.googlesource.com/dawn |
DirectXShaderCompiler (dxcompiler.dll) |
with Dawn | NCSA / University of Illinois Open Source | https://github.com/microsoft/DirectXShaderCompiler |
| SDL | 3.4.4 | zlib | https://github.com/libsdl-org/SDL |
| libusb (linked into SDL on Windows) | 1.0.30 | LGPL-2.1-or-later | https://github.com/libusb/libusb |
| Abseil | LTS 20240722.0 | Apache-2.0 | https://github.com/abseil/abseil-cpp |
| Dear ImGui | 1.91.9b-docking | MIT | https://github.com/ocornut/imgui |
| {fmt} | 11.1.4 | MIT | https://github.com/fmtlib/fmt |
| xxHash | 0.8.3 | BSD-2-Clause | https://github.com/Cyan4973/xxHash |
| zlib | 1.3.2 | zlib | https://github.com/madler/zlib |
| libpng | 1.6.58 | PNG Reference Library License v2 | https://github.com/pnggroup/libpng |
| FreeType | 2.14.3 | FreeType License (FTL) - see below | https://freetype.org/ |
| Zstandard | 1.5.7 | BSD-3-Clause - see below | https://github.com/facebook/zstd |
| SQLite | 3.51.3 amalgamation | Public domain | https://sqlite.org/ |
| Tracy Profiler | pinned commit | BSD-3-Clause | https://github.com/wolfpld/tracy |
| C++/WinRT | - | MIT (Microsoft) | https://github.com/microsoft/cppwinrt |
| OpenXR-SDK | 1.1.61 | Apache-2.0 | https://github.com/KhronosGroup/OpenXR-SDK |
| nodtool (disc image extraction) | v2.0.0-alpha.10 | MIT OR Apache-2.0 | https://github.com/encounter/nod |
The Meta Quest APK builds nod itself into libnod_jni.so (android/nod-jni) for its disc image
extraction, and that library also carries the compression code nod reads WIA and RVZ images with.
The Rust crates pulled in by android/nod-jni/Cargo.lock are all MIT, Apache-2.0, BSD, Zlib,
Unicode-3.0, BSL-1.0 or Unlicense licensed.
| Component (Quest APK) | Version | License | Upstream |
|---|---|---|---|
| nod | v2.0.0-alpha.10 | MIT OR Apache-2.0 | https://github.com/encounter/nod |
| Zstandard (via zstd-sys) | 1.5.7 | BSD-3-Clause | https://github.com/facebook/zstd |
| XZ Utils liblzma (via liblzma-sys) | liblzma-sys 0.4.9 | 0BSD | https://github.com/tukaani-project/xz |
| bzip2 (via bzip2-sys) | 1.0.8 | bzip2 license (BSD-style) | https://sourceware.org/bzip2/ |
| jni-rs | 0.21.1 | MIT OR Apache-2.0 | https://github.com/jni-rs/jni-rs |
For building the game on the headset, the APK also carries a toolchain
(android/Prepare-QuestToolchain.ps1): the translator published with the .NET 10 runtime for
linux-bionic-arm64, and Termux's Android builds of clang and lld with the libraries they load,
redistributed unmodified from the Termux package repository (pins and license names in the script
and in the toolchain's llvm/licenses/).
| Component (Quest APK toolchain) | Version | License | Upstream |
|---|---|---|---|
| .NET runtime (Mono, linux-bionic-arm64) | 10.0 | MIT | https://github.com/dotnet/runtime |
| YamlDotNet | 15.1.2 | MIT | https://github.com/aaubry/YamlDotNet |
| LLVM clang, lld, libLLVM, libc++ (Termux clang/lld/libllvm 21.1.8-3, libc++ 29) | 21.1.8 | Apache-2.0 WITH LLVM-exception | https://github.com/termux/termux-packages |
| libffi | 3.8.0 | MIT | https://github.com/libffi/libffi |
| libxml2 | 2.15.4 | MIT | https://gitlab.gnome.org/GNOME/libxml2 |
| GNU libiconv | 1.19 | LGPL-2.1-or-later | https://www.gnu.org/software/libiconv/ |
| zlib | 1.3.2 | Zlib | https://zlib.net/ |
| Zstandard | 1.5.7 | BSD-3-Clause | https://github.com/facebook/zstd |
| OpenSSL | 3.6.3 | Apache-2.0 | https://www.openssl.org/ |
libiconv is LGPL-licensed and ships as the unmodified shared library libiconv.so, which can be
replaced; its complete corresponding source is available from the Termux package repository and
from GNU, and this project will supply it on request for the version shipped.
Dual-licensed components - elections made by this project
-
FreeType is offered under the FreeType License (FTL) or GPL-2.0. This project elects the FreeType License. The FTL requires the following credit, which is given here and reproduced in distributed builds:
Portions of this software are copyright © 2026 The FreeType Project (www.freetype.org). All rights reserved.
-
Zstandard is offered under BSD-3-Clause or GPL-2.0. This project elects BSD-3-Clause. Copyright (c) Meta Platforms, Inc. and affiliates.
Bundled in the setup executable's toolkit payload
The distributed WiiCompiled-Setup.exe carries a build toolkit so that translation and
compilation can run on a machine with nothing preinstalled. These tools are redistributed
unmodified, with their license texts, in the installer's licenses/ folder.
| Component | License | Upstream |
|---|---|---|
| llvm-mingw (Clang, LLD, libc++, libunwind, MinGW-w64 runtime) | Apache-2.0 with LLVM Exception; MinGW-w64 runtime under its own permissive terms; bundled GNU utilities under GPL-2.0-or-later or GPL-3.0-or-later | https://github.com/mstorsjo/llvm-mingw |
| CMake | BSD-3-Clause | https://cmake.org/ |
| Ninja | Apache-2.0 | https://ninja-build.org/ |
| nodtool (disc image extraction) | MIT OR Apache-2.0 | https://github.com/encounter/nod |
Microsoft Visual C++ Runtime (vcruntime140.dll, vcruntime140_1.dll, msvcp140.dll) |
Microsoft redistributable terms | Microsoft Visual Studio |
dxil.dll |
Microsoft redistributable (proprietary signing library) | Microsoft |
Important
The GNU utilities bundled inside llvm-mingw are GPL-licensed. Their complete corresponding source is available from the upstream project linked above at its pinned version, and this project will supply it on request for the exact version shipped in any given release. Pins live in
Launcher/Prepare-PortableTools.ps1andLauncher/NativeBuildFlags.ps1.
Downloaded on the user's machine, never redistributed
| Component | License | Upstream |
|---|---|---|
Android NDK r29 for Windows (clang, lld, sysroot), fetched by --build-quest from Google with a pinned SHA-1 |
Android Software Development Kit License Agreement | https://developer.android.com/studio/terms |
| Android NDK r29 aarch64 sysroot, compiler-rt builtins, libunwind and libatomic, fetched by the Quest app's Build on this Quest from Google's Linux NDK zip with pinned SHA-256s | Android Software Development Kit License Agreement | https://developer.android.com/studio/terms |
Development-only dependencies
Not redistributed in any release artifact.
| Component | License |
|---|---|
| xUnit.net 2.4.2, xunit.runner.visualstudio 2.4.5 | Apache-2.0 |
| Microsoft.NET.Test.Sdk 17.6.0 | MIT |
| coverlet.collector 6.0.0 | MIT |
| .NET 8 SDK | MIT |
Reference material
Not code, but the documentation this project depends on:
- WiiBrew - Wii hardware and IOS documentation.
- Custom Mario Kart Wiiki (Tockdom) - Mario Kart Wii file formats and modding documentation.
- Retro Rewind by ZPL - the mod distribution this project can build as a static profile. No Retro Rewind content is redistributed here; users supply their own copy.
- The references heurazy's mario-kart-wii-VR-port credits for the cockpit, none of whose source is compiled into this repository: AnimalCrossing-VR-MR-Standalone (OpenXR hand meshes), Cyberpunk VR port (squeeze-to-grab steering) and Pulsar (Mario Kart Wii class layouts).
If you believe a component is missing or misattributed here, please open an issue.