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

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.24"
+ *   "version": "1.6.0-internal.1.20.40-preview.20"
  * }
  * ```
  *
@@ -776,6 +776,20 @@ export class Block {
      *
      */
     readonly z: number;
+    /**
+     * @beta
+     * @throws This function can throw errors.
+     */
+    above(steps?: number): Block | undefined;
+    /**
+     * @beta
+     * @throws This function can throw errors.
+     */
+    below(steps?: number): Block | undefined;
+    /**
+     * @beta
+     */
+    bottomCenter(): Vector3;
     /**
      * @beta
      * @remarks
@@ -794,6 +808,15 @@ export class Block {
      * @throws This function can throw errors.
      */
     canPlace(blockToPlace: BlockPermutation | BlockType | string, faceToPlaceOn?: Direction): boolean;
+    /**
+     * @beta
+     */
+    center(): Vector3;
+    /**
+     * @beta
+     * @throws This function can throw errors.
+     */
+    east(steps?: number): Block | undefined;
     /**
      * @beta
      * @remarks
@@ -882,6 +905,16 @@ export class Block {
      * True if this block object is still working and valid.
      */
     isValid(): boolean;
+    /**
+     * @beta
+     * @throws This function can throw errors.
+     */
+    north(steps?: number): Block | undefined;
+    /**
+     * @beta
+     * @throws This function can throw errors.
+     */
+    offset(offset: Vector3): Block | undefined;
     /**
      * @remarks
      * Sets the block in the dimension to the state of the
@@ -908,6 +941,11 @@ export class Block {
      * @throws This function can throw errors.
      */
     setType(blockType: BlockType | string): void;
+    /**
+     * @beta
+     * @throws This function can throw errors.
+     */
+    south(steps?: number): Block | undefined;
     /**
      * @beta
      * @remarks
@@ -925,6 +963,11 @@ export class Block {
      * @throws This function can throw errors.
      */
     trySetPermutation(permutation: BlockPermutation): boolean;
+    /**
+     * @beta
+     * @throws This function can throw errors.
+     */
+    west(steps?: number): Block | undefined;
 }
 
 /**
@@ -1195,7 +1238,7 @@ export class BlockPermutation {
      * Number of instances of this block to place in the prototype
      * item stack.
      */
-    getItemStack(amount?: number): ItemStack;
+    getItemStack(amount?: number): ItemStack | undefined;
     /**
      * @beta
      * @remarks
@@ -1572,7 +1615,7 @@ export class BlockStates {
      * Returns the block state instance if it is found. If the
      * block state instance is not found returns undefined.
      */
-    static get(stateName: string): BlockStateType;
+    static get(stateName: string): BlockStateType | undefined;
     /**
      * @remarks
      * Retrieves a set of all available block states.
@@ -1995,11 +2038,11 @@ export class Camera {
     setCamera(
         cameraPreset: string,
         setOptions?:
-            | ScriptCameraDefaultOptions
-            | ScriptCameraSetFacingOptions
-            | ScriptCameraSetLocationOptions
-            | ScriptCameraSetPosOptions
-            | ScriptCameraSetRotOptions,
+            | CameraDefaultOptions
+            | CameraSetFacingOptions
+            | CameraSetLocationOptions
+            | CameraSetPosOptions
+            | CameraSetRotOptions,
     ): void;
 }
 
@@ -3483,47 +3526,6 @@ export class DimensionTypes {
     static getAll(): DimensionType[];
 }
 
-/**
- * @beta
- * Class used in conjunction with {@link PropertyRegistry} to
- * define dynamic properties that can be used on entities of a
- * specified type or at the global World- level.
- */
-export class DynamicPropertiesDefinition {
-    /**
-     * @remarks
-     * Defines a boolean dynamic property.
-     *
-     * @throws This function can throw errors.
-     */
-    defineBoolean(identifier: string, defaultValue?: boolean): DynamicPropertiesDefinition;
-    /**
-     * @remarks
-     * Defines a number dynamic property.
-     *
-     * @throws This function can throw errors.
-     */
-    defineNumber(identifier: string, defaultValue?: number): DynamicPropertiesDefinition;
-    /**
-     * @remarks
-     * Defines a string dynamic property.
-     *
-     * @throws This function can throw errors.
-     */
-    defineString(identifier: string, maxLength: number, defaultValue?: string): DynamicPropertiesDefinition;
-    /**
-     * @remarks
-     * Defines a new Vector3-based dynamic property.
-     *
-     * @param identifier
-     * Identifier of the Vector3 property.
-     * @param defaultValue
-     * Optional default starting Vector for this property.
-     * @throws This function can throw errors.
-     */
-    defineVector(identifier: string, defaultValue?: Vector3): DynamicPropertiesDefinition;
-}
-
 /**
  * @beta
  * Represents an effect - like poison - that has been added to
@@ -4212,6 +4214,11 @@ export class Entity {
      * ```
      */
     applyKnockback(directionX: number, directionZ: number, horizontalStrength: number, verticalStrength: number): void;
