forked from godotengine/godot
-
Notifications
You must be signed in to change notification settings - Fork 2
Building Godot 3.5 for Nintendo Switch
Caroline Joy Bell edited this page Oct 18, 2024
·
8 revisions
These steps must be done under Linux / Windows Subsystem for Linux (WSL) or MSYS2 on Windows.
If you haven't done so already, install the dependencies called for by the official Godot docs
- Install devkitPro pacman or add DKP to your existing pacman configuration:
- Install the required packages from the terminal
OR
# 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
# 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
- Clone the repo
git clone https://github.com/Homebrodot/Godot
- Navigate to the cloned repo
cd Godot
- Checkout the
main/3.5
branch
git checkout origin/main/3.5
- Run
scons platform=switch
in the root of the repo.
Addtarget=release
to the end to build for release instead of debug. - Run
misc/scripts/build/create-switch-release.sh
from inside thebin
folder to create an installable release for your Switch. - Run
misc/scripts/build/create-switch-template.sh
from inside thebin
folder to create an export template for your editor.
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.
Why won't my game run in Ryujinx 🪦 / Yuzu 🪦 / Skyline 🪦 / Suyu?
Nintendo Switch emulators are currently not capable of running our fork of Godot.
Please use a real Nintendo Switch with custom firmware.
- 2.x
- 3.x
- Nintendo Wii
- 3.5 for Nintendo Switch
- 3.5 for Playstation Vita
- 4.x
- *New* Nintendo 3DS
- 4.2 for Nintendo Wii U
- Nintendo Switch