@minecraft/server 1.6.0-beta.1.20.30-preview.21 → 1.6.0-beta.1.20.30-preview.24

package/README.md

@@ -6,4 +6,4 @@ Contains many types related to manipulating a Minecraft world, including entitie
 
 See full documentation for this module here:
 
-https://learn.microsoft.com/en-us/minecraft/creator/scriptapi/@minecraft/server/@minecraft/server
+https://learn.microsoft.com/en-us/minecraft/creator/scriptapi/minecraft/server/minecraft-server

package/index.d.ts

@@ -16,7 +16,7 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "1.6.0-internal.1.20.30-preview.21"
+ *   "version": "1.6.0-internal.1.20.30-preview.24"
  * }
  * ```
  *
@@ -258,6 +258,45 @@ export enum EntityDamageCause {
     wither = 'wither',
 }
 
+/**
+ * @beta
+ * An enumeration describing initialization cause of an entity.
+ */
+export enum EntityInitializationCause {
+    /**
+     * @beta
+     * @remarks
+     * Case when an entity is created as child of other entity or
+     * entities, e.g., cows making a cow or slimes making smaller
+     * slimes after dying.
+     *
+     */
+    Born = 'Born',
+    /**
+     * @beta
+     * @remarks
+     * Case when an entity is created by an event, e.g., Wandering
+     * trader spawning llamas.
+     *
+     */
+    Event = 'Event',
+    Loaded = 'Loaded',
+    /**
+     * @beta
+     * @remarks
+     * Case when an entity is naturally spawned in the world.
+     *
+     */
+    Spawned = 'Spawned',
+    /**
+     * @beta
+     * @remarks
+     * Case when an entity is transformed into another entity.
+     *
+     */
+    Transformed = 'Transformed',
+}
+
 /**
  * @beta
  * Describes the lifetime state of an Entity. For example,
@@ -296,7 +335,7 @@ export enum EquipmentSlot {
      * Chestplate or Elytra.
      *
      */
-    chest = 'chest',
+    Chest = 'Chest',
     /**
      * @beta
      * @remarks
@@ -304,7 +343,7 @@ export enum EquipmentSlot {
      * Boots.
      *
      */
-    feet = 'feet',
+    Feet = 'Feet',
     /**
      * @beta
      * @remarks
@@ -312,7 +351,7 @@ export enum EquipmentSlot {
      * Helmets or Carved Pumpkins.
      *
      */
-    head = 'head',
+    Head = 'Head',
     /**
      * @beta
      * @remarks
@@ -320,7 +359,7 @@ export enum EquipmentSlot {
      * Leggings.
      *
      */
-    legs = 'legs',
+    Legs = 'Legs',
     /**
      * @beta
      * @remarks
@@ -328,7 +367,7 @@ export enum EquipmentSlot {
      * the currently active hotbar slot.
      *
      */
-    mainhand = 'mainhand',
+    Mainhand = 'Mainhand',
     /**
      * @beta
      * @remarks
@@ -336,7 +375,7 @@ export enum EquipmentSlot {
      * shields and maps.
      *
      */
-    offhand = 'offhand',
+    Offhand = 'Offhand',
 }
 
 /**
@@ -927,57 +966,6 @@ export class BlockAreaSize {
     equals(other: BlockAreaSize): boolean;
 }
 
-/**
- * @beta
- * Contains information regarding an event where a player
- * breaks a block.
- */
-// @ts-ignore Class inheritance allowed for native defined classes
-export class BlockBreakAfterEvent extends BlockEvent {
-    private constructor();
-    /**
-     * @remarks
-     * Returns permutation information about this block before it
-     * was broken.
-     *
-     */
-    readonly brokenBlockPermutation: BlockPermutation;
-    /**
-     * @remarks
-     * Player that broke the block for this event.
-     *
-     */
-    readonly player: Player;
-}
-
-/**
- * @beta
- * Manages callbacks that are connected to when a block is
- * broken.
- */
-export class BlockBreakAfterEventSignal {
-    private constructor();
-    /**
-     * @remarks
-     * Adds a callback that will be called when a block is broken
-     * by a player.
-     *
-     * This function can't be called in read-only mode.
-     *
-     */
-    subscribe(callback: (arg: BlockBreakAfterEvent) => void): (arg: BlockBreakAfterEvent) => void;
-    /**
-     * @remarks
-     * Removes a callback from being called when an block is
-     * broken.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @throws This function can throw errors.
-     */
-    unsubscribe(callback: (arg: BlockBreakAfterEvent) => void): void;
-}
-
 /**
  * @beta
  * Base type for components associated with blocks.
@@ -1379,50 +1367,6 @@ export class BlockPistonComponent extends BlockComponent {
     getAttachedBlocks(): Vector3[];
 }
 
-/**
- * @beta
- * Contains information regarding an event where a player
- * places a block.
- */
-// @ts-ignore Class inheritance allowed for native defined classes
-export class BlockPlaceAfterEvent extends BlockEvent {
-    private constructor();
-    /**
-     * @remarks
-     * Player that placed the block for this event.
-     *
-     */
-    readonly player: Player;
-}
-
-/**
- * @beta
- * Manages callbacks that are connected to when a block is
- * placed.
- */
-export class BlockPlaceAfterEventSignal {
-    private constructor();
-    /**
-     * @remarks
-     * Adds a callback that will be called when a block is placed
-     * by a player.
-     *
-     * This function can't be called in read-only mode.
-     *
-     */
-    subscribe(callback: (arg: BlockPlaceAfterEvent) => void): (arg: BlockPlaceAfterEvent) => void;
-    /**
-     * @remarks
-     * Removes a callback from being called when an block is
-     * placed.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @throws This function can throw errors.
-     */
-    unsubscribe(callback: (arg: BlockPlaceAfterEvent) => void): void;
-}
-
 /**
  * @beta
  * Represents a fluid container block that currently contains a
@@ -1624,6 +1568,9 @@ export class BlockStates {
      * @remarks
      * Retrieves a specific block state instance.
      *
+     * @returns
+     * Returns the block state instance if it is found. If the
+     * block state instance is not found returns undefined.
      */
     static get(stateName: string): BlockStateType;
     /**
@@ -3083,6 +3030,14 @@ export class DefinitionModifier {
  */
 export class Dimension {
     private constructor();
+    /**
+     * @beta
+     * @remarks
+     * Height range of the dimension.
+     *
+     * @throws This property can throw when used.
+     */
+    readonly heightRange: NumberRange;
     /**
      * @remarks
      * Identifier of the dimension.
@@ -3357,8 +3312,13 @@ export class Dimension {
      *
      * @param weatherType
      * Set the type of weather to apply.
+     * @param duration
+     * Sets the duration of the weather (in ticks). If no duration
+     * is provided, the duration will be set to a random duration
+     * between 300 and 900 seconds.
+     * @throws This function can throw errors.
      */
-    setWeather(weatherType: WeatherType): void;
+    setWeather(weatherType: WeatherType, duration?: number): void;
     /**
      * @beta
      * @remarks
@@ -3978,6 +3938,14 @@ export class Entity {
      * @throws This property can throw when used.
      */
     readonly isOnGround: boolean;
+    /**
+     * @beta
+     * @remarks
+     * If true, the entity is currently sleeping.
+     *
+     * @throws This property can throw when used.
+     */
+    readonly isSleeping: boolean;
     /**
      * @beta
      * @remarks
@@ -4038,8 +4006,8 @@ export class Entity {
      * @beta
      * @remarks
      * Returns a scoreboard identity that represents this entity.
+     * Will remain valid when the entity is killed.
      *
-     * @throws This property can throw when used.
      */
     readonly scoreboardIdentity?: ScoreboardIdentity;
     /**
@@ -4053,7 +4021,7 @@ export class Entity {
     readonly target: Entity;
     /**
      * @remarks
-     * Unique identifier of the type of the entity - for example,
+     * Identifier of the type of the entity - for example,
      * 'minecraft:skeleton'. This property is accessible even if
      * {@link Entity.isValid} is false.
      *
@@ -4417,10 +4385,29 @@ export class Entity {
     /**
      * @beta
      * @remarks
-     * Returns the current rotation component of this entity.
+     * Gets an entity Property value. If the property was set using
+     * the setProperty function within the same tick, the updated
+     * value will not be reflected until the subsequent tick.
      *
+     * @param identifier
+     * The entity Property identifier.
      * @returns
+     * Returns the current property value. For enum properties, a
+     * string is returned. For float and int properties, a number
+     * is returned. For undefined properties, undefined is
+     * returned.
+     * @throws
+     * Throws if the entity is invalid.
+     */
+    getProperty(identifier: string): boolean | number | string | undefined;
+    /**
+     * @beta
+     * @remarks
      * Returns the current rotation component of this entity.
+     *
+     * @returns
+     * Returns a Vec2 containing the rotation of this entity (in
+     * degrees).
      * @throws This function can throw errors.
      */
     getRotation(): Vector2;
@@ -4552,6 +4539,10 @@ export class Entity {
     /**
      * @beta
      * @remarks
+     * Immediately removes the entity from the world. The removed
+     * entity will not perform a death animation or drop loot upon
+     * removal.
+     *
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
@@ -4599,6 +4590,26 @@ export class Entity {
      * @throws This function can throw errors.
      */
     removeTag(tag: string): boolean;
+    /**
+     * @beta
+     * @remarks
+     * Resets an Entity Property back to its default value, as
+     * specified in the Entity's definition. This property change
+     * is not applied until the next tick.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param identifier
+     * The Entity Property identifier.
+     * @returns
+     * Returns the default property value. For enum properties, a
+     * string is returned. For float and int properties, a number
+     * is returned. For undefined properties, undefined is
+     * returned.
+     * @throws
+     * Throws if the entity is invalid.
+     */
+    resetProperty(identifier: string): boolean | number | string;
     /**
      * @beta
      * @remarks
@@ -4691,6 +4702,30 @@ export class Entity {
      * ```
      */
     setOnFire(seconds: number, useEffects?: boolean): boolean;
