Represents a position of a block in the world

This class was added by a mod with mod-id crafttweaker. So you need to have this mod installed if you want to use this feature.

Importing the class

Link to importing-the-class

It might be required for you to import the package if you encounter any issues (like casting an Array), so better be safe than sorry and add the import.

ZenScript
Copy
crafttweaker.api.util.BlockPos
ZenScript
Copy
new crafttweaker.api.util.BlockPos(x as int, y as int, z as int);
ParameterTypeDescription
Parameter
x
Type
int
Description
No description provided
Parameter
y
Type
int
Description
No description provided
Parameter
z
Type
int
Description
No description provided

Adds two positions together and returns the result.

Returns crafttweaker.api.util.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).add(pos as crafttweaker.api.util.BlockPos);
new BlockPos(0, 1, 2).add(new BlockPos(3, 2, 1));
ParameterTypeDescription
Parameter
pos
Type
crafttweaker.api.util.BlockPos
Description
other position to add

Adds the given values to this position, and returns a new position with the new values.

Returns crafttweaker.api.util.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).add(x as double, y as double, z as double);
new BlockPos(0, 1, 2).add(50.21, -20.8, -25.2);
ParameterTypeDescription
Parameter
x
Type
double
Description
x value to add
Parameter
y
Type
double
Description
y value to add
Parameter
z
Type
double
Description
z value to add

Creates a new BlockPos based on the cross product of this position, and the given position

Returns crafttweaker.api.util.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).crossProduct(pos as crafttweaker.api.util.BlockPos);
new BlockPos(0, 1, 2).crossProduct(new BlockPos(5, 8, 2););
ParameterTypeDescription
Parameter
pos
Type
crafttweaker.api.util.BlockPos
Description
BlockPos to cross product

Gets the squared distance of this position to the specified BlockPos, using the center of the BlockPos

Returns double

ZenScript
Copy
new BlockPos(0, 1, 2).distanceSq(to as crafttweaker.api.util.BlockPos);
new BlockPos(0, 1, 2).distanceSq(new BlockPos(256, 128, 10););
ParameterTypeDescription
Parameter
to
Type
crafttweaker.api.util.BlockPos
Description
BlockPos to check against

Gets the squared distance of this position to the specified BlockPos

Returns double

ZenScript
Copy
new BlockPos(0, 1, 2).distanceSq(to as crafttweaker.api.util.BlockPos, useCenter as boolean);
new BlockPos(0, 1, 2).distanceSq(new BlockPos(256, 128, 10);, true);
ParameterTypeDescription
Parameter
to
Type
crafttweaker.api.util.BlockPos
Description
BlockPos to check against
Parameter
useCenter
Type
boolean
Description
should the center of the coordinate be used? (adds 0.5 to each value)

Gets the squared distance of this position to the specified coordinates

Returns double

ZenScript
Copy
new BlockPos(0, 1, 2).distanceSq(x as double, y as double, z as double, useCenter as boolean);
new BlockPos(0, 1, 2).distanceSq(500.25, 250.75, 100.20, false);
ParameterTypeDescription
Parameter
x
Type
double
Description
x position to check against
Parameter
y
Type
double
Description
y position to check against
Parameter
z
Type
double
Description
z position to check against
Parameter
useCenter
Type
boolean
Description
should the center of the coordinate be used? (adds 0.5 to each value)

Creates a new BlockPos based on this BlockPos that is one block lower than this BlockPos

Returns: a new BlockPos that is one block lower than this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).down();

Creates a new BlockPos based on this BlockPos that is one block east of this BlockPos

Returns: a new BlockPos that is one block east of this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).east();

Creates a new BlockPos based on this BlockPos that is n block(s) east of this BlockPos

Returns: a new BlockPos that is n block(s) east of this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).east(n as int);
new BlockPos(0, 1, 2).east(2);
ParameterTypeDescription
Parameter
n
Type
int
Description
No description provided

manhattanDistance

Link to manhattandistance

Gets the Manhattan Distance of this pos compared to a different position

Returns int

ZenScript
Copy
new BlockPos(0, 1, 2).manhattanDistance(other as crafttweaker.api.util.BlockPos);
new BlockPos(0, 1, 2).manhattanDistance(new BlockPos(4, 5, 6));
ParameterTypeDescription
Parameter
other
Type
crafttweaker.api.util.BlockPos
Description
other position to get the distance to

Creates a new BlockPos based on this BlockPos that is one block north of this BlockPos

Returns: a new BlockPos that is one block north of this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).north();

Creates a new BlockPos based on this BlockPos that is n block(s) north of this BlockPos

