@minecraft/server 2.12.0-beta.1.26.60-preview.25 → 2.12.0-beta.1.26.60-preview.29

package/README.md

@@ -1,9 +1,9 @@
-# `@minecraft/server`
-
-Contains many types related to manipulating a Minecraft world, including entities, blocks, dimensions, and more.
-
-## **NOTE: This version of this module is still in pre-release.  It may change or it may be removed in future releases.**
-
-See full documentation for this module here:
-
+# `@minecraft/server`
+
+Contains many types related to manipulating a Minecraft world, including entities, blocks, dimensions, and more.
+
+## **NOTE: This version of this module is still in pre-release.  It may change or it may be removed in future releases.**
+
+See full documentation for this module here:
+
 https://learn.microsoft.com/en-us/minecraft/creator/scriptapi/minecraft/server/minecraft-server

package/index.d.ts

@@ -48,6 +48,10 @@ export enum AimAssistTargetMode {
  */
 export enum BlockComponentTypes {
     DynamicProperties = 'minecraft:dynamic_properties',
+    /**
+     * @beta
+     */
+    EntityStorage = 'minecraft:entity_storage',
     FluidContainer = 'minecraft:fluid_container',
     Instrument = 'minecraft:instrument_sound',
     /**
@@ -87,6 +91,10 @@ export enum BlockComponentTypes {
      * @beta
      */
     RecipeCrafting = 'minecraft:recipe_crafting',
+    /**
+     * @beta
+     */
+    RecipeProcessing = 'minecraft:recipe_processing',
     /**
      * @remarks
      * Represents a block that can play a record.
@@ -105,6 +113,10 @@ export enum BlockComponentTypes {
      *
      */
     Sign = 'minecraft:sign',
+    /**
+     * @beta
+     */
+    VibrationProperties = 'minecraft:vibration_properties',
 }
 
 /**
@@ -3167,11 +3179,13 @@ export type BlockComponentReturnType<T extends string> = T extends keyof BlockCo
 
 export type BlockComponentTypeMap = {
     dynamic_properties: BlockDynamicPropertiesComponent;
+    entity_storage: BlockEntityStorageComponent;
     fluid_container: BlockFluidContainerComponent;
     instrument_sound: BlockInstrumentComponent;
     inventory: BlockInventoryComponent;
     map_color: BlockMapColorComponent;
     'minecraft:dynamic_properties': BlockDynamicPropertiesComponent;
+    'minecraft:entity_storage': BlockEntityStorageComponent;
     'minecraft:fluid_container': BlockFluidContainerComponent;
     'minecraft:instrument_sound': BlockInstrumentComponent;
     'minecraft:inventory': BlockInventoryComponent;
@@ -3180,16 +3194,20 @@ export type BlockComponentTypeMap = {
     'minecraft:piston': BlockPistonComponent;
     'minecraft:precipitation_interactions': BlockPrecipitationInteractionsComponent;
     'minecraft:recipe_crafting': BlockRecipeCraftingComponent;
+    'minecraft:recipe_processing': BlockRecipeProcessingComponent;
     'minecraft:record_player': BlockRecordPlayerComponent;
     'minecraft:redstone_producer': BlockRedstoneProducerComponent;
     'minecraft:sign': BlockSignComponent;
+    'minecraft:vibration_properties': BlockVibrationPropertiesComponent;
     movable: BlockMovableComponent;
     piston: BlockPistonComponent;
     precipitation_interactions: BlockPrecipitationInteractionsComponent;
     recipe_crafting: BlockRecipeCraftingComponent;
+    recipe_processing: BlockRecipeProcessingComponent;
     record_player: BlockRecordPlayerComponent;
     redstone_producer: BlockRedstoneProducerComponent;
     sign: BlockSignComponent;
+    vibration_properties: BlockVibrationPropertiesComponent;
 };
 
 /**
@@ -4987,6 +5005,28 @@ export class BlockComponentNamedTickEvent extends BlockEvent {
     isName(eventName: string): boolean;
 }
 
+/**
+ * @beta
+ * Contains information regarding neighboring block changes for
+ * a specific block.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class BlockComponentNeighborChangedAfterEvent extends BlockEvent {
+    private constructor();
+    /**
+     * @remarks
+     * Returns the neighboring block changes for this event.
+     *
+     * @returns
+     * One entry for each neighboring direction that changed,
+     * ordered by when each direction first changed. If a direction
+     * changed multiple times during the tick, the entry contains
+     * the permutation before the first change and after the last
+     * change. Intermediate permutations are not included.
+     */
+    getChanges(): NeighborChange[];
+}
+
 /**
  * Contains information regarding a specific block that was
  * placed.
@@ -5404,6 +5444,181 @@ export class BlockDynamicPropertiesComponent extends BlockComponent {
     totalByteCount(): number;
 }
 
+/**
+ * @beta
+ * Represents storage for entities associated with a block
+ * entity. This component is available on blocks whose behavior
+ * pack definition enables entity storage with the
+ * `minecraft:block_entity` component. Stored entities are
+ * serialized and removed from the world until they are
+ * released or transferred. A block can store up to four
+ * entities. Entity storage is scoped to the content pack
+ * accessing it.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class BlockEntityStorageComponent extends BlockComponent {
+    private constructor();
+    static readonly componentId = 'minecraft:entity_storage';
+    /**
+     * @remarks
+     * Returns information about the entities stored in this
+     * block's entity storage. The returned entities are not
+     * present in the world while they are stored. Only entities
+     * stored by the current content pack are included.
+     *
+     * @returns
+     * An array of {@link BlockEntityStorageInfo} values containing
+     * the unique ID and definition ID of each stored entity.
+     * Returns an empty array when no entities are stored by the
+     * current content pack.
+     * @throws
+     * Throws if the block entity is invalid or the block's
+     * location is not loaded or is outside the world boundaries.
+     *
+     * {@link Error}
+     *
+     * {@link InvalidBlockComponentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    getEntities(): BlockEntityStorageInfo[];
+    /**
+     * @remarks
+     * Releases a stored entity from this block's entity storage
+     * and spawns it back into the world, at the same location it
+     * was when stored.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param entityId
+     * The unique ID of the stored entity. Use the value returned
+     * by {@link BlockEntityStorageComponent.store} or the
+     * `uniqueId` property from {@link BlockEntityStorageInfo}.
+     * @returns
+     * The released {@link Entity}. The released entity receives a
+     * new runtime ID.
+     * @throws
+     * Throws if the entity ID is invalid or does not identify an
+     * entity stored by the current content pack, if the stored
+     * entity cannot be loaded or spawned, or if the block entity
+     * is invalid.
+     *
+     * {@link Error}
+     *
+     * {@link InvalidBlockComponentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    release(entityId: string): Entity;
+    /**
+     * @remarks
+     * Returns the number of entities stored in this block's entity
+     * storage by the current content pack.
+     *
+     * @returns
+     * The number of entities stored by the current content pack.
+     * @throws
+     * Throws if the block entity is invalid or the block's
+     * location is not loaded or is outside the world boundaries.
+     *
+     * {@link Error}
+     *
+     * {@link InvalidBlockComponentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    size(): number;
+    /**
+     * @remarks
+     * Serializes and stores an entity in this block's entity
+     * storage. The entity is removed from the world after it is
+     * stored. Only non-player mob entities can be stored. Entities
+     * with passengers or that are passengers cannot be stored.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param entity
+     * The {@link Entity} to store.
+     * @returns
+     * The unique ID assigned to the stored entity. Keep this ID to
+     * release, transfer, or inspect the stored entity later.
+     * @throws
+     * Throws if the storage is full, the entity is already stored,
+     * the entity cannot be serialized, or the block entity is
+     * invalid.
+     *
+     * {@link Error}
+     *
+     * {@link InvalidBlockComponentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    store(entity: Entity): string;
+    /**
+     * @remarks
+     * Moves a stored entity from this block's entity storage to
+     * the target block's entity storage without releasing it into
+     * the world.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param entityId
+     * The unique ID of the stored entity. Use the value returned
+     * by {@link BlockEntityStorageComponent.store} or the
+     * `uniqueId` property from {@link BlockEntityStorageInfo}.
+     * @param targetBlock
+     * The target {@link Block} with an entity storage component.
+     * The target block must be in the same dimension as this
+     * block.
+     * @throws
+     * Throws if the entity ID is invalid or not stored by the
+     * current content pack, if the target block is invalid, in
+     * another dimension, lacks entity storage, or is full, or if
+     * the source and target blocks are the same.
+     *
+     * {@link Error}
+     *
+     * {@link InvalidBlockComponentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    transfer(entityId: string, targetBlock: Block): void;
+}
+
+/**
+ * @beta
+ * Contains identifying information about an entity stored in a
+ * {@link BlockEntityStorageComponent}. Stored entities are not
+ * present in the world until they are released.
+ */
+export class BlockEntityStorageInfo {
+    private constructor();
+    /**
+     * @remarks
+     * The entity's definition ID, such as `minecraft:pig`.
+     *
+     */
+    readonly definitionId: string;
+    /**
+     * @remarks
+     * The unique ID of the stored entity. Use this ID with
+     * {@link BlockEntityStorageComponent.release} or
+     * {@link BlockEntityStorageComponent.transfer}.
+     *
+     */
+    readonly uniqueId: string;
+}
+
 /**
  * Contains information regarding an event that impacts a
  * specific block.
@@ -6109,6 +6324,104 @@ export class BlockRecipeCraftingComponent extends BlockComponent {
     getCraftingContext(player: Player): RecipeCraftingContext | undefined;
 }
 
+/**
+ * @beta
+ * Represents a block component that provides access to recipe
+ * processing inputs and output.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class BlockRecipeProcessingComponent extends BlockComponent {
+    private constructor();
+    /**
+     * @remarks
+     * The number of addressable input slots for getInputItem,
+     * setInputItem, setInputSlotEnabled, and getInputSlotEnabled.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidBlockComponentError}
+     */
+    readonly inputSlotCount: number;
+    static readonly componentId = 'minecraft:recipe_processing';
+    /**
+     * @remarks
+     * Gets the item in the provided input slot.
+     *
+     * @param slot
+     * The zero-based input slot index.
+     * @returns
+     * The item stack in the input slot, or undefined if the slot
+     * is empty.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link InvalidBlockComponentError}
+     */
+    getInputItem(slot: number): ItemStack | undefined;
+    /**
+     * @remarks
+     * Gets whether an input slot is enabled for recipe processing.
+     *
+     * @param slot
+     * The zero-based input slot index.
+     * @returns
+     * Whether the input slot is enabled.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link InvalidBlockComponentError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
+     */
+    getInputSlotEnabled(slot: number): boolean;
+    /**
+     * @remarks
+     * Gets the item produced by the current recipe processing
+     * inputs.
+     *
+     * @returns
+     * The output item stack, or undefined if the current inputs do
+     * not produce an item.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidBlockComponentError}
+     */
+    getOutputItem(): ItemStack | undefined;
+    /**
+     * @remarks
+     * Sets or clears an item in an input slot.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param slot
+     * The zero-based input slot index.
+     * @param item
+     * The item stack to place in the slot, or undefined to clear
+     * the slot.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link InvalidBlockComponentError}
+     */
+    setInputItem(slot: number, item?: ItemStack): void;
+    /**
+     * @remarks
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link InvalidBlockComponentError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
+     */
+    setInputSlotEnabled(slot: number, enabled: boolean): void;
+}
+
 /**
  * Represents a block that can play a record.
  */
