@minecraft/server 1.1.0-beta.preview.1.19.50.24 → 1.1.0-beta.preview.1.19.60.20

package/index.d.ts

@@ -15,7 +15,7 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "1.1.0-internal.preview.1.19.50.24"
+ *   "version": "1.1.0-internal.preview.1.19.60.20"
  * }
  * ```
  *
@@ -666,6 +666,21 @@ export class Block {
      * Z coordinate of the block.
      */
     readonly z: number;
+    /**
+     * @remarks
+     * Checks to see whether it is valid to place the specified
+     * block type or block permutation, on a specified face on this
+     * block
+     * @param blockToPlace
+     * Block type or block permutation to check placement for.
+     * @param faceToPlaceOn
+     * Optional specific face of this block to check placement
+     * against.
+     * @returns
+     * Returns `true` if the block type or permutation can be
+     * placed on this block, else `false`.
+     * @throws This function can throw errors.
+     */
     canPlace(blockToPlace: BlockPermutation | BlockType, faceToPlaceOn?: Direction): boolean;
     /**
      * @remarks
@@ -730,6 +745,18 @@ export class Block {
      * @throws This function can throw errors.
      */
     setType(blockType: BlockType): void;
+    /**
+     * @remarks
+     * Tries to set the block in the dimension to the state of the
+     * permutation by first checking if the placement is valid.
+     * @param permutation
+     * Permutation that contains a set of property states for the
+     * Block.
+     * @returns
+     * Returns `true` if the block permutation data was
+     * successfully set, else `false`.
+     * @throws This function can throw errors.
+     */
     trySetPermutation(permutation: BlockPermutation): boolean;
 }
 /**
@@ -957,6 +984,8 @@ export class BlockInventoryComponentContainer extends Container {
      * @throws This function can throw errors.
      */
     addItem(itemStack: ItemStack): void;
+    clearAll(): void;
+    clearItem(slot: number): void;
     /**
      * @remarks
      * Gets the item stack for the set of items at the specified
@@ -973,6 +1002,7 @@ export class BlockInventoryComponentContainer extends Container {
      * ```
      */
     getItem(slot: number): ItemStack;
+    getSlot(slot: number): ContainerSlot;
     /**
      * @remarks
      * Sets an item stack within a particular slot.
@@ -982,7 +1012,7 @@ export class BlockInventoryComponentContainer extends Container {
      * Stack of items to place within the specified slot.
      * @throws This function can throw errors.
      */
-    setItem(slot: number, itemStack: ItemStack): void;
+    setItem(slot: number, itemStack?: ItemStack): void;
     /**
      * @remarks
      * Swaps items between two different slots within containers.
@@ -2270,6 +2300,8 @@ export class Container {
      * @throws This function can throw errors.
      */
     addItem(itemStack: ItemStack): void;
+    clearAll(): void;
+    clearItem(slot: number): void;
     /**
      * @remarks
      * Gets the item stack for the set of items at the specified
@@ -2290,6 +2322,7 @@ export class Container {
      * ```
      */
     getItem(slot: number): ItemStack;
+    getSlot(slot: number): ContainerSlot;
     /**
      * @remarks
      * Sets an item stack within a particular slot.
@@ -2299,7 +2332,7 @@ export class Container {
      * Stack of items to place within the specified slot.
      * @throws This function can throw errors.
      */
-    setItem(slot: number, itemStack: ItemStack): void;
+    setItem(slot: number, itemStack?: ItemStack): void;
     /**
      * @remarks
      * Swaps items between two different slots within containers.
@@ -2337,6 +2370,19 @@ export class Container {
      */
     transferItem(fromSlot: number, toSlot: number, toContainer: Container): boolean;
 }
+export class ContainerSlot {
+    protected constructor();
+    amount: number;
+    data: number;
+    readonly isValid: boolean;
+    nameTag?: string;
+    readonly typeId?: string;
+    clearItem(): void;
+    getItem(): ItemStack;
+    getLore(): string[];
+    setItem(itemStack?: ItemStack): void;
+    setLore(loreList: string[]): void;
+}
 /**
  * Contains information related to firing of a data driven
  * entity event - for example, the minecraft:ageable_grow_up
@@ -2950,11 +2996,7 @@ export class Entity {
      * @throws This property can throw when used.
      */
     readonly velocity: Vector;
-    /**
-     * Vector of the current view of the entity.
-     * @throws This property can throw when used.
-     */
-    readonly viewVector: Vector;
+    readonly viewDirection: Vector3;
     /**
      * @remarks
      * Adds an effect, like poison, to the entity.
@@ -3003,15 +3045,7 @@ export class Entity {
      * @throws This function can throw errors.
      */
     addTag(tag: string): boolean;
