# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://thepython10110.gitbook.io/better-commands/data-types.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.