@minecraft/server 2.0.0-beta.1.21.70-preview.23 → 2.0.0-beta.1.21.70-preview.25

package/index.d.ts

@@ -1856,7 +1856,7 @@ export enum ItemLockMode {
 }
 
 /**
- * @beta
+ * @rc
  * Represents the type of liquid that can be placed on a block
  * or flow dynamically in the world.
  */
@@ -2379,6 +2379,7 @@ export enum TimeOfDay {
 export enum TintMethod {
     BirchFoliage = 'BirchFoliage',
     DefaultFoliage = 'DefaultFoliage',
+    DryFoliage = 'DryFoliage',
     EvergreenFoliage = 'EvergreenFoliage',
     Grass = 'Grass',
     None = 'None',
@@ -2434,12 +2435,21 @@ export enum WeatherType {
 }
 
 /**
- * @beta
+ * @rc
+ */
+export type BlockComponentReturnType<T extends string> = T extends keyof BlockComponentTypeMap
+    ? BlockComponentTypeMap[T]
+    : BlockComponent;
+
+/**
+ * @rc
  */
 export type BlockComponentTypeMap = {
+    destruction_particles: BlockDestructionParticlesComponent;
     fluid_container: BlockFluidContainerComponent;
     inventory: BlockInventoryComponent;
     map_color: BlockMapColorComponent;
+    'minecraft:destruction_particles': BlockDestructionParticlesComponent;
     'minecraft:fluid_container': BlockFluidContainerComponent;
     'minecraft:inventory': BlockInventoryComponent;
     'minecraft:map_color': BlockMapColorComponent;
@@ -2452,7 +2462,7 @@ export type BlockComponentTypeMap = {
 };
 
 /**
- * @beta
+ * @rc
  * Type alias used by the {@link BlockPermutation} matches and
  * resolve functions to narrow block state argument types to
  * those mapped by {@link
@@ -2465,7 +2475,14 @@ export type BlockStateArg<T> = T extends `${minecraftvanilladata.MinecraftBlockT
     : Record<string, boolean | number | string>;
 
 /**
- * @beta
+ * @rc
+ */
+export type EntityComponentReturnType<T extends string> = T extends keyof EntityComponentTypeMap
+    ? EntityComponentTypeMap[T]
+    : EntityComponent;
+
+/**
+ * @rc
  */
 export type EntityComponentTypeMap = {
     addrider: EntityAddRiderComponent;
@@ -2603,7 +2620,14 @@ export type EntityComponentTypeMap = {
 };
 
 /**
- * @beta
+ * @rc
+ */
+export type ItemComponentReturnType<T extends string> = T extends keyof ItemComponentTypeMap
+    ? ItemComponentTypeMap[T]
+    : ItemComponent;
+
+/**
+ * @rc
  */
 export type ItemComponentTypeMap = {
     compostable: ItemCompostableComponent;
@@ -2741,6 +2765,8 @@ export class AimAssistCategorySettings {
      * @remarks
      * Sets the priority settings used for block targeting.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param blockPriorities
      * A record mapping block Ids to their priority settings.
      * Larger numbers have greater priority.
@@ -2752,6 +2778,8 @@ export class AimAssistCategorySettings {
      * @remarks
      * Sets the priority settings used for entity targeting.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param entityPriorities
      * A record mapping entity Ids to their priority settings.
      * Larger numbers have greater priority.
@@ -2898,6 +2926,8 @@ export class AimAssistPresetSettings {
      * Sets the list of block/entity Ids to exclude from aim assist
      * targeting.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param targets
      * An array of block/entity Ids.
      */
@@ -2912,6 +2942,8 @@ export class AimAssistPresetSettings {
      * @remarks
      * Sets the per-item aim-assist category Ids.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param itemSettings
      * A record mapping item Ids to aim-assist category Ids.
      * Category Ids must have a namespace.
@@ -2922,6 +2954,8 @@ export class AimAssistPresetSettings {
      * Sets the list of item Ids that will target liquid blocks
      * with aim-assist when being held.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param items
      * An array of item Ids.
      */
@@ -3237,7 +3271,7 @@ export class Block {
      */
     bottomCenter(): Vector3;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block is removed when touched by
      * liquid.
@@ -3256,7 +3290,7 @@ export class Block {
      */
     canBeDestroyedByLiquidSpread(liquidType: LiquidType): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block can have a liquid placed over it,
      * i.e. be waterlogged.
@@ -3339,7 +3373,7 @@ export class Block {
      *
      * {@link LocationOutOfWorldBoundariesError}
      */
-    getComponent<T extends keyof BlockComponentTypeMap>(componentId: T): BlockComponentTypeMap[T] | undefined;
+    getComponent<T extends string>(componentId: T): BlockComponentReturnType<T> | undefined;
     /**
      * @remarks
      * Creates a prototype item stack based on this block that can
@@ -3431,7 +3465,7 @@ export class Block {
      */
     hasTag(tag: string): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block stops liquid from flowing.
      *
@@ -3449,7 +3483,18 @@ export class Block {
      */
     isLiquidBlocking(liquidType: LiquidType): boolean;
     /**
-     * @beta
+     * @rc
+     * @remarks
+     * Returns whether liquid can flow into the block from the
+     * provided direction, or flow out from the provided direction
+     * when liquid is placed into it with a bucket.
+     *
+     * @param liquidType
+     * The type of liquid this function should be called for.
+     * @returns
+     * Whether liquid can flow into the block from the provided
+     * direction, or flow out from the provided direction when
+     * liquid is placed into it with a bucket
      * @throws This function can throw errors.
      *
      * {@link Error}
@@ -3460,7 +3505,7 @@ export class Block {
      */
     liquidCanFlowFromDirection(liquidType: LiquidType, flowDirection: Direction): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block is removed and spawns its item
      * when touched by liquid.
@@ -3839,6 +3884,35 @@ export class BlockComponentTickEvent extends BlockEvent {
     private constructor();
 }
 
+/**
+ * @beta
+ * Represents the particles that appear when the block is
+ * destroyed.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class BlockDestructionParticlesComponent extends BlockComponent {
+    private constructor();
+    /**
+     * @remarks
+     * Name of the texture used for the particles.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link Error}
+     */
+    readonly texture: string;
+    /**
+     * @remarks
+     * 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';
+}
+
 /**
  * Contains information regarding an event that impacts a
  * specific block.
@@ -4083,38 +4157,32 @@ export class BlockLocationIterator implements Iterable<Vector3> {
 // @ts-ignore Class inheritance allowed for native defined classes
 export class BlockMapColorComponent extends BlockComponent {
     private constructor();
-    static readonly componentId = 'minecraft:map_color';
     /**
      * @remarks
      * Base map color defined for that block.
      *
-     * This function can't be called in read-only mode.
-     *
-     * @throws This function can throw errors.
+     * @throws This property can throw when used.
      *
      * {@link Error}
      */
-    color(): RGBA;
+    readonly color: RGBA;
     /**
      * @remarks
      * Returns the base color multiplied to the evaluated tint at
      * the given position.
      *
-     * This function can't be called in read-only mode.
-     *
      */
-    tintedColor(): RGBA;
+    readonly tintedColor: RGBA;
     /**
      * @remarks
      * Type of tint applied to the color.
      *
-     * This function can't be called in read-only mode.
-     *
-     * @throws This function can throw errors.
+     * @throws This property can throw when used.
      *
      * {@link Error}
      */
-    tintMethod(): TintMethod;
+    readonly tintMethod: TintMethod;
+    static readonly componentId = 'minecraft:map_color';
 }
 
 /**
@@ -4157,7 +4225,7 @@ export class BlockPermutation {
      */
     readonly 'type': BlockType;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block is removed when touched by
      * liquid.
@@ -4172,7 +4240,7 @@ export class BlockPermutation {
      */
     canBeDestroyedByLiquidSpread(liquidType: LiquidType): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block can have a liquid placed over it,
      * i.e. be waterlogged.
@@ -4251,7 +4319,7 @@ export class BlockPermutation {
      */
     hasTag(tag: string): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block stops liquid from flowing.
      *
@@ -4265,7 +4333,7 @@ export class BlockPermutation {
      */
     isLiquidBlocking(liquidType: LiquidType): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block is removed and spawns its item
      * when touched by liquid.
@@ -7858,7 +7926,7 @@ export class Entity {
      *
      * {@link InvalidEntityError}
      */
-    getComponent<T extends keyof EntityComponentTypeMap>(componentId: T): EntityComponentTypeMap[T] | undefined;
+    getComponent<T extends string>(componentId: T): EntityComponentReturnType<T> | undefined;
     /**
      * @remarks
      * Returns all components that are both present on this entity
@@ -10636,10 +10704,9 @@ export class EntityScaleComponent extends EntityComponent {
      * @remarks
      * Current value for the scale property set on entities.
      *
-     * 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:scale';
 }
 
@@ -12571,7 +12638,7 @@ export class ItemStack {
      * }
      * ```
      */
-    getComponent<T extends keyof ItemComponentTypeMap>(componentId: T): ItemComponentTypeMap[T] | undefined;
+    getComponent<T extends string>(componentId: T): ItemComponentReturnType<T> | undefined;
     /**
      * @remarks
      * Returns all components that are both present on this item
@@ -13192,129 +13259,6 @@ export class ItemUseBeforeEventSignal {
     unsubscribe(callback: (arg0: ItemUseBeforeEvent) => void): void;
 }
 
-/**
- * Contains information related to an item being used on a
- * block. This event fires when an item used by a player
- * successfully triggers a block interaction.
- */
-export class ItemUseOnAfterEvent {
-    private constructor();
-    /**
-     * @remarks
-     * The block that the item is used on.
-     *
-     */
-    readonly block: Block;
-    /**
-     * @remarks
-     * The face of the block that an item is being used on.
-     *
-     */
-    readonly blockFace: Direction;
-    /**
-     * @remarks
-     * Location relative to the bottom north-west corner of the
-     * block where the item is placed.
-     *
-     */
-    readonly faceLocation: Vector3;
-    /**
-     * @remarks
-     * This value will be true if the event was triggered on
-     * players initial interaction button press and false on events
-     * triggered from holding the interaction button.
-     *
-     */
-    readonly isFirstEvent: boolean;
-    /**
-     * @remarks
-     * The impacted item stack that is being used on a block.
-     *
-     */
-    readonly itemStack: ItemStack;
-    /**
-     * @remarks
-     * Returns the source entity that triggered this item event.
-     *
-     */
-    readonly source: Player;
-}
-
-/**
- * Manages callbacks that are connected to an item being used
- * on a block event.
- */
-export class ItemUseOnAfterEventSignal {
-    private constructor();
-    /**
-     * @remarks
-     * Adds a callback that will be called when an item is used on
-     * a block.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * This function can be called in early-execution mode.
-     *
-     */
-    subscribe(callback: (arg0: ItemUseOnAfterEvent) => void): (arg0: ItemUseOnAfterEvent) => void;
-    /**
-     * @remarks
-     * Removes a callback from being called when an item is used on
-     * a block.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * This function can be called in early-execution mode.
-     *
-     */
-    unsubscribe(callback: (arg0: ItemUseOnAfterEvent) => void): void;
-}
-
-/**
- * Contains information related to an item being used on a
- * block.
- */
-// @ts-ignore Class inheritance allowed for native defined classes
-export class ItemUseOnBeforeEvent extends ItemUseOnAfterEvent {
-    private constructor();
-    /**
-     * @remarks
-     * If set to true, this will cancel the item use behavior.
-     *
-     */
-    cancel: boolean;
-}
-
-/**
- * Manages callbacks that fire before an item being used on a
- * block event.
- */
-export class ItemUseOnBeforeEventSignal {
-    private constructor();
-    /**
-     * @remarks
-     * Adds a callback that will be called before an item is used
-     * on a block.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * This function can be called in early-execution mode.
-     *
-     */
-    subscribe(callback: (arg0: ItemUseOnBeforeEvent) => void): (arg0: ItemUseOnBeforeEvent) => void;
-    /**
-     * @remarks
-     * Removes a callback from being called before an item is used
-     * on a block.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * This function can be called in early-execution mode.
-     *
-     */
-    unsubscribe(callback: (arg0: ItemUseOnBeforeEvent) => void): void;
-}
-
 /**
  * Contains information regarding the use of an item on a
  * block.
@@ -13870,6 +13814,22 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     addLevels(amount: number): number;
+    /**
+     * @beta
+     * @remarks
+     * For this player, removes all overrides of any Entity
+     * Properties on the target Entity. This change is not applied
+     * until the next tick and will not apply to other players.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param targetEntity
+     * The Entity whose Entity Property overrides are being
+     * cleared.
+     * @throws
+     * Throws if the entity is invalid.
+     */
+    clearPropertyOverridesForEntity(targetEntity: Entity): void;
     /**
      * @beta
      * @remarks
@@ -14013,6 +13973,26 @@ export class Player extends Entity {
      *
      */
     queueMusic(trackId: string, musicOptions?: MusicOptions): void;
+    /**
+     * @beta
+     * @remarks
+     * For this player, removes the override on an Entity Property.
+     * This change is not applied until the next tick and will not
+     * apply to other players.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param targetEntity
+     * The Entity whose Entity Property override is being removed.
+     * @param identifier
+     * The Entity Property identifier.
+     * @throws
+     * Throws if the entity is invalid.
+     * Throws if an invalid identifier is provided.
+     * Throws if the provided value type does not match the
+     * property type.
+     */
+    removePropertyOverrideForEntity(targetEntity: Entity, identifier: string): void;
     /**
      * @remarks
      * Resets the level of the player.
@@ -14130,6 +14110,34 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     setOp(isOp: boolean): void;
+    /**
+     * @beta
+     * @remarks
+     * For this player, overrides an Entity Property on the target
+     * Entity to the provided value. This property must be client
+     * synced. This change is not applied until the next tick and
+     * will not apply to other players.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param targetEntity
+     * The Entity whose Entity Property is being overriden.
+     * @param identifier
+     * The Entity Property identifier.
+     * @param value
+     * The override value. The provided type must be compatible
+     * with the type specified in the entity's definition.
+     * @throws
+     * Throws if the entity is invalid.
+     * Throws if an invalid identifier is provided.
+     * Throws if the provided value type does not match the
+     * property type.
+     * Throws if the provided value is outside the expected range
+     * (int, float properties).
+     * Throws if the provided string value does not match the set
+     * of accepted enum values (enum properties)
+     */
+    setPropertyOverrideForEntity(targetEntity: Entity, identifier: string, value: boolean | number | string): void;
     /**
      * @remarks
      * Sets the current starting spawn point for this particular
@@ -14145,7 +14153,7 @@ export class Player extends Entity {
      */
     setSpawnPoint(spawnPoint?: DimensionLocation): void;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Creates a new particle emitter at a specified location in
      * the world. Only visible to the target player.
@@ -16581,7 +16589,17 @@ export class StartupBeforeEventSignal {
  */
 export class StartupEvent {
     private constructor();
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly blockComponentRegistry: BlockComponentRegistry;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly itemComponentRegistry: ItemComponentRegistry;
 }
 
@@ -16955,6 +16973,8 @@ export class System {
      * Returns a collection of after-events for system-level
      * operations.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly afterEvents: SystemAfterEvents;
     /**
@@ -16963,12 +16983,16 @@ export class System {
      * Returns a collection of before-events for system-level
      * operations.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly beforeEvents: SystemBeforeEvents;
     /**
      * @remarks
      * Represents the current world tick of the server.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly currentTick: number;
     /**
@@ -16977,12 +17001,16 @@ export class System {
      * Returns true if this is a world where the editor is
      * currently loaded, returns false otherwise.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly isEditorWorld: boolean;
     /**
      * @remarks
      * Contains the device information for the server.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly serverSystemInfo: SystemInfo;
     /**
@@ -17182,6 +17210,8 @@ export class SystemAfterEvents {
      * provides a way for commands and other systems to trigger
      * behavior within script.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly scriptEventReceive: ScriptEventCommandMessageAfterEventSignal;
 }
@@ -17196,7 +17226,17 @@ export class SystemAfterEvents {
  */
 export class SystemBeforeEvents {
     private constructor();
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly shutdown: ShutdownBeforeEventSignal;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly startup: StartupBeforeEventSignal;
     /**
      * @remarks
@@ -17206,6 +17246,8 @@ export class SystemBeforeEvents {
      * To prevent shutdown, set the event's cancel property to
      * true.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly watchdogTerminate: WatchdogTerminateBeforeEventSignal;
 }
@@ -17609,6 +17651,8 @@ export class World {
      * of the world.  Event callbacks are called in a deferred
      * manner. Event callbacks are executed in read-write mode.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly afterEvents: WorldAfterEvents;
     /**
@@ -17617,6 +17661,8 @@ export class World {
      * of the world. Event callbacks are called immediately. Event
      * callbacks are executed in read-only mode.
      *
+     * This property can be read in early-execution mode.
+     *
      * @example customCommand.ts
      * ```typescript
      * import { world, DimensionLocation } from "@minecraft/server";
@@ -18115,12 +18161,16 @@ export class WorldAfterEvents {
      * explosion. It is fired after the blocks have already been
      * destroyed.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly blockExplode: BlockExplodeAfterEventSignal;
     /**
      * @remarks
      * This event fires when a button is pushed.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly buttonPush: ButtonPushAfterEventSignal;
     /**
@@ -18129,6 +18179,8 @@ export class WorldAfterEvents {
      * This event is triggered after a chat message has been
      * broadcast or sent to players.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly chatSend: ChatSendAfterEventSignal;
     /**
@@ -18137,6 +18189,8 @@ export class WorldAfterEvents {
      * that will update the component definition state of an
      * entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly dataDrivenEntityTrigger: DataDrivenEntityTriggerAfterEventSignal;
     /**
@@ -18144,18 +18198,24 @@ export class WorldAfterEvents {
      * This event fires when an effect, like poisoning, is added to
      * an entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly effectAdd: EffectAddAfterEventSignal;
     /**
      * @remarks
      * This event fires when an entity dies.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityDie: EntityDieAfterEventSignal;
     /**
      * @remarks
      * This event fires when entity health changes in any degree.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityHealthChanged: EntityHealthChangedAfterEventSignal;
     /**
@@ -18163,6 +18223,8 @@ export class WorldAfterEvents {
      * This event fires when an entity hits (that is, melee
      * attacks) a block.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityHitBlock: EntityHitBlockAfterEventSignal;
     /**
@@ -18170,18 +18232,24 @@ export class WorldAfterEvents {
      * This event fires when an entity hits (that is, melee
      * attacks) another entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityHitEntity: EntityHitEntityAfterEventSignal;
     /**
      * @remarks
      * This event fires when an entity is hurt (takes damage).
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityHurt: EntityHurtAfterEventSignal;
     /**
      * @remarks
      * Fires when an entity is loaded.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityLoad: EntityLoadAfterEventSignal;
     /**
@@ -18189,18 +18257,24 @@ export class WorldAfterEvents {
      * Fires when an entity is removed (for example, potentially
      * unloaded, or removed after being killed).
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityRemove: EntityRemoveAfterEventSignal;
     /**
      * @remarks
      * This event fires when an entity is spawned.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entitySpawn: EntitySpawnAfterEventSignal;
     /**
      * @remarks
      * This event is fired after an explosion occurs.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly explosion: ExplosionAfterEventSignal;
     /**
@@ -18208,12 +18282,16 @@ export class WorldAfterEvents {
      * This event fires when a world.gameRules property has
      * changed.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly gameRuleChange: GameRuleChangeAfterEventSignal;
     /**
      * @remarks
      * This event fires when a chargeable item completes charging.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemCompleteUse: ItemCompleteUseAfterEventSignal;
     /**
@@ -18221,12 +18299,16 @@ export class WorldAfterEvents {
      * This event fires when a chargeable item is released from
      * charging.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemReleaseUse: ItemReleaseUseAfterEventSignal;
     /**
      * @remarks
      * This event fires when a chargeable item starts charging.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemStartUse: ItemStartUseAfterEventSignal;
     /**
@@ -18237,12 +18319,16 @@ export class WorldAfterEvents {
      * occur once at the beginning of the block placement. Note:
      * This event cannot be used with Hoe or Axe items.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemStartUseOn: ItemStartUseOnAfterEventSignal;
     /**
      * @remarks
      * This event fires when a chargeable item stops charging.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemStopUse: ItemStopUseAfterEventSignal;
     /**
@@ -18251,6 +18337,8 @@ export class WorldAfterEvents {
      * Block button after successfully using an item. Note: This
      * event cannot be used with Hoe or Axe items.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemStopUseOn: ItemStopUseOnAfterEventSignal;
     /**
@@ -18258,19 +18346,16 @@ export class WorldAfterEvents {
      * This event fires when an item is successfully used by a
      * player.
      *
-     */
-    readonly itemUse: ItemUseAfterEventSignal;
-    /**
-     * @remarks
-     * This event fires when an item is used on a block by a
-     * player.
+     * This property can be read in early-execution mode.
      *
      */
-    readonly itemUseOn: ItemUseOnAfterEventSignal;
+    readonly itemUse: ItemUseAfterEventSignal;
     /**
      * @remarks
      * A lever has been pulled.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly leverAction: LeverActionAfterEventSignal;
     /**
@@ -18279,18 +18364,24 @@ export class WorldAfterEvents {
      * This event is an internal implementation detail, and is
      * otherwise not currently functional.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly messageReceive: ServerMessageAfterEventSignal;
     /**
      * @remarks
      * This event fires when a piston expands or retracts.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly pistonActivate: PistonActivateAfterEventSignal;
     /**
      * @remarks
      * This event fires for a block that is broken by a player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerBreakBlock: PlayerBreakBlockAfterEventSignal;
     /**
@@ -18299,38 +18390,60 @@ export class WorldAfterEvents {
      * This event fires when an {@link InputButton} state is
      * changed.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerButtonInput: PlayerButtonInputAfterEventSignal;
     /**
      * @remarks
      * Fires when a player moved to a different dimension.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerDimensionChange: PlayerDimensionChangeAfterEventSignal;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly playerEmote: PlayerEmoteAfterEventSignal;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly playerGameModeChange: PlayerGameModeChangeAfterEventSignal;
     /**
      * @remarks
      * This event fires when a player's {@link InputMode} changes.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInputModeChange: PlayerInputModeChangeAfterEventSignal;
     /**
      * @remarks
      * This event fires when a players input permissions change.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInputPermissionCategoryChange: PlayerInputPermissionCategoryChangeAfterEventSignal;
     /**
      * @remarks
      * An event for when a player interacts with a block.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInteractWithBlock: PlayerInteractWithBlockAfterEventSignal;
     /**
      * @remarks
      * This event fires when a player interacts with an entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInteractWithEntity: PlayerInteractWithEntityAfterEventSignal;
     /**
@@ -18339,18 +18452,24 @@ export class WorldAfterEvents {
      * playerSpawn for another related event you can trap for when
      * a player is spawned the first time within a world.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerJoin: PlayerJoinAfterEventSignal;
     /**
      * @remarks
      * This event fires when a player leaves a world.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerLeave: PlayerLeaveAfterEventSignal;
     /**
      * @remarks
      * This event fires for a block that is placed by a player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerPlaceBlock: PlayerPlaceBlockAfterEventSignal;
     /**
@@ -18359,6 +18478,8 @@ export class WorldAfterEvents {
      * an additional flag within this event will tell you whether
      * the player is spawning right after join vs. a respawn.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerSpawn: PlayerSpawnAfterEventSignal;
     /**
@@ -18366,6 +18487,8 @@ export class WorldAfterEvents {
      * A pressure plate has popped back up (i.e., there are no
      * entities on the pressure plate.)
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly pressurePlatePop: PressurePlatePopAfterEventSignal;
     /**
@@ -18373,30 +18496,40 @@ export class WorldAfterEvents {
      * A pressure plate has pushed (at least one entity has moved
      * onto a pressure plate.)
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly pressurePlatePush: PressurePlatePushAfterEventSignal;
     /**
      * @remarks
      * This event fires when a projectile hits a block.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly projectileHitBlock: ProjectileHitBlockAfterEventSignal;
     /**
      * @remarks
      * This event fires when a projectile hits an entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly projectileHitEntity: ProjectileHitEntityAfterEventSignal;
     /**
      * @remarks
      * A target block was hit.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly targetBlockHit: TargetBlockHitAfterEventSignal;
     /**
      * @remarks
      * A trip wire was tripped.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly tripWireTrip: TripWireTripAfterEventSignal;
     /**
@@ -18404,10 +18537,15 @@ export class WorldAfterEvents {
      * This event will be triggered when the weather changes within
      * Minecraft.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly weatherChange: WeatherChangeAfterEventSignal;
     /**
      * @beta
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
      */
     readonly worldLoad: WorldLoadAfterEventSignal;
 }
@@ -18427,6 +18565,8 @@ export class WorldBeforeEvents {
      * This event is triggered after a chat message has been
      * broadcast or sent to players.
      *
+     * This property can be read in early-execution mode.
+     *
      * @example customCommand.ts
      * ```typescript
      * import { world, DimensionLocation } from "@minecraft/server";
@@ -18461,6 +18601,8 @@ export class WorldBeforeEvents {
      * This event is triggered after an event has been added to an
      * entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly effectAdd: EffectAddBeforeEventSignal;
     /**
@@ -18468,12 +18610,16 @@ export class WorldBeforeEvents {
      * Fires before an entity is removed from the world (for
      * example, unloaded or removed after being killed.)
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityRemove: EntityRemoveBeforeEventSignal;
     /**
      * @remarks
      * This event is fired after an explosion occurs.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly explosion: ExplosionBeforeEventSignal;
     /**
@@ -18481,38 +18627,46 @@ export class WorldBeforeEvents {
      * This event fires when an item is successfully used by a
      * player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemUse: ItemUseBeforeEventSignal;
     /**
      * @remarks
-     * This event fires when an item is used on a block by a
-     * player.
+     * This event fires before a block is broken by a player.
+     *
+     * This property can be read in early-execution mode.
      *
      */
-    readonly itemUseOn: ItemUseOnBeforeEventSignal;
+    readonly playerBreakBlock: PlayerBreakBlockBeforeEventSignal;
     /**
      * @remarks
-     * This event fires before a block is broken by a player.
+     * This property can be read in early-execution mode.
      *
      */
-    readonly playerBreakBlock: PlayerBreakBlockBeforeEventSignal;
     readonly playerGameModeChange: PlayerGameModeChangeBeforeEventSignal;
     /**
      * @remarks
      * Fires before a player interacts with a block.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInteractWithBlock: PlayerInteractWithBlockBeforeEventSignal;
     /**
      * @remarks
      * Fires before a player interacts with an entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInteractWithEntity: PlayerInteractWithEntityBeforeEventSignal;
     /**
      * @remarks
      * Fires when a player leaves the game.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerLeave: PlayerLeaveBeforeEventSignal;
     /**
@@ -18520,8 +18674,15 @@ export class WorldBeforeEvents {
      * @remarks
      * This event fires before a block is placed by a player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerPlaceBlock: PlayerPlaceBlockBeforeEventSignal;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly weatherChange: WeatherChangeBeforeEventSignal;
 }
 
@@ -18914,14 +19075,22 @@ export interface CameraFadeTimeOptions {
 }
 
 /**
- * @beta
- *
- * Required Experiments:
- * - Third Person Cameras
- *
+ * Options to control pivot points and offsets of the third
+ * person boom preset.
  */
 export interface CameraFixedBoomOptions {
+    /**
+     * @remarks
+     * Changes the pivot point to be <x, y, z> away from the
+     * player.
+     *
+     */
     entityOffset?: Vector3;
+    /**
+     * @remarks
+     * Offsets the camera from center by <x, y>.
+     *
+     */
     viewOffset?: Vector2;
 }
 
@@ -20686,6 +20855,11 @@ export class CustomComponentInvalidRegistryError extends Error {
 // @ts-ignore Class inheritance allowed for native defined classes
 export class CustomComponentNameError extends Error {
     private constructor();
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     reason: CustomComponentNameErrorReason;
 }
 
@@ -20724,12 +20898,16 @@ export class InvalidEntityError extends Error {
      * @remarks
      * The id of the entity that is now invalid.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     id: string;
     /**
      * @remarks
      * The type of the entity that is now invalid.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     type: string;
 }
@@ -20812,6 +20990,11 @@ export class LocationOutOfWorldBoundariesError extends Error {
 // @ts-ignore Class inheritance allowed for native defined classes
 export class NamespaceNameError extends Error {
     private constructor();
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     reason: NamespaceNameErrorReason;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "2.0.0-beta.1.21.70-preview.23",
+  "version": "2.0.0-beta.1.21.70-preview.25",
   "description": "",
   "contributors": [
     {