Scratch Blocks

HOME

This command block return the robot at it's "home" location and restore it's orientation to the default.
The home location is set when you place the robot in the world.
This command can be used at the start of the Scratch program in order to make the robot to start at a precise location each time the execution is launched.

MOVE

This command move the robot of one step. The drop down menu select the direction where you want to move the robot. Forward and Backward direction depend on the orientation of the robot.
If an obstacle prevents the robot from moving, the command will not be executed.

TURN

Change the orientation of the robot. The dropdown menu let you choose to turn right or left.

DIG

Grab a block from the world and place it into the inventory. The drop down menu select the direction where the robot will dig. The directions are relative to the robot's orientation.

PLACE

Place a block in the world. The block is taken from the inventory. The drop down menu select the direction where the robot will dig. The directions are relative to the robot's orientation.
If the School Mode is activated, this command can be used even if the robot don't have any block in it's inventory. It is possible to change this behaviour by activating the "strict mode" (see the advanced commands).

USE

This command let you choose the block type for the PLACE command. It's like the color of the drawing. The required number is the VoxelType of a block. VoxelType is indicated in this manual on the dedicated page for each type of cube.

EXPORT

Export a cube of the indicated type from the robot's inventory to the inventory of the bloc located in the direction selected by the drop down menu.

IMPORT

Import a cube from the inventory of the bloc located in the indicated direction. The destination is the inventory of the robot.

WHICH BLOC

Return the VoxelType of the bloc in the indicated direction. 0 is for a void space.
This command is like a sensor.

LOCATION

This command return a coordinate of the robot in the space. The drop down menu select which coordinate (x,y or z) will be returned. By default, the returned coordinates are relative to the home point. The drop down menu also offer to get the absolute coordinates.

QNT OF CUBE

Return the quantity of the selected kind of cube in the robot's inventory.

ADVANCED (Command)

This command allow to use some advanced commands.
The drop down menu selects the effective command. The two parameters provide arguments depending on the command.

• IP : Allow to change the IP address and port of the computer where Blackvoxel is running. This allow to run Scratch in one computer and Blackvoxel in another. The first argument is the IP address and the second is the port. The port argument can be left to 0, in this case, the default port will be used. This command should be the first in the Scratch program.
• Strict Mode : The strict mode ensure that the robot have a bloc in the inventory before you can use it with the PLACE command. By default, the strict mode is disabled when School Mode is on. You can force enable it with "1" in the first argument.

ADVANCED (Function)

It's purpose is like the ADVANCED command but this function return a value. The function is selected by the drop down menu.

• Inventory slot count : Return the number of inventory slots in the robot. Better use this value than a fixed number. If this value change in the future, your program won't be broken.
• VoxelType in Slot : Return the VoxelType of the bloc in a selected slot of the inventory. The slot is indicated by the first argument.
• Voxel Count in Slot : Return the bloc count in a selected slot of the inventory. The slot is indicated by the first argument.