+    /**
+     * @beta
+     * @remarks
+     * Sets an Entity Property to the provided value. This property
+     * change is not applied until the next tick.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param identifier
+     * The Entity Property identifier.
+     * @param value
+     * The property 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
+     */
+    setProperty(identifier: string, value: boolean | number | string): void;
     /**
      * @beta
      * @remarks
@@ -4699,9 +4734,9 @@ export class Entity {
      * This function can't be called in read-only mode.
      *
      * @param rotation
-     * The x and y rotation of the entity. For most mobs, the x
-     * rotation controls the head tilt and the y rotation controls
-     * the body rotation.
+     * The x and y rotation of the entity (in degrees). For most
+     * mobs, the x rotation controls the head tilt and the y
+     * rotation controls the body rotation.
      * @throws This function can throw errors.
      */
     setRotation(rotation: Vector2): void;
@@ -5198,6 +5233,8 @@ export class EntityDieAfterEventSignal {
 
 /**
  * @beta
+ * Provides access to a mob's equipment slots. This component
+ * exists for all mob entities.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class EntityEquippableComponent extends EntityComponent {
@@ -5205,22 +5242,44 @@ export class EntityEquippableComponent extends EntityComponent {
     static readonly componentId = 'minecraft:equippable';
     /**
      * @remarks
+     * Gets the equipped item for the given EquipmentSlot.
+     *
      * This function can't be called in read-only mode.
      *
+     * @param equipmentSlot
+     * The equipment slot. e.g. "head", "chest", "offhand"
+     * @returns
+     * Returns the item equipped to the given EquipmentSlot. If
+     * empty, returns undefined.
      * @throws This function can throw errors.
      */
     getEquipment(equipmentSlot: EquipmentSlot): ItemStack | undefined;
     /**
+     * @beta
      * @remarks
+     * Gets the ContainerSlot corresponding to the given
+     * EquipmentSlot.
+     *
      * This function can't be called in read-only mode.
      *
+     * @param equipmentSlot
+     * The equipment slot. e.g. "head", "chest", "offhand".
+     * @returns
+     * Returns the ContainerSlot corresponding to the given
+     * EquipmentSlot.
      * @throws This function can throw errors.
      */
     getEquipmentSlot(equipmentSlot: EquipmentSlot): ContainerSlot;
     /**
      * @remarks
+     * Replaces the item in the given EquipmentSlot.
+     *
      * This function can't be called in read-only mode.
      *
+     * @param equipmentSlot
+     * The equipment slot. e.g. "head", "chest", "offhand".
+     * @param itemStack
+     * The item to equip. If undefined, clears the slot.
      * @throws This function can throw errors.
      */
     setEquipment(equipmentSlot: EquipmentSlot, itemStack?: ItemStack): boolean;
@@ -5875,6 +5934,57 @@ export class EntityLeashableComponent extends EntityComponent {
     unleash(): void;
 }
 
+/**
+ * @beta
+ * Contains data related to an entity loaded within the world.
+ * This could happen when an unloaded chunk is reloaded, or
+ * when an entity changes dimensions.
+ */
+export class EntityLoadAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * Entity that was loaded.
+     *
+     * This property can't be edited in read-only mode.
+     *
+     */
+    entity: Entity;
+}
+
+/**
+ * @beta
+ * Registers a script-based event handler for handling what
+ * happens when an entity loads.
+ */
+export class EntityLoadAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Method to register an event handler for what happens when an
+     * entity loads.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param callback
+     * Function that handles the load event.
+     */
+    subscribe(callback: (arg: EntityLoadAfterEvent) => void): (arg: EntityLoadAfterEvent) => void;
+    /**
+     * @remarks
+     * Unregisters a method that was previously subscribed to the
+     * subscription event.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param callback
+     * Original function that was passed into the subscribe event,
+     * that is to be unregistered.
+     * @throws This function can throw errors.
+     */
+    unsubscribe(callback: (arg: EntityLoadAfterEvent) => void): void;
+}
+
 /**
  * @beta
  * Additional variant value. Can be used to further
@@ -6315,14 +6425,21 @@ export class EntityPushThroughComponent extends EntityComponent {
  * from the world (for example, the entity is unloaded because
  * it is not close to players.)
  */
