> For the complete documentation index, see [llms.txt](https://thepython10110.gitbook.io/better-commands/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://thepython10110.gitbook.io/better-commands/data-types.md).

# Data types

A list of data types.

## String

Any single word (whitespace at the beginning and end is ignored)

#### Examples:

`hi`

`ThePython10110`

`better_commands`

## Long string

Any text (whitespace at the beginning and end is ignored). Long strings are *always* the last argument in a command.

#### Examples:

`example`

`another example`

`12983 + eighty-nine =     thirteen thousand and 72.000000`

## Number

Any positive or negative number from -99,999,999,999,999 (negative 100 trillion + 1**)** to 100,000,000,000,000. (100 trillion)

#### Examples:

`1`

`3.141592`

`-65535`

## Range

Either a number or values in the format \[`min]..[max]`. Only one of `[min]` and `[max]` is required. Ranges are inclusive.

#### Examples:

`6` (matches exactly 6)

`3..5` (matches any number between 3 and 5, inclusive)

`-293.5..` (matches any number greater than or equal to -293.5

`...4` (matches any number less than or equal to .4)

`1..-1` (matches no numbers, since no numbers are >= 1 but <= -1)

## Boolean

Either `true` or `false`.

## Position

A position is a set of three values intended to be used as x, y, and z coordinates (in that order).

#### Axes:

* North: +Z (note that in ACOVG, north and south are reversed)
* South: -Z
* East: +X
* West: -X
* Up: +Y
* Down: -Y

There are three possible value types that can be used as coordinates:

### Absolute coordinates (numbers)

Absolute coordinates are used to specify an exact position in the world. They are just numbers.

#### Examples

`1 50 7` means the position {x=1, y=50, z=7}.

`-23.52 38.8 0` means the position {x=-23.52, y=38.8, z=0}

### Relative coordinates (tilde notation)

Relative coordinates are used to specify a coordinate relative to where the command is executed. Relative coordinates are preceded by a tilde (\~). You can combine relative coordinates with absolute coordinates.

#### Examples

`~ ~5 ~` means the position 5 nodes above the execution position.

`~-2 ~ 25` means the position 2 nodes in the -X direction from the execution position, with the Z coordinate replaced with 25. At {x=3, y=5, z=-3.5}, this would evaluate to {x=1, y=5, z=25}.

### Local coordinates (caret notation)

Local coordinates are used to specify a coordinate relative to the execution position and rotation. It's similar to relative coordinates, except the execution rotation is treated as the Z-axis. Local coordinates are preceded with a caret (^). You ***cannot*** combine local coordinates with absolute or relative coordinates.

#### Examples

`^ ^ ^5` Five nodes "forward"

`^ ^-5 ^` Five nodes "down"

`^-2 ^ ^` Two nodes "left"

## Rotation

One or two values, intended to be used as yaw (left/right rotation) and sometimes pitch (up/down rotation). Values are in degrees, and support tilde (relative) notation.

#### Directions

* North: Yaw = 0
* West: Yaw = 90
* South: Yaw = 180
* East: Yaw = 270
* Up: Pitch = 90 (maximum for players is 89.5)
* Down: Pitch = -90 (minimum for players is -89.5)

#### Examples

`45`: Northwest

`~45`: 45 degrees counterclockwise from the current direction

`180 -90`: Facing south and down

`~1 ~-1` (1 degree counterclockwise and one degree up from the current direction)

## Selector

See [Target Selectors](/better-commands/target-selectors.md).

## Item/Node

An itemstring or item alias, with optional metadata in `[square brackets]`. Nodes support param1 and param2 being set this way.

Items can also be specified with a `count` and `wear` value, such as `default:pick_wood 1 65535`

#### Item Examples

`default:dirt` = dirt

`dirt` = dirt (alias)

`dirt[color=green]` = green dirt

`dirt[color=green] 24` = 24 green dirt

`default:pick_wood[color=green] 1 32768` = a green half-worn wooden pickaxe

#### Node Examples

`default:dirt` = dirt

`default:water_flowing[param2=3]` = flowing water (level 3)