Class StructureManager

Manager for Structure related APIs. Includes APIs for creating, getting, placing and deleting Structures.

Hierarchy

  • StructureManager

Constructors

Methods

Constructors

Methods

  • Parameters

    • identifier: string

      The name of the structure. A valid identifier must include a namespace and must be unique.

    • size: Vector3

      The size of the structure. For example, to create a single block structure the size should be {x:1, y:1, z:1}.

    • Optional saveMode: StructureSaveMode

      How the Structure should be saved upon creation. Defaults to StructureSaveMode.Memory.

    Returns Structure

    Returns the newly created Structure.

    Remarks

    Creates an empty Structure in memory. Use Structure.setBlockPermutation to populate the structure with blocks and save changes with @minecraft/server.Structure.save.

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

    Throws

    Throws if the identifier is invalid. A valid identifier must include a namespace and must be unique.

    minecraftcommon.EngineError

    minecraftcommon.InvalidArgumentError

  • Parameters

    • structure: string | Structure

      The structure identifier or Structure object that should be deleted. Note, a Structure object will become invalid after it is deleted.

    Returns boolean

    Returns whether the structure was removed.

    Remarks

    Deletes a structure from memory and from the world if it exists.

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

    Throws

    Throws if a structure cannot be removed. For example, a structure loaded from a Behavior Pack.

    minecraftcommon.InvalidArgumentError

  • Parameters

    • identifier: string

      The name of the structure to get.

    Returns undefined | Structure

    Returns a Structure if it exists, otherwise undefined.

    Remarks

    Gets a Structure that is saved to memory or the world.

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

  • Parameters

    • structure: string | Structure

      The structure's identifier or a Structure object.

    • dimension: Dimension

      The dimension where the Structure should be placed.

    • location: Vector3

      The location within the dimension where the Structure should be placed.

    • Optional options: StructurePlaceOptions

      Additional options for Structure placement.

    Returns void

    Remarks

    Places a structure in the world. Structures placed in unloaded chunks will be queued for loading.

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

    Throws

    Throws if the integrity value is outside of the range [0,1] Throws if the integrity seed is invalid. Throws if the placement location contains blocks that are outside the world bounds.

    minecraftcommon.ArgumentOutOfBoundsError

    minecraftcommon.InvalidArgumentError

    InvalidStructureError