@@ -6531,6 +6844,49 @@ export class BlockTypes {
     static getAll(): BlockType[];
 }
 
+/**
+ * @beta
+ * Represents the vibration properties of a block with a
+ * 'minecraft:vibration_properties' component.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class BlockVibrationPropertiesComponent extends BlockComponent {
+    private constructor();
+    static readonly componentId = 'minecraft:vibration_properties';
+    /**
+     * @remarks
+     * Gets whether this block can dampen vibrations. Vibrations
+     * that occur on this block will be discarded by this block if
+     * it can dampen vibrations. Returns false when the block does
+     * not define a 'minecraft:vibration_properties' component.
+     *
+     * @returns
+     * Whether this block can dampen vibrations.
+     * @throws This function can throw errors.
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    getCanDampenVibrations(): boolean;
+    /**
+     * @remarks
+     * Gets whether this block can occlude vibrations. Vibrations
+     * that pass through this block will be discarded if this block
+     * can occlude vibrations. Returns false when the block does
+     * not define a 'minecraft:vibration_properties' component.
+     *
+     * @returns
+     * Whether this block can occlude vibrations.
+     * @throws This function can throw errors.
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    getCanOccludeVibrations(): boolean;
+}
+
 /**
  * A BlockVolume is a simple interface to an object which
  * represents a 3D rectangle of a given size (in blocks) at a
@@ -12252,7 +12608,7 @@ export class EntityIsStunnedComponent extends EntityComponent {
 export class EntityIsTamedComponent extends EntityComponent {
     private constructor();
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns the player that has tamed the entity, or 'undefined'
      * if the entity has no player owner.
@@ -12263,7 +12619,7 @@ export class EntityIsTamedComponent extends EntityComponent {
      */
     readonly tamedToPlayer?: Player;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns the id of the player that has tamed the entity, or
      * 'undefined' if the entity has no player owner.
