Play your MakeCode Arcade games on a real handheld (open-source RetroArch core)

Hi everyone!

I’d like to show something I’ve been working on: an unofficial, open-source MakeCode Arcade core for RetroArch that runs Arcade games on real handhelds — real buttons, real fullscreen, no browser.

What it is

  • A libretro core that runs the same bytecode your game compiles to. There is no JavaScript engine inside: it executes the pxt-compiled .pxt64 cartridge natively on 64-bit CPUs, which is why it runs smoothly even on low-end ARM handhelds.

  • It loads into RetroArch like any other core, so it works on Windows / Linux / Android devices.

  • Fully open source (MIT): https://github.com/whmzsu/makecode-arcade-libretro

  • Unofficial project — not affiliated with or endorsed by Microsoft.

Below is Jumpy Platformer running on a Powkiddy RGB30 (RK3566) via RetroArch:

What hardware do you need?

  • Linux handhelds: any device with an RK3326 or newer SoC and a 64-bit RetroArch build — RGB30, RG351 series and friends (r36s or clones) all work. (The core is 64-bit only: a 32-bit frontend can load it but cannot run anything, because the official pxt compiler has no 32-bit output.)

  • Android: also works, but be aware that manually installing a core into RetroArch on Android is a bit more involved than dropping a file into the cores folder on Linux.

How to export your own game as a .pxt64 cartridge

You don’t need to install anything — the official online IDE can already do it. Enable the experimental VM hardware target, and the Download button produces a .pxt64 file that this core can run:

  1. In the IDE, open the :gear: menu → About… → click Experiments

  2. Switch Experimental Hardware to Enabled

  3. Back in the editor: … → Choose Hardware → pick VM

  4. Click Download — you get a .pxt64 cartridge file

Step-by-step with screenshots (English / 中文): https://github.com/whmzsu/makecode-arcade-cartconv/blob/main/MakeCode%20Arcade%20如何官方导出pxt64/官方导出pxt64指导.en.md

Status

  • Release packages for 6 platforms (Windows x64/ARM64, Linux x64/ARM64, Android, Lakka) on the Releases page.

  • Sound, music, sprites and the save-data directory are all handled; RetroPad buttons are remappable.

  • If a game of yours doesn’t work, please open an issue on GitHub with the game’s share link — that’s the fastest way to get it fixed.

Feedback very welcome — especially “my game runs!” / “my game doesn’t” reports. :video_game:

10 Likes

Nice tutorial! Just wondering where you found the game you used for it and if the creator is still around?

5 Likes

Works pretty good on my retroid pocket flip 2! I did notice sprite animations didnt really work though (i tried it with jumpy platformer, im using the arm android version)

I random select a game on the offical online ide , So it should be still there , but Sorry I forgot the game name.

1 Like

its magnate by some guy name like hexadevil or smth

2 Likes

Could you provide more details and the game url ? Then I can have a test

Hi Jedi, I tested on my android phone and my observation is 1 keep still – no animation 2 jumping or moving — do have animation .

wait, what about games that have that keyboard exclusive functions extenison?

Hi Alex, do you have “keyboard exclusive functions extenison” offical doc or url ? then I can have a deep dig on it.

1 Like

yeah

https://arcade.makecode.com/reference/browser-events

1 Like

@AlexTheGoober64 @TheGooberEarth This extension only works in the official browser JS simulator, not on physical hardware. Since the RetroArch core emulates the actual hardware rather than the browser simulator, full keyboard (ASCII) input isn’t supported and is currently not on the roadmap.

2 Likes

OMG I can play makecode games on 3ds now???

1 Like

nope , Only 64bit machine , because microsoft upstream not support to export 32bit vm game image .

these days I will have a check on the offical source code and try a build on vita and 3ds

Good news :new3ds can run makecode arcade game jumpy platformer now, the core is not release yet, after the complete test , I will push the code and have a full release for all platfoms .