REFERENCE GUIDE

3. SCRATCH BlOCkS
TyPES OF BlOCkS
There are three main types of blocks in the Blocks Palette:

Stack Blocks: These blocks have bumps on the bottom and/or notches on the top, such
as . You can snap these blocks together into stacks. Some stack blocks have an input
area inside them, where you can type a number (such as 10 in the block) or
choose an item from a pull-down menu (such as pop in the block). Some
stack blocks, such as , have a C-shaped “mouth” where you can insert other
stack blocks.

Hats: These blocks have rounded tops, such as . These blocks are placed
at the tops of stacks. They wait for an event to happen, such as a key being pressed, then
run the blocks underneath them.

Reporters: These blocks, such as nd

a , are designed to fit in the input
area of other blocks. Reporters come in two shapes, and fit only into “holes” of the same
shape. Reporters with rounded ends (such as ) report numbers and fit inside blocks
with rounded holes (such as ). Reporters with pointed ends (such as )
report boolean values (true or false) and fit inside blocks with pointed holes (such as ).

Some reporter blocks have a check box next to them, such as . If you click in the check
box, a monitor appears on the stage, displaying the current value of the reporter. As the value
of the reporter changes, the monitor updates automatically. A monitor can display the value of
the reporter in several different formats:

a small readout with the name of the reporter

a large readout without any name
a slider that allows you to manipulate the value
of the reporter (available only for variables)

Double-click or right-click on the monitor to change from one format to another.

The slider format is available only for user-created variables. Right-click on the monitor in slider
format to adjust its minimum and maximum values.

http://scratch.mit.edu 10 REFERENCE GUIDE

REFERENCE GUIDE
BlOCk DESCRIPTIONS
The Scratch blocks are organized into eight color-coded categories: motion, looks, sound, pen, control,
sensing, numbers, and variables.
motion
Moves sprite forward or backward.

Rotates sprite clockwise.

Rotates sprite counterclockwise.

Points sprite in the specified direction. (0=up, 90=right,
180=down, -90=left)

Points sprite toward mouse-pointer or another sprite.

Moves sprite to specified x and y position on Stage.

Moves sprite to the location of the mouse-pointer
or another sprite.
Moves sprite smoothly to a specified position over
specified length of time.
Changes sprite’s x-position by specified amount.

Sets sprite’s x-position to specified value.

Changes sprite’s y-position by specified amount.

Sets sprite’s y-position to specified value.

Turns sprite in opposite direction when sprite touches
edge of Stage.

Reports sprite’s x-position. (Ranges from -240 to 240)

Reports sprite’s y-position. (Ranges from -180 to 180)

Reports sprite’s direction. (0=up, 90=right, 180=down, -90=left)

http://scratch.mit.edu 11 REFERENCE GUIDE

REFERENCE GUIDE
looks
Changes sprite’s appearance by switching to different
costume.
Changes sprite’s costume to next costume in the cos-
tume list. (If at end of the costume list, jumps back to first costume.)

Reports sprite’s current costume number.

Changes Stage’s appearance by switching to a different

background.

Changes Stage’s background to next background in

the background list.

Reports Stage’s current background number.

Displays sprite’s speech bubble for specified

amount of time.
Displays sprite’s speech bubble. (you can remove speech
bubble by running this block without any text.)

Displays sprite’s thought bubble for specified

amount of time.
Displays sprite’s thought bubble.

Changes a visual effect on a sprite by specified amount.

(Use pull-down menu to choose effect.)

Sets a visual effect to a given number. (most visual effects

range from 0 to 100.)

Clears all graphic effects for a sprite.

Changes sprite’s size by specified amount.

Sets sprite’s size to specified % of original size.

Reports sprite’s size, as % of original size.

Makes sprite appear on the Stage.

http://scratch.mit.edu 12 REFERENCE GUIDE

