A tool designed so that, together with a custom hxcpp fork and the DevKita64 tools, you can compile a Haxe program for the Nintendo Switch and even for other platforms!
This is inspired by an attempt by the RetroNX Team to use Haxe on the Nintendo Switch. I used part of the original project for this so credit goes to them for achieving this in the first place!
This project is being tested with Haxe 4.3.6 and a Nintendo Switch V2 with firmware 20.4.0 and Atmosphère 1.9.4.
Officially there are supported libraries or utilities to be used in conjunction with HaxeNXCompiler:
-
hx_libnx: Haxe/hxcpp
@:nativebindings for libnx, the Nintendo Switch's homebrew library. -
Vupx Engine: A framework engine 2D and 3D built with Haxe, SDL2 and OpenGL 4.3 that can be used to make games for the Nintendo Switch.
-
Lime-NX: Use Lime projects such as OpenFL and even HaxeFlixel on the Nintendo Switch!!! (HaxeNXCompiler comes integrated with Lime-NX, so you don't really need this program to use Lime-NX.) (This is the limit of HaxeNXCompiler).
- Switch Funkin': Psych Engine 1.0.4 on the Nintendo Switch, enjoy the real experience of Friday Night Funkin' on your console!
The term "officially" does not mean that only these libraries will work with this tool; they are simply the libraries that I have created specifically for this project and for the Nintendo Switch. However, you can try any libraries you want that are in Haxelib! (with certain limitations; remember that this is a separate target from the normal ones and is experimental; libraries that depend on C++ libraries will generally not work without changes).
Well, let's start at the beginning.
Haxe on Nintendo Switch can be used officially through the Nintendo Developer program, giving access to modified versions of certain Haxe libraries, but as far as I know, these are old libraries alongside an old version of Haxe and an old version of hxcpp.
When I started wanting a Wii U, I found out about a very old case of bringing Haxe, or rather OpenFL, to consoles, called "OpenFL for Home Game Consoles.". Among the “targets” was the Wii U. I don't know what came of that, but I don't think it was anything important or interesting. I currently understand that the only console where Haxe is supported is the Nintendo Switch.
To which I had found a project that modified hxcpp to make it functional with the Nintendo Switch, but it was a very basic attempt at just a "hello world.", that project was switch-haxe.
Although with the Wii U I had to choose to use Reflaxe/C++ to use Haxe there, which resulted in HxCompileU, when I got a Nintendo Switch, I already knew that I could use Haxe with hxcpp on this console. And that's what this project is about:
Providing the ability to use Haxe on a Nintendo Switch freely and with what the homebrew of this console allows!
This tool helps you compile a Haxe project more easily and obtain executable files for a Nintendo Switch.
An XML project file is used, based on the XML file of Haxe projects made with Lime/OpenFL.
Want to start a new project? Then go to the guide on how to get started.
Want create a library for this tool? Then go to the guide on how to create a library.
Want to use assets with this tool? Then go to the guide on how to use assets.
This project is released under the MIT License.
