SandCastleIcon.png This article has links to websites or programs outside of Scratch and Wikipedia. Remember to stay safe while using the internet, as we cannot guarantee the safety of other websites.
Archive.png This article or section documents something not included in the current version of Scratch (3.0). It is only useful from a historical perspective.
Document.png Please expand this article or section. You can help by adding more information if you are an editor. More information might be found in a section of the talk page. (August 2022)
This article or section documents an outdated version of Scratch (version 2.0). For this article in the current version (version 3.0), see How to Make a Scratch Modification (3.0). For this article in Scratch 1.4, see How to Make a Scratch Modification (1.4).

Although Scratch can seem complicated to some users, some Scratchers make Mods, or Modifications of the program to add more elements and blocks. Scratch was developed in ActionScript. The ActionScript page on Adobe is here, but now redirects to the related tools about Flash Player after its EOL (End of Life).

Before Beginning


Before modding Scratch 2.0, the following tools must be installed on your computer:

  • Git client
  • Code Editor or Text Editor: Although a Scratch 3.0 mod could be made in a text editor like Notepad or vim, Notepad++ is strongly recommended for being lightweight and having many useful features such as syntax highlighting for many languages. And, it might be much more easier with a code editor or IDE, such as Visual Studio Code or Atom.

Additionally, the features of ActionScript should be known, which is a version of ECMAScript (and in turn originally derived from JavaScript). On this case, prior knowledge of JavaScript would prove handy in understanding the underlying syntax better.

Getting Started

Getting the Source Code

First of all, create a new folder for your mod before starting. Open a terminal from your folder and run the command

git clone


After making changes to Scratch, it needs to be recompiled.

Open a terminal and change the directory to the one containing the Scratch source code (the one containing the src directory, not the src directory itself) by running

cd <path to source code>

If the OS is a *nix-like OS (such as MacOS, Linux and all its distros, and variants of BSD), run

./gradlew build

If Windows is used instead, run

gradlew.bat build

External Links

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