@minecraft/server 1.1.0-beta.1.19.70-preview.20 → 1.1.0-beta.1.19.70-preview.22

package/index.d.ts

@@ -16,7 +16,7 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "1.1.0-internal.1.19.70-preview.20"
+ *   "version": "1.1.0-internal.1.19.70-preview.22"
  * }
  * ```
  *
@@ -181,6 +181,11 @@ export enum GameMode {
      */
     survival = 'survival',
 }
+export enum ItemLockMode {
+    inventory = 'inventory',
+    none = 'none',
+    slot = 'slot',
+}
 export enum MessageSourceType {
     clientScript = 'clientScript',
     commandBlock = 'commandBlock',
@@ -377,16 +382,12 @@ export class BeforeExplosionEvent {
      * Dimension where the explosion has occurred.
      */
     readonly dimension: Dimension;
-    /**
-     * A collection of blocks impacted by this explosion event.
-     * Note that this property can be updated to change the set of
-     * blocks impacted.
-     */
-    impactedBlocks: Vector3[];
     /**
      * Optional source of the explosion.
      */
     readonly source: Entity;
+    getImpactedBlocks(): Vector3[];
+    setImpactedBlocks(blocks: Vector3[]): void;
 }
 /**
  * @beta
@@ -513,10 +514,6 @@ export class BeforeItemUseOnEvent {
      * The face of the block that an item is being used on.
      */
     readonly blockFace: Direction;
-    /**
-     * Location of the block being impacted.
-     */
-    readonly blockLocation: Vector3;
     /**
      * If set to true, this will cancel the item use behavior.
      */
@@ -539,6 +536,7 @@ export class BeforeItemUseOnEvent {
      * Returns the source entity that triggered this item event.
      */
     readonly source: Entity;
+    getBlockLocation(): Vector3;
 }
 /**
  * @beta
@@ -987,10 +985,6 @@ export class BlockInventoryComponent extends BlockComponent {
      * @throws This property can throw when used.
      */
     readonly container: BlockInventoryComponentContainer;
-    /**
-     * Coordinates of the specified block.
-     */
-    readonly location: Vector3;
     /**
      * Identifier of this component. Should always be
      * minecraft:inventory.
@@ -1128,10 +1122,6 @@ export class BlockLavaContainerComponent extends BlockComponent {
      * FluidContainer.maxFillLevel (6).
      */
     fillLevel: number;
-    /**
-     * Source location of the block.
-     */
-    readonly location: Vector3;
     /**
      * Identifier of this component. Should always be
      * minecraft:lavaContainer.
@@ -1214,12 +1204,6 @@ export class BlockPermutation {
  */
 export class BlockPistonComponent extends BlockComponent {
     protected constructor();
-    /**
-     * A set of locations for blocks that are impacted by the
-     * activation of this piston.
-     * @throws This property can throw when used.
-     */
-    readonly attachedBlocks: Vector3[];
     /**
      * Whether the piston is fully expanded.
      * @throws This property can throw when used.
@@ -1246,10 +1230,6 @@ export class BlockPistonComponent extends BlockComponent {
      * @throws This property can throw when used.
      */
     readonly isRetracting: boolean;
-    /**
-     * Source location of the block.
-     */
-    readonly location: Vector3;
     /**
      * Identifier of this component.
      */
@@ -1258,6 +1238,7 @@ export class BlockPistonComponent extends BlockComponent {
      * Identifier of this component.
      */
     static readonly componentId = 'minecraft:piston';
+    getAttachedBlocks(): Vector3[];
 }
 /**
  * @beta
@@ -1316,10 +1297,6 @@ export class BlockPotionContainerComponent extends BlockComponent {
      * FluidContainer.maxFillLevel (6).
      */
     fillLevel: number;
-    /**
-     * Source location of the block.
-     */
-    readonly location: Vector3;
     /**
      * Identifier of this component. Should always be
      * minecraft:potionContainer.
@@ -1951,10 +1928,6 @@ export class BlockProperties {
  */
 export class BlockRecordPlayerComponent extends BlockComponent {
     protected constructor();
-    /**
-     * Location of this record-playing block.
-     */
-    readonly location: Vector3;
     /**
      * Identifier of this component. Should always be
      * minecraft:recordPlayer.
@@ -1993,10 +1966,6 @@ export class BlockRecordPlayerComponent extends BlockComponent {
  */
 export class BlockSignComponent extends BlockComponent {
     protected constructor();
-    /**
-     * Location of the sign.
-     */
-    readonly location: Vector3;
     /**
      * Text of the sign
      * @throws This property can throw when used.
@@ -2026,10 +1995,6 @@ export class BlockSnowContainerComponent extends BlockComponent {
      * FluidContainer.maxFillLevel (6).
      */
     fillLevel: number;
-    /**
-     * Source location of the block.
-     */
-    readonly location: Vector3;
     /**
      * Identifier of this component. Should always be
      * minecraft:snowContainer.
@@ -2081,10 +2046,6 @@ export class BlockWaterContainerComponent extends BlockComponent {
      * FluidContainer.maxFillLevel (6).
      */
     fillLevel: number;
-    /**
-     * Source location of the block.
-     */
-    readonly location: Vector3;
     /**
      * Identifier of this component. Should always be
      * minecraft:waterContainer.
@@ -2373,29 +2334,28 @@ export class ContainerSlot {
      * Modifier value for the item type stored within the slot.
      */
     data: number;
+    readonly isStackable: boolean;
     /**
      * If true, the state of this container slot is still valid
      * (e.g., the underlying block or entity for this container
      * slot still exists.)
      */
     readonly isValid: boolean;
+    keepOnDeath: boolean;
+    lockMode: ItemLockMode;
+    readonly maxAmount: number;
     /**
      * Returns a name tag for the container slot.
      */
     nameTag?: string;
+    readonly 'type': ItemType;
     /**
      * Returns a string identifier of the type if item stored in
      * this slot.
      * @throws This property can throw when used.
      */
     readonly typeId?: string;
-    /**
-     * @remarks
-     * Empties the item stored at the specified slot.
-     * @throws This function can throw errors.
-     */
-    clearItem(): void;
-    clearLore(): void;
+    clone(): ItemStack;
     /**
      * @remarks
      * Returns the item stored within the container.
@@ -2409,6 +2369,9 @@ export class ContainerSlot {
      * @throws This function can throw errors.
      */
     getLore(): string[];
+    isStackableWith(itemStack: ItemStack): boolean;
+    setCanDestroy(blockIdentifiers?: string[]): void;
+    setCanPlaceOn(blockIdentifiers?: string[]): void;
     /**
      * @remarks
      * Sets the item within the slot to a new value.
@@ -3024,12 +2987,6 @@ export class Entity {
      * @throws This property can throw when used.
      */
     readonly dimension: Dimension;
-    /**
-     * @beta
-     * Location of the center of the head component of the entity.
-     * @throws This property can throw when used.
-     */
-    readonly headLocation: Vector3;
     /**
      * Unique identifier of the entity. This identifier is intended
      * to be consistent across loads of a world instance. No
@@ -3130,6 +3087,9 @@ export class Entity {
      */
     addTag(tag: string): boolean;
     applyDamage(amount: number, source?: EntityDamageSource): boolean;
+    applyImpulse(vector: Vector3): void;
+    applyKnockback(directionX: number, directionZ: number, horizontalStrength: number, verticalStrength: number): void;
+    clearVelocity(): void;
     extinguishFire(useEffects?: boolean): boolean;
     /**
      * @beta
@@ -3192,6 +3152,7 @@ export class Entity {
      * @throws This function can throw errors.
      */
     getEntitiesFromViewDirection(options?: EntityRaycastOptions): Entity[];
+    getHeadLocation(): Vector3;
     getRotation(): XYRotation;
     /**
      * @beta
@@ -3229,6 +3190,7 @@ export class Entity {
      * @throws This function can throw errors.
      */
     kill(): void;
+    playAnimation(animationName: string, options?: PlayAnimationOptions): void;
     /**
      * @beta
      * @remarks
@@ -3280,15 +3242,6 @@ export class Entity {
      * @throws This function can throw errors.
      */
     setRotation(degreesX: number, degreesY: number): void;
-    /**
-     * @beta
-     * @remarks
-     * Sets a velocity for the entity to move with.
-     * @param velocity
-     * X/Y/Z components of the velocity.
-     * @throws This function can throw errors.
-     */
-    setVelocity(velocity: Vector3): void;
     /**
      * @beta
      * @remarks
@@ -5977,14 +5930,11 @@ export class ExplosionEvent {
      * Dimension where the explosion has occurred.
      */
     readonly dimension: Dimension;
-    /**
-     * A collection of blocks impacted by this explosion event.
-     */
-    readonly impactedBlocks: Vector3[];
     /**
      * Optional source of the explosion.
      */
     readonly source: Entity;
+    getImpactedBlocks(): Vector3[];
 }
 /**
  * @beta
@@ -6535,14 +6485,15 @@ export class ItemStack {
      * 0 and 64.
      */
     amount: number;
-    /**
-     * A data value used to configure alternate states of the item.
-     */
-    data: number;
+    readonly isStackable: boolean;
+    keepOnDeath: boolean;
+    lockMode: ItemLockMode;
+    readonly maxAmount: number;
     /**
      * Given name of this stack of items.
      */
     nameTag?: string;
+    readonly 'type': ItemType;
     /**
      * Identifier of the type of items for the stack. If a
      * namespace is not specified, 'minecraft:' is assumed.
@@ -6560,12 +6511,10 @@ export class ItemStack {
      * @param amount
      * Number of items to place in the stack, between 1 and 64.
      * Note that certain items can only have one item in the stack.
-     * @param data
-     * Optional data value used for creating the item, or 0 if no
-     * data value is specified.
+     * @throws This function can throw errors.
      */
-    constructor(itemType: ItemType, amount?: number, data?: number);
-    clearLore(): void;
+    constructor(itemType: ItemType | string, amount?: number);
+    clone(): ItemStack;
     /**
      * @remarks
      * Gets a component (that represents additional capabilities)
@@ -6599,6 +6548,9 @@ export class ItemStack {
      * is assumed.
      */
     hasComponent(componentId: string): boolean;
+    isStackableWith(itemStack: ItemStack): boolean;
+    setCanDestroy(blockIdentifiers?: string[]): void;
+    setCanPlaceOn(blockIdentifiers?: string[]): void;
     /**
      * @remarks
      * Sets the lore value - a secondary display string - for an
@@ -6672,15 +6624,6 @@ export class ItemStartUseOnEvent {
      * The face of the block that an item is being used on.
      */
     readonly blockFace: Direction;
-    /**
-     * Location of the block being impacted.
-     */
-    readonly blockLocation: Vector3;
-    /**
-     * Location of the resulting build block position. Useful for
-     * determining where a block was placed.
-     */
-    readonly buildBlockLocation: Vector3;
     /**
      * The impacted item stack that is starting to be used.
      */
@@ -6689,6 +6632,8 @@ export class ItemStartUseOnEvent {
      * Returns the source entity that triggered this item event.
      */
     readonly source: Entity;
+    getBlockLocation(): Vector3;
+    getBuildBlockLocation(): Vector3;
 }
 /**
  * @beta
@@ -6766,10 +6711,6 @@ export class ItemStopChargeEventSignal {
  */
 export class ItemStopUseOnEvent {
     protected constructor();
-    /**
-     * Location of the block being impacted.
-     */
-    readonly blockLocation: Vector3;
     /**
      * The impacted item stack that is being used on a block.
      */
@@ -6778,6 +6719,7 @@ export class ItemStopUseOnEvent {
      * Returns the source entity that triggered this item event.
      */
     readonly source: Entity;
+    getBlockLocation(): Vector3;
 }
 /**
  * @beta
@@ -6889,10 +6831,6 @@ export class ItemUseOnEvent {
      * The face of the block that an item is being used on.
      */
     readonly blockFace: Direction;
-    /**
-     * Location of the block being impacted.
-     */
-    readonly blockLocation: Vector3;
     /**
      * X coordinate of the item-use impact location on the face of
      * the target block.
@@ -6911,6 +6849,7 @@ export class ItemUseOnEvent {
      * Returns the source entity that triggered this item event.
      */
     readonly source: Entity;
+    getBlockLocation(): Vector3;
 }
 /**
  * @beta
@@ -12993,24 +12932,36 @@ export class MinecraftItemTypes {
 export class MolangVariableMap {
     /**
      * @remarks
-     * Sets a Molang rendering/animation variable with the value of
-     * a Red/Green/Blue color.
+     * Adds the following variables to Molang:
+     * - `<variable_name>.r` - Red color value [0-1]
+     * - `<variable_name>.g` - Green color value [0-1]
+     * - `<variable_name>.b` - Blue color value [0-1]
      * @param variableName
      * @param color
      */
     setColorRGB(variableName: string, color: Color): MolangVariableMap;
     /**
      * @remarks
-     * Sets a Molang rendering/animation variable with the value of
-     * a Red/Green/Blue color + Alpha (transparency) value.
+     * Adds the following variables to Molang:
+     * - `<variable_name>.r` - Red color value [0-1]
+     * - `<variable_name>.g` - Green color value [0-1]
+     * - `<variable_name>.b` - Blue color value [0-1]
+     * - `<variable_name>.a` - Alpha (transparency) color value
+     * [0-1]
      * @param variableName
      * @param color
      */
     setColorRGBA(variableName: string, color: Color): MolangVariableMap;
     /**
      * @remarks
-     * Sets the speed and direction for a Molang (rendering and
-     * animation) variable.
+     * Adds the following variables to Molang:
+     * - `<variable_name>.speed` - Speed number provided
+     * - `<variable_name>.direction_x` - X value from the {@link
+     * Vector3} provided
+     * - `<variable_name>.direction_y` - Y value from the {@link
+     * Vector3} provided
+     * - `<variable_name>.direction_z` - Z value from the {@link
+     * Vector3} provided
      * @param variableName
      * @param speed
      * @param direction
@@ -13018,8 +12969,13 @@ export class MolangVariableMap {
     setSpeedAndDirection(variableName: string, speed: number, direction: Vector): MolangVariableMap;
     /**
      * @remarks
-     * Sets a vector value for a Molang (rendering and animation)
-     * variable.
+     * Adds the following variables to Molang:
+     * - `<variable_name>.x` - X value from the {@link Vector3}
+     * provided
+     * - `<variable_name>.y` - Y value from the {@link Vector3}
+     * provided
+     * - `<variable_name>.z` - Z value from the {@link Vector3}
+     * provided
      * @param variableName
      * @param vector
      */
@@ -13038,10 +12994,7 @@ export class NavigationResult {
      * including to the requested destination.
      */
     readonly isFullPath: boolean;
-    /**
-     * A set of block locations that comprise the navigation route.
-     */
-    readonly path: Vector3[];
+    getPath(): Vector3[];
 }
 /**
  * @beta
@@ -13121,12 +13074,6 @@ export class Player extends Entity {
      * @throws This property can throw when used.
      */
     readonly dimension: Dimension;
-    /**
-     * @beta
-     * Location of the center of the head component of the player.
-     * @throws This property can throw when used.
-     */
-    readonly headLocation: Vector3;
     /**
      * Unique identifier of the player. This identifier is intended
      * to be consistent across loads of a world instance. No
@@ -13218,7 +13165,10 @@ export class Player extends Entity {
      */
     addTag(tag: string): boolean;
     applyDamage(amount: number, source?: EntityDamageSource): boolean;
+    applyImpulse(vector: Vector3): void;
+    applyKnockback(directionX: number, directionZ: number, horizontalStrength: number, verticalStrength: number): void;
     clearSpawn(): void;
+    clearVelocity(): void;
     extinguishFire(useEffects?: boolean): boolean;
     /**
      * @beta
@@ -13281,6 +13231,7 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     getEntitiesFromViewDirection(options?: EntityRaycastOptions): Entity[];
+    getHeadLocation(): Vector3;
     /**
      * @beta
      * @remarks
@@ -13338,6 +13289,7 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     kill(): void;
+    playAnimation(animationName: string, options?: PlayAnimationOptions): void;
     /**
      * @beta
      * @remarks
@@ -13422,15 +13374,6 @@ export class Player extends Entity {
      */
     setRotation(degreesX: number, degreesY: number): void;
     setSpawn(spawnPosition: Vector3, spawnDimension: Dimension): void;
-    /**
-     * @beta
-     * @remarks
-     * Sets a velocity for the entity to move with.
-     * @param velocity
-     * X/Y/Z components of the velocity.
-     * @throws This function can throw errors.
-     */
-    setVelocity(velocity: Vector3): void;
     /**
      * @beta
      * @remarks
@@ -14975,6 +14918,12 @@ export interface NumberRange {
      */
     min: number;
 }
+export interface PlayAnimationOptions {
+    blendOutTime?: number;
+    controller?: string;
+    nextState?: string;
+    stopExpression?: string;
+}
 export interface RawMessage {
     rawtext?: (RawMessage | string)[];
     score?: RawMessageScore;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "1.1.0-beta.1.19.70-preview.20",
+  "version": "1.1.0-beta.1.19.70-preview.22",
   "description": "",
   "contributors": [
     {