@minecraft/server
    Preparing search index...

    Class StructureManager

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

    Index

    Methods

    createEmpty createFromWorld delete get getWorldStructureIds place

    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}.

      • OptionalsaveMode: StructureSaveMode

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

      Returns Structure

      Returns the newly created Structure.

      Creates an empty Structure in memory. Use Structure.setBlockPermutation to populate the structure with blocks and save changes with Structure.saveAs.

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

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

      minecraftcommon.EngineError

      minecraftcommon.InvalidArgumentError

    • Parameters

      • identifier: string

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

      • dimension: Dimension

        The dimension where the blocks should be read from.

      • from: Vector3
      • to: Vector3
      • Optionaloptions: StructureCreateOptions

        Additional options for creating a structure from the world.

      Returns Structure

      Returns the newly created Structure.

      Creates a new Structure from blocks in the world. This is functionally equivalent to the /structure save command.

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

      Throws if the identifier is invalid. A valid identifier must include a namespace and must be unique. Throws if the structure bounds exceed the maximum size. Throws if the structure bounds contains blocks outside the world bounds.

      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.

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

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

      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.

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

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

    • Returns string[]

      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.

      • Optionaloptions: StructurePlaceOptions

        Additional options for Structure placement.

      Returns void

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

    Settings

    Member Visibility

    On This Page

    Methods