@minecraft/server 2.0.0-beta.1.21.80-preview.21 → 2.0.0-beta.1.21.80-preview.26

package/index.d.ts

@@ -133,7 +133,6 @@ export enum BlockVolumeIntersection {
 }
 
 /**
- * @rc
  * The state of a button on a keyboard, controller, or touch
  * interface.
  */
@@ -142,6 +141,43 @@ export enum ButtonState {
     Released = 'Released',
 }
 
+/**
+ * @beta
+ * The required permission level to execute the custom command.
+ */
+export enum CommandPermissionLevel {
+    /**
+     * @remarks
+     * Anything can run this level.
+     *
+     */
+    Any = 0,
+    /**
+     * @remarks
+     * Any operator can run this command, including command blocks.
+     *
+     */
+    GameDirectors = 1,
+    /**
+     * @remarks
+     * Any operator can run this command, but NOT command blocks.
+     *
+     */
+    Admin = 2,
+    /**
+     * @remarks
+     * Any server host can run this command.
+     *
+     */
+    Host = 3,
+    /**
+     * @remarks
+     * Only dedicated server can run this command.
+     *
+     */
+    Owner = 4,
+}
+
 /**
  * @beta
  * The Action enum determines how the CompoundBlockVolume
@@ -191,41 +227,123 @@ export enum CompoundBlockVolumePositionRelativity {
     Absolute = 1,
 }
 
+/**
+ * @beta
+ * Reason why custom command registration failed.
+ */
+export enum CustomCommandErrorReason {
+    /**
+     * @remarks
+     * Command name already registered.
+     *
+     */
+    AlreadyRegistered = 'AlreadyRegistered',
+    /**
+     * @remarks
+     * Too many command parameters defined in CustomCommand.
+     *
+     */
+    ParameterLimit = 'ParameterLimit',
+    /**
+     * @remarks
+     * Custom command registry can not be accessed after world
+     * initialized event.
+     *
+     */
+    RegistryInvalid = 'RegistryInvalid',
+    /**
+     * @remarks
+     * Command parameters cannot be redefined during reload. Only
+     * the script closure itself can be changed.
+     *
+     */
+    RegistryReadOnly = 'RegistryReadOnly',
+}
+
+/**
+ * @beta
+ */
+export enum CustomCommandParamType {
+    Boolean = 0,
+    Integer = 1,
+    Float = 2,
+    String = 3,
+    EntitySelector = 4,
+    PlayerSelector = 5,
+    Location = 6,
+    BlockType = 7,
+    ItemType = 8,
+}
+
+/**
+ * @beta
+ * Who executed the command.
+ */
+export enum CustomCommandSource {
+    /**
+     * @remarks
+     * Command originated from a command block.
+     *
+     */
+    Block = 'Block',
+    /**
+     * @remarks
+     * Command originated from an entity or player.
+     *
+     */
+    Entity = 'Entity',
+    NPCDialogue = 'NPCDialogue',
+    /**
+     * @remarks
+     * Command originated from the server.
+     *
+     */
+    Server = 'Server',
+}
+
+/**
+ * @beta
+ */
+export enum CustomCommandStatus {
+    Success = 0,
+    Failure = 1,
+}
+
 export enum CustomComponentNameErrorReason {
     NoNamespace = 1,
     DisallowedNamespace = 2,
 }
 
 /**
- * @beta
+ * @rc
  * An enumeration for the various difficulty levels of
  * Minecraft.
  */
 export enum Difficulty {
     /**
      * @remarks
-     * Peaceful difficulty level.
+     * Easy difficulty level.
      *
      */
-    Peaceful = 0,
+    Easy = 'Easy',
     /**
      * @remarks
-     * Easy difficulty level.
+     * Hard difficulty level.
      *
      */
-    Easy = 1,
+    Hard = 'Hard',
     /**
      * @remarks
      * Normal difficulty level.
      *
      */
-    Normal = 2,
+    Normal = 'Normal',
     /**
      * @remarks
-     * Hard difficulty level.
+     * Peaceful difficulty level.
      *
      */
-    Hard = 3,
+    Peaceful = 'Peaceful',
 }
 
 /**
@@ -1436,6 +1554,10 @@ export enum GameRule {
      *
      */
     KeepInventory = 'keepInventory',
+    /**
+     * @beta
+     */
+    LocatorBar = 'locatorBar',
     /**
      * @remarks
      * The maximum number of chained commands that can execute per
@@ -1648,7 +1770,6 @@ export enum HudVisibility {
 }
 
 /**
- * @rc
  * All the different input buttons that are supported. Use with
  * {@link InputInfo.getButtonState} via {@link
  * Player.inputInfo} or {@link PlayerButtonInputAfterEvent} via
@@ -1856,7 +1977,6 @@ export enum ItemLockMode {
 }
 
 /**
- * @rc
  * Represents the type of liquid that can be placed on a block
  * or flow dynamically in the world.
  */