-    /**
-     * @remarks
-     * Gets the first block that intersects with the vector of the
-     * view of this entity.
-     * @param options
-     * Additional options for processing this raycast query.
-     * @throws This function can throw errors.
-     */
-    getBlockFromViewVector(options?: BlockRaycastOptions): Block;
+    getBlockFromViewDirection(options?: BlockRaycastOptions): Block;
     /**
      * @remarks
      * Gets a component (that represents additional capabilities)
@@ -3050,15 +3084,7 @@ export class Entity {
      * @throws This function can throw errors.
      */
     getEffect(effectType: EffectType): Effect;
-    /**
-     * @remarks
-     * Gets the first entity that intersects with the vector of the
-     * view of this entity.
-     * @param options
-     * Additional options for processing this raycast query.
-     * @throws This function can throw errors.
-     */
-    getEntitiesFromViewVector(options?: EntityRaycastOptions): Entity[];
+    getEntitiesFromViewDirection(options?: EntityRaycastOptions): Entity[];
     /**
      * @remarks
      * Returns all tags associated with an entity.
@@ -3411,60 +3437,6 @@ export class EntityColorComponent extends IEntityComponent {
      */
     static readonly componentId = 'minecraft:color';
 }
-/**
- * Contains information related to the creation of a new
- * entity.
- */
-export class EntityCreateEvent {
-    protected constructor();
-    /**
-     * New entity that was created.
-     */
-    entity: Entity;
-}
-/**
- * Manages callbacks that are connected to when a new entity is
- * created.
- */
-export class EntityCreateEventSignal {
-    protected constructor();
-    /**
-     * @remarks
-     * Adds a callback that will be called when a new entity is
-     * created.
-     * @param callback
-     * @example runEntityCreatedEvent.ts
-     * ```typescript
-     *          // register a new function that is called when a new entity is created.
-     *          const entityCreatedCallback = mc.world.events.entityCreate.subscribe((entityEvent: mc.EntityCreateEvent) => {
-     *            if (entityEvent && entityEvent.entity) {
-     *              log("New entity of type '" + +entityEvent.entity + "' created!", 1);
-     *            } else {
-     *              log("The entity event didn't work as expected.", -1);
-     *            }
-     *          });
-     * ```
-     */
-    subscribe(callback: (arg: EntityCreateEvent) => void): (arg: EntityCreateEvent) => void;
-    /**
-     * @remarks
-     * Removes a callback from being called when a new entity is
-     * created.
-     * @param callback
-     * @throws This function can throw errors.
-     * @example unsubscribeEntityCreatedEvent.ts
-     * ```typescript
-     *          if (entityCreatedCallbacks.length > 0) {
-     *            let callback = entityCreatedCallbacks.pop();
-     *
-     *            if (callback) {
-     *              mc.world.events.entityCreate.unsubscribe(callback);
-     *            }
-     *          }
-     * ```
-     */
-    unsubscribe(callback: (arg: EntityCreateEvent) => void): void;
-}
 /**
  * As part of the Ageable component, represents a set of items
  * that can be fed to an entity and the rate at which that
@@ -5420,6 +5392,15 @@ export class EntitySkinIdComponent extends IEntityComponent {
      */
     static readonly componentId = 'minecraft:skin_id';
 }
+export class EntitySpawnEvent {
+    protected constructor();
+    entity: Entity;
+}
+export class EntitySpawnEventSignal {
+    protected constructor();
+    subscribe(callback: (arg: EntitySpawnEvent) => void): (arg: EntitySpawnEvent) => void;
+    unsubscribe(callback: (arg: EntitySpawnEvent) => void): void;
+}
 /**
  * Defines the entity's strength to carry items.
  */