+    /**
+     * @beta
+     * @throws This function can throw errors.
+     */
+    clearDynamicProperties(): void;
     /**
      * @beta
      * @remarks
@@ -4330,6 +4337,16 @@ export class Entity {
      * @throws This function can throw errors.
      */
     getDynamicProperty(identifier: string): boolean | number | string | Vector3 | undefined;
+    /**
+     * @beta
+     * @throws This function can throw errors.
+     */
+    getDynamicPropertyIds(): string[];
+    /**
+     * @beta
+     * @throws This function can throw errors.
+     */
+    getDynamicPropertyTotalByteCount(): number;
     /**
      * @beta
      * @remarks
@@ -4548,18 +4565,6 @@ export class Entity {
      * @throws This function can throw errors.
      */
     remove(): void;
-    /**
-     * @beta
-     * @remarks
-     * Removes a specified property.
-     *
-     * @param identifier
-     * The property identifier.
-     * @returns
-     * Returns whether the given property existed on the entity.
-     * @throws This function can throw errors.
-     */
-    removeDynamicProperty(identifier: string): boolean;
     /**
      * @beta
      * @remarks
@@ -4652,7 +4657,7 @@ export class Entity {
      * Data value of the property to set.
      * @throws This function can throw errors.
      */
-    setDynamicProperty(identifier: string, value: boolean | number | string | Vector3): void;
+    setDynamicProperty(identifier: string, value?: boolean | number | string | Vector3): void;
     /**
      * @beta
      * @remarks
@@ -6956,7 +6961,7 @@ export class ExplosionAfterEvent {
      * A collection of blocks impacted by this explosion event.
      *
      */
-    getImpactedBlocks(): Vector3[];
+    getImpactedBlocks(): Block[];
 }
 
 /**
@@ -7009,7 +7014,7 @@ export class ExplosionBeforeEvent extends ExplosionAfterEvent {
      * @param blocks
      * New list of blocks that are impacted by this explosion.
      */
-    setImpactedBlocks(blocks: Vector3[]): void;
+    setImpactedBlocks(blocks: Block[]): void;
 }
 
 /**
@@ -7437,7 +7442,7 @@ export class ItemDefinitionTriggeredAfterEvent {
      * Returns the source entity that triggered this item event.
      *
      */
-    readonly source: Player;
+    readonly source?: Player;
 }
 
 /**
@@ -8218,7 +8223,7 @@ export class ItemTypes {
      * Returns a specific item type, if available within Minecraft.
      *
      */
-    static get(itemId: string): ItemType;
+    static get(itemId: string): ItemType | undefined;
     /**
      * @remarks
      * Retrieves all available item types registered within
@@ -8975,6 +8980,14 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     isOp(): boolean;
+    /**
+     * @beta
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    playMusic(trackId: string, musicOptions?: MusicOptions): void;
     /**
      * @beta
      * @remarks
@@ -8982,8 +8995,6 @@ export class Player extends Entity {
      *
      * This function can't be called in read-only mode.
      *
-     * @param soundID
-     * Identifier of the sound to play.
      * @param soundOptions
      * Additional optional options for the sound.
      * @throws This function can throw errors.
@@ -9012,7 +9023,7 @@ export class Player extends Entity {
      *   players[0].playSound("bucket.fill_water", playerSoundOptions);
      * ```
      */