-export class EntityRemovedAfterEvent {
+export class EntityRemoveAfterEvent {
     private constructor();
     /**
      * @remarks
-     * Reference to an entity that was removed.
+     * Id of the entity that was removed.
+     *
+     */
+    readonly removedEntityId: string;
+    /**
+     * @remarks
+     * Identifier of the type of the entity removed - for example,
+     * 'minecraft:skeleton'.
      *
      */
-    readonly removedEntity: string;
+    readonly typeId: string;
 }
 
 /**
@@ -6331,7 +6448,7 @@ export class EntityRemovedAfterEvent {
  * is removed from  the game (for example, unloaded, or a few
  * seconds after they are dead.)
  */
-export class EntityRemovedAfterEventSignal {
+export class EntityRemoveAfterEventSignal {
     private constructor();
     /**
      * @remarks
@@ -6349,9 +6466,9 @@ export class EntityRemovedAfterEventSignal {
      * operations.
      */
     subscribe(
-        callback: (arg: EntityRemovedAfterEvent) => void,
+        callback: (arg: EntityRemoveAfterEvent) => void,
         options?: EntityEventOptions,
-    ): (arg: EntityRemovedAfterEvent) => void;
+    ): (arg: EntityRemoveAfterEvent) => void;
     /**
      * @remarks
      * Unsubscribes your function from subsequent calls when an
@@ -6361,7 +6478,57 @@ export class EntityRemovedAfterEventSignal {
      *
      * @throws This function can throw errors.
      */
-    unsubscribe(callback: (arg: EntityRemovedAfterEvent) => void): void;
+    unsubscribe(callback: (arg: EntityRemoveAfterEvent) => void): void;
+}
+
+/**
+ * @beta
+ * Data for an event that happens when an entity is being
+ * removed from the world (for example, the entity is unloaded
+ * because it is not close to players.)
+ */
+export class EntityRemoveBeforeEvent {
+    private constructor();
+    /**
+     * @remarks
+     * Reference to an entity that is being removed.
+     *
+     */
+    readonly removedEntity: Entity;
+}
+
+/**
+ * @beta
+ * Allows registration for an event that fires when an entity
+ * is being removed from  the game (for example, unloaded, or a
+ * few seconds after they are dead.)
+ */
+export class EntityRemoveBeforeEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Will call your function every time an entity is being
+     * removed from the game.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param callback
+     * Function to call.
+     * @returns
+     * Returns a closure that can be used in subsequent unsubscribe
+     * operations.
+     */
+    subscribe(callback: (arg: EntityRemoveBeforeEvent) => void): (arg: EntityRemoveBeforeEvent) => void;
+    /**
+     * @remarks
+     * Unsubscribes your function from subsequent calls when an
+     * entity is being removed.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    unsubscribe(callback: (arg: EntityRemoveBeforeEvent) => void): void;
 }
 
 /**
@@ -6542,6 +6709,12 @@ export class EntitySkinIdComponent extends EntityComponent {
  */
 export class EntitySpawnAfterEvent {
     private constructor();
+    /**
+     * @remarks
+     * Initialization cause (Spawned, Born ...).
+     *
+     */
+    readonly cause: EntityInitializationCause;
     /**
      * @remarks
      * Entity that was spawned.
@@ -7578,15 +7751,35 @@ export class ItemStack {
      */
     clone(): ItemStack;
     /**
+     * @beta
      * @remarks
-     * Gets a component (that represents additional capabilities)
-     * for an item stack.
+     * Get the list of block types this item can break in Adventure
+     * mode.
      *
-     * @param componentId
-     * The identifier of the component (e.g., 'minecraft:food') to
-     * retrieve. If no namespace prefix is specified, 'minecraft:'
-     * is assumed. If the component is not present on the item
-     * stack or doesn't exist, undefined is returned.
+     * This function can't be called in read-only mode.
+     *
+     */
+    getCanDestroy(): string[];
+    /**
+     * @beta
+     * @remarks
+     * Get the list of block types this item can be placed on in
+     * Adventure mode.
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    getCanPlaceOn(): string[];
+    /**
+     * @remarks
+     * Gets a component (that represents additional capabilities)
+     * for an item stack.
+     *
+     * @param componentId
+     * The identifier of the component (e.g., 'minecraft:food') to
+     * retrieve. If no namespace prefix is specified, 'minecraft:'
+     * is assumed. If the component is not present on the item
+     * stack or doesn't exist, undefined is returned.
      * @example durability.ts
      * ```typescript
      * // Get the maximum durability of a custom sword item
@@ -8624,9 +8817,20 @@ export class Player extends Entity {
     private constructor();
     /**
      * @beta
+     * @remarks
+     * The player's Camera.
+     *
      * @throws This property can throw when used.
      */
     readonly camera: Camera;
+    /**
+     * @beta
+     * @remarks
+     * If true, the player is currently emoting.
+     *
+     * @throws This property can throw when used.
+     */
+    readonly isEmoting: boolean;
     /**
      * @beta
      * @remarks
@@ -8921,6 +9125,134 @@ export class Player extends Entity {
     startItemCooldown(itemCategory: string, tickDuration: number): void;
 }
 
+/**
+ * @beta
+ * Contains information regarding an event after a player
+ * breaks a block.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class PlayerBreakBlockAfterEvent extends BlockEvent {
+    private constructor();
+    /**
+     * @remarks
+     * Returns permutation information about this block before it
+     * was broken.
+     *
+     */
+    readonly brokenBlockPermutation: BlockPermutation;
+    /**
+     * @remarks
+     * The item stack that was used to break the block after the
+     * block was broken, or undefined if empty hand.
+     *
+     */
+    readonly itemStackAfterBreak?: ItemStack;
+    /**
+     * @remarks
+     * The item stack that was used to break the block before the
+     * block was broken, or undefined if empty hand.
+     *
+     */
+    readonly itemStackBeforeBreak?: ItemStack;
+    /**
+     * @remarks
+     * Player that broke the block for this event.
+     *
+     */
+    readonly player: Player;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to when a player breaks
+ * a block.
+ */
+export class PlayerBreakBlockAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when a block is broken
+     * by a player.
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    subscribe(
+        callback: (arg: PlayerBreakBlockAfterEvent) => void,
+        options?: BlockEventOptions,
+    ): (arg: PlayerBreakBlockAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when a player breaks a
+     * block.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    unsubscribe(callback: (arg: PlayerBreakBlockAfterEvent) => void): void;
+}
+
+/**
+ * @beta
+ * Contains information regarding an event before a player
+ * breaks a block.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class PlayerBreakBlockBeforeEvent extends BlockEvent {
+    private constructor();
+    /**
+     * @remarks
+     * If set to true, cancels the block break event.
+     *
+     */
+    cancel: boolean;
+    /**
+     * @remarks
+     * The item stack that is being used to break the block, or
+     * undefined if empty hand.
+     *
+     */
+    itemStack?: ItemStack;
+    /**
+     * @remarks
+     * Player breaking the block for this event.
+     *
+     */
+    readonly player: Player;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to before a player
+ * breaks a block.
+ */
+export class PlayerBreakBlockBeforeEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called before a block is broken
+     * by a player.
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    subscribe(
+        callback: (arg: PlayerBreakBlockBeforeEvent) => void,
+        options?: BlockEventOptions,
+    ): (arg: PlayerBreakBlockBeforeEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called before a player breaks
+     * a block.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    unsubscribe(callback: (arg: PlayerBreakBlockBeforeEvent) => void): void;
+}
+
 /**
  * @beta
  * This type is usable for iterating over a set of players.
@@ -9012,6 +9344,125 @@ export class PlayerLeaveAfterEventSignal extends IPlayerLeaveAfterEventSignal {
     private constructor();
 }
 
+/**
+ * @beta
+ * Contains information regarding an event where a player
+ * places a block.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class PlayerPlaceBlockAfterEvent extends BlockEvent {
+    private constructor();
+    /**
+     * @remarks
+     * Player that placed the block for this event.
+     *
+     */
+    readonly player: Player;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to when a block is
+ * placed by a player.
+ */
+export class PlayerPlaceBlockAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when a block is placed
+     * by a player.
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    subscribe(
+        callback: (arg: PlayerPlaceBlockAfterEvent) => void,
+        options?: BlockEventOptions,
+    ): (arg: PlayerPlaceBlockAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when an block is placed
+     * by a player.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    unsubscribe(callback: (arg: PlayerPlaceBlockAfterEvent) => void): void;
+}
+
+/**
+ * @beta
+ * Contains information regarding an event before a player
+ * places a block.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class PlayerPlaceBlockBeforeEvent extends BlockEvent {
+    private constructor();
+    /**
+     * @remarks
+     * If set to true, cancels the block place event.
+     *
+     */
+    cancel: boolean;
+    /**
+     * @remarks
+     * The face of the block that the new block is being placed on.
+     *
+     */
+    readonly face: Direction;
+    /**
+     * @remarks
+     * Location relative to the bottom north-west corner of the
+     * block where the new block is being placed onto.
+     *
+     */
+    readonly faceLocation: Vector3;
+    /**
+     * @remarks
+     * The item being used to place the block.
+     *
+     */
+    itemStack: ItemStack;
+    /**
+     * @remarks
+     * Player that is placing the block for this event.
+     *
+     */
+    readonly player: Player;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to before a block is
+ * placed by a player.
+ */
+export class PlayerPlaceBlockBeforeEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called before a block is placed
+     * by a player.
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    subscribe(
+        callback: (arg: PlayerPlaceBlockBeforeEvent) => void,
+        options?: BlockEventOptions,
+    ): (arg: PlayerPlaceBlockBeforeEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called before an block is
+     * placed by a player.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    unsubscribe(callback: (arg: PlayerPlaceBlockBeforeEvent) => void): void;
+}
+
 /**
  * @beta
  * An event that contains more information about a player
@@ -9408,12 +9859,16 @@ export class Scoreboard {
      *
      * This function can't be called in read-only mode.
      *
+     * @returns
+     * Returns the previous `ScoreboardObjective` set at the
+     * display slot, if no objective was previously set it returns
+     * `undefined`.
      * @throws This function can throw errors.
      */
     setObjectiveAtDisplaySlot(
         displaySlotId: DisplaySlotId,
         objectiveDisplaySetting: ScoreboardObjectiveDisplayOptions,
-    ): ScoreboardObjective;
+    ): ScoreboardObjective | undefined;
 }
 
 /**
@@ -9447,7 +9902,7 @@ export class ScoreboardIdentity {
      *
      * @throws This function can throw errors.
      */
