An NDS/PSV 3D engine with a Windows desktop editor.

This project is in active development. Features and APIs may change.

• Windows 10/11
• Visual Studio 2022+ (MSVC C++17)
• CMake 3.16+
• Visual C++ Redistributable (required to run pre-built releases — download)

Each build target needs its own toolchain — see Build Targets below. You can install only the ones you need.

git clone https://github.com/myuu-151/Affinity.git
cd Affinity
cmake -S . -B build
cmake --build build --config Release

Run the editor:

build\Release\AffinityEditor.exe

Author your project once, then package it for any target. In the editor, pick a target and build — it exports that target's data headers and invokes the matching toolchain automatically.

GBA and NDS use the software/hardware 2D+3D path; PSP and PS Vita are Mode 4 / 3D targets.

Toolchain — install devkitPro from devkitpro.org, then in the devkitPro MSYS2 terminal:

pacman -S devkitARM libtonc

The installer usually sets DEVKITPRO=/opt/devkitpro and DEVKITARM=/opt/devkitpro/devkitARM.

Build — in the editor, click GBA Build. It exports mapdata.h and runs make. Output:

gba_runtime/affinity.gba

Open it in mGBA (the editor can launch it for you), or flash it to a real GBA.

# after exporting mapdata.h from the editor
cd gba_runtime
make

Toolchain — install devkitPro (same installer as GBA), then add the NDS packages in the devkitPro MSYS2 terminal:

pacman -S nds-dev      # pulls devkitARM, libnds, calico, maxmod, etc.

Build — in the editor, click NDS Build. It exports the NDS data headers and runs make in nds_runtime/. Output:

nds_runtime/affinity.nds

Run it in melonDS.

DeSmuME does not work with modern libnds homebrew (the calico ARM7 core) — use melonDS for testing.

# devkitPro MSYS2 shell, after exporting from the editor
cd nds_runtime
make

PSP packaging uses the pspdev toolchain. Because pspdev ships Linux binaries, the editor invokes it through WSL.

Toolchain

1. Install WSL (Ubuntu): run wsl --install in an elevated PowerShell, then reboot.
2. Inside WSL, install pspdev — follow pspdev.github.io (or use the pspdev installer). Make sure PSPDEV is set and psp-gcc is on the PATH.

Build — in the editor, select the PSP build target and build. It exports the PSP data headers (psp_mapdata.h, psp_rig.h, psp_sprites.h, psp_sound.h, …) and runs make in psp_runtime/. Output:

psp_runtime/EBOOT.PBP

Run it in PPSSPP, or copy it to a real PSP under PSP/GAME/<folder>/EBOOT.PBP.

# inside WSL, after exporting the PSP headers from the editor
cd psp_runtime
make clean; make

PS Vita packaging uses VitaSDK, invoked through the devkitPro MSYS2 shell (CMake + make).

Toolchain — install VitaSDK to C:\vitasdk by following vitasdk.org (the vdpm bootstrap). The editor expects VITASDK=/c/vitasdk.

Build — in the editor, select the PS Vita build target and build. It exports the PSV data headers (psv_mapdata.h, psv_rig.h, psv_sprites.h, psv_hud.h, …) and runs cmake .. && make in psv_runtime/build. Output:

psv_runtime/build/affinity_psv.vpk

Install it on a real Vita with VitaShell, or run it in Vita3K.

Vita3K: install libshacccg.suprx into ur0:/data/ (Vita3K can't compile shaders without it). The runtime already builds with the Vita3K-support flags enabled.

# devkitPro MSYS2 shell, after exporting the PSV headers from the editor
export VITASDK=/c/vitasdk
export PATH="$VITASDK/bin:$PATH"
cd psv_runtime && mkdir -p build && cd build
cmake .. && make

src/
  editor/          — ImGui editor (main loop, frame tick)
  viewport/        — Software 3D rasterizer and Mode 7 preview
  map/             — Mesh, sprite, and tilemap data types
  math/            — Fixed-point types, camera struct
  platform/gba/    — GBA ROM packaging (invokes devkitARM)
  platform/nds/    — NDS ROM packaging
  platform/psp/    — PSP EBOOT packaging (invokes pspdev via WSL)
  platform/psv/    — PS Vita VPK packaging (invokes VitaSDK)
  platform/common/ — Shared node-graph -> C codegen (NDS + PSV)
gba_runtime/
  source/          — GBA runtime (software polygon renderer, OAM sprites, input)
  include/         — Generated mesh and map data header (mapdata.h)
nds_runtime/
  source/          — NDS runtime
psp_runtime/
  source/          — PSP runtime (Mode 4 / 3D, sceGu)
  include/         — Generated PSP data headers
psv_runtime/
  main.c, audio.c  — PS Vita runtime (Mode 4 / 3D, vitaGL)
  include/         — Generated PSV data headers
thirdparty/
  glfw/            — Windowing
  imgui/           — UI framework

MIT