Troubleshooting

If your tutorial is not behaving properly or you receive an error message, you can check some of these common trouble situations to help resolve the problem with your custom tutorial.

Please check your internet connection and check the tutorial is valid

Tutorial file is too large

Tutorial markdown files are required to be less than 128K bytes.

Asset packs in MakeCode Arcade

There can be several images and/or very large images within the asset sections or instructions of a tutorial markdown file. Often these will make the tutorial file size exceed the 128K byte limit. You can reduce the size of the tutorial file by moving the images into a separate asset pack. See the instructions in the resources page for creating an asset pack.

Tutorial game screen just shows activity spinner

If activity indicator on the game screen in the tutorial seems to just spin and never load, there’s probably an error. Start by opening the JavaScript console and try to re-run the tutorial. It should give you an idea of what’s causing it to not work.

Kind types aren’t working in MakeCode Arcade

If you added a “kind” and MakeCode generated the code for you, it won’t work correctly in the tutorial. You need to add //% isKind before each declaration.

The kind that was declared in your tutorial code, such as:

namespace SpriteKind {
    export const Veggies = SpriteKind.create()
}

You should add //% isKind to the declaration:

namespace SpriteKind {
    //% isKind
    export const Veggies = SpriteKind.create()
}