Blocks#

The VEX CTE Blocks API Reference explains what each VEXcode block does, how its inputs change the 6-Axis Arm’s behavior, and how the block can be used in a project.

Use this reference when you want to understand a block before adding it to a project, check what a block reports, or compare similar blocks in a category.

Blocks are used in VEXcode Blocks projects. Python projects use the text-based API section instead.

How to Read a Block Entry#

Most block entries include the following parts:

  • Block description - Explains what the block does and when it is useful.

  • Block image - Shows what the block looks like in VEXcode.

  • Parameters - Lists the inputs on the block and explains how each input affects the 6-Axis Arm or project.

  • Return value - Explains what a Boolean or Reporter block reports.

  • Example - Shows one way the block can be used in a project.

Common Block Types#

Different block shapes have different jobs in a project.

Block Type

What it means

Stack

A block that performs an action. Stack blocks connect above and below other blocks in a stack.

Hat

A block that starts a stack of blocks when something happens, such as when the project starts or an event occurs.

Boolean

A block that reports True or False. Boolean blocks are often used inside conditions, such as if then or wait until blocks.

Reporter

A block that reports a value, such as a number or text. Reporter blocks are often used inside other blocks.

C block

A block that wraps around other blocks and controls when or how they run, such as repeating blocks or if then blocks.

Example Block Entry#

move arm to position#

The move arm to position block moves the 6-Axis Arm to a specified x, y, and z coordinate.

move [arm v] to position x:[120] y:[0] z:[100] [mm v] ▶

Parameter

Description

x

The x-coordinate of the target position.

y

The y-coordinate of the target position.

z

The z-coordinate of the target position.

unit

Selects the unit for coordinates:

  • mm — millimeters
  • inches

expanding arrow

By default, this is a waiting block, so the 6-Axis Arm will finish moving before running the next block. To make the 6-Axis Arm start moving and immediately run the next block right away, expand the block to say and don’t wait.

Example

when started
[Move the 6-Axis Arm to standard position at start of project.]
move [arm v] to position x:(120) y:(120) z:(75) [mm v] ▶