-    playSound(soundID: string, soundOptions?: PlayerSoundOptions): void;
+    playSound(soundId: string, soundOptions?: PlayerSoundOptions): void;
     /**
      * @beta
      * @remarks
@@ -9024,6 +9035,14 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     postClientMessage(id: string, value: string): void;
+    /**
+     * @beta
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    queueMusic(trackId: string, musicOptions?: MusicOptions): void;
     /**
      * @beta
      * @remarks
@@ -9123,6 +9142,14 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     startItemCooldown(itemCategory: string, tickDuration: number): void;
+    /**
+     * @beta
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    stopMusic(): void;
 }
 
 /**
@@ -9255,178 +9282,167 @@ export class PlayerBreakBlockBeforeEventSignal {
 
 /**
  * @beta
- * This type is usable for iterating over a set of players.
- * This means it can be used in statements like for...of
- * statements, Array.from(iterator), and more.
+ * Contains information related to changes to a player's
+ * dimension having been changed.
  */
-export class PlayerIterator implements Iterable<Player> {
+export class PlayerDimensionChangeAfterEvent {
     private constructor();
     /**
      * @remarks
-     * This function can't be called in read-only mode.
+     * The dimension the player is changing from.
      *
      */
-    [Symbol.iterator](): Iterator<Player>;
+    readonly fromDimension: Dimension;
     /**
      * @remarks
-     * Retrieves the next item in this iteration. The resulting
-     * IteratorResult contains .done and .value properties which
-     * can be used to see the next Player in the iteration.
+     * The location the player was at before changing dimensions.
      *
-     * This function can't be called in read-only mode.
+     */
+    readonly fromLocation: Vector3;
+    /**
+     * @remarks
+     * Handle to the player that is changing dimensions.
      *
      */
-    next(): IteratorResult<Player>;
-}
-
-/**
- * @beta
- * Contains information regarding a player that has joined.
- * See the playerSpawn event for more detailed information that
- * could be returned after the first time a player has spawned
- * within the game.
- */
-export class PlayerJoinAfterEvent {
-    private constructor();
+    readonly player: Player;
     /**
      * @remarks
-     * Opaque string identifier of the player that joined the game.
+     * The dimension that the player is changing to.
      *
      */
-    readonly playerId: string;
+    readonly toDimension: Dimension;
     /**
      * @remarks
-     * Name of the player that has joined.
+     * The location the player will spawn to after changing
+     * dimensions.
      *
      */
-    readonly playerName: string;
-}
-
-/**
- * @beta
- * Manages callbacks that are connected to a player joining the
- * world.
- */
-// @ts-ignore Class inheritance allowed for native defined classes
-export class PlayerJoinAfterEventSignal extends IPlayerJoinAfterEventSignal {
-    private constructor();
+    readonly toLocation: Vector3;
 }
 
 /**
  * @beta
- * Contains information regarding a player that has left the
- * world.
+ * Manages callbacks that are connected to successful player
+ * dimension changes.
  */
-export class PlayerLeaveAfterEvent {
+export class PlayerDimensionChangeAfterEventSignal {
     private constructor();
     /**
      * @remarks
-     * Opaque string identifier of the player that has left the
-     * event.
+     * This function can't be called in read-only mode.
      *
      */
-    readonly playerId: string;
+    subscribe(callback: (arg: PlayerDimensionChangeAfterEvent) => void): (arg: PlayerDimensionChangeAfterEvent) => void;
     /**
      * @remarks
-     * Player that has left the world.
+     * This function can't be called in read-only mode.
      *
+     * @throws This function can throw errors.
      */
-    readonly playerName: string;
-}
-
-/**
- * @beta
- * Manages callbacks that are connected to a player leaving the
- * world.
- */
-// @ts-ignore Class inheritance allowed for native defined classes
-export class PlayerLeaveAfterEventSignal extends IPlayerLeaveAfterEventSignal {
-    private constructor();
+    unsubscribe(callback: (arg: PlayerDimensionChangeAfterEvent) => void): void;
 }
 
 /**
  * @beta
- * Contains information regarding an event where a player
- * places a block.
+ * Contains information related to a player's dimension
+ * changing.
  */
-// @ts-ignore Class inheritance allowed for native defined classes
-export class PlayerPlaceBlockAfterEvent extends BlockEvent {
+export class PlayerDimensionChangeBeforeEvent {
     private constructor();
     /**
      * @remarks
-     * Player that placed the block for this event.
+     * The dimension the player is changing from.
+     *
+     */
+    readonly fromDimension: Dimension;
+    /**
+     * @remarks
+     * The location the player was at before changing dimensions.
+     *
+     */
+    readonly fromLocation: Vector3;
+    /**
+     * @remarks
+     * Handle to the player that is changing dimensions.
      *
      */
     readonly player: Player;
+    /**
+     * @remarks
+     * The dimension that the player is changing to, property will
+     * modify dimension change request.
+     *
+     */
+    readonly toDimension: Dimension;
+    /**
+     * @remarks
+     * The location the player will spawn to after changing
+     * dimensions, property will modify spawn location request.
+     *
+     */
+    readonly toLocation: Vector3;
 }
 
 /**
  * @beta
- * Manages callbacks that are connected to when a block is
- * placed by a player.
+ * Manages callbacks that are connected to player dimension
+ * change requests.
  */
-export class PlayerPlaceBlockAfterEventSignal {
+export class PlayerDimensionChangeBeforeEventSignal {
     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;
+        callback: (arg: PlayerDimensionChangeBeforeEvent) => void,
+    ): (arg: PlayerDimensionChangeBeforeEvent) => 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;
+    unsubscribe(callback: (arg: PlayerDimensionChangeBeforeEvent) => void): void;
 }
 
 /**
  * @beta
- * Contains information regarding an event before a player
- * places a block.
+ * Contains information regarding an event after a player
+ * interacts with a block.
  */
-// @ts-ignore Class inheritance allowed for native defined classes
-export class PlayerPlaceBlockBeforeEvent extends BlockEvent {
+export class PlayerInteractWithBlockAfterEvent {
     private constructor();
     /**
      * @remarks
-     * If set to true, cancels the block place event.
+     * The block that will be interacted with.
      *
      */
-    cancel: boolean;
+    readonly block: Block;
     /**
      * @remarks
-     * The face of the block that the new block is being placed on.
+     * The face of the block that is being interacted with.
      *
      */
-    readonly face: Direction;
+    readonly blockFace: Direction;
     /**
      * @remarks
      * Location relative to the bottom north-west corner of the
-     * block where the new block is being placed onto.
+     * block where the item is placed.
      *
      */
     readonly faceLocation: Vector3;
     /**
      * @remarks
-     * The item being used to place the block.
+     * The item stack that is being used in the interaction, or
+     * undefined if empty hand.
      *
      */
-    itemStack: ItemStack;
+    readonly itemStack?: ItemStack;
     /**
      * @remarks
-     * Player that is placing the block for this event.
+     * Source Player for this event.
      *
      */
     readonly player: Player;
@@ -9434,63 +9450,439 @@ export class PlayerPlaceBlockBeforeEvent extends BlockEvent {
 
 /**
  * @beta
- * Manages callbacks that are connected to before a block is
- * placed by a player.
  */
-export class PlayerPlaceBlockBeforeEventSignal {
+export class PlayerInteractWithBlockAfterEventSignal {
     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;
+        callback: (arg: PlayerInteractWithBlockAfterEvent) => void,
+    ): (arg: PlayerInteractWithBlockAfterEvent) => 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;
+    unsubscribe(callback: (arg: PlayerInteractWithBlockAfterEvent) => void): void;
 }
 
 /**
  * @beta
- * An event that contains more information about a player
- * spawning.
+ * Contains information regarding an event before a player
+ * interacts with a block.
  */
-export class PlayerSpawnAfterEvent {
+export class PlayerInteractWithBlockBeforeEvent {
     private constructor();
     /**
      * @remarks
-     * If true, this is the initial spawn of a player after joining
-     * the game.
+     * The block that will be interacted with.
      *
-     * This property can't be edited in read-only mode.
+     */
+    readonly block: Block;
+    /**
+     * @remarks
+     * The face of the block that is being interacted with.
      *
      */
-    initialSpawn: boolean;
+    readonly blockFace: Direction;
     /**
      * @remarks
-     * Object that represents the player that joined the game.
+     * If set to true the interaction will be cancelled.
      *
-     * This property can't be edited in read-only mode.
+     */
+    cancel: boolean;
+    /**
+     * @remarks
+     * Location relative to the bottom north-west corner of the
+     * block where the item is placed.
      *
      */
-    player: Player;
-}
-
-/**
- * @beta
+    readonly faceLocation: Vector3;
+    /**
+     * @remarks
+     * The item stack that is being used in the interaction, or
+     * undefined if empty hand.
+     *
+     */
+    readonly itemStack?: ItemStack;
+    /**
+     * @remarks
+     * Source Player for this event.
+     *
+     */
+    readonly player: Player;
+}
+
+/**
+ * @beta
+ */
+export class PlayerInteractWithBlockBeforeEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    subscribe(
+        callback: (arg: PlayerInteractWithBlockBeforeEvent) => void,
+    ): (arg: PlayerInteractWithBlockBeforeEvent) => void;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    unsubscribe(callback: (arg: PlayerInteractWithBlockBeforeEvent) => void): void;
+}
+
+/**
+ * @beta
+ * Contains information regarding an event after a player
+ * interacts with an entity.
+ */
+export class PlayerInteractWithEntityAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The item stack that is being used in the interaction, or
+     * undefined if empty hand.
+     *
+     */
+    readonly itemStack?: ItemStack;
+    /**
+     * @remarks
+     * Source Player for this event.
+     *
+     */
+    readonly player: Player;
+    /**
+     * @remarks
+     * The entity that will be interacted with.
+     *
+     */
+    readonly target: Entity;
+}
+
+/**
+ * @beta
+ */
+export class PlayerInteractWithEntityAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    subscribe(
+        callback: (arg: PlayerInteractWithEntityAfterEvent) => void,
+    ): (arg: PlayerInteractWithEntityAfterEvent) => void;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    unsubscribe(callback: (arg: PlayerInteractWithEntityAfterEvent) => void): void;
+}
+
+/**
+ * @beta
+ * Contains information regarding an event before a player
+ * interacts with an entity.
+ */
+export class PlayerInteractWithEntityBeforeEvent {
+    private constructor();
+    /**
+     * @remarks
+     * If set to true the interaction will be cancelled.
+     *
+     */
+    cancel: boolean;
+    /**
+     * @remarks
+     * The item stack that is being used in the interaction, or
+     * undefined if empty hand.
+     *
+     */
+    readonly itemStack?: ItemStack;
+    /**
+     * @remarks
+     * Source Player for this event.
+     *
+     */
+    readonly player: Player;
+    /**
+     * @remarks
+     * The entity that will be interacted with.
+     *
+     */
+    readonly target: Entity;
+}
+
+/**
+ * @beta
+ */
+export class PlayerInteractWithEntityBeforeEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    subscribe(
+        callback: (arg: PlayerInteractWithEntityBeforeEvent) => void,
+    ): (arg: PlayerInteractWithEntityBeforeEvent) => void;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    unsubscribe(callback: (arg: PlayerInteractWithEntityBeforeEvent) => void): void;
+}
+
+/**
+ * @beta
+ * This type is usable for iterating over a set of players.
+ * This means it can be used in statements like for...of
+ * statements, Array.from(iterator), and more.
+ */
+export class PlayerIterator implements Iterable<Player> {
+    private constructor();
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    [Symbol.iterator](): Iterator<Player>;
+    /**
+     * @remarks
+     * Retrieves the next item in this iteration. The resulting
+     * IteratorResult contains .done and .value properties which
+     * can be used to see the next Player in the iteration.
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    next(): IteratorResult<Player>;
+}
+
+/**
+ * @beta
+ * Contains information regarding a player that has joined.
+ * See the playerSpawn event for more detailed information that
+ * could be returned after the first time a player has spawned
+ * within the game.
+ */
+export class PlayerJoinAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * Opaque string identifier of the player that joined the game.
+     *
+     */
+    readonly playerId: string;
+    /**
+     * @remarks
+     * Name of the player that has joined.
+     *
+     */
+    readonly playerName: string;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to a player joining the
+ * world.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class PlayerJoinAfterEventSignal extends IPlayerJoinAfterEventSignal {
+    private constructor();
+}
+
+/**
+ * @beta
+ * Contains information regarding a player that has left the
+ * world.
+ */
+export class PlayerLeaveAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * Opaque string identifier of the player that has left the
+     * event.
+     *
+     */
+    readonly playerId: string;
+    /**
+     * @remarks
+     * Player that has left the world.
+     *
+     */
+    readonly playerName: string;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to a player leaving the
+ * world.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+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
+ * spawning.
+ */
+export class PlayerSpawnAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * If true, this is the initial spawn of a player after joining
+     * the game.
+     *
+     * This property can't be edited in read-only mode.
+     *
+     */
+    initialSpawn: boolean;
+    /**
+     * @remarks
+     * Object that represents the player that joined the game.
+     *
+     * This property can't be edited in read-only mode.
+     *
+     */
+    player: Player;
+}
+
+/**
+ * @beta
  * Registers an event when a player is spawned (or re-spawned
  * after death) and fully ready within the world.
  */
@@ -9761,38 +10153,6 @@ export class ProjectileHitEntityAfterEventSignal {
     unsubscribe(callback: (arg: ProjectileHitEntityAfterEvent) => void): void;
 }
 
-/**
- * @beta
- * Provides methods that should be used within the World
- * Initialize event to register dynamic properties that can be
- * used and stored within Minecraft.
- */
-export class PropertyRegistry {
-    private constructor();
-    /**
-     * @remarks
-     * Registers a dynamic property for a particular entity type
-     * (e.g., a minecraft:skeleton.).
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @throws This function can throw errors.
-     */
-    registerEntityTypeDynamicProperties(
-        propertiesDefinition: DynamicPropertiesDefinition,
-        entityTypeOrId: EntityType | string,
-    ): void;
-    /**
-     * @remarks
-     * Registers a globally available dynamic property for a world.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @throws This function can throw errors.
-     */
-    registerWorldDynamicProperties(propertiesDefinition: DynamicPropertiesDefinition): void;
-}
-
 /**
  * @beta
  * Contains objectives and participants for the scoreboard.
@@ -10857,6 +11217,10 @@ export class World {
      * The message.
      */
     broadcastClientMessage(id: string, value: string): void;
+    /**
+     * @beta
+     */
+    clearDynamicProperties(): void;
     /**
      * @beta
      * @remarks
@@ -10972,6 +11336,14 @@ export class World {
      * ```
      */
     getDynamicProperty(identifier: string): boolean | number | string | Vector3 | undefined;
+    /**
+     * @beta
+     */
+    getDynamicPropertyIds(): string[];
+    /**
+     * @beta
+     */
+    getDynamicPropertyTotalByteCount(): number;
     /**
      * @beta
      * @remarks
@@ -11049,7 +11421,7 @@ export class World {
      *   players[0].playSound("bucket.fill_water", playerSoundOptions);
      * ```
      */
-    playMusic(trackID: string, musicOptions?: MusicOptions): void;
+    playMusic(trackId: string, musicOptions?: MusicOptions): void;
     /**
      * @beta
      * @remarks
@@ -11087,7 +11459,7 @@ export class World {
      *   players[0].playSound("bucket.fill_water", playerSoundOptions);
      * ```
      */
-    playSound(soundID: string, location: Vector3, soundOptions?: WorldSoundOptions): void;
+    playSound(soundId: string, location: Vector3, soundOptions?: WorldSoundOptions): void;
     /**
      * @beta
      * @remarks
@@ -11101,17 +11473,7 @@ export class World {
      * An error will be thrown if fade is less than 0.0.
      *
      */
-    queueMusic(trackID: string, musicOptions?: MusicOptions): void;
-    /**
-     * @beta
-     * @remarks
-     * Removes a specified property.
-     *
-     * This function can't be called in read-only mode.
-     *
-     * @throws This function can throw errors.
-     */
-    removeDynamicProperty(identifier: string): boolean;
+    queueMusic(trackId: string, musicOptions?: MusicOptions): void;
     /**
      * @beta
      * @remarks
@@ -11181,8 +11543,6 @@ export class World {
      * @remarks
      * Sets a specified property to a value.
      *
-     * This function can't be called in read-only mode.
-     *
      * @param identifier
      * The property identifier.
      * @param value
@@ -11243,7 +11603,7 @@ export class World {
      *   mc.world.setDynamicProperty("samplelibrary:longerjson", paintStr);
      * ```
      */
-    setDynamicProperty(identifier: string, value: boolean | number | string | Vector3): void;
+    setDynamicProperty(identifier: string, value?: boolean | number | string | Vector3): void;
     /**
      * @beta
      * @remarks
@@ -11478,6 +11838,18 @@ export class WorldAfterEvents {
      *
      */
     readonly playerBreakBlock: PlayerBreakBlockAfterEventSignal;
+    /**
+     * @beta
+     */
+    readonly playerDimensionChange: PlayerDimensionChangeAfterEventSignal;
+    /**
+     * @beta
+     */
+    readonly playerInteractWithBlock: PlayerInteractWithBlockAfterEventSignal;
+    /**
+     * @beta
+     */
+    readonly playerInteractWithEntity: PlayerInteractWithEntityAfterEventSignal;
     /**
      * @remarks
      * This event fires when a player joins a world.  See also
@@ -11646,6 +12018,18 @@ export class WorldBeforeEvents {
      *
      */
     readonly playerBreakBlock: PlayerBreakBlockBeforeEventSignal;
+    /**
+     * @beta
+     */
+    readonly playerDimensionChange: PlayerDimensionChangeBeforeEventSignal;
+    /**
+     * @beta
+     */
+    readonly playerInteractWithBlock: PlayerInteractWithBlockBeforeEventSignal;
+    /**
+     * @beta
+     */
+    readonly playerInteractWithEntity: PlayerInteractWithEntityBeforeEventSignal;
     /**
      * @beta
      * @remarks
@@ -11665,28 +12049,6 @@ export class WorldBeforeEvents {
  */
 export class WorldInitializeAfterEvent {
     private constructor();
-    /**
-     * @remarks
-     * Contains methods for scripts to initialize and register
-     * dynamic properties they may wish to use within a world.
-     *
-     * @example propertyRegistration.js
-     * ```typescript
-     * import { DynamicPropertiesDefinition, EntityTypes, world } from '@minecraft/server';
-     * import { MinecraftEntityTypes } from '@minecraft/vanilla-data';
-     *
-     * world.afterEvents.worldInitialize.subscribe(e => {
-     *     let def = new DynamicPropertiesDefinition();
-     *
-     *     def.defineNumber('rpgStrength');
-     *     def.defineString('rpgRole', 16);
-     *     def.defineBoolean('rpgIsHero');
-     *
-     *     e.propertyRegistry.registerEntityTypeDynamicProperties(def, EntityTypes.get(MinecraftEntityTypes.Skeleton));
-     * });
-     * ```
-     */
-    readonly propertyRegistry: PropertyRegistry;
 }
 
 /**
@@ -11916,6 +12278,13 @@ export interface BoundingBox {
     min: Vector3;
 }
 
+/**
+ * @beta
+ */
+export interface CameraDefaultOptions {
+    easeOptions: CameraEaseOptions;
+}
+
 /**
  * @beta
  */
@@ -11941,6 +12310,41 @@ export interface CameraFadeTimeOptions {
     holdTime: number;
 }
 
+/**
+ * @beta
+ */
+export interface CameraSetFacingOptions {
+    easeOptions?: CameraEaseOptions;
+    facingEntity: Entity;
+    location?: Vector3;
+}
+
+/**
+ * @beta
+ */
+export interface CameraSetLocationOptions {
+    easeOptions?: CameraEaseOptions;
+    location: Vector3;
+}
+
+/**
+ * @beta
+ */
+export interface CameraSetPosOptions {
+    easeOptions?: CameraEaseOptions;
+    facingLocation: Vector3;
+    location?: Vector3;
+}
+
+/**
+ * @beta
+ */
+export interface CameraSetRotOptions {
+    easeOptions?: CameraEaseOptions;
+    location?: Vector3;
+    rotation: Vector2;
+}
+
 /**
  * @beta
  * This interface defines an entry into the {@link
@@ -12696,48 +13100,6 @@ export interface ScoreboardObjectiveDisplayOptions {
     sortOrder?: ObjectiveSortOrder;
 }
 
-/**
- * @beta
- */
-export interface ScriptCameraDefaultOptions {
-    easeOptions: CameraEaseOptions;
-}
-
-/**
- * @beta
- */
-export interface ScriptCameraSetFacingOptions {
-    easeOptions?: CameraEaseOptions;
-    facingEntity: Entity;
-    location?: Vector3;
-}
-
-/**
- * @beta
- */
-export interface ScriptCameraSetLocationOptions {
-    easeOptions?: CameraEaseOptions;
-    location: Vector3;
-}
-
-/**
- * @beta
- */
-export interface ScriptCameraSetPosOptions {
-    easeOptions?: CameraEaseOptions;
-    facingLocation: Vector3;
-    location?: Vector3;
-}
-
-/**
- * @beta
- */
-export interface ScriptCameraSetRotOptions {
-    easeOptions?: CameraEaseOptions;
-    location?: Vector3;
-    rotation: Vector2;
-}
-
 /**
  * @beta
  * Contains additional options for registering a script event

package/package.json

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