Scratch for Java


  • 🚀 Feat: Random can now create a new random unit vector (Random.randomVector2()).
  • 🚀 Feat: You can now set the width of a text after calling the constructor (text.setWidth(40)).


  • 🐛 Fix: AnimatedSprite throws an error, because the animationFrame is too high.


  • 💥 BREAKING CHANGE: Replace addStage, removeStage and getStage in favour of setStage, which simplifies the handling of multiple stages.
  • 🐛 Fix: First frame of an AnimatedSprite is skipped.


  • 🚀 Feat: New extension tiled.
  • 🐛 Fix: Fix isTouchingMousePointer.


  • 🐛 Fix: Missing stamp method on Sprite


  • 🐛 Fix: Scratch for Java Window not creating on Windows


  • 💥 BREAKING CHANGE: Move (0, 0) to the center of the stage to be in-line with Scratch.
  • 🚀 Feat: Add stamp method to the pen pen.stamp(). This is also available on a Sprite with stamp(), stampToForeground() or stampToBackground().
  • 🚀 Feat: Unify constructors of Window and Stage.
  • 🚀 Feat: Load all tiles from a sprite sheet as costumes with addCostumes.
  • 🚀 Feat: Add goToMousePointer to the sprite class.
  • 🚀 Feat: Add goToRandomPosition to the sprite class.
  • 🚀 Feat: switchCostumes now also accepts an integer for switching to a specific index.
  • 🚀 Feat: Allow for custom sorting of sprites by providing a Comparator via the setSorter-method of the stage.
  • 🐛 Fix: Random.randomInt did not work correct.


  • 🚀 Feat: Add support for broadcast and when i receive blocks to the Sprite and the Stage class.


  • 🚀 Feat: Support for vertical sprite sheets was added.
  • 🚀 feat: Loading Animation got improved. The loading screen now shows the percentage of files, which are already loaded.


#scratch4j v3.7.0 got released:

  • 💥 BREAKING CHANGE: AnimatedSprite, Hitbox, Text and Timer were moved into the org.openpatch.scratch.extensions package. Each extension got its package. For example, org.openpatch.scratch.extensions.animation. In the main package, we only want the classes with emulate the current Scratch behavior. This should lead to a smoother transition. The extensions package should be used, we the normal functionality is not enough.
  • 🚀 Feat: New class Vector2 for the math extension. Every so often, it is easier to work with vectors. Therefore, this class got introduced. The Sprite class was updated to make use of the Vector2 class. You can, for example, call the move and setDirection methods with a Vector2.
  • 🚀 Feat: New class Operators. This class has several simple methods for transforming data and working with mathematical operations – just like the Scratch operator blocks. For example, mapping values, lerping between values or using sine and cosine.
  • 🚀 Feat: New class Random in the math extension. This class contains several methods for generating random numbers. This makes working with randomness outside a Sprite or Stage class easier.
  • 🚀 Feat: Introduce the method ifOnEdgeBounce for the class Sprite. This method works like the if on edge, bounce-block in Scratch in is an alternative to the setOnEdgeBounce-method.
  • 🚀 Feat: Introduce pointTowardsMousePointer and pointTowardsSprite methods for the class Sprite.
  • 🐛 Fix: Jar files missing version information.
  • 🐛 Fix: Speak and Think-bubble rendering. Speak and Think-bubbles now behave like they do in Scratch. Meaning, they will ever leave the Stage.
  • 📝 Docs: Add more documentation


  • 🚀 Feat: Add method setTextSize to the Text-class
Text myText = new Text();
  • 🚀 Feat: Allow custom fonts for Text-objects. Custom fonts can be added like a costume for a Sprite-object. Each Text-object does have a default font named default.
Text myText = new Text();
myText.addFont("playful", "opensans.odt");