-    getEntity(): Entity;
+    getEntity(): Entity | undefined;
     isValid(): boolean;
 }
 
@@ -10821,13 +11276,6 @@ export class World {
  */
 export class WorldAfterEvents {
     private constructor();
-    /**
-     * @beta
-     * @remarks
-     * This event fires for a block that is broken by a player.
-     *
-     */
-    readonly blockBreak: BlockBreakAfterEventSignal;
     /**
      * @beta
      * @remarks
@@ -10837,13 +11285,6 @@ export class WorldAfterEvents {
      *
      */
     readonly blockExplode: BlockExplodeAfterEventSignal;
-    /**
-     * @beta
-     * @remarks
-     * This event fires for a block that is placed by a player.
-     *
-     */
-    readonly blockPlace: BlockPlaceAfterEventSignal;
     /**
      * @remarks
      * This event fires when a button is pushed.
@@ -10914,13 +11355,12 @@ export class WorldAfterEvents {
     readonly entityHurt: EntityHurtAfterEventSignal;
     /**
      * @beta
-     * @remarks
-     * This event fires when an entity is removed from the game
-     * (e.g., is unloaded when it goes out of range; or a few
-     * seconds after the death of an entity.)
-     *
      */
-    readonly entityRemoved: EntityRemovedAfterEventSignal;
+    readonly entityLoad: EntityLoadAfterEventSignal;
+    /**
+     * @beta
+     */
+    readonly entityRemove: EntityRemoveAfterEventSignal;
     /**
      * @beta
      * @remarks
@@ -11031,6 +11471,13 @@ export class WorldAfterEvents {
      *
      */
     readonly pistonActivate: PistonActivateAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires for a block that is broken by a player.
+     *
+     */
+    readonly playerBreakBlock: PlayerBreakBlockAfterEventSignal;
     /**
      * @remarks
      * This event fires when a player joins a world.  See also
@@ -11045,6 +11492,13 @@ export class WorldAfterEvents {
      *
      */
     readonly playerLeave: PlayerLeaveAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires for a block that is placed by a player.
+     *
+     */
+    readonly playerPlaceBlock: PlayerPlaceBlockAfterEventSignal;
     /**
      * @remarks
      * This event fires when a player spawns or respawns. Note that
@@ -11143,6 +11597,10 @@ export class WorldBeforeEvents {
      *
      */
     readonly dataDrivenEntityTriggerEvent: DataDrivenEntityTriggerBeforeEventSignal;
+    /**
+     * @beta
+     */
+    readonly entityRemove: EntityRemoveBeforeEventSignal;
     /**
      * @beta
      * @remarks
@@ -11181,6 +11639,20 @@ export class WorldBeforeEvents {
      *
      */
     readonly pistonActivate: PistonActivateBeforeEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires before a block is broken by a player.
+     *
+     */
+    readonly playerBreakBlock: PlayerBreakBlockBeforeEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires before a block is placed by a player.
+     *
+     */
+    readonly playerPlaceBlock: PlayerPlaceBlockBeforeEventSignal;
 }
 
 /**
@@ -11247,6 +11719,27 @@ export class WorldInitializeAfterEventSignal {
     unsubscribe(callback: (arg: WorldInitializeAfterEvent) => void): void;
 }
 
+/**
+ * @beta
+ * Contains optional parameters for registering a block event.
+ */
+export interface BlockEventOptions {
+    /**
+     * @remarks
+     * If this value is set, this event will only fire if the
+     * impacted block's type matches this parameter.
+     *
+     */
+    blockTypes?: string[];
+    /**
+     * @remarks
+     * If this value is set, this event will only fire if the
+     * impacted block's permutation matches this parameter.
+     *
+     */
+    permutations?: BlockPermutation[];
+}
+
 /**
  * @beta
  * Contains additional options for a block fill operation.
@@ -12073,6 +12566,13 @@ export interface RawMessage {
      *
      */
     translate?: string;
+    /**
+     * @remarks
+     * Arguments for the translation token. Can be either an array
+     * of strings or RawMessage containing an array of raw text
+     * objects.
+     *
+     */
     with?: string[] | RawMessage;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "1.6.0-beta.1.20.30-preview.21",
+  "version": "1.6.0-beta.1.20.30-preview.24",
   "description": "",
   "contributors": [
     {