N64 Exporter for Armory 3D

Export games for the Nintendo 64 with Armory 3D using fast64, libdragon and tiny3d.

Notes: this project is experimental and in development. Working with Armory 2026.2 and Blender 4.5.

Supported features:

• Scenes:
  • cameras
  • directional lights
  • transitions (using Scene.setActive)
  • parent/child hierarchy
• Objects with Traits:
  • Transform.translate
  • Transform.rotate
  • Transform.scale
• Asset brower/Linked blend files
• Gamepad input (with hardcoded mapping)
• Physics (a stripped down OimoPhysics engine):
  • RigidBody.applyForce
  • RigidBody.notifyOnContact
  • shapes and contacts debugging
  • sphere, box, capsule and static mesh colliders
• UI (Koui Editor):
  • labels (font family, text color and font size)
  • image panels
  • panels
  • buttons
• Audio (Aura)
• Render2D (kha.graphics2.Graphics):
  • fillRect
  • color
• Animation actions

Pre-requisites

• Windows 11
• MSYS2: https://www.msys2.org/
• Ares emulator: https://ares-emu.net/
• libdragon's toolchain: https://github.com/DragonMinded/libdragon/releases/tag/toolchain-continuous-prerelease (follow Windows users with MSYS2 steps 1 and 2 to install it)
• Fast64: this specific branch https://github.com/moisesjpelaez/fast64/tree/f3d-to-bsdf

Installation

• Locate the .blend file you are working with
• Create Libraries folder alongside your .blend file
• Clone these into Libraries folder:

  git clone https://github.com/DragonMinded/libdragon.git -b preview
  git clone https://github.com/HailToDodongo/tiny3d.git
  git clone https://github.com/moisesjpelaez/armor_64.git
  git clone https://github.com/moisesjpelaez/koui_editor.git
  git clone https://github.com/armory3d/oimo_module
  git clone https://github.com/armory3d/OimoPhysics
  

• Create Subprojects folder alongside your .blend file
• Clone these into Subprojects folder:

  git clone https://github.com/MoritzBrueckner/aura.git
  git clone https://gitlab.com/moises.jpelaez/Koui.git -b koui_editor
  

Setup

• Go to Edit > Preferences > Add-ons > Armory > N64 Settings and set the paths for:
  • N64 toolchain
  • MSYS2 Bash Executable
  • MinGW 64
  • Ares Emulator
• Click Install Dependencies and wait for it to finish
• Click Build libdragon and wait for it to finish
• Click Build Tiny3D and wait for it to finish
• Set Render > Armory Project > Modules > Physics Engine to Oimo

License

This project is licensed under the terms of the zlib License. See the LICENSE file for details.

Support the project.