@@ -19175,6 +19531,118 @@ export class PlayerCursorInventoryComponent extends EntityComponent {
     clear(): void;
 }
 
+/**
+ * @beta
+ * Contains information about an item moved from a container to
+ * a player's cursor.
+ */
+export class PlayerCursorItemGrabAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The item stack moved to the player's cursor.
+     *
+     */
+    readonly item: ItemStack;
+    /**
+     * @remarks
+     * The player whose cursor item changed.
+     *
+     */
+    readonly player: Player;
+}
+
+/**
+ * @beta
+ * Manages callbacks for items grabbed from a container to a
+ * player's cursor.
+ */
+export class PlayerCursorItemGrabAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that is called when a player grabs an item
+     * from a container to their cursor.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     * @param callback
+     * The callback function invoked when the event fires.
+     */
+    subscribe(callback: (arg0: PlayerCursorItemGrabAfterEvent) => void): (arg0: PlayerCursorItemGrabAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a previously registered event callback.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     * @param callback
+     * The callback function to remove.
+     */
+    unsubscribe(callback: (arg0: PlayerCursorItemGrabAfterEvent) => void): void;
+}
+
+/**
+ * @beta
+ * Contains information about an item moved from a player's
+ * cursor to a container.
+ */
+export class PlayerCursorItemReleaseAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The item stack from the player's cursor.
+     *
+     */
+    readonly item: ItemStack;
+    /**
+     * @remarks
+     * The player whose cursor item changed.
+     *
+     */
+    readonly player: Player;
+}
+
+/**
+ * @beta
+ * Manages callbacks for items released from a player's cursor
+ * to a container.
+ */
+export class PlayerCursorItemReleaseAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that is called when a player releases an
+     * item from their cursor to a container.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     * @param callback
+     * The callback function invoked when the event fires.
+     */
+    subscribe(
+        callback: (arg0: PlayerCursorItemReleaseAfterEvent) => void,
+    ): (arg0: PlayerCursorItemReleaseAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a previously registered event callback.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     * @param callback
+     * The callback function to remove.
+     */
+    unsubscribe(callback: (arg0: PlayerCursorItemReleaseAfterEvent) => void): void;
+}
+
 /**
  * Contains information related to changes to a player's
  * dimension having been changed.
@@ -19998,6 +20466,92 @@ export class PlayerInventoryItemChangeAfterEventSignal {
     unsubscribe(callback: (arg0: PlayerInventoryItemChangeAfterEvent) => void): void;
 }
 
+/**
+ * @beta
+ * Contains information about an attack initiated through a
+ * player item interaction before it causes effects. Set cancel
+ * to true to prevent the attack.
+ */
+export class PlayerItemAttackEntityBeforeEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The normalized world-space direction used for the attack.
+     * For standard client-initiated transaction attacks, this
+     * direction is derived from the client-provided hit position
+     * and the player's server-side eye position. Other attack
+     * paths can provide a server-derived direction. This property
+     * is undefined when the attack path does not provide an aim
+     * direction.
+     *
+     */
+    readonly aimDirection?: Vector3;
+    /**
+     * @remarks
+     * If set to true, the attack does not cause damage or other
+     * authoritative attack effects.
+     *
+     */
+    cancel: boolean;
+    /**
+     * @remarks
+     * A snapshot of the item held by the attacking player. This
+     * property is undefined when the player holds no item.
+     *
+     */
+    readonly itemStack?: ItemStack;
+    /**
+     * @remarks
+     * The player that initiated the attack.
+     *
+     */
+    readonly player: Player;
+    /**
+     * @remarks
+     * The entity targeted by the attack.
+     *
+     */
+    readonly target: Entity;
+}
+
+/**
+ * @beta
+ * Manages callbacks that run before a player attacks an entity
+ * through an item interaction.
+ */
+export class PlayerItemAttackEntityBeforeEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that runs before a player attacks an entity
+     * through an item interaction.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     * @param callback
+     * This closure is called with restricted-execution privilege.
+     * @returns
+     * Closure that is called with restricted-execution privilege.
+     */
+    subscribe(
+        callback: (arg0: PlayerItemAttackEntityBeforeEvent) => void,
+    ): (arg0: PlayerItemAttackEntityBeforeEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from this event signal.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     * @param callback
+     * This closure is called with restricted-execution privilege.
+     */
+    unsubscribe(callback: (arg0: PlayerItemAttackEntityBeforeEvent) => void): void;
+}
+
 /**
  * Contains information regarding a player that has joined.
  * See the playerSpawn event for more detailed information that
@@ -20860,7 +21414,7 @@ export class PoiBlockType {
      * @returns
      * True if the POI conatains the tag; otherwise false.
      */
