NEW Explore the Scratch Block Dictionary, tutorials, textbook, and classroom guides

Start learning →

100 Scratch Bug Fixes by Exact Symptom

📌 What you will learn

Fast, symptom-by-symptom solutions for the 100 most common Scratch bugs—from stuck sprites to clone leaks and lag.

Browse all 100 Scratch bug fixes

Find the exact symptom you are seeing and follow the quick fix checklist.

Fix: Sprite Will Not Move at All Check for a green-flag hat block and wrap continuous key checks inside forever. Learn more → Fix: Player Gets Stuck Inside Walls Separate X and Y axis movement and undo only the axis that caused the collision. Learn more → Fix: Player Falls Through Thin Floors Cap max downward y_vel (e.g., -15) and resolve floor overlap inside a no-refresh block. Learn more → Fix: Character Can Jump Forever in Midair Allow jumping only when grounded (touching floor) or jumps_left > 0. Learn more → Fix: Jump Key Sometimes Does Not Respond Test floor contact by nudging y by -1, checking touching floor, then restoring y by +1. Learn more → Fix: Double Jump Uses Both Jumps Instantly Add a key-release check so holding Space does not consume jump #2 on the very next frame. Learn more → Fix: Sprite Flips Upside Down Moving Left Run "set rotation style [left-right]" under the green flag. Learn more → Fix: Sprite Disappeared From the Stage Reset go to x:0 y:0, show, set size 100%, clear graphic effects, and go to front layer. Learn more → Fix: Sprite Hidden Behind Another Object Call "go to front layer" on players and UI, and "go to back layer" on scenery. Learn more → Fix: Sprite Moves Sideways or Backward Check costume orientation (must face right in editor) and direction value (90° = right). Learn more → Fix: Sprite Jumps Around When Turning Center every costume accurately on the crosshair in the Costume Editor. Learn more → Fix: Walking Animation Looks Frozen or Blurry Add a 0.1–0.15s wait after "next costume" and run animation in a separate script from glide. Learn more → Fix: Keyboard Controls Freeze During Glide Replace "glide" with small "change x/y" steps inside a forever loop so input stays live. Learn more → Fix: Walking Stutters Before Moving Smoothly Switch from "when key pressed" hat blocks to "forever + if <key pressed?>". Learn more → Fix: Moving Diagonally Is Faster Than Straight Multiply both x and y steps by 0.707 when horizontal and vertical keys are held together. Learn more → Fix: "If on Edge, Bounce" Does Nothing Use "move steps" instead of "change x/y" because edge bounce reverses sprite direction. Learn more → Fix: Sprite Vibrates Stuck Against Screen Edge Nudge the sprite 2 steps inward after bouncing or clamp coordinates cleanly. Learn more → Fix: "Touching Color?" Fails to Detect Re-sample with the eyedropper tool and beware anti-aliased edge colors—prefer touching Sprite. Learn more → Fix: Collision Does Not Work on Hidden Sprite Use "set ghost effect to 100" instead of "hide" when an invisible trigger must still detect hits. Learn more → Fix: Fast Bullets Pass Right Through Enemies Break large 25-step moves into smaller sub-steps (e.g., repeat 5: move 5 steps + check hit). Learn more → Fix: Bullet Deletes Before Enemy Detects Hit Add "wait 0 seconds" before "delete this clone" so both sprites detect contact on that frame. Learn more → Fix: Score Jumps by +30 on One Coin Touch Hide, move, or delete the coin immediately on contact—or add a wait-until-not-touching guard. Learn more → Fix: Score Starts With Last Game’s Points Add "set score to 0" directly under "When green flag clicked". Learn more → Fix: Score Always Stays Stuck at 0 Move "set score to 0" OUTSIDE the forever loop! Learn more → Fix: Health Drops Below 0 (-5 HP) Check <(hp) < (1)> for Game Over and clamp with "if <(hp) < (0)> set hp to 0". Learn more → Fix: Touching Enemy Drains All HP Instantly Add 1-second invulnerability cooldown after taking damage. Learn more → Fix: Clones Stop Appearing Mid-Game You hit Scratch’s 300-clone limit—ensure every finished clone runs "delete this clone". Learn more → Fix: Broadcast Spawns Hundreds of Extra Clones Filter broadcasts using a local ("for this sprite only") variable is_clone = 0 on the original. Learn more → Fix: Hitting One Enemy Damages Every Enemy Recreate the HP variable as "For this sprite only" so each clone owns its own HP. Learn more → Fix: Created Clones Never Show Up Put a "show" block under "When I start as a clone" when the original sprite is hidden. Learn more → Fix: Old Clones Remain on Title Screen Add "when I receive [Reset] → delete this clone" so all clones clear cleanly. Learn more → Fix: Background Music Buzzes Like a Machine Gun Replace "start sound" inside forever with "play sound until done". Learn more → Fix: Sprite Freezes While Sound Plays Use "start sound" for instant effects or play music in a separate parallel script. Learn more → Fix: No Audio Plays in Scratch Check browser tab mute, system volume, Sounds tab preview, and "set volume to 100%". Learn more → Fix: Music Keeps Playing After Game Over Stop the BGM script ("stop other scripts in sprite") before calling "stop all sounds". Learn more → Fix: Speech Bubble Never Disappears Use "say ()" with an empty input or switch to "say (...) for (2) seconds". Learn more → Fix: Ask Input Box Stays Stuck on Screen Stop the asking script with "stop other scripts in sprite" when leaving the quiz scene. Learn more → Fix: Broadcast Receiver Restarts Over and Over Do not fire a broadcast continuously inside an unguarded forever loop. Learn more → Fix: Sprite Ignores My Broadcast Verify sender and receiver select the exact same message name in the dropdown. Learn more → Fix: Project Only Works After Clicking Green Flag Twice Use "broadcast [Init] and wait" before starting gameplay loops so variables reset first. Learn more → Fix: Game Freezes to 1 FPS Immediately Remove every "wait", "glide", or "forever" block from inside "Run without screen refresh" custom blocks! Learn more → Fix: FPS Drops When Many Enemies Spawn Replace "touching color?" checks inside clones with "touching Sprite?" or distance math. Learn more → Fix: Complex Vector Art Causes Stuttering Simplify unused vector nodes or avoid scaling huge sprites every single frame. Learn more → Fix: Pen Blocks Draw Nothing Check "pen down", pen size >= 1, contrast with backdrop, and that no sprite covers the stage. Learn more → Fix: Unwanted Line Connects Two Shapes Run "pen up" BEFORE moving to the next starting coordinate, then "pen down". Learn more → Fix: Pen Drawing Appears Behind Sprites Pen always renders on the backdrop layer—hide blocking background sprites or use pen-only UI. Learn more → Fix: Stamped Sprites Look Slightly Blurry Draw crisp vector costumes at 100% scale and align coordinates to whole integers. Learn more → Fix: List Items Double Every Time You Play Add "delete all of [list]" before populating temporary lists on green flag. Learn more → Fix: First List Item Is Blank or Skipped Scratch lists start at index 1 (not 0)—initialize counter i to 1! Learn more → Fix: Loop Deleting List Items Skips Neighbors Iterate backward from (length of list) down to 1 when deleting inside a loop. Learn more → Fix: Cannot Copy Save Code From Variable Put the save code into a 1-item list and show the list—players can triple-click and copy cleanly. Learn more → Fix: Random Number Checks Never Match Store "pick random" into a variable first before testing it in multiple "if" blocks. Learn more → Fix: Pick Random Only Gives Whole Numbers Include a decimal point like "pick random (0.0) to (1.0)" to generate decimal values. Learn more → Fix: Score 10 Does Not Trigger "Score > 10" Use <(score) > (9)> for integers or <<(score) > (10)> or <(score) = (10)>>. Learn more → Fix: Joined Words Run Together ("Score:10") Add a trailing space inside the first text slot: join("Score: ", score). Learn more → Fix: "Letter 0 of Word" Returns Empty Scratch string positions start at 1 ("letter 1 of Scratch" = "S"). Learn more → Fix: Timer Keeps Counting After Stop That is normal in Scratch—call "reset timer" at start and copy into a variable when stopped. Learn more → Fix: Timer Shows 4.829104 Seconds Display "round(timer)" or "floor(timer)" in a clean variable instead of raw timer. Learn more → Fix: Cloud Variable Does Not Save Text Cloud variables accept DIGITS ONLY (no letters or symbols, max 256 digits). Learn more → Fix: Cloud Variable Checkbox Is Missing Cloud variables require a confirmed full "Scratcher" account (not New Scratcher). Learn more → Fix: Cloud Multiplayer Stops Updating Limit cloud writes to at most ~10 updates per second (wait 0.1s between writes). Learn more → Fix: Custom Block Definition Never Runs Defining a block only teaches Scratch what it means—you must also call it from a script! Learn more → Fix: Cannot See My Custom Block in Another Sprite Custom blocks are sprite-local; drag the define stack onto the other sprite thumbnail to copy it. Learn more → Fix: All Blue Motion Blocks Disappeared You selected the Stage! Click a Sprite thumbnail in the bottom-right panel. Learn more → Fix: Two Blocks Refuse to Connect Check shapes: hat blocks go on top, cap blocks ("stop all") cannot have blocks below them. Learn more → Fix: "Project Could Not Save" Warning Download a .sb3 backup immediately, check login status, and ensure no audio clip exceeds 10 MB. Learn more → Fix: Orange Share Button Is Missing Confirm the email address registered to your Scratch account in Account Settings. Learn more → Fix: Double-Clicking .sb3 File Shows Error Open Scratch first and load via File → Load from your computer. Learn more → Fix: Stage Turns Blank White on Chromebook Close extra browser tabs, enable hardware acceleration, and reload the page. Learn more → Fix: Game Unplayable on iPad or Phone Add clickable on-screen arrow/jump button sprites for touch players. Learn more → Fix: Game Restarts on Game Over Backdrop Add "switch backdrop to [Title]" under green flag on the Stage. Learn more → Fix: Sprite Misses Backdrop Switch Ensure the sprite’s "when backdrop switches to" selects the exact spelling of the backdrop. Learn more → Fix: Sprite Refuses to Grow Past 150% Scratch caps max size based on costume dimensions; switch briefly to a tiny costume, set size, then switch back. Learn more → Fix: Sprite Will Not Shrink Below 20% Switch briefly to a large blank costume, set size, then switch back to the target costume. Learn more → Fix: Scrolling Sprite Stops at Screen Edge Scratch fences sprites onscreen; switch temporarily to a huge costume before moving off-stage, then swap back. Learn more → Fix: Players Can Drag Character Past Walls Set drag mode to "not draggable" and test in full-screen Project Page mode (editor always allows dragging). Learn more → Fix: Webcam Motion Feels Backwards Use "turn video [on-flipped]" so left and right match like a mirror. Learn more → Fix: Text-to-Speech Does Not Speak Confirm active internet connection and that browser audio is not muted. Learn more → Fix: Translate Block Returns Original Word Check internet connectivity and school firewall allow-lists for Scratch API endpoints. Learn more → Fix: Scratch Cannot Find My micro:bit Flash the official Scratch micro:bit HEX file, open Scratch Link, and turn Bluetooth ON. Learn more → Fix: micro:bit Drops Connection Mid-Game Replace weak AAA batteries or power via a stable USB cable. Learn more → Fix: White Seams Appear Between Scrolling Tiles Overlap tiles by 1 pixel or snap camera coordinates with round(cam_x). Learn more → Fix: Player Gets Caught Walking Up Slopes Allow stepping up by 1 pixel up to 8 times on horizontal wall hit before undoing x movement. Learn more → Fix: Player Slides Off Moving Platforms Add the platform’s frame delta_x to the player’s x while standing on top. Learn more → Fix: 3D Raycaster Walls Look Curved (Fisheye) Multiply raw ray distance by cos(ray_angle - camera_angle) before computing wall height. Learn more → Fix: Player Dies Without Visually Touching Spike Switch to a slightly forgiving inner rectangle hitbox costume during collision checks. Learn more → Fix: All Enemy Clones Merge Into One Blob Give each clone a slight random speed offset or push overlapping clones apart gently. Learn more → Fix: Quiz Marks Correct Answer Wrong for Spaces Use clickable multiple-choice buttons or check "<answer contains ...?>" for friendlier grading. Learn more → Fix: Typing Game Triggers Twice Per Press Wait until <not <key pressed?>> or use "ask and wait" for multi-letter words. Learn more → Fix: Accidentally Deleted a Whole Sprite Immediately click Edit → Restore Sprite in the top menu bar before closing the tab! Learn more → Fix: Imported MP3 Stops Project From Saving Trim or split long audio clips into smaller pieces under 10 MB (WAV/MP3 limit). Learn more → Fix: Orange Variable Monitors Block Gameplay Drag monitors to corners, switch to Large Readout, or hide debug variables before sharing. Learn more → Fix: Costume Text Gets Cropped on Stage Leave a small transparent margin around vector text in the Costume Editor. Learn more → Fix: Sprite Looks Jagged and Blurry Convert artwork to Vector mode before scaling or rotating. Learn more → Fix: Welcome Message Says "Hello, !" Check "if <(username) = ()>" and fall back to "Guest" for signed-out players. Learn more → Fix: Keyboard Ignores 3rd Simultaneous Key Spread Player 1 (WASD) and Player 2 (IJKL or Arrows) across keys that avoid laptop rollover limits. Learn more → Fix: TurboWarp Project Fails on Scratch.mit.edu Remove TurboWarp-only extensions if you plan to upload the .sb3 back to Scratch. Learn more → Fix: Missing Credit on a Remixed Project Keep original attribution intact and list every changed mechanic in Notes & Credits. Learn more → Fix: Project Takes Long to Start After Green Flag Pre-generate static lists once and avoid running heavy Pen loops before the Title screen. Learn more → Fix: Recursive Custom Block Freezes Browser Always add a stopping base case (e.g., "if <(depth) > (0)> then") that shrinks toward 0. Learn more →

This guide is provided for educational purposes. Scratch screens and terms may change over time, so please check the official Scratch website as well.