@minecraft/server 2.0.0-beta.1.21.80-preview.22 → 2.0.0-beta.1.21.80-preview.27

package/index.d.ts

@@ -141,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
@@ -201,6 +238,20 @@ export enum CustomCommandErrorReason {
      *
      */
     AlreadyRegistered = 'AlreadyRegistered',
+    /**
+     * @remarks
+     * Custom Command references an enum that has not been
+     * registered.
+     *
+     */
+    EnumDependencyMissing = 'EnumDependencyMissing',
+    /**
+     * @remarks
+     * Supplied Custom Command namespace does not match previous
+     * registrations for this add-on.
+     *
+     */
+    NamespaceMismatch = 'NamespaceMismatch',
     /**
      * @remarks
      * Too many command parameters defined in CustomCommand.
@@ -225,54 +276,95 @@ export enum CustomCommandErrorReason {
 
 /**
  * @beta
+ * The types of paramaters accepted by a custom command.
  */
 export enum CustomCommandParamType {
+    /**
+     * @remarks
+     * Command boolean parameter expecting true or false as input.
+     *
+     */
     Boolean = 0,
+    /**
+     * @remarks
+     * Command integer parameter.
+     *
+     */
     Integer = 1,
+    /**
+     * @remarks
+     * Command float parameter.
+     *
+     */
     Float = 2,
+    /**
+     * @remarks
+     * Command string parameter.
+     *
+     */
     String = 3,
+    /**
+     * @remarks
+     * Command entity selector parameter.
+     *
+     */
     EntitySelector = 4,
+    /**
+     * @remarks
+     * Command player selector parameter.
+     *
+     */
     PlayerSelector = 5,
-    Position = 6,
+    /**
+     * @remarks
+     * Command location parameter.
+     *
+     */
+    Location = 6,
+    /**
+     * @remarks
+     * Command block type parameter expecting a Minecraft block.
+     *
+     */
     BlockType = 7,
-    ItemType = 8,
-}
-
-/**
- * @beta
- * The required permission level to execute the custom command.
- */
-export enum CustomCommandPermissionLevel {
     /**
      * @remarks
-     * Anything can run this level.
+     * Command item name parameter.
      *
      */
-    Any = 0,
+    ItemType = 8,
     /**
      * @remarks
-     * Any operator can run this command, including command blocks.
+     * Command enum parameter.
      *
      */
-    GameDirectors = 1,
+    Enum = 9,
+}
+
+/**
+ * @beta
+ * Who executed the command.
+ */
+export enum CustomCommandSource {
     /**
      * @remarks
-     * Any operator can run this command, but NOT command blocks.
+     * Command originated from a command block.
      *
      */
-    Admin = 2,
+    Block = 'Block',
     /**
      * @remarks
-     * Any server host can run this command.
+     * Command originated from an entity or player.
      *
      */
-    Host = 3,
+    Entity = 'Entity',
+    NPCDialogue = 'NPCDialogue',
     /**
      * @remarks
-     * Only dedicated server can run this command.
+     * Command originated from the server.
      *
      */
-    Owner = 4,
+    Server = 'Server',
 }
 
 /**
@@ -289,35 +381,35 @@ export enum CustomComponentNameErrorReason {
 }
 
 /**
- * @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',
 }
 
 /**
@@ -644,13 +736,6 @@ export enum EntityComponentTypes {
      *
      */
     FrictionModifier = 'minecraft:friction_modifier',
-    /**
-     * @remarks
-     * Sets the offset from the ground that the entity is actually
-     * at.
-     *
-     */
-    GroundOffset = 'minecraft:ground_offset',
     /**
      * @remarks
      * Defines the interactions with this entity for healing it.
@@ -1528,6 +1613,10 @@ export enum GameRule {
      *
      */
     KeepInventory = 'keepInventory',
+    /**
+     * @beta
+     */
+    LocatorBar = 'locatorBar',
     /**
      * @remarks
      * The maximum number of chained commands that can execute per
@@ -2525,7 +2614,7 @@ export enum WeatherType {
 
 export type BlockComponentReturnType<T extends string> = T extends keyof BlockComponentTypeMap
     ? BlockComponentTypeMap[T]
-    : BlockComponent;
+    : BlockCustomComponentInstance;
 
 export type BlockComponentTypeMap = {
     destruction_particles: BlockDestructionParticlesComponent;
@@ -2575,7 +2664,6 @@ export type EntityComponentTypeMap = {
     floats_in_liquid: EntityFloatsInLiquidComponent;
     flying_speed: EntityFlyingSpeedComponent;
     friction_modifier: EntityFrictionModifierComponent;
-    ground_offset: EntityGroundOffsetComponent;
     healable: EntityHealableComponent;
     health: EntityHealthComponent;
     inventory: EntityInventoryComponent;
@@ -2610,7 +2698,6 @@ export type EntityComponentTypeMap = {
     'minecraft:floats_in_liquid': EntityFloatsInLiquidComponent;
     'minecraft:flying_speed': EntityFlyingSpeedComponent;
     'minecraft:friction_modifier': EntityFrictionModifierComponent;
-    'minecraft:ground_offset': EntityGroundOffsetComponent;
     'minecraft:healable': EntityHealableComponent;
     'minecraft:health': EntityHealthComponent;
     'minecraft:inventory': EntityInventoryComponent;
@@ -2747,8 +2834,6 @@ export class AimAssistCategory {
      * getBlockPriorities.
      *
      * @throws This property can throw when used.
-     *
-     * {@link Error}
      */
     readonly defaultBlockPriority: number;
     /**
@@ -2757,8 +2842,6 @@ export class AimAssistCategory {
      * in getEntityPriorities.
      *
      * @throws This property can throw when used.
-     *
-     * {@link Error}
      */
     readonly defaultEntityPriority: number;
     /**
@@ -2775,8 +2858,6 @@ export class AimAssistCategory {
      * The record mapping block Ids to their priority settings.
      * Larger numbers have greater priority.
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     getBlockPriorities(): Record<string, number>;
     /**
@@ -2787,8 +2868,6 @@ export class AimAssistCategory {
      * The record mapping entity Ids to their priority settings.
      * Larger numbers have greater priority.
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     getEntityPriorities(): Record<string, number>;
 }
@@ -2890,8 +2969,6 @@ export class AimAssistPreset {
      * provided to setItemSettings.
      *
      * @throws This property can throw when used.
-     *
-     * {@link Error}
      */
     readonly defaultItemSettings?: string;
     /**
@@ -2899,8 +2976,6 @@ export class AimAssistPreset {
      * Optional. Aim-assist category Id used for an empty hand.
      *
      * @throws This property can throw when used.
-     *
-     * {@link Error}
      */
     readonly handSettings?: string;
     /**
@@ -2917,8 +2992,6 @@ export class AimAssistPreset {
      * @returns
      * The array of block/entity Ids.
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     getExcludedTargets(): string[];
     /**
@@ -2928,8 +3001,6 @@ export class AimAssistPreset {
      * @returns
      * The record mapping item Ids to aim-assist category Ids.
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     getItemSettings(): Record<string, string>;
     /**
@@ -2940,8 +3011,6 @@ export class AimAssistPreset {
      * @returns
      * The array of item Ids.
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     getLiquidTargetingItems(): string[];
 }
@@ -3343,6 +3412,7 @@ export class Block {
      *
      * @param steps
      * Number of steps above to step before returning.
+     * Defaults to: 1
      * @throws This function can throw errors.
      *
      * {@link LocationInUnloadedChunkError}
@@ -3357,6 +3427,7 @@ export class Block {
      *
      * @param steps
      * Number of steps below to step before returning.
+     * Defaults to: 1
      * @throws This function can throw errors.
      *
      * {@link LocationInUnloadedChunkError}
@@ -3445,6 +3516,7 @@ export class Block {
      *
      * @param steps
      * Number of steps to the east to step before returning.
+     * Defaults to: 1
      * @throws This function can throw errors.
      *
      * {@link LocationInUnloadedChunkError}
@@ -3461,8 +3533,9 @@ export class Block {
      * @param componentId
      * The identifier of the component (e.g.,
      * 'minecraft:inventory'). If no namespace prefix is specified,
-     * 'minecraft:' is assumed. Available component IDs can be
-     * found as part of the {@link BlockComponentTypes} enum.
+     * 'minecraft:' is assumed. Available component IDs are those
+     * in the {@link BlockComponentTypes} enum and custom component
+     * IDs registered with the {@link BlockComponentRegistry}.
      * @returns
      * Returns the component if it exists on the block, otherwise
      * undefined.
@@ -3481,9 +3554,11 @@ export class Block {
      * @param amount
      * Number of instances of this block to place in the item
      * stack.
+     * Defaults to: 1
      * @param withData
      * Whether additional data facets of the item stack are
      * included.
+     * Defaults to: false
      * @returns
      * An itemStack with the specified amount of items and data.
      * Returns undefined if block type is incompatible.
@@ -3644,6 +3719,7 @@ export class Block {
      *
      * @param steps
      * Number of steps to the north to step before returning.
+     * Defaults to: 1
      * @throws This function can throw errors.
      *
      * {@link LocationInUnloadedChunkError}
@@ -3729,6 +3805,7 @@ export class Block {
      *
      * @param steps
      * Number of steps to the south to step before returning.
+     * Defaults to: 1
      * @throws This function can throw errors.
      *
      * {@link LocationInUnloadedChunkError}
@@ -3764,6 +3841,7 @@ export class Block {
      *
      * @param steps
      * Number of steps to the west to step before returning.
+     * Defaults to: 1
      * @throws This function can throw errors.
      *
      * {@link LocationInUnloadedChunkError}
@@ -3773,6 +3851,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.
  */
@@ -3980,6 +4189,15 @@ export class BlockComponentTickEvent extends BlockEvent {
     private constructor();
 }
 
+/**
+ * @beta
+ * An instance of a custom component on a block.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class BlockCustomComponentInstance extends BlockComponent {
+    private constructor();
+}
+
 /**
  * @beta
  * Represents the particles that appear when the block is
@@ -3993,8 +4211,6 @@ export class BlockDestructionParticlesComponent extends BlockComponent {
      * Name of the texture used for the particles.
      *
      * @throws This property can throw when used.
-     *
-     * {@link Error}
      */
     readonly texture: string;
     /**
@@ -4002,8 +4218,6 @@ export class BlockDestructionParticlesComponent extends BlockComponent {
      * Type of tint applied to the particles.
      *
      * @throws This property can throw when used.
-     *
-     * {@link Error}
      */
     readonly tintMethod: TintMethod;
     static readonly componentId = 'minecraft:destruction_particles';
@@ -4113,8 +4327,6 @@ export class BlockFluidContainerComponent extends BlockComponent {
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     addDye(dye: ItemType): void;
     /**
@@ -4124,8 +4336,6 @@ export class BlockFluidContainerComponent extends BlockComponent {
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     getFluidType(): FluidType;
     /**
@@ -4135,8 +4345,6 @@ export class BlockFluidContainerComponent extends BlockComponent {
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     setFluidType(fluidType: FluidType): void;
     /**
@@ -4147,8 +4355,6 @@ export class BlockFluidContainerComponent extends BlockComponent {
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     setPotion(itemStack: ItemStack): void;
 }
@@ -4258,8 +4464,6 @@ export class BlockMapColorComponent extends BlockComponent {
      * Base map color defined for that block.
      *
      * @throws This property can throw when used.
-     *
-     * {@link Error}
      */
     readonly color: RGBA;
     /**
@@ -4274,8 +4478,6 @@ export class BlockMapColorComponent extends BlockComponent {
      * Type of tint applied to the color.
      *
      * @throws This property can throw when used.
-     *
-     * {@link Error}
      */
     readonly tintMethod: TintMethod;
     static readonly componentId = 'minecraft:map_color';
@@ -4330,8 +4532,6 @@ export class BlockPermutation {
      * @returns
      * Whether this block is removed when touched by liquid.
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     canBeDestroyedByLiquidSpread(liquidType: LiquidType): boolean;
     /**
@@ -4344,8 +4544,6 @@ export class BlockPermutation {
      * @returns
      * Whether this block can have a liquid placed over it.
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     canContainLiquid(liquidType: LiquidType): boolean;
     /**
@@ -4367,6 +4565,7 @@ export class BlockPermutation {
      * @param amount
      * Number of instances of this block to place in the prototype
      * item stack.
+     * Defaults to: 1
      */
     getItemStack(amount?: number): ItemStack | undefined;
     /**
@@ -4421,8 +4620,6 @@ export class BlockPermutation {
      * @returns
      * Whether this block stops liquid from flowing.
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     isLiquidBlocking(liquidType: LiquidType): boolean;
     /**
@@ -4436,8 +4633,6 @@ export class BlockPermutation {
      * Whether this block is removed and spawns its item when
      * touched by liquid.
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     liquidSpreadCausesSpawn(liquidType: LiquidType): boolean;
     /**
@@ -4624,6 +4819,8 @@ export class BlockRecordPlayerComponent extends BlockComponent {
      *
      * This function can't be called in read-only mode.
      *
+     * @param startPlaying
+     * Defaults to: true
      * @throws This function can throw errors.
      */
     setRecord(recordItemType?: ItemType | string, startPlaying?: boolean): void;
@@ -4764,6 +4961,7 @@ export class BlockSignComponent extends BlockComponent {
      * The side of the sign to read the message from. If not
      * provided, this will return the message from the front side
      * of the sign.
+     * Defaults to: 0
      * @throws This function can throw errors.
      */
     getRawText(side?: SignSide): RawText | undefined;
@@ -4776,6 +4974,7 @@ export class BlockSignComponent extends BlockComponent {
      * The side of the sign to read the message from. If not
      * provided, this will return the message from the front side
      * of the sign.
+     * Defaults to: 0
      * @throws This function can throw errors.
      */
     getText(side?: SignSide): string | undefined;
@@ -4787,6 +4986,7 @@ export class BlockSignComponent extends BlockComponent {
      * @param side
      * The side of the sign to read the dye from. If not provided,
      * this will return the dye on the front side of the sign.
+     * Defaults to: 0
      * @throws This function can throw errors.
      */
     getTextDyeColor(side?: SignSide): DyeColor | undefined;
@@ -4806,6 +5006,7 @@ export class BlockSignComponent extends BlockComponent {
      * The side of the sign the message will be set on. If not
      * provided, the message will be set on the front side of the
      * sign.
+     * Defaults to: 0
      * @throws
      * Throws if the provided message is greater than 512
      * characters in length.
@@ -4820,10 +5021,12 @@ export class BlockSignComponent extends BlockComponent {
      * @param color
      * The dye color to apply to the sign or undefined to clear the
      * dye on the sign.
+     * Defaults to: null
      * @param side
      * The side of the sign the color will be set on. If not
      * provided, the color will be set on the front side of the
      * sign.
+     * Defaults to: 0
      * @throws This function can throw errors.
      */
     setTextDyeColor(color?: DyeColor, side?: SignSide): void;
@@ -4977,226 +5180,100 @@ export class BlockVolume extends BlockVolumeBase {
      *
      *
      * @param pos
-     * The world block location to test
-     * @returns
-     * If the location is either inside or more than 0 blocks away,
-     * the function will return false.
-     * If the location is directly contacting the outer surface of
-     * the BlockVolume, the function will return true.
-     */
-    doesLocationTouchFaces(pos: Vector3): boolean;
-    /**
-     * @remarks
-     * Check to see if a two block volumes are directly adjacent
-     * and two faces touch.
-     *
-     * @param other
-     * The volume to test
-     * @returns
-     * If the outer faces of both block volumes touch and are
-     * directly adjacent at any point, return true.
-     */
-    doesVolumeTouchFaces(other: BlockVolume): boolean;
-    /**
-     * @remarks
-     * Return an enumeration which represents the intersection
-     * between two BlockVolume objects
-     *
-     */
-    intersects(other: BlockVolume): BlockVolumeIntersection;
-}
-
-/**
- * Base type for BlockVolumes.
- */
-export class BlockVolumeBase {
-    private constructor();
-    /**
-     * @remarks
-     * Fetch a {@link BlockLocationIterator} that represents all of
-     * the block world locations within the specified volume
-     *
-     */
-    getBlockLocationIterator(): BlockLocationIterator;
-    /**
-     * @beta
-     * @remarks
-     * Return a {@link BoundingBox} object which represents the
-     * validated min and max coordinates of the volume
-     *
-     * @throws This function can throw errors.
-     */
-    getBoundingBox(): BoundingBox;
-    /**
-     * @remarks
-     * Return the capacity (volume) of the BlockVolume (W*D*H)
-     *
-     */
-    getCapacity(): number;
-    /**
-     * @remarks
-     * Get the largest corner position of the volume (guaranteed to
-     * be >= min)
-     *
-     * @throws This function can throw errors.
-     */
-    getMax(): Vector3;
-    /**
-     * @remarks
-     * Get the smallest corner position of the volume (guaranteed
-     * to be <= max)
-     *
-     * @throws This function can throw errors.
-     */
-    getMin(): Vector3;
-    /**
-     * @remarks
-     * Get a {@link Vector3} object where each component represents
-     * the number of blocks along that axis
-     *
-     */
-    getSpan(): Vector3;
-    /**
-     * @remarks
-     * Check to see if a given world block location is inside a
-     * BlockVolume
-     *
-     */
-    isInside(location: Vector3): boolean;
-    /**
-     * @remarks
-     * Move a BlockVolume by a specified amount
-     *
-     * @param delta
-     * Amount of blocks to move by
-     */
-    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
+     * The world block location to test
+     * @returns
+     * If the location is either inside or more than 0 blocks away,
+     * the function will return false.
+     * If the location is directly contacting the outer surface of
+     * the BlockVolume, the function will return true.
      */
-    static createValid(min: Vector3, max: Vector3): BoundingBox;
+    doesLocationTouchFaces(pos: Vector3): boolean;
     /**
      * @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.
+     * Check to see if a two block volumes are directly adjacent
+     * and two faces touch.
      *
+     * @param other
+     * The volume to test
      * @returns
-     * Return a new {@link BoundingBox} object representing the
-     * changes
+     * If the outer faces of both block volumes touch and are
+     * directly adjacent at any point, return true.
      */
-    static dilate(box: BoundingBox, size: Vector3): BoundingBox;
+    doesVolumeTouchFaces(other: BlockVolume): boolean;
     /**
      * @remarks
-     * Check if two {@link BoundingBox} objects are identical
-     *
-     * This function can't be called in read-only mode.
+     * Return an enumeration which represents the intersection
+     * between two BlockVolume objects
      *
      */
-    static equals(box: BoundingBox, other: BoundingBox): boolean;
+    intersects(other: BlockVolume): BlockVolumeIntersection;
+}
+
+/**
+ * Base type for BlockVolumes.
+ */
+export class BlockVolumeBase {
+    private constructor();
     /**
      * @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.
+     * Fetch a {@link BlockLocationIterator} that represents all of
+     * the block world locations within the specified volume
      *
-     * @returns
-     * A new {@link BoundingBox} instance representing the smallest
-     * possible bounding box which can encompass both
      */
-    static expand(box: BoundingBox, other: BoundingBox): BoundingBox;
+    getBlockLocationIterator(): BlockLocationIterator;
     /**
+     * @beta
      * @remarks
-     * Calculate the center block of a given {@link BoundingBox}
-     * object.
-     *
-     * This function can't be called in read-only mode.
+     * Return a {@link BlockBoundingBox} object which represents
+     * the validated min and max coordinates of the volume
      *
-     * @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)
+     * @throws This function can throw errors.
      */
-    static getCenter(box: BoundingBox): Vector3;
+    getBoundingBox(): BlockBoundingBox;
     /**
      * @remarks
-     * Calculate the BoundingBox which represents the union area of
-     * two intersecting BoundingBoxes
-     *
-     * This function can't be called in read-only mode.
+     * Return the capacity (volume) of the BlockVolume (W*D*H)
      *
      */
-    static getIntersection(box: BoundingBox, other: BoundingBox): BoundingBox | undefined;
+    getCapacity(): number;
     /**
      * @remarks
-     * Get the Span of each of the BoundingBox Axis components
-     *
-     * This function can't be called in read-only mode.
+     * Get the largest corner position of the volume (guaranteed to
+     * be >= min)
      *
+     * @throws This function can throw errors.
      */
-    static getSpan(box: BoundingBox): Vector3;
+    getMax(): Vector3;
     /**
      * @remarks
-     * Check to see if two BoundingBox objects intersect
-     *
-     * This function can't be called in read-only mode.
+     * Get the smallest corner position of the volume (guaranteed
+     * to be <= max)
      *
+     * @throws This function can throw errors.
      */
-    static intersects(box: BoundingBox, other: BoundingBox): boolean;
+    getMin(): Vector3;
     /**
      * @remarks
-     * Check to see if a given coordinate is inside a BoundingBox
-     *
-     * This function can't be called in read-only mode.
+     * Get a {@link Vector3} object where each component represents
+     * the number of blocks along that axis
      *
      */
-    static isInside(box: BoundingBox, pos: Vector3): boolean;
+    getSpan(): Vector3;
     /**
      * @remarks
-     * Check to see if a BoundingBox is valid (i.e. (min <= max))
-     *
-     * This function can't be called in read-only mode.
+     * Check to see if a given world block location is inside a
+     * BlockVolume
      *
      */
-    static isValid(box: BoundingBox): boolean;
+    isInside(location: Vector3): boolean;
     /**
      * @remarks
-     * Move a BoundingBox by a given amount
-     *
-     * This function can't be called in read-only mode.
+     * Move a BlockVolume by a specified amount
      *
-     * @returns
-     * Return a new BoundingBox object which represents the change
+     * @param delta
+     * Amount of blocks to move by
      */
-    static translate(box: BoundingBox, delta: Vector3): BoundingBox;
+    translate(delta: Vector3): void;
 }
 
 /**
@@ -5672,7 +5749,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
@@ -6110,6 +6187,12 @@ 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}
@@ -6571,6 +6654,41 @@ 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.
@@ -6596,7 +6714,42 @@ export class CustomCommandRegistry {
      *
      * {@link NamespaceNameError}
      */
-    registerCommand(customCommand: CustomCommand, callback: (...args: any[]) => CustomCommandResult | undefined): void;
+    registerCommand(
+        customCommand: CustomCommand,
+        callback: (origin: CustomCommandOrigin, ...args: any[]) => CustomCommandResult | undefined,
+    ): void;
+    /**
+     * @remarks
+     * Registers a custom command enum.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link CustomCommandError}
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link NamespaceNameError}
+     */
+    registerEnum(name: string, values: string[]): 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;
 }
 
 /**
@@ -6695,6 +6848,7 @@ export class Dimension {
      * or all of the block volume is outside of the loaded chunks.
      * Will only check the block locations that are within the
      * loaded chunks in the volume.
+     * Defaults to: false
      * @returns
      * Returns true if at least one block in the volume satisfies
      * the filter, false otherwise.
@@ -6889,6 +7043,7 @@ export class Dimension {
      * or all of the block volume is outside of the loaded chunks.
      * Will only check the block locations that are within the
      * loaded chunks in the volume.
+     * Defaults to: false
      * @returns
      * Returns the ListBlockVolume that contains all the block
      * locations that satisfied the block filter.
@@ -7040,7 +7195,7 @@ export class Dimension {
      */
     getWeather(): WeatherType;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Places the given feature into the dimension at the specified
      * location.
@@ -7057,6 +7212,7 @@ export class Dimension {
      * Note: The function call will always throw an error if using
      * an unknown feature name or trying to place in a unloaded
      * chunk.
+     * Defaults to: false
      * @throws
      * An error will be thrown if the feature name is invalid.
      * An error will be thrown if the location is in an unloaded
@@ -7070,7 +7226,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.
@@ -7208,20 +7364,24 @@ export class Dimension {
      * Newly created entity at the specified location.
      * @throws This function can throw errors.
      *
+     * {@link Error}
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
      * {@link LocationInUnloadedChunkError}
      *
      * {@link LocationOutOfWorldBoundariesError}
      * @example spawnAdultHorse.ts
      * ```typescript
-     * import { DimensionLocation } from "@minecraft/server";
-     * import { Vector3Utils } from "@minecraft/math";
+     * import { DimensionLocation } from '@minecraft/server';
+     * import { Vector3Utils } from '@minecraft/math';
      *
      * function spawnAdultHorse(log: (message: string, status?: number) => void, targetLocation: DimensionLocation) {
-     *   log("Create a horse and triggering the ageable_grow_up event, ensuring the horse is created as an adult");
-     *   targetLocation.dimension.spawnEntity(
-     *     "minecraft:horse<minecraft:ageable_grow_up>",
-     *     Vector3Utils.add(targetLocation, { x: 0, y: 1, z: 0 })
-     *   );
+     *     log('Create a horse and triggering the ageable_grow_up event, ensuring the horse is created as an adult');
+     *     targetLocation.dimension.spawnEntity(
+     *         'minecraft:horse<minecraft:ageable_grow_up>',
+     *         Vector3Utils.add(targetLocation, { x: 0, y: 1, z: 0 })
+     *     );
      * }
      * ```
      * @example quickFoxLazyDog.ts
@@ -8059,6 +8219,7 @@ export class Entity {
      * @param useEffects
      * Whether to show any visual effects connected to the
      * extinguishing.
+     * Defaults to: true
      * @returns
      * Returns whether the entity was on fire.
      * @throws This function can throw errors.
@@ -8467,7 +8628,7 @@ export class Entity {
      *
      * {@link CommandError}
      *
-     * {@link Error}
+     * {@link InvalidEntityError}
      */
     runCommand(commandString: string): CommandResult;
     /**
@@ -8506,6 +8667,7 @@ export class Entity {
      * Whether side-effects should be applied (e.g. thawing freeze)
      * and other conditions such as rain or fire protection should
      * be taken into consideration.
+     * Defaults to: true
      * @returns
      * Whether the entity was set on fire. This can fail if seconds
      * is less than or equal to zero, the entity is wet or the
@@ -9236,33 +9398,12 @@ 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';
 }
 
-/**
- * Sets the offset from the ground that the entity is actually
- * at.
- */
-// @ts-ignore Class inheritance allowed for native defined classes
-export class EntityGroundOffsetComponent extends EntityComponent {
-    private constructor();
-    /**
-     * @remarks
-     * Value of this particular ground offset. Note that this value
-     * is effectively read only; setting the ground offset value
-     * will not have an impact on the related entity.
-     *
-     * This property can't be edited in read-only mode.
-     *
-     */
-    value: number;
-    static readonly componentId = 'minecraft:ground_offset';
-}
-
 /**
  * Defines the interactions with this entity for healing it.
  */
@@ -11652,6 +11793,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.
@@ -12117,8 +12265,6 @@ export class ItemCompostableComponent extends ItemComponent {
      *
      * @throws
      * Throws if value outside the range [1 - 100]
-     *
-     * {@link Error}
      */
     readonly compostingChance: number;
     static readonly componentId = 'minecraft:compostable';
@@ -12251,6 +12397,7 @@ export class ItemDurabilityComponent extends ItemComponent {
      * Unbreaking factor to consider in factoring the damage
      * chance. Incoming unbreaking parameter must be within the
      * range [0, 3].
+     * Defaults to: 0
      * @throws This function can throw errors.
      */
     getDamageChance(unbreakingEnchantmentLevel?: number): number;
@@ -12287,8 +12434,6 @@ export class ItemDyeableComponent extends ItemComponent {
      * Returns the default color of the item.
      *
      * @throws This property can throw when used.
-     *
-     * {@link Error}
      */
     readonly defaultColor?: RGB;
     static readonly componentId = 'minecraft:dyeable';
@@ -12763,6 +12908,7 @@ export class ItemStack {
      * provided value will be clamped to the item's maximum stack
      * size. Note that certain items can only have one item in the
      * stack.
+     * Defaults to: 1
      * @throws
      * Throws if `itemType` is invalid, or if `amount` is outside
      * the range of 1-255.
@@ -13886,8 +14032,6 @@ export class Player extends Entity {
      * Contains the player's device information.
      *
      * @throws This property can throw when used.
-     *
-     * {@link Error}
      */
     readonly clientSystemInfo: ClientSystemInfo;
     /**
@@ -14018,6 +14162,7 @@ export class Player extends Entity {
      */
     addLevels(amount: number): number;
     /**
+     * @rc
      * @remarks
      * For this player, removes all overrides of any Entity
      * Properties on the target Entity. This change is not applied
@@ -14176,6 +14321,7 @@ export class Player extends Entity {
      */
     queueMusic(trackId: string, musicOptions?: MusicOptions): void;
     /**
+     * @rc
      * @remarks
      * For this player, removes the override on an Entity Property.
      * This change is not applied until the next tick and will not
@@ -14316,6 +14462,7 @@ export class Player extends Entity {
      */
     setOp(isOp: boolean): void;
     /**
+     * @rc
      * @remarks
      * For this player, overrides an Entity Property on the target
      * Entity to the provided value. This property must be client
@@ -15026,8 +15173,6 @@ export class PlayerInputPermissions {
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
-     *
-     * {@link Error}
      */
     isPermissionCategoryEnabled(permissionCategory: InputPermissionCategory): boolean;
     /**
@@ -16919,6 +17064,7 @@ export class Structure {
      * @param saveMode
      * Determines how the Structure should be saved. Defaults to
      * saving to the world.
+     * Defaults to: 1
      * @returns
      * Returns the newly created structure.
      * @throws
@@ -16955,9 +17101,11 @@ export class Structure {
      * The block location relative to the Structure's origin.
      * @param blockPermutation
      * The BlockPermutation to set.
+     * Defaults to: null
      * @param waterlogged
      * Specifies whether the block should be waterlogged. Air and
      * undefined blocks cannot be waterlogged.
+     * Defaults to: false
      * @throws
      * Throws if the type of block is StructureVoid.
      * Throws if the block is undefined and waterlogged is set to
@@ -16996,6 +17144,7 @@ export class StructureManager {
      * @param saveMode
      * How the Structure should be saved upon creation. Defaults to
      * StructureSaveMode.Memory.
+     * Defaults to: 0
      * @returns
      * Returns the newly created Structure.
      * @throws
@@ -17113,7 +17262,7 @@ export class StructureManager {
         options?: StructurePlaceOptions,
     ): void;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Places a partial jigsaw structure in the world. This is
      * useful for debugging connections between jigsaw blocks.
@@ -17137,8 +17286,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
@@ -17155,9 +17304,9 @@ export class StructureManager {
         dimension: Dimension,
         location: Vector3,
         options?: JigsawPlaceOptions,
-    ): BoundingBox;
+    ): BlockBoundingBox;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Places a jigsaw structure in the world.
      *
@@ -17177,8 +17326,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.
@@ -17192,7 +17341,7 @@ export class StructureManager {
         dimension: Dimension,
         location: Vector3,
         options?: JigsawStructurePlaceOptions,
-    ): BoundingBox;
+    ): BlockBoundingBox;
 }
 
 /**
@@ -18005,7 +18154,7 @@ export class World {
      */
     getDefaultSpawnLocation(): Vector3;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Gets the difficulty from the world.
      *
@@ -18257,7 +18406,7 @@ export class World {
      */
     setDefaultSpawnLocation(spawnLocation: Vector3): void;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Sets the worlds difficulty.
      *
@@ -18960,6 +19109,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.
@@ -18971,28 +19154,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
@@ -19000,33 +19183,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;
 }
 
 /**
@@ -19201,40 +19384,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
@@ -19434,7 +19583,7 @@ export interface CustomCommand {
      * The permission level required to execute the command.
      *
      */
-    permissionLevel: CustomCommandPermissionLevel;
+    permissionLevel: CommandPermissionLevel;
 }
 
 /**
@@ -20283,53 +20432,56 @@ 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;
 }
 
 /**
- * @beta
+ * @rc
  * Provides additional options for {@link
  * StructureManager.placeJigsaw}.
  */
@@ -20351,7 +20503,7 @@ export interface JigsawPlaceOptions {
 }
 
 /**
- * @beta
+ * @rc
  * Provides additional options for {@link
  * StructureManager.placeJigsawStructure}.
  */
@@ -20840,10 +20992,31 @@ export interface ScriptEventMessageFilterOptions {
 
 /**
  * @beta
+ * Contains additional options for spawning an Entity.
  */
 export interface SpawnEntityOptions {
+    /**
+     * @remarks
+     * Optional boolean which determines if this entity should
+     * persist in the game world. Persistence prevents the entity
+     * from automatically despawning.
+     *
+     */
     initialPersistence?: boolean;
+    /**
+     * @remarks
+     * Optional initial rotation, in degrees, to set on the entity
+     * when it spawns.
+     *
+     */
     initialRotation?: number;
+    /**
+     * @remarks
+     * Optional spawn event to send to the entity after it is
+     * spawned.
+     *
+     */
+    spawnEvent?: string;
 }
 
 /**
@@ -21330,7 +21503,7 @@ export class NamespaceNameError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class PlaceJigsawError extends Error {