Skip to content

Building from Source

Samuel Costa edited this page Jun 28, 2026 · 1 revision

Building from Source

You don't need to build the plugin to use it — grab the .zip from Releases instead. This page is for contributors.

Requirements

  • devkitPro (with devkitARM)
  • The CTRPluginFramework toolchain from ThePixellizerOSS (added via pacman below)

Steps

  1. Install devkitPro.

  2. Open C:/devkitPro/msys2 and run msys2_shell.bat.

  3. Add the ThePixellizerOSS package repos — paste and run:

    if ! grep -Fxq "[thepixellizeross-lib]" /etc/pacman.conf; then echo -e "\n[thepixellizeross-lib]\nServer = https://thepixellizeross.gitlab.io/packages/any\nSigLevel = Optional" | tee -a /etc/pacman.conf > /dev/null; fi; if ! grep -Fxq "[thepixellizeross-win]" /etc/pacman.conf; then echo -e "\n[thepixellizeross-win]\nServer = https://thepixellizeross.gitlab.io/packages/x86_64/win\nSigLevel = Optional" | tee -a /etc/pacman.conf > /dev/null; fi
  4. Run pacman -Sy and confirm the ThePixellizerOSS databases appear.

  5. Run Release.bat in the plugin directory.

The build produces Gen6CTRPluginFramework.3gx, which goes into luma/plugins/<Title ID>/ (see Installation).

Notes

  • One binary serves all four Gen 6 games — the game is detected at runtime, so there's no per‑game fork to build.
  • UI strings live in the Gen6CTRPluginFramework/Language/*.txt files and are loaded at runtime, not compiled in — so text changes don't require a rebuild. See Languages.

Clone this wiki locally