Building Godot 3.5 for Nintendo Switch

These steps must be done under Linux / Windows Subsystem for Linux (WSL) or MSYS2 on Windows.

Dependencies

If you haven't done so already, install the dependencies called for by the official Godot docs

1. Install devkitPro pacman or add DKP to your existing pacman configuration:
2. Install the required packages from the terminal

   # On systems without pacman pre-installed (Such as Debian, Ubuntu):
   sudo dkp-pacman -S switch-pkg-config switch-freetype switch-bulletphysics switch-libtheora switch-libpcre2 switch-mesa switch-opusfile switch-mbedtls switch-libwebp switch-libvpx switch-miniupnpc switch-libzstd switch-wslay

   OR

   # On systems with pacman pre-installed (Such as Arch, Manjaro, MSYS2):
   sudo pacman -S switch-pkg-config switch-freetype switch-bulletphysics switch-libtheora switch-libpcre2 switch-mesa switch-opusfile switch-mbedtls switch-libwebp switch-libvpx switch-miniupnpc switch-libzstd switch-wslay

Getting the source code

1. Clone the repo
   git clone https://github.com/Homebrodot/Godot
2. Navigate to the cloned repo
   cd Godot
3. Checkout the main/3.5 branch
   git checkout origin/main/3.5

Building

1. Run scons platform=switch in the root of the repo.
   Add target=release to the end to build for release instead of debug.
2. Run misc/scripts/build/create-switch-release.sh from inside the bin folder to create an installable release for your Switch.
3. Run misc/scripts/build/create-switch-template.sh from inside the bin folder to create an export template for your editor.

Exporting for Nintendo Switch

The editor releases add a Switch exporter to the list - it can generate a Switch homebrew NRO or a generic Godot PCK file that can be transferred to your Switch.

If additional debugging is required, sending the NRO file via nxlink (make sure to send it to the right place with the -p argument) will allow the output of the console to be viewed on PC.

Frequently Asked Questions

Why won't my game run in Ryujinx / Yuzu / Suyu / Skyline?

Nintendo Switch emulators are currently not capable of running our fork of Godot.
Please use a real Nintendo Switch with custom firmware.