@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 getPackStructureIds getWorldStructureIds place placeJigsaw placeJigsawStructure

    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. Defaults to: 0

      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.

      no-restricted-execution - This function can't be called in restricted-execution 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.

      no-restricted-execution - This function can't be called in restricted-execution 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.

      no-restricted-execution - This function can't be called in restricted-execution 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 Structure | undefined

      Returns a Structure if it exists, otherwise undefined.

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

      no-restricted-execution - This function can't be called in restricted-execution mode.

    • Returns string[]

      The list of structure identifiers.

      Returns a list of all structures contained in behavior packs. Does not include structures saved to the world or in memory.

      no-restricted-execution - This function can't be called in restricted-execution mode.

    • Returns string[]

      The list of structure identifiers.

      Returns a list of all structures saved to the world and to memory. Does not include structures contained in behavior packs.

      no-restricted-execution - This function can't be called in restricted-execution 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.

      no-restricted-execution - This function can't be called in restricted-execution 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

    • Parameters

      • pool: string

        The identifier of the template pool to start from.

      • targetJigsaw: string

        The name of the jigsaw block to start from. This block must be included in at least one of the starting pool structure templates.

      • maxDepth: number

        The maximum recursion depth for the jigsaw structure. Bounds: [1, 20]

      • dimension: Dimension

        The dimension to place the jigsaw structure in.

      • location: Vector3

        The location where the jigsaw structure will begin generating relative to the targetJigsaw block.

      • Optionaloptions: JigsawPlaceOptions

        Optional settings to use when generating the jigsaw structure.

      Returns BlockBoundingBox

      Returns a BlockBoundingBox object which represents the maximum bounds of the jigsaw structure.

      Places a partial jigsaw structure in the world. This is useful for debugging connections between jigsaw blocks.

      no-restricted-execution - This function can't be called in restricted-execution mode.

      Throws if maxDepth is outside of the range [1,20] Throws if generation fails due to invalid parameters or jigsaw configuration. Throws if the placement location contains blocks that are outside the world bounds.

      PlaceJigsawError

    • Parameters

      • identifier: string

        The identifier of the jigsaw structure.

      • dimension: Dimension

        The dimension to place the jigsaw structure in.

      • location: Vector3

        The location where the jigsaw structure will begin generating. Note that the y value will be overridden by the structure's start height unless the ignoreStarJigsawStructurePlaceOptions ignoreStartHeight option is set.

      • Optionaloptions: JigsawStructurePlaceOptions

        Optional settings to use when generating the jigsaw structure.

      Returns BlockBoundingBox

      Returns a BlockBoundingBox object which represents the maximum bounds of the jigsaw structure.

      Places a jigsaw structure in the world.

      no-restricted-execution - This function can't be called in restricted-execution mode.

      Throws if generation fails due to invalid parameters or jigsaw configuration. Throws if the placement location contains blocks that are outside the world bounds.

      PlaceJigsawError

    Settings

    Member Visibility

    On This Page

    Methods