A BlockVolume is a simple interface to an object which represents a 3D rectangle of a given size (in blocks) at a world block location. Note that these are not analogous to "min" and "max" values, in that the vector components are not guaranteed to be in any order. In addition, these vector positions are not interchangeable with BlockLocation. If you want to get this volume represented as range of of BlockLocations, you can use the getBoundingBox utility function. This volume class will maintain the ordering of the corner indexes as initially set. imagine that each corner is assigned in Editor - as you move the corner around (potentially inverting the min/max relationship of the bounds) - what you had originally selected as the top/left corner would traditionally become the bottom/right. When manually editing these kinds of volumes, you need to maintain the identity of the corner as you edit - the BlockVolume utility functions do this.

Important to note that this measures block sizes (to/from) - a normal AABB (0,0,0) to (0,0,0) would traditionally be of size (0,0,0) However, because we're measuring blocks - the size or span of a BlockVolume would actually be (1,1,1)

Hierarchy (View Summary)

Constructors

Properties

from: Vector3

A world block location that represents a corner in a 3D rectangle

This property can't be edited in read-only mode.

A world block location that represents the opposite corner in a 3D rectangle

This property can't be edited in read-only mode.

Methods

  • Beta

    Parameters

    • pos: Vector3

      The world block location to test

    Returns boolean

    If the location is either inside or more than 0 blocks away, the function will return false. If the location is directly contacting the outer surface of the BlockVolume, the function will return true.

    Check to see if the given location is directly adjacent to the outer surface of a BlockVolume.

    This function can't be called in read-only mode.

  • Beta

    Parameters

    Returns boolean

    If the outer faces of both block volumes touch and are directly adjacent at any point, return true.

    Check to see if a two block volumes are directly adjacent and two faces touch.

    This function can't be called in read-only mode.

  • Beta

    Returns number

    Return the capacity (volume) of the BlockVolume (WDH)

    This function can't be called in read-only mode.

  • Beta

    Returns Vector3

    Get the largest corner position of the volume (guaranteed to be >= min)

    This function can't be called in read-only mode.

    This function can throw errors.

  • Beta

    Returns Vector3

    Get the smallest corner position of the volume (guaranteed to be <= max)

    This function can't be called in read-only mode.

    This function can throw errors.

  • Beta

    Returns Vector3

    Get a Vector3 object where each component represents the number of blocks along that axis

    This function can't be called in read-only mode.

  • Beta

    Parameters

    Returns boolean

    Check to see if a given world block location is inside a BlockVolume

    This function can't be called in read-only mode.

  • Beta

    Parameters

    • delta: Vector3

      Amount of blocks to move by

    Returns void

    Move a BlockVolume by a specified amount

    This function can't be called in read-only mode.