Need help with pxt-arcade?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

310 Stars 117 Forks MIT License 2.4K Commits 625 Opened issues


Arcade game editor based on Microsoft MakeCode

Services available


Need anything else?

Contributors list

Casual game editor using Microsoft MakeCode Build Status

This repo contains the Arcade editor built with Microsoft MakeCode (PXT).

Creating and editing a package

In the editor, you will find a GitHub icon next to the save icon. Use the GitHub integration to build a library package. You do not need to install the local dev server; everything can happen in the editor.

Local server setup

This setup gives you a local version of the editor and the ability to load packages from your machine. This is the setup to develop new packages.


  • install Node.js 8+
  • clone to
    folder. For example, from a git bash,
git clone
  • go to
    and run
cd pxt-arcade
npm install

Don't forget to periodically

git pull
npm install
to get the latest changes.
git pull
npm install

Launching the server

This command launches a local web server. Note that this web server is meant for development purposes only. It was not designed or secured to be run on a web server.

npm run serve

Refreshing the file

Run this command, then patch description, improve the screenshot (or record gifs) if necessary.

pxt ddt featured-game --md docs/

This command requires ImageMagick ( to be installed and available at the command line as "magick".

Updating pxt-arcade-sim version

When changing the version of pxt-arcade-sim referenced by pxt-arcade, you need to change the version in three places:

  1. package.json
  2. .github/workflows/pxt-buildmain.yml
  3. .github/workflows/pxt-buildpush.yml

In the two yml files, you'll find the version in the

field under the step that checks out pxt-arcade-sim.

Update playlists in markdown

Get a Google API key and store it in the

environment variables (turn on data from the app).
pxt downloadplaylists

How to create sprite packs

Packs of images can be added to the editor using PXT packages. To create a package of images.

  1. Create a package (see steps above)
  2. Prepare your sprites in a spritesheet: All sprites in a sheet must be the same size and arranged in a grid with no gaps. Spritesheets must be PNG files. An example spritesheet is located here
  3. Inside the package directory, create a subdirectory where the assets will be placed and copy the spritesheet containing your images into it.
  4. Create a file named
    in the directory you created. An example
    can be found here and documentation on all of the options can be found here
  5. Create another
    file with the same basename as the spritesheet.
  6. Inside that file add a single property called
    which maps to an array of names for the sprites. Indices start in the top left of the sheet and proceed left to right. For a sample file see here
  7. From the root of your package, run the command
    pxt buildsprites SUBDIR
    is the name of the directory containing the assets.
  8. Two files will be generated in the package root, one with the extenstion
    and one with the extension
    . Add both to the package's
  9. You're done! The images will show up in the Image category when the package is added to a project

Local Dev setup

These instructions allow you to test changes to pxt-core and pxt-common-packages. They are more involved as you need to clone and link 3 repos.

  • install Node.js 8+
  • (optional) install Visual Studio Code
  • install the pxt command line tool
[sudo] npm install -g pxt

In a common folder,

  • clone to
  • clone to
  • clone to
  • go to
    and run
npm install
npm run build
  • go to
    and run
npm install
pxt link ../pxt
  • go to
    and run
npm install
pxt link ../pxt
pxt link ../pxt-common-packages

to run the local server

From root github folder,

cd pxt-arcade
pxt serve --rebundle

More instructions at

to watch for changes

To rebuild automatically when changes are made, we need gulp.

Install gulp:

npm install -g gulp

and in a seperate terminal from

pxt serve
and in the pxt/ folder, run:
gulp watch

Viewing documents

Documents are rendered at the server and are viewable when received by the browser. Special styles and extended formatting are used which prevent them from rendering properly as generalized Markdown. While you can browse them here in the repo, they are not meant to render properly as GitHub document.


This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.


MICROSOFT, the Microsoft Logo, MAKECODE, and MAKECODE ARCADE are registered trademarks of Microsoft Corporation. They can only be used for the purposes described in and in accordance with Microsoft’s Trademark and Brand guidelines published at If the use is not covered in Microsoft’s published guidelines or you are not sure, please consult your legal counsel or MakeCode team ([email protected]).

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.