类 Selection实验性

The Selection represents a volume in space, which may potentially be made up of one or more block locations. These block locations do not need to be contiguous, and a Selection represent an irregular shape. It's important to note that a Selection is only a representation of the volume shape space - and does NOT represent the actual contents of the space.

属性

isEmpty: boolean

Returns a boolean representing whether or not there are any volumes pushed to the selection stack

This property can throw when used.

visible: boolean

Set whether or not the selection volume is visible to the client user. NOTE: Use this option carefully - Selection volumes are generally server-only, but marking a volume as visible causes the volume (and all volume operations) to be synchronized with the client game which can potentially generate excessive network traffic.

无法在只读模式下修改此属性,详见 WorldBeforeEvents

方法

  • 实验性

    返回 BlockLocationIterator

    Fetch a block iterator which can be used to step across the Selection shape. Each call to the iterator will return the next block location within the Selection bounds which is actually selected. Block iteration is not guaranteed to be contiguous - it is possible to create irregular selection shapes by adding volumes to a selection which may or may not be contiguous or adjacent to other volumes within the selection. The Block iterator will return only selected volume locations

    无法在只读模式下调用此函数,详见 WorldBeforeEvents

  • 实验性

    返回 BoundingBox

    Return a bounding rectangle that contains all of the volumes within the selection (the bounding rectangle does NOT represent the shape of the selection, only the largest rectangle that will fit all of the volumes)

    无法在只读模式下调用此函数,详见 WorldBeforeEvents

    This function can throw errors.

  • 实验性

    参数

    • delta: Vector3

      The amount by which to move

    返回 Vector3

    Return the newly moved position

    Translate a selection by a given amount (this causes all of the volumes within the selection to be moved by the specified offset)

    无法在只读模式下调用此函数,详见 WorldBeforeEvents

    This function can throw errors.

  • 实验性

    参数

    • location: Vector3

      The world location to which to relocate the selection

    返回 Vector3

    Return the newly moved position

    Move the selection to an absolute world location (causing all of the volumes within the selection to be moved to a location relative to the world location)

    无法在只读模式下调用此函数,详见 WorldBeforeEvents

    This function can throw errors.

  • 实验性

    返回 void

    Remove the volume information that was last pushed to the volume stack. This will reduce the stack item length by 1

    无法在只读模式下调用此函数,详见 WorldBeforeEvents

    This function can throw errors.

  • 实验性

    参数

    返回 void

    Replace the contents of the current selection with a new specified selection. This operation will delete the current contents and copy the contents of the new selection to the target selection - it does this by content, not by reference.

    无法在只读模式下调用此函数,详见 WorldBeforeEvents

    This function can throw errors.

  • 实验性

    参数

    返回 void

    Set the color of the hull of the selection object if it is visible.

    无法在只读模式下调用此函数,详见 WorldBeforeEvents

    This function can throw errors.

  • 实验性

    参数

    返回 void

    Set the color of the outline around the selection object if it is visible

    无法在只读模式下调用此函数,详见 WorldBeforeEvents

    This function can throw errors.