REFERENCE GUIDE
Makes sprite disappear from the Stage. (W
hidden, other sprites cannot detect it with touching? b

Moves sprite in front of all other sprites.

Moves sprite back a specified number of l

it can be hidden behind other sprites.

Sound
Starts playing a sound, selected from pull-down menu,
and immediately goes on to the next block even as
sound is still playing.
Plays a sound and waits until the sound is finished
playing before continuing with next block.

Stops playing all sounds.

Plays a drum sound, selected from pull-down menu, for

specified number of beats.

Plays a musical note (higher numbers for higher pitches) for

specified number of beats.

Sets the type of instrument that the sprite uses for

play note blocks. (Each sprite has its own instrument.)

Changes sprite’s sound volume by specified amount.

Sets sprite’s sound volume to specified value.

Reports sprite’s sound volume.

Changes sprite’s tempo by specified amount.

Sets sprite’s tempo to specified value in beats per min-

ute.

Reports sprite’s tempo in beats per minute.

http://scratch.mit.edu 13 REFERENCE GUIDE

REFERENCE GUIDE
Pen
Clears all pen marks and stamps from the Stage.

Puts down sprite’s pen, so it will draw as it moves.

Pulls up sprite’s pen, so it won’t draw as it moves.

Sets pen’s color, based on choice from color picker.

Changes pen’s color by specified amount.

Sets pen’s color to specified value. (pen-color=0 at red end of

rainbow, pen-color=100 at blue end of rainbow)

Changes pen’s shade by specified amount.

Sets pen’s shade to specified amount. (pen-shade=0 is very

dark, pen-shade=100 is very light)

Changes pen’s thickness.

Sets pen’s thickness.

Stamps sprite’s image onto the Stage.

Control
Runs script below when green flag is clicked.

Runs script below when specified key is pressed.

Runs script below when sprite is clicked.

Waits specified number of seconds, then continues

with next block.

Runs the blocks inside over and over.

Runs the blocks inside a specified number of times.

http://scratch.mit.edu 14 REFERENCE GUIDE

REFERENCE GUIDE
Sends a message to all sprites, triggering them to do
something, and waits until they all finish before con-
tinuing with next block.
Sends a message to all sprites, then continues with the
next block without waiting for the triggered scripts.

Runs script below when it receives specified broadcast

message.

Continually checks whether condition is true; when-

ever it is, runs the blocks inside.

If condition is true, runs the blocks inside.

If condition is true, runs the blocks inside the if por-

tion; if not, runs the blocks inside the else portion.

Waits until condition is true, then runs the blocks

below.
Checks to see if condition is true; if so, runs blocks
inside and checks condition again. If condition is not
true, goes on to the blocks that follow.

Stops the script.

Stops all scripts in all sprites.

http://scratch.mit.edu 15 REFERENCE GUIDE

REFERENCE GUIDE
Sensing
Reports the x-position of mouse-pointer.

Reports the y-position of mouse-pointer.

Reports true if mouse button is pressed.

Reports true if specified key is pressed.

Reports true if sprite is touching specified sprite, edge,
or mouse-pointer. (Selected from pull-down menu.)
Reports true if sprite is touching specified color. (Click on
color patch, then use eyedropper to select color.)

Reports true if first color (within sprite) is touching

second color (in background or another sprite). (Click on
color patch, then use eyedropper to select color.)

Reports distance from the specified sprite or

mouse-pointer.
Sets the timer to zero.

Reports the value of the timer in seconds. (The timer is

always running.)

Reports a property or variable of another sprite.

Reports the volume (from 1 to 100) of sounds detected

by the computer microphone.
Reports true if computer microphone detects a sound
volume greater than 30 (on scale of 1 to 100).
Reports the value of specified sensor. To use this block, you
need to have a Scratch Board connected to your computer. See http://
scratch.mit.edu/scratchboard

Reports true if specified sensor is pressed. To use this

block, you need to have a Scratch Board connected to your computer.
See http://scratch.mit.edu/scratchboard

http://scratch.mit.edu 16 REFERENCE GUIDE

REFERENCE GUIDE
Numbers
Adds two numbers.

Subtracts second number from first number.

Multiplies two numbers.

Divides first number by second number.

Picks a random integer within the specified range.

Reports true if first number is less than second.

Reports true if two numbers are equal.

Reports true if first number is greater than second.

Reports true if both conditions are true.

Reports true if either condition is true.

Reports true if condition is false; reports false if
condition is true.
Reports result of selected function (abs, sqrt, sin, cos, tan,
asin, acos, atan, ln, log, e^, 10^) applied to specified number.

Reports remainder from division of first number by

second number.
Reports closest integer to a number.

Variables
Allows you to create and name a new variable. When you
create a variable, three blocks are created automatically (see below). you
can choose whether the variable is for all sprites (global) or just for one
sprite (local).

Deletes all three blocks associated with the variable.

Changes variable by specified amount.

Sets variable to specified number.

Reports value of variable.

http://scratch.mit.edu 17 REFERENCE GUIDE