@@ -1969,7 +2089,6 @@ export enum MoonPhase {
 }
 
 /**
- * @rc
  * An enumeration describing the reason for the namespace name
  * error being thrown
  */
@@ -2434,16 +2553,10 @@ export enum WeatherType {
     Thunder = 'Thunder',
 }
 
-/**
- * @rc
- */
 export type BlockComponentReturnType<T extends string> = T extends keyof BlockComponentTypeMap
     ? BlockComponentTypeMap[T]
     : BlockComponent;
 
-/**
- * @rc
- */
 export type BlockComponentTypeMap = {
     destruction_particles: BlockDestructionParticlesComponent;
     fluid_container: BlockFluidContainerComponent;
@@ -2462,7 +2575,6 @@ export type BlockComponentTypeMap = {
 };
 
 /**
- * @rc
  * Type alias used by the {@link BlockPermutation} matches and
  * resolve functions to narrow block state argument types to
  * those mapped by {@link
@@ -2474,16 +2586,10 @@ export type BlockStateArg<T> = T extends `${minecraftvanilladata.MinecraftBlockT
         : never
     : Record<string, boolean | number | string>;
 
-/**
- * @rc
- */
 export type EntityComponentReturnType<T extends string> = T extends keyof EntityComponentTypeMap
     ? EntityComponentTypeMap[T]
     : EntityComponent;
 
-/**
- * @rc
- */
 export type EntityComponentTypeMap = {
     addrider: EntityAddRiderComponent;
     ageable: EntityAgeableComponent;
@@ -2628,16 +2734,10 @@ export type EntityIdentifierType<T> = [T] extends [never]
     ? VanillaEntityIdentifier | T
     : never;
 
-/**
- * @rc
- */
 export type ItemComponentReturnType<T extends string> = T extends keyof ItemComponentTypeMap
     ? ItemComponentTypeMap[T]
     : ItemCustomComponentInstance;
 
-/**
- * @rc
- */
 export type ItemComponentTypeMap = {
     compostable: ItemCompostableComponent;
     cooldown: ItemCooldownComponent;
@@ -3192,6 +3292,19 @@ export class Block {
      * {@link LocationOutOfWorldBoundariesError}
      */
     readonly isWaterlogged: boolean;
+    /**
+     * @beta
+     * @remarks
+     * key for the localization of this block's name used in .lang
+     * files.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    readonly localizationKey: string;
     /**
      * @remarks
      * Coordinates of the specified block.
@@ -3289,7 +3402,6 @@ export class Block {
      */
     bottomCenter(): Vector3;
     /**
-     * @rc
      * @remarks
      * Returns whether this block is removed when touched by
      * liquid.
@@ -3308,7 +3420,6 @@ export class Block {
      */
     canBeDestroyedByLiquidSpread(liquidType: LiquidType): boolean;
     /**
-     * @rc
      * @remarks
      * Returns whether this block can have a liquid placed over it,
      * i.e. be waterlogged.
@@ -3483,7 +3594,6 @@ export class Block {
      */
     hasTag(tag: string): boolean;
     /**
-     * @rc
      * @remarks
      * Returns whether this block stops liquid from flowing.
      *
@@ -3501,7 +3611,6 @@ export class Block {
      */
     isLiquidBlocking(liquidType: LiquidType): boolean;
     /**
-     * @rc
      * @remarks
      * Returns whether liquid can flow into the block from the
      * provided direction, or flow out from the provided direction
@@ -3523,7 +3632,6 @@ export class Block {
      */
     liquidCanFlowFromDirection(liquidType: LiquidType, flowDirection: Direction): boolean;
     /**
-     * @rc
      * @remarks
      * Returns whether this block is removed and spawns its item
      * when touched by liquid.
@@ -3695,6 +3803,137 @@ export class Block {
     west(steps?: number): Block | undefined;
 }
 
+/**
+ * @beta
+ * Bounding Box Utils is a utility class that provides a number
+ * of useful functions for the creation and utility of {@link
+ * BlockBoundingBox} objects
+ */
+export class BlockBoundingBoxUtils {
+    private constructor();
+    /**
+     * @remarks
+     * Create a validated instance of a {@link BlockBoundingBox}
+     * where the min and max components are guaranteed to be (min
+     * <= max)
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param min
+     * A corner world location
+     * @param max
+     * A corner world location diametrically opposite
+     */
+    static createValid(min: Vector3, max: Vector3): BlockBoundingBox;
+    /**
+     * @remarks
+     * Expand a {@link BlockBoundingBox} by a given amount along
+     * each axis.
+     * Sizes can be negative to perform contraction.
+     * Note: corners can be inverted if the contraction size is
+     * greater than the span, but the min/max relationship will
+     * remain correct
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @returns
+     * Return a new {@link BlockBoundingBox} object representing
+     * the changes
+     */
+    static dilate(box: BlockBoundingBox, size: Vector3): BlockBoundingBox;
+    /**
+     * @remarks
+     * Check if two {@link BlockBoundingBox} objects are identical
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    static equals(box: BlockBoundingBox, other: BlockBoundingBox): boolean;
+    /**
+     * @remarks
+     * Expand the initial box object bounds to include the 2nd box
+     * argument.  The resultant {@link BlockBoundingBox} object
+     * will be a BlockBoundingBox which exactly encompasses the two
+     * boxes.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @returns
+     * A new {@link BlockBoundingBox} instance representing the
+     * smallest possible bounding box which can encompass both
+     */
+    static expand(box: BlockBoundingBox, other: BlockBoundingBox): BlockBoundingBox;
+    /**
+     * @remarks
+     * Calculate the center block of a given {@link
+     * BlockBoundingBox} object.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @returns
+     * Note that {@link BlockBoundingBox} objects represent whole
+     * blocks, so the center of boxes which have odd numbered
+     * bounds are not mathematically centered...
+     * i.e. a BlockBoundingBox( 0,0,0 -> 3,3,3 )  would have a
+     * center of (1,1,1)  (not (1.5, 1.5, 1.5) as expected)
+     */
+    static getCenter(box: BlockBoundingBox): Vector3;
+    /**
+     * @remarks
+     * Calculate the BlockBoundingBox which represents the union
+     * area of two intersecting BlockBoundingBoxes
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    static getIntersection(box: BlockBoundingBox, other: BlockBoundingBox): BlockBoundingBox | undefined;
+    /**
+     * @remarks
+     * Get the Span of each of the BlockBoundingBox Axis components
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    static getSpan(box: BlockBoundingBox): Vector3;
+    /**
+     * @remarks
+     * Check to see if two BlockBoundingBox objects intersect
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    static intersects(box: BlockBoundingBox, other: BlockBoundingBox): boolean;
+    /**
+     * @remarks
+     * Check to see if a given coordinate is inside a
+     * BlockBoundingBox
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    static isInside(box: BlockBoundingBox, pos: Vector3): boolean;
+    /**
+     * @remarks
+     * Check to see if a BlockBoundingBox is valid (i.e. (min <=
+     * max))
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    static isValid(box: BlockBoundingBox): boolean;
+    /**
+     * @remarks
+     * Move a BlockBoundingBox by a given amount
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @returns
+     * Return a new BlockBoundingBox object which represents the
+     * change
+     */
+    static translate(box: BlockBoundingBox, delta: Vector3): BlockBoundingBox;
+}
+
 /**
  * Base type for components associated with blocks.
  */
@@ -4243,7 +4482,6 @@ export class BlockPermutation {
      */
     readonly 'type': BlockType;
     /**
-     * @rc
      * @remarks
      * Returns whether this block is removed when touched by
      * liquid.
@@ -4258,7 +4496,6 @@ export class BlockPermutation {
      */
     canBeDestroyedByLiquidSpread(liquidType: LiquidType): boolean;
     /**
-     * @rc
      * @remarks
      * Returns whether this block can have a liquid placed over it,
      * i.e. be waterlogged.
@@ -4337,7 +4574,6 @@ export class BlockPermutation {
      */
     hasTag(tag: string): boolean;
     /**
-     * @rc
      * @remarks
      * Returns whether this block stops liquid from flowing.
      *
@@ -4351,7 +4587,6 @@ export class BlockPermutation {
      */
     isLiquidBlocking(liquidType: LiquidType): boolean;
     /**
-     * @rc
      * @remarks
      * Returns whether this block is removed and spawns its item
      * when touched by liquid.
@@ -4947,12 +5182,12 @@ export class BlockVolumeBase {
     /**
      * @beta
      * @remarks
-     * Return a {@link BoundingBox} object which represents the
-     * validated min and max coordinates of the volume
+     * Return a {@link BlockBoundingBox} object which represents
+     * the validated min and max coordinates of the volume
      *
      * @throws This function can throw errors.
      */
-    getBoundingBox(): BoundingBox;
+    getBoundingBox(): BlockBoundingBox;
     /**
      * @remarks
      * Return the capacity (volume) of the BlockVolume (W*D*H)
@@ -4999,132 +5234,6 @@ export class BlockVolumeBase {
     translate(delta: Vector3): void;
 }
 
-/**
- * @beta
- * Bounding Box Utils is a utility class that provides a number
- * of useful functions for the creation and utility of {@link
- * BoundingBox} objects
- */
-export class BoundingBoxUtils {
-    private constructor();
-    /**
-     * @remarks
-     * Create a validated instance of a {@link BoundingBox} where
-     * the min and max components are guaranteed to be (min <= max)
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @param min
-     * A corner world location
-     * @param max
-     * A corner world location diametrically opposite
-     */
-    static createValid(min: Vector3, max: Vector3): BoundingBox;
-    /**
-     * @remarks
-     * Expand a {@link BoundingBox} by a given amount along each
-     * axis.
-     * Sizes can be negative to perform contraction.
-     * Note: corners can be inverted if the contraction size is
-     * greater than the span, but the min/max relationship will
-     * remain correct
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @returns
-     * Return a new {@link BoundingBox} object representing the
-     * changes
-     */
-    static dilate(box: BoundingBox, size: Vector3): BoundingBox;
-    /**
-     * @remarks
-     * Check if two {@link BoundingBox} objects are identical
-     *
-     * This function can't be called in read-only mode.
-     *
-     */
-    static equals(box: BoundingBox, other: BoundingBox): boolean;
-    /**
-     * @remarks
-     * Expand the initial box object bounds to include the 2nd box
-     * argument.  The resultant {@link BoundingBox} object will be
-     * a BoundingBox which exactly encompasses the two boxes.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @returns
-     * A new {@link BoundingBox} instance representing the smallest
-     * possible bounding box which can encompass both
-     */
-    static expand(box: BoundingBox, other: BoundingBox): BoundingBox;
-    /**
-     * @remarks
-     * Calculate the center block of a given {@link BoundingBox}
-     * object.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @returns
-     * Note that {@link BoundingBox} objects represent whole
-     * blocks, so the center of boxes which have odd numbered
-     * bounds are not mathematically centered...
-     * i.e. a BoundingBox( 0,0,0 -> 3,3,3 )  would have a center of
-     * (1,1,1)  (not (1.5, 1.5, 1.5) as expected)
-     */
-    static getCenter(box: BoundingBox): Vector3;
-    /**
-     * @remarks
-     * Calculate the BoundingBox which represents the union area of
-     * two intersecting BoundingBoxes
-     *
-     * This function can't be called in read-only mode.
-     *
-     */
-    static getIntersection(box: BoundingBox, other: BoundingBox): BoundingBox | undefined;
-    /**
-     * @remarks
-     * Get the Span of each of the BoundingBox Axis components
-     *
-     * This function can't be called in read-only mode.
-     *
-     */
-    static getSpan(box: BoundingBox): Vector3;
-    /**
-     * @remarks
-     * Check to see if two BoundingBox objects intersect
-     *
-     * This function can't be called in read-only mode.
-     *
-     */
-    static intersects(box: BoundingBox, other: BoundingBox): boolean;
-    /**
-     * @remarks
-     * Check to see if a given coordinate is inside a BoundingBox
-     *
-     * This function can't be called in read-only mode.
-     *
-     */
-    static isInside(box: BoundingBox, pos: Vector3): boolean;
-    /**
-     * @remarks
-     * Check to see if a BoundingBox is valid (i.e. (min <= max))
-     *
-     * This function can't be called in read-only mode.
-     *
-     */
-    static isValid(box: BoundingBox): boolean;
-    /**
-     * @remarks
-     * Move a BoundingBox by a given amount
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @returns
-     * Return a new BoundingBox object which represents the change
-     */
-    static translate(box: BoundingBox, delta: Vector3): BoundingBox;
-}
-
 /**
  * Contains information related to changes to a button push.
  * @example buttonPushEvent.ts
@@ -5598,7 +5707,7 @@ export class CompoundBlockVolume {
      * This function can't be called in read-only mode.
      *
      */
-    getBoundingBox(): BoundingBox;
+    getBoundingBox(): BlockBoundingBox;
     /**
      * @remarks
      * Get the max block location of the outermost bounding
@@ -5884,14 +5993,59 @@ export class Container {
     addItem(itemStack: ItemStack): ItemStack | undefined;
     /**
      * @remarks
-     * Clears all inventory items in the container.
+     * Clears all inventory items in the container.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @throws
+     * Throws if the container is invalid.
+     */
+    clearAll(): void;
+    /**
+     * @beta
+     * @remarks
+     * Attempts to find an item inside the container
+     *
+     * @param itemStack
+     * The item to find.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidContainerError}
+     */
+    contains(itemStack: ItemStack): boolean;
+    /**
+     * @beta
+     * @remarks
+     * Find the index of the first instance of an item inside the
+     * container
+     *
+     * @param itemStack
+     * The item to find.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidContainerError}
+     */
+    find(itemStack: ItemStack): number;
+    /**
+     * @beta
+     * @remarks
+     * Finds the index of the first empty slot inside the container
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidContainerError}
+     */
+    firstEmptySlot(): number;
+    /**
+     * @beta
+     * @remarks
+     * Finds the index of the first item inside the container
      *
-     * This function can't be called in read-only mode.
+     * @throws This function can throw errors.
      *
-     * @throws
-     * Throws if the container is invalid.
+     * {@link InvalidContainerError}
      */
-    clearAll(): void;
+    firstItem(): number;
     /**
      * @remarks
      * Gets an {@link ItemStack} of the item at the specified slot.
@@ -5989,6 +6143,19 @@ export class Container {
      * ```
      */
     moveItem(fromSlot: number, toSlot: number, toContainer: Container): void;
+    /**
+     * @beta
+     * @remarks
+     * Find the index of the last instance of an item inside the
+     * container
+     *
+     * @param itemStack
+     * The item to find.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidContainerError}
+     */
+    reverseFind(itemStack: ItemStack): number;
     /**
      * @remarks
      * Sets an item stack within a particular slot.
@@ -6445,6 +6612,87 @@ export class ContainerSlot {
     setLore(loreList?: string[]): void;
 }
 
+/**
+ * @beta
+ * Details about the origins of the command.
+ */
+export class CustomCommandOrigin {
+    private constructor();
+    /**
+     * @remarks
+     * If this command was initiated via an NPC, returns the entity
+     * that initiated the NPC dialogue.
+     *
+     */
+    readonly initiator?: Entity;
+    /**
+     * @remarks
+     * Source block if this command was triggered via a block
+     * (e.g., a commandblock.)
+     *
+     */
+    readonly sourceBlock?: Block;
+    /**
+     * @remarks
+     * Source entity if this command was triggered by an entity
+     * (e.g., a NPC).
+     *
+     */
+    readonly sourceEntity?: Entity;
+    /**
+     * @remarks
+     * Returns the type of source that fired this command.
+     *
+     */
+    readonly sourceType: CustomCommandSource;
+}
+
+/**
+ * @beta
+ * Provides the functionality for registering custom commands.
+ */
+export class CustomCommandRegistry {
+    private constructor();
+    /**
+     * @remarks
+     * Registers a custom command that when executed triggers a
+     * script callback.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     * @param callback
+     * The callback triggered when the command executes.
+     * @throws This function can throw errors.
+     *
+     * {@link CustomCommandError}
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link NamespaceNameError}
+     */
+    registerCommand(
+        customCommand: CustomCommand,
+        callback: (origin: CustomCommandOrigin, ...args: any[]) => CustomCommandResult | undefined,
+    ): void;
+}
+
+/**
+ * @beta
+ * Contains the custom component's JSON parameters
+ */
+export class CustomComponentParameters {
+    private constructor();
+    /**
+     * @remarks
+     * JSON object containing the parameters from the custom
+     * component definition
+     *
+     */
+    readonly params: unknown;
+}
+
 /**
  * Contains information related to firing of a data driven
  * entity event - for example, the minecraft:ageable_grow_up
@@ -6886,7 +7134,7 @@ export class Dimension {
      */
     getWeather(): WeatherType;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Places the given feature into the dimension at the specified
      * location.
@@ -6916,7 +7164,7 @@ export class Dimension {
      */
     placeFeature(featureName: string, location: Vector3, shouldThrow?: boolean): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Places the given feature rule into the dimension at the
      * specified location.
@@ -7607,6 +7855,17 @@ export class Entity {
      *
      */
     readonly isValid: boolean;
+    /**
+     * @beta
+     * @remarks
+     * key for the localization of this entity's name used in .lang
+     * files.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
+     */
+    readonly localizationKey: string;
     /**
      * @remarks
      * Current location of the entity.
@@ -9071,10 +9330,9 @@ export class EntityFrictionModifierComponent extends EntityComponent {
      * Current value of the friction modifier of the associated
      * entity.
      *
-     * This property can't be edited in read-only mode.
-     *
+     * @throws This property can throw when used.
      */
-    value: number;
+    readonly value: number;
     static readonly componentId = 'minecraft:friction_modifier';
 }
 
@@ -10741,10 +10999,9 @@ export class EntitySkinIdComponent extends EntityComponent {
      * @remarks
      * Returns the value of the skin Id identifier of the entity.
      *
-     * This property can't be edited in read-only mode.
-     *
+     * @throws This property can throw when used.
      */
-    value: number;
+    readonly value: number;
     static readonly componentId = 'minecraft:skin_id';
 }
 
@@ -11488,6 +11745,13 @@ export class GameRules {
      *
      */
     keepInventory: boolean;
+    /**
+     * @beta
+     * @remarks
+     * This property can't be edited in read-only mode.
+     *
+     */
+    locatorBar: boolean;
     /**
      * @remarks
      * This property can't be edited in read-only mode.
@@ -11631,7 +11895,6 @@ export class InputInfo {
      */
     readonly touchOnlyAffectsHotbar: boolean;
     /**
-     * @rc
      * @throws This function can throw errors.
      *
      * {@link minecraftcommon.EngineError}
@@ -11640,7 +11903,6 @@ export class InputInfo {
      */
     getButtonState(button: InputButton): ButtonState;
     /**
-     * @rc
      * @throws This function can throw errors.
      *
      * {@link InvalidEntityError}
@@ -12533,6 +12795,17 @@ export class ItemStack {
      *
      */
     keepOnDeath: boolean;
+    /**
+     * @beta
+     * @remarks
+     * key for the localization of this items's name used in .lang
+     * files.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link minecraftcommon.EngineError}
+     */
+    readonly localizationKey: string;
     /**
      * @remarks
      * Gets or sets the item's lock mode. The default value is
@@ -14187,7 +14460,6 @@ export class Player extends Entity {
      */
     setSpawnPoint(spawnPoint?: DimensionLocation): void;
     /**
-     * @rc
      * @remarks
      * Creates a new particle emitter at a specified location in
      * the world. Only visible to the target player.
@@ -14431,7 +14703,6 @@ export class PlayerBreakBlockBeforeEventSignal {
 }
 
 /**
- * @rc
  * Event data for when a player presses a button.
  */
 export class PlayerButtonInputAfterEvent {
@@ -14457,7 +14728,6 @@ export class PlayerButtonInputAfterEvent {
 }
 
 /**
- * @rc
  * Manages callbacks that are connected to player inputs.
  */
 export class PlayerButtonInputAfterEventSignal {
@@ -16654,6 +16924,12 @@ export class StartupEvent {
      *
      */
     readonly blockComponentRegistry: BlockComponentRegistry;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
+    readonly customCommandRegistry: CustomCommandRegistry;
     /**
      * @remarks
      * This property can be read in early-execution mode.
@@ -16964,8 +17240,8 @@ export class StructureManager {
      * Optional settings to use when generating the jigsaw
      * structure.
      * @returns
-     * Returns a {@link BoundingBox} object which represents the
-     * maximum bounds of the jigsaw structure.
+     * Returns a {@link BlockBoundingBox} object which represents
+     * the maximum bounds of the jigsaw structure.
      * @throws
      * Throws if maxDepth is outside of the range [1,20]
      * Throws if generation fails due to invalid parameters or
@@ -16982,7 +17258,7 @@ export class StructureManager {
         dimension: Dimension,
         location: Vector3,
         options?: JigsawPlaceOptions,
-    ): BoundingBox;
+    ): BlockBoundingBox;
     /**
      * @beta
      * @remarks
@@ -17004,8 +17280,8 @@ export class StructureManager {
      * Optional settings to use when generating the jigsaw
      * structure.
      * @returns
-     * Returns a {@link BoundingBox} object which represents the
-     * maximum bounds of the jigsaw structure.
+     * Returns a {@link BlockBoundingBox} object which represents
+     * the maximum bounds of the jigsaw structure.
      * @throws
      * Throws if generation fails due to invalid parameters or
      * jigsaw configuration.
@@ -17019,7 +17295,7 @@ export class StructureManager {
         dimension: Dimension,
         location: Vector3,
         options?: JigsawStructurePlaceOptions,
-    ): BoundingBox;
+    ): BlockBoundingBox;
 }
 
 /**
@@ -17213,7 +17489,6 @@ export class System {
      */
     runTimeout(callback: () => void, tickDelay?: number): number;
     /**
-     * @rc
      * @remarks
      * Causes an event to fire within script with the specified
      * message ID and payload.
@@ -17833,7 +18108,7 @@ export class World {
      */
     getDefaultSpawnLocation(): Vector3;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Gets the difficulty from the world.
      *
@@ -18085,7 +18360,7 @@ export class World {
      */
     setDefaultSpawnLocation(spawnLocation: Vector3): void;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Sets the worlds difficulty.
      *
@@ -18444,7 +18719,6 @@ export class WorldAfterEvents {
      */
     readonly playerBreakBlock: PlayerBreakBlockAfterEventSignal;
     /**
-     * @rc
      * @remarks
      * This event fires when an {@link InputButton} state is
      * changed.
@@ -18789,6 +19063,40 @@ export interface BiomeSearchOptions {
     boundingSize?: Vector3;
 }
 
+/**
+ * @rc
+ * A BlockBoundingBox is an interface to an object which
+ * represents an AABB aligned rectangle.
+ * The BlockBoundingBox assumes that it was created in a valid
+ * state (min <= max) but cannot guarantee it (unless it was
+ * created using the associated {@link BlockBoundingBoxUtils}
+ * utility functions.
+ * The min/max coordinates represent the diametrically opposite
+ * corners of the rectangle.
+ * The BlockBoundingBox is not a representation of blocks - it
+ * has no association with any type, it is just a mathematical
+ * construct - so a rectangle with
+ * ( 0,0,0 ) -> ( 0,0,0 )
+ * has a size of ( 0,0,0 ) (unlike the very similar {@link
+ * BlockVolume} object)
+ */
+export interface BlockBoundingBox {
+    /**
+     * @remarks
+     * A {@link Vector3} that represents the largest corner of the
+     * rectangle
+     *
+     */
+    max: Vector3;
+    /**
+     * @remarks
+     * A {@link Vector3} that represents the smallest corner of the
+     * rectangle
+     *
+     */
+    min: Vector3;
+}
+
 /**
  * Contains a set of events that will be raised for a block.
  * This object must be bound using the BlockRegistry.
@@ -18800,28 +19108,28 @@ export interface BlockCustomComponent {
      * block.
      *
      */
-    beforeOnPlayerPlace?: (arg0: BlockComponentPlayerPlaceBeforeEvent) => void;
+    beforeOnPlayerPlace?: (arg0: BlockComponentPlayerPlaceBeforeEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when an entity falls onto the
      * block that this custom component is bound to.
      *
      */
-    onEntityFallOn?: (arg0: BlockComponentEntityFallOnEvent) => void;
+    onEntityFallOn?: (arg0: BlockComponentEntityFallOnEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when the block that this custom
      * component is bound to is placed.
      *
      */
-    onPlace?: (arg0: BlockComponentOnPlaceEvent) => void;
+    onPlace?: (arg0: BlockComponentOnPlaceEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when a player destroys a
      * specific block.
      *
      */
-    onPlayerDestroy?: (arg0: BlockComponentPlayerDestroyEvent) => void;
+    onPlayerDestroy?: (arg0: BlockComponentPlayerDestroyEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when a player sucessfully
@@ -18829,33 +19137,33 @@ export interface BlockCustomComponent {
      * to.
      *
      */
-    onPlayerInteract?: (arg0: BlockComponentPlayerInteractEvent) => void;
+    onPlayerInteract?: (arg0: BlockComponentPlayerInteractEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when a block randomly ticks.
      *
      */
-    onRandomTick?: (arg0: BlockComponentRandomTickEvent) => void;
+    onRandomTick?: (arg0: BlockComponentRandomTickEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when an entity steps off the
      * block that this custom component is bound to.
      *
      */
-    onStepOff?: (arg0: BlockComponentStepOffEvent) => void;
+    onStepOff?: (arg0: BlockComponentStepOffEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when an entity steps onto the
      * block that this custom component is bound to.
      *
      */
-    onStepOn?: (arg0: BlockComponentStepOnEvent) => void;
+    onStepOn?: (arg0: BlockComponentStepOnEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when a block ticks.
      *
      */
-    onTick?: (arg0: BlockComponentTickEvent) => void;
+    onTick?: (arg0: BlockComponentTickEvent, arg1: CustomComponentParameters) => void;
 }
 
 /**
@@ -19030,40 +19338,6 @@ export interface BlockRaycastOptions extends BlockFilter {
     maxDistance?: number;
 }
 
-/**
- * @beta
- * A BoundingBox is an interface to an object which represents
- * an AABB aligned rectangle.
- * The BoundingBox assumes that it was created in a valid state
- * (min <= max) but cannot guarantee it (unless it was created
- * using the associated {@link BoundingBoxUtils} utility
- * functions.
- * The min/max coordinates represent the diametrically opposite
- * corners of the rectangle.
- * The BoundingBox is not a representation of blocks - it has
- * no association with any type, it is just a mathematical
- * construct - so a rectangle with
- * ( 0,0,0 ) -> ( 0,0,0 )
- * has a size of ( 0,0,0 ) (unlike the very similar {@link
- * BlockVolume} object)
- */
-export interface BoundingBox {
-    /**
-     * @remarks
-     * A {@link Vector3} that represents the largest corner of the
-     * rectangle
-     *
-     */
-    max: Vector3;
-    /**
-     * @remarks
-     * A {@link Vector3} that represents the smallest corner of the
-     * rectangle
-     *
-     */
-    min: Vector3;
-}
-
 export interface CameraDefaultOptions {
     /**
      * @remarks
@@ -19228,6 +19502,84 @@ export interface CompoundBlockVolumeItem {
     volume: BlockVolume;
 }
 
+/**
+ * @beta
+ * Define the custom command, including name, permissions, and
+ * parameters.
+ */
+export interface CustomCommand {
+    /**
+     * @remarks
+     * Command description as seen on the command line.
+     *
+     */
+    description: string;
+    /**
+     * @remarks
+     * List of mandatory command parameters.
+     *
+     */
+    mandatoryParameters?: CustomCommandParameter[];
+    /**
+     * @remarks
+     * The name of the command. A namespace is required.
+     *
+     */
+    name: string;
+    /**
+     * @remarks
+     * List of optional command parameters.
+     *
+     */
+    optionalParameters?: CustomCommandParameter[];
+    /**
+     * @remarks
+     * The permission level required to execute the command.
+     *
+     */
+    permissionLevel: CommandPermissionLevel;
+}
+
+/**
+ * @beta
+ * Definition for each parameter expected by the custom
+ * command.
+ */
+export interface CustomCommandParameter {
+    /**
+     * @remarks
+     * The name of parameter as it appears on the command line.
+     *
+     */
+    name: string;
+    /**
+     * @remarks
+     * The data type of the parameter.
+     *
+     */
+    type: CustomCommandParamType;
+}
+
+/**
+ * @beta
+ * Interface returned from custom command callback function.
+ */
+export interface CustomCommandResult {
+    /**
+     * @remarks
+     * Message displayed to chat after command execution.
+     *
+     */
+    message?: string;
+    /**
+     * @remarks
+     * Command execution Success or Failure. Determines how the
+     * status message is displayed.
+     *
+     */
+    status: CustomCommandStatus;
+}
+
 /**
  * Contains a set of updates to the component definition state
  * of an entity.
@@ -20000,7 +20352,6 @@ export interface GreaterThanOrEqualsComparison {
 }
 
 /**
- * @rc
  * An interface that is passed into {@link
  * @minecraft/Server.PlayerButtonInputAfterEventSignal.subscribe}
  * that filters out which events are passed to the provided
@@ -20035,49 +20386,52 @@ export interface ItemCustomComponent {
      * damage.
      *
      */
-    onBeforeDurabilityDamage?: (arg0: ItemComponentBeforeDurabilityDamageEvent) => void;
+    onBeforeDurabilityDamage?: (
+        arg0: ItemComponentBeforeDurabilityDamageEvent,
+        arg1: CustomComponentParameters,
+    ) => void;
     /**
      * @remarks
      * This function will be called when an item containing this
      * component's use duration was completed.
      *
      */
-    onCompleteUse?: (arg0: ItemComponentCompleteUseEvent) => void;
+    onCompleteUse?: (arg0: ItemComponentCompleteUseEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when an item containing this
      * component is eaten by an entity.
      *
      */
-    onConsume?: (arg0: ItemComponentConsumeEvent) => void;
+    onConsume?: (arg0: ItemComponentConsumeEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when an item containing this
      * component is used to hit another entity.
      *
      */
-    onHitEntity?: (arg0: ItemComponentHitEntityEvent) => void;
+    onHitEntity?: (arg0: ItemComponentHitEntityEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when an item containing this
      * component is used to mine a block.
      *
      */
-    onMineBlock?: (arg0: ItemComponentMineBlockEvent) => void;
+    onMineBlock?: (arg0: ItemComponentMineBlockEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when an item containing this
      * component is used by a player.
      *
      */
-    onUse?: (arg0: ItemComponentUseEvent) => void;
+    onUse?: (arg0: ItemComponentUseEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when an item containing this
      * component is used on a block.
      *
      */
-    onUseOn?: (arg0: ItemComponentUseOnEvent) => void;
+    onUseOn?: (arg0: ItemComponentUseOnEvent, arg1: CustomComponentParameters) => void;
 }
 
 /**
@@ -20906,6 +21260,23 @@ export class CommandError extends Error {
     private constructor();
 }
 
+/**
+ * @beta
+ * Error object thrown when CustomCommandRegistry errors occur.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class CustomCommandError extends Error {
+    private constructor();
+    /**
+     * @remarks
+     * Reason for the error.
+     *
+     * This property can be read in early-execution mode.
+     *
+     */
+    reason: CustomCommandErrorReason;
+}
+
 // @ts-ignore Class inheritance allowed for native defined classes
 export class CustomComponentInvalidRegistryError extends Error {
     private constructor();
@@ -20937,6 +21308,14 @@ export class EnchantmentTypeUnknownIdError extends Error {
     private constructor();
 }
 
+/**
+ * @beta
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class InvalidContainerError extends Error {
+    private constructor();
+}
+
 /**
  * The container slot is invalid. This can occur when the
  * owning container is destroyed or unloaded.
@@ -21042,7 +21421,6 @@ export class LocationOutOfWorldBoundariesError extends Error {
 }
 
 /**
- * @rc
  * Thrown when a name requires a namespace and an error occurs
  * when validating that namespace
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "2.0.0-beta.1.21.80-preview.21",
+  "version": "2.0.0-beta.1.21.80-preview.26",
   "description": "",
   "contributors": [
     {