Returns: a new BlockPos that is n block(s) north of this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).north(n as int);
new BlockPos(0, 1, 2).north(10);
ParameterTypeDescription
Parameter
n
Type
int
Description
No description provided

Creates a new BlockPos based on this BlockPos that is one block offset of this BlockPos based on the given crafttweaker.api.util.Direction

Returns: a new BlockPos that is 1 block offset of this BlockPos

Returns crafttweaker.api.util.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).offset(direction as crafttweaker.api.util.Direction);
new BlockPos(0, 1, 2).offset(<direction:east>);
ParameterTypeDescription
Parameter
direction
Type
crafttweaker.api.util.Direction
Description
No description provided

Creates a new BlockPos based on this BlockPos that is n block(s) offset of this BlockPos based on the given crafttweaker.api.util.Direction

Returns: a new BlockPos that is n block(s) offset of this BlockPos

Returns crafttweaker.api.util.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).offset(direction as crafttweaker.api.util.Direction, n as int);
new BlockPos(0, 1, 2).offset(<direction:south>, 3);
ParameterTypeDescription
Parameter
direction
Type
crafttweaker.api.util.Direction
Description
No description provided
Parameter
n
Type
int
Description
No description provided

Creates a new BlockPos based on this BlockPos that is one block south of this BlockPos

Returns: a new BlockPos that is one block south of this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).south();

Creates a new BlockPos based on this BlockPos that is n block(s) south of this BlockPos

Returns: a new BlockPos that is n block(s) south of this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).south(n as int);
new BlockPos(0, 1, 2).south(12);
ParameterTypeDescription
Parameter
n
Type
int
Description
No description provided

Subtracts two positions together and returns the result.

Returns crafttweaker.api.util.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).subtract(pos as crafttweaker.api.util.BlockPos);
new BlockPos(0, 1, 2).subtract(new BlockPos(2, 1, 3));
ParameterTypeDescription
Parameter
pos
Type
crafttweaker.api.util.BlockPos
Description
other position to remove

Creates a new BlockPos based on this BlockPos that is one block higher than this BlockPos

Returns: a new BlockPos that is one block higher than this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).up();

Creates a new BlockPos based on this BlockPos that is n block(s) higher than this BlockPos

Returns: a new BlockPos that is n block(s) higher than this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).up(n as int);
new BlockPos(0, 1, 2).up(45);
ParameterTypeDescription
Parameter
n
Type
int
Description
No description provided

Creates a new BlockPos based on this BlockPos that is one block west of this BlockPos

Returns: a new BlockPos that is one block west of this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).west();

Creates a new BlockPos based on this BlockPos that is n block(s) west of this BlockPos

Returns: a new BlockPos that is n block(s) west of this BlockPos

Returns net.minecraft.util.math.BlockPos

ZenScript
Copy
new BlockPos(0, 1, 2).west(n as int);
new BlockPos(0, 1, 2).west(120);
ParameterTypeDescription
Parameter
n
Type
int
Description
No description provided

Checks if the given BlockPos is within the specified distance of this BlockPos (this uses the middle of the BlockPos)

Returns boolean

ZenScript
Copy
new BlockPos(0, 1, 2).withinDistance(pos as crafttweaker.api.util.BlockPos, distance as double);
new BlockPos(0, 1, 2).withinDistance(new BlockPos(80, 75, 54);, 10);
ParameterTypeDescription
Parameter
pos
Type
crafttweaker.api.util.BlockPos
Description
BlockPos to check if it is within the distance
Parameter
distance
Type
double
Description
distance to check within
NameTypeHas GetterHas Setter
Name
x
Type
int
Has Getter
true
Has Setter
false
Name
y
Type
int
Has Getter
true
Has Setter
false
Name
z
Type
int
Has Getter
true
Has Setter
false

Adds two positions together and returns the result.

ZenScript
Copy
new BlockPos(0, 1, 2) + pos as crafttweaker.api.util.BlockPos
new BlockPos(0, 1, 2) + new BlockPos(3, 2, 1)
ParameterTypeDescription
Parameter
pos
Type
crafttweaker.api.util.BlockPos
Description
other position to add
Parameter
### SUB

Subtracts two positions together and returns the result.

ZenScript
Copy
new BlockPos(0, 1, 2) - pos as crafttweaker.api.util.BlockPos
new BlockPos(0, 1, 2) - new BlockPos(2, 1, 3)
ParameterTypeDescription
Parameter
pos
Type
crafttweaker.api.util.BlockPos
Description
other position to remove
Result typeIs Implicit
Result type
long
Is Implicit
false