@@ -5701,10 +5682,6 @@ export class Events {
      * an entity.
      */
     readonly effectAdd: EffectAddEventSignal;
-    /**
-     * This event fires when a new entity is created.
-     */
-    readonly entityCreate: EntityCreateEventSignal;
     /**
      * This event fires when an entity hits (makes a melee attack)
      * and potentially impacts another entity or block.
@@ -5714,6 +5691,7 @@ export class Events {
      * This event fires when an entity is hurt (takes damage).
      */
     readonly entityHurt: EntityHurtEventSignal;
+    readonly entitySpawn: EntitySpawnEventSignal;
     /**
      * This event is fired after an explosion occurs.
      */
@@ -5783,6 +5761,7 @@ export class Events {
      * This event fires when a player leaves a world.
      */
     readonly playerLeave: PlayerLeaveEventSignal;
+    readonly playerSpawn: PlayerSpawnEventSignal;
     /**
      * This event fires when a projectile hits an entity or block.
      */
@@ -5991,6 +5970,8 @@ export class InventoryComponentContainer extends Container {
      * @throws This function can throw errors.
      */
     addItem(itemStack: ItemStack): void;
+    clearAll(): void;
+    clearItem(slot: number): void;
     /**
      * @remarks
      * Gets the item stack for the set of items at the specified
@@ -6007,6 +5988,7 @@ export class InventoryComponentContainer extends Container {
      * ```
      */
     getItem(slot: number): ItemStack;
+    getSlot(slot: number): ContainerSlot;
     /**
      * @remarks
      * Sets an item stack within a particular slot.
@@ -6016,7 +5998,7 @@ export class InventoryComponentContainer extends Container {
      * Stack of items to place within the specified slot.
      * @throws This function can throw errors.
      */
-    setItem(slot: number, itemStack: ItemStack): void;
+    setItem(slot: number, itemStack?: ItemStack): void;
     /**
      * @remarks
      * Swaps items between two different slots within containers.
@@ -6901,6 +6883,7 @@ export class MinecraftBlockTypes {
      * Represents a bamboo tree within Minecraft.
      */
     static readonly bamboo: BlockType;
+    static readonly bambooBlock: BlockType;
     static readonly bambooButton: BlockType;
     static readonly bambooDoor: BlockType;
     static readonly bambooDoubleSlab: BlockType;
@@ -9482,6 +9465,7 @@ export class MinecraftBlockTypes {
      * Represents a stripped acacia log within Minecraft.
      */
     static readonly strippedAcaciaLog: BlockType;
+    static readonly strippedBambooBlock: BlockType;
     /**
      * Represents a stripped birch log within Minecraft.
      */
@@ -11032,6 +11016,7 @@ export class MinecraftItemTypes {
      * Minecraft.
      */
     static readonly enderChest: ItemType;
+    static readonly enderDragonSpawnEgg: ItemType;
     static readonly enderEye: ItemType;
     static readonly endermanSpawnEgg: ItemType;
     static readonly endermiteSpawnEgg: ItemType;
@@ -11317,6 +11302,7 @@ export class MinecraftItemTypes {
      * Minecraft.
      */
     static readonly ironDoor: ItemType;
+    static readonly ironGolemSpawnEgg: ItemType;
     static readonly ironHelmet: ItemType;
     static readonly ironHoe: ItemType;
     static readonly ironHorseArmor: ItemType;
@@ -12198,6 +12184,7 @@ export class MinecraftItemTypes {
      */
     static readonly snow: ItemType;
     static readonly snowball: ItemType;
+    static readonly snowGolemSpawnEgg: ItemType;
     /**
      * Represents an item that can place a layer of snow within
      * Minecraft.
@@ -12699,6 +12686,7 @@ export class MinecraftItemTypes {
      */
     static readonly witherRose: ItemType;
     static readonly witherSkeletonSpawnEgg: ItemType;
+    static readonly witherSpawnEgg: ItemType;
     static readonly wolfSpawnEgg: ItemType;
     /**
      * Represents an item that can place a block of wood within
@@ -12976,11 +12964,7 @@ export class Player extends Entity {
      * @throws This property can throw when used.
      */
     readonly velocity: Vector;
-    /**
-     * Vector of the current view of the player.
-     * @throws This property can throw when used.
-     */
-    readonly viewVector: Vector;
+    readonly viewDirection: Vector3;
     /**
      * @remarks
      * Adds an effect, like poison, to the entity.
@@ -13002,15 +12986,7 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     addTag(tag: string): boolean;
-    /**
-     * @remarks
-     * Gets the first block that intersects with the vector of the
-     * view of this entity.
-     * @param options
-     * Additional options for processing this raycast query.
-     * @throws This function can throw errors.
-     */
-    getBlockFromViewVector(options?: BlockRaycastOptions): Block;
+    getBlockFromViewDirection(options?: BlockRaycastOptions): Block;
     /**
      * @remarks
      * Gets a component (that represents additional capabilities)
@@ -13049,15 +13025,7 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     getEffect(effectType: EffectType): Effect;
-    /**
-     * @remarks
-     * Gets the first entity that intersects with the vector of the
-     * view of this entity.
-     * @param options
-     * Additional options for processing this raycast query.
-     * @throws This function can throw errors.
-     */
-    getEntitiesFromViewVector(options?: EntityRaycastOptions): Entity[];
+    getEntitiesFromViewDirection(options?: EntityRaycastOptions): Entity[];
     /**
      * @remarks
      * Gets the current item cooldown time for a particular
@@ -13219,7 +13187,7 @@ export class Player extends Entity {
      * @param message
      * @throws This function can throw errors.
      */
-    tell(message: IRawMessage | string): void;
+    tell(message: RawMessage | string): void;
     /**
      * @remarks
      * Triggers an entity type event. For every entity, a number of
@@ -13260,6 +13228,8 @@ export class PlayerInventoryComponentContainer extends InventoryComponentContain
      * @throws This function can throw errors.
      */
     addItem(itemStack: ItemStack): void;
+    clearAll(): void;
+    clearItem(slot: number): void;
     /**
      * @remarks
      * Gets the item stack for the set of items at the specified
@@ -13270,6 +13240,7 @@ export class PlayerInventoryComponentContainer extends InventoryComponentContain
      * @throws This function can throw errors.
      */
     getItem(slot: number): ItemStack;
+    getSlot(slot: number): ContainerSlot;
     /**
      * @remarks
      * Sets an item stack within a particular slot.
@@ -13279,7 +13250,7 @@ export class PlayerInventoryComponentContainer extends InventoryComponentContain
      * Stack of items to place within the specified slot.
      * @throws This function can throw errors.
      */
-    setItem(slot: number, itemStack: ItemStack): void;
+    setItem(slot: number, itemStack?: ItemStack): void;
     /**
      * @remarks
      * Swaps items between two different slots within containers.
@@ -13328,10 +13299,8 @@ export class PlayerIterator implements Iterable<Player> {
  */
 export class PlayerJoinEvent {
     protected constructor();
-    /**
-     * Player that has joined the world.
-     */
-    player: Player;
+    readonly playerId: string;
+    readonly playerName: string;
 }
 /**
  * Manages callbacks that are connected to a player joining the
@@ -13361,6 +13330,7 @@ export class PlayerJoinEventSignal {
  */
 export class PlayerLeaveEvent {
     protected constructor();
+    readonly playerId: string;
     /**
      * Player that has left the world.
      */
@@ -13388,6 +13358,16 @@ export class PlayerLeaveEventSignal {
      */
     unsubscribe(callback: (arg: PlayerLeaveEvent) => void): void;
 }
+export class PlayerSpawnEvent {
+    protected constructor();
+    initialSpawn: boolean;
+    player: Player;
+}
+export class PlayerSpawnEventSignal {
+    protected constructor();
+    subscribe(callback: (arg: PlayerSpawnEvent) => void): (arg: PlayerSpawnEvent) => void;
+    unsubscribe(callback: (arg: PlayerSpawnEvent) => void): void;
+}
 /**
  * Contains information related to a projectile hitting an
  * entity or block.
@@ -14136,7 +14116,7 @@ export class World {
      * @param message
      * @throws This function can throw errors.
      */
-    say(message: IRawMessage | string): void;
+    say(message: RawMessage | string): void;
     /**
      * @remarks
      * Sets a specified property to a value.
@@ -14465,33 +14445,6 @@ export interface ExplosionOptions {
      */
     source?: Entity;
 }
-/**
- * An interface that describes the signature of a message that
- * is passed into a say/tell API request.
- */
-// tslint:disable-next-line:interface-name
-export interface IRawMessage {
-    /**
-     * A list of text objects used to build a message.
-     */
-    rawtext?: IRawMessage[] | string[];
-    /**
-     * Contains plain text to display directly. Only valid when
-     * used as a sub member in a parent _rawtext_ or _with_ member.
-     */
-    text?: string;
-    /**
-     * Contains a resource pack translation identifier that can be
-     * used to translate text in the player's selected language.
-     */
-    translate?: string;
-    /**
-     * A list of text object arguments that can be used to fill
-     * values in the _translate_ text. Ignored when _translate_ is
-     * not present.
-     */
-    with?: IRawMessage[] | string[];
-}
 /**
  * Additional configuration options for {@link
  * World.playMusic}/{@link World.queueMusic} methods.
@@ -14510,6 +14463,12 @@ export interface MusicOptions {
      */
     volume?: number;
 }
+export interface RawMessage {
+    rawtext?: RawMessage[] | string[];
+    text?: string;
+    translate?: string;
+    with?: RawMessage[] | string[];
+}
 /**
  * Contains additional options for how a scoreboard should be
  * displayed within its display slot.

package/package.json

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