// get the text-object, which is used for the think and speak bubble
Text spriteText = new Sprite().getText();
  • 📝 Docs: Add example Shakespeare which shows the usage of the new methods of the Text-class


  • 💻 OS: Added Linux ARM 32-bit and ARM 64-bit versions


  • 🧹 Chore: Update Processing core to version 4.2
  • 💻 OS: Added MacOS aarch64 version


  • 🚀 Feat: Added isSoundPlaying and stopSound to the Sprite and Stage Class.


  • 🎨 Visual: Improve Pen rendering
  • 🐎 Perf: Pen does not draw everything again, but only the last additions.
  • 🐛 Fix: isTouchingSprite threw an error, if a sprite did not have a costume.
  • 🐛 Fix: exit method not found for Window class.


  • 🐛 Fix: Pen only drawing dots


  • 🚀 Feat: Introducing the new class Window. Every Scratch for Java program can have on Window-object. A Window-object contains one stage object, which can be change during the runtime. This allows for using multiple stages in your program. For example, you could have one stage for the menu, one for the game and one for the credits.
public class Prog {
    public static void main(String[] args) {
        Window myWindow = new Window();
        Stage stage1 = new Stage();
        Stage stage2 = new Stage();
        myWindow.addStage("one", stage1);
        myWindow.addStage("two", stage2);

  • 🚀 Feat: The class Text became more usable as a standalone Drawable. You can now create a Text-object with the default constructor new Text(). The created Text-object will in TextStyle.PLAIN, meaning having nothing drawn around it and be freely placeable on the stage.

    • The background color can now be set by passing a Color-object. setBackgroundColor(Color c)
    • The text color can now be set by passing a Color-object. setTextColor(Color c)
  • 🐎 Perf: Scratch for Java now used an OpenGL renderer, which increases the performance by many times.

  • 🐎 Perf: The collision detection got improved.

  • 💥 BREAKING: setSize got removed from the Stage class. Since the switch to the OpenGL Renderer you can only set the size of the Stage or Window at the constructor.

public class MyStage extends Stage {
    public MyStage() {
        super(800, 400)
        // this.setSize(800, 400);


  • 🐛 Fix: setSize did not affect getWidth and getHeight.


  • 🚀 Feat: The debug modus now shows the current FPS.
  • 🚀 Feat: isTouchingSprite(Class). IsTouchingSprite accepts also a Class. So you can check the collision with all objects of this class.


Scratch for Java will from now on focus on being a standalone library. Therefore, it can not be used in Processing anymore.



  • 🚀 Feat: Image, Text and Pen can now be added without being used in a Sprite. Example:
import org.openpatch.scratch.Stage;
import org.openpatch.scratch.extensions.Pen;

public class PenStandalone {
    public static void main(String[] args) {
        Stage s = new Stage(400, 400);
        Pen p = new Pen();
        p.setPosition(40, 40);
        p.setPosition(40, 100);
  • 🚀 Feat: AnimatedSprite and Sprite now support SpriteSheets. Example:
import org.openpatch.scratch.AnimatedSprite;
import org.openpatch.scratch.Stage;

public class SpriteSheet {
    public static void main(String[] args) {
       Stage stage = new Stage() ;
       stage.add(new AnimatedBee());

class AnimatedBee extends AnimatedSprite {
    public AnimatedBee() {
        this.addAnimation("idle", "bee_idle.png", 6, 36, 34);

    public void run() {
  • 🐛 Fix: Pen did not include the first point


  • 💥 Prefix Scratch is removed. For exmaple: ScratchSprite -> Sprite, ScratchStage -> Stage
  • 💥 getInstance and init got removed from Stage. You now have to instantiate a Stage like a normal Object new Stage(this) // Processing or new Stage(400, 400) // Standalone. Be aware that you can only have one Stage at a time.


  • BREAKING CHANGE: Rename package to org.openpatch.scratch


  • Add standalone version


  • Improve Text rendering


  • add think and say to Sprite
  • add display to Stage
  • add whenClicked to Sprite
  • add whenBackdropSwitches to Sprite


  • add stage.removeSprites
  • add stage.findSprites
  • use CopyOnWriteArrayList instead of ArrayList


  • add more timer methods
  • add a timer example