Warning SVG.svg This article or section is undergoing major changes by A-MARIO-PLAYER (talk | contribs) and may be incomplete. Please avoid making large edits to this page until this template has been removed. (December 2024)
Document stub.png This article is a stub. It may be incomplete, unfinished, or have missing parts/sections. If the article can be expanded, please do so! There may be suggestions on its talk page. (December 2024)
The Debug button.
An image of the debug dialogue menu.
The full debug dialogue menu.

Debugging Help is a dialogue in the Scratch Program that gives help on debugging scripts. It was added as part of a major Scratch 3.0 update on the 16th of December, 2024.

The Debugging Help dialogue can be opened by clicking on "Debug" in the Header.

When clicked, the debug button opens a dialogue with 13 different sections including different tips to help the user understand the issue within their project. It goes through different ways the user may have made a mistake in their code, and gives instructions on different methods to try to fix their project, like timing, sound checkpoints, and adding comments to the code.

Getting Unstuck

This is an explanation of each of the tips in the Debugging Help dialogue.

Read Aloud

Read the code aloud. One should notice if they have steps that shouldn't be there, if their code is clear, and if the required instructions are included when starting the project.

Break It Down

Separate the blocks into smaller chunks, and click them to see what they do.

Slow It Down

Add wait () seconds or wait until <> blocks so that one can see what is going on.

Add Sound Checkpoints

Similar to "Slow It Down", add sounds at key points using the play sound ( v) until done block. If a sound doesn't play, the bug may be happening earlier in the code.

Tinker with Block Order

Adjust the order of the blocks, and try using conditional blocks or loops.

To Loop or Not to Loop

If blocks that repeat scripts are used, check that all blocks inside should be looped, and if any blocks inside should only run once.

Think About Timing & Parallelism

Add waits, broadcasts, or user interaction to see if anything changes.

Think About Block Options

Use similar but different blocks, such as swapping out start sound ( v) for play sound ( v) until done.

Check the Values

If variables or other Reporter Blocks are used, check the value at the moment the code sequence is run.

Check Code Sequence

Ensure a script is attached to the correct sprite. If it needs to be moved, drag it to the correct sprite and drop it when the sprite wiggles.

Comment Your Code

Add comments to one's code, and explain what the code does.

Take a Break, Step Away

Take a break away from Scratch, and do something else. After enough time, the Scratcher can return to Scratch and attempt to solve the issue again.

Ask for Help

Ask the Scratch Community to help with debugging the script. Ask for help in a comment or the project's notes. Ask a small amount of people to try the code as they may have different solutions.

Cookies help us deliver our services. By using our services, you agree to our use of cookies.