-    has(tag: string): boolean;
+    hasTag(tag: string): boolean;
 }
 
 /**
@@ -22793,10 +23347,11 @@ export class SoundInstance {
     /**
      * @rc
      * @remarks
-     * Fades this sound instance from its current volume to the
-     * target volume over the specified duration. To fade in from
-     * silence, call `setVolume(0.0)` first; to fade out, pass a
-     * target volume of `0.0`.
+     * Fades this sound instance from its current volume multiplier
+     * to the target multiplier over the specified duration. Volume
+     * multipliers are relative to the selected sound variant's
+     * volume. To fade in from silence, call `setVolume(0.0)`
+     * first; to fade out, pass a target volume of `0.0`.
      *
      * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
      *
@@ -22804,7 +23359,8 @@ export class SoundInstance {
      * Duration of the fade in seconds. Must be non-negative.
      * Minimum value: 0
      * @param targetVolume
-     * Volume to fade to. Must be non-negative.
+     * Volume multiplier to fade to, relative to the selected sound
+     * variant's volume. Must be non-negative.
      * Minimum value: 0
      */
     fade(duration: number, targetVolume: number): void;
@@ -22859,12 +23415,14 @@ export class SoundInstance {
     /**
      * @rc
      * @remarks
-     * Sets the volume of this sound instance.
+     * Sets the volume multiplier of this sound instance relative
+     * to the volume of the selected sound variant.
      *
      * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
      *
      * @param volume
-     * Volume level between 0.0 and 10.0.
+     * Volume multiplier between 0.0 and 10.0. A value of 1.0 uses
+     * the selected sound variant's volume.
      * Bounds: [0, 10]
      */
     setVolume(volume: number): void;
@@ -22941,7 +23499,7 @@ export class StartupEvent {
      */
     readonly itemComponentRegistry: ItemComponentRegistry;
     /**
-     * @beta
+     * @rc
      * @remarks
      * @privilege early-execution-readable - This property can be read in early-execution mode.
      *
@@ -23868,7 +24426,7 @@ export class TickingAreaManager {
 }
 
 /**
- * @beta
+ * @rc
  * A named point in time on a world clock that can occur once
  * or periodically.
  */
@@ -24463,7 +25021,7 @@ export class World {
      */
     getAllPlayers(): Player[];
     /**
-     * @beta
+     * @rc
      * @remarks
      * Retrieves a world clock by its name.
      *
@@ -25250,6 +25808,26 @@ export class WorldAfterEvents {
      *
      */
     readonly playerCraftRecipe: PlayerCraftRecipeAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * Event signal that fires when a player grabs an item from a
+     * container to their cursor.
+     *
+     * @privilege early-execution-readable - This property can be read in early-execution mode.
+     *
+     */
+    readonly playerCursorItemGrab: PlayerCursorItemGrabAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * Event signal that fires when a player releases an item from
+     * their cursor into a container.
+     *
+     * @privilege early-execution-readable - This property can be read in early-execution mode.
+     *
+     */
+    readonly playerCursorItemRelease: PlayerCursorItemReleaseAfterEventSignal;
     /**
      * @remarks
      * Fires when a player moved to a different dimension.
@@ -25447,7 +26025,7 @@ export class WorldAfterEvents {
      */
     readonly weatherChange: WeatherChangeAfterEventSignal;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This event fires when a {@link WorldClock} is paused.
      *
@@ -25456,7 +26034,7 @@ export class WorldAfterEvents {
      */
     readonly worldClockOnPaused: WorldClockOnPausedAfterEventSignal;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This event fires when a {@link WorldClock} is resumed.
      *
@@ -25465,7 +26043,7 @@ export class WorldAfterEvents {
      */
     readonly worldClockOnResumed: WorldClockOnResumedAfterEventSignal;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This event fires when the time of a {@link WorldClock} hits
      * a {@link TimeMarker} on the clock. This can happen during a
@@ -25476,7 +26054,7 @@ export class WorldAfterEvents {
      */
     readonly worldClockOnTimeMarker: WorldClockOnTimeMarkerAfterEventSignal;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This event fires when a {@link WorldClock} time is changed.
      * This can happen when the time is directly set through
@@ -25634,6 +26212,13 @@ export class WorldBeforeEvents {
      *
      */
     readonly playerInteractWithEntity: PlayerInteractWithEntityBeforeEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * @privilege early-execution-readable - This property can be read in early-execution mode.
+     *
+     */
+    readonly playerItemAttackEntity: PlayerItemAttackEntityBeforeEventSignal;
     /**
      * @remarks
      * Fires when a player leaves the game.
@@ -25658,7 +26243,7 @@ export class WorldBeforeEvents {
      */
     readonly weatherChange: WeatherChangeBeforeEventSignal;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This event fires when a {@link WorldClock} reaches its
      * maximum time and is about to restart.
@@ -25670,7 +26255,7 @@ export class WorldBeforeEvents {
 }
 
 /**
- * @beta
+ * @rc
  * A class that represents a particular clock within a world.
  */
 export class WorldClock {
@@ -25797,7 +26382,7 @@ export class WorldClock {
 }
 
 /**
- * @beta
+ * @rc
  * Contains information related to a {@link WorldClock} being
  * paused.
  */
@@ -25812,7 +26397,7 @@ export class WorldClockOnPausedAfterEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Manages callbacks that are connected to a {@link WorldClock}
  * being paused.
  */
@@ -25846,7 +26431,7 @@ export class WorldClockOnPausedAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Contains information related to a {@link WorldClock}
  * restarting.
  */
@@ -25877,7 +26462,7 @@ export class WorldClockOnRestartBeforeEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Manages callbacks that are connected to a {@link WorldClock}
  * restarting.
  */
@@ -25917,7 +26502,7 @@ export class WorldClockOnRestartBeforeEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Contains information related to a {@link WorldClock} being
  * resumed.
  */
@@ -25932,7 +26517,7 @@ export class WorldClockOnResumedAfterEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Manages callbacks that are connected to a {@link WorldClock}
  * being resumed.
  */
@@ -25966,7 +26551,7 @@ export class WorldClockOnResumedAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Contains information related to when the time of a
  * {@link WorldClock} hits a {@link TimeMarker}.
  */
@@ -25987,7 +26572,7 @@ export class WorldClockOnTimeMarkerAfterEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Manages callbacks that are connected to when the time of a
  * {@link WorldClock} hits a {@link TimeMarker}.
  */
@@ -26021,7 +26606,7 @@ export class WorldClockOnTimeMarkerAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Contains information related to changes to the time of a
  * {@link WorldClock}.
  */
@@ -26036,7 +26621,7 @@ export class WorldClockOnTimeModifiedAfterEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Manages callbacks that are connected to changes to the time
  * of a {@link WorldClock}.
  */
@@ -26070,7 +26655,7 @@ export class WorldClockOnTimeModifiedAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Provides the functionality for registering custom world
  * clocks. World clocks can only be registered during the
  * system startup event.
@@ -26283,6 +26868,10 @@ export interface BlockCustomComponent {
      * @beta
      */
     onNamedTick?: (arg0: BlockComponentNamedTickEvent, arg1: CustomComponentParameters) => void;
+    /**
+     * @beta
+     */
+    onNeighborChanged?: (arg0: BlockComponentNeighborChangedAfterEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when the block that this custom
@@ -28160,6 +28749,35 @@ export interface MusicOptions {
     volume?: number;
 }
 
+/**
+ * @beta
+ * Contains information regarding a block change in one
+ * neighboring direction.
+ */
+export interface NeighborChange {
+    /**
+     * @remarks
+     * The permutation of the neighboring block after its last
+     * change during the tick.
+     *
+     */
+    blockPermutation: BlockPermutation;
+    /**
+     * @remarks
+     * Direction from the block receiving the event to the
+     * neighboring block that changed.
+     *
+     */
+    direction: Direction;
+    /**
+     * @remarks
+     * The permutation of the neighboring block before its first
+     * change during the tick.
+     *
+     */
+    previousPermutation: BlockPermutation;
+}
+
 /**
  * Not equal to operator.
  */
@@ -29214,7 +29832,7 @@ export interface TickingAreaOptions {
 }
 
 /**
- * @beta
+ * @rc
  * Options for creating time markers for world clocks.
  */
 export interface TimeMarkerOptions {
@@ -29382,7 +30000,7 @@ export interface WaypointTextureSelector {
 }
 
 /**
- * @beta
+ * @rc
  * Contains parameters for world clock events that filters out
  * which events are passed to the provided callback.
  */
@@ -29396,7 +30014,7 @@ export interface WorldClockEventOptions {
 }
 
 /**
- * @beta
+ * @rc
  * Contains additional options for registering world clocks.
  */
 export interface WorldClockRegistrationOptions {
@@ -29410,7 +30028,7 @@ export interface WorldClockRegistrationOptions {
 }
 
 /**
- * @beta
+ * @rc
  * Contains parameters for world clock time marker events that
  * filters out which events are passed to the provided
  * callback.
@@ -29915,7 +30533,7 @@ export class UnloadedChunksError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Error thrown by {@link WorldClock.addTimeMarker} when
  * failing to add a time marker to a world clock.
  */
@@ -29925,7 +30543,7 @@ export class WorldClockAddTimeMarkerError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Thrown when trying to register a world clock outside of the
  * system startup event.
  */
@@ -29935,7 +30553,7 @@ export class WorldClockInvalidRegistryError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Error thrown when a time marker is invalid. This can occur
  * when trying to access data on a time marker that has been
  * removed.
@@ -29946,7 +30564,7 @@ export class WorldClockInvalidTimeMarkerError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Error thrown when a world clock is not found in the world
  * clock registry.
  */
@@ -29956,7 +30574,7 @@ export class WorldClockNotFoundError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Error thrown by {@link WorldClockRegistry.registerClock}
  * when failing to register a world clock.
  */
@@ -29966,7 +30584,7 @@ export class WorldClockRegistrationError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Thrown after using the /reload command when trying to
  * register a world clock that was not previously registered.
  * New world clocks cannot be added during a reload.
@@ -29977,7 +30595,7 @@ export class WorldClockReloadNewWorldClockError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Error thrown after using the /reload command when trying to
  * re-register an existing world clock with an invalid time
  * marker.
@@ -29988,7 +30606,7 @@ export class WorldClockReloadTimeMarkerError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Error thrown by {@link WorldClock.removeTimeMarker} when
  * trying to remove a time marker with the 'minecraft'
  * namespace from a world clock.
@@ -29999,7 +30617,7 @@ export class WorldClockRemoveMinecraftTimeMarkerError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Error thrown by {@link WorldClock.rewindTo} when the world
  * clock's time is already before the time marker's first
  * occurrence.
@@ -30010,7 +30628,7 @@ export class WorldClockRewindError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Error thrown when performing actions on a world clock with a
  * time marker that does not exist.
  */

package/package.json

@@ -1,20 +1,20 @@
-{
-  "name": "@minecraft/server",
-  "version": "2.12.0-beta.1.26.60-preview.25",
-  "description": "",
-  "contributors": [
-    {
-      "name": "Jake Shirley",
-      "email": "jake@xbox.com"
-    },
-    {
-      "name": "Mike Ammerlaan",
-      "email": "mikeam@microsoft.com"
-    }
-  ],
-  "peerDependencies": {
-    "@minecraft/common": "^1.2.0",
-    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.60-preview.25"
-  },
-  "license": "MIT"
+{
+  "name": "@minecraft/server",
+  "version": "2.12.0-beta.1.26.60-preview.29",
+  "description": "",
+  "contributors": [
+    {
+      "name": "Jake Shirley",
+      "email": "jake@xbox.com"
+    },
+    {
+      "name": "Mike Ammerlaan",
+      "email": "mikeam@microsoft.com"
+    }
+  ],
+  "peerDependencies": {
+    "@minecraft/common": "^1.2.0",
+    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.60-preview.29"
+  },
+  "license": "MIT"
 }