@minecraft/server 1.1.0-beta.preview.1.19.60.20 → 1.1.0-beta.release.1.19.50

package/README.md

@@ -2,8 +2,6 @@
 
 Contains many types related to manipulating a Minecraft world, including entities, blocks, dimensions, and more.
 
-## **NOTE: This version of this module is still in pre-release.  It may change or it may be removed in future releases.**
-
 See full documentation for this module here:
 
 https://learn.microsoft.com/en-us/minecraft/creator/scriptapi/@minecraft/server/@minecraft/server

package/index.d.ts

@@ -15,7 +15,7 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "1.1.0-internal.preview.1.19.60.20"
+ *   "version": "1.0.0"
  * }
  * ```
  *
@@ -984,8 +984,6 @@ 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
@@ -1002,7 +1000,6 @@ export class BlockInventoryComponentContainer extends Container {
      * ```
      */
     getItem(slot: number): ItemStack;
-    getSlot(slot: number): ContainerSlot;
     /**
      * @remarks
      * Sets an item stack within a particular slot.
@@ -1012,7 +1009,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.
@@ -2300,8 +2297,6 @@ 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
@@ -2322,7 +2317,6 @@ export class Container {
      * ```
      */
     getItem(slot: number): ItemStack;
-    getSlot(slot: number): ContainerSlot;
     /**
      * @remarks
      * Sets an item stack within a particular slot.
@@ -2332,7 +2326,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.
@@ -2370,19 +2364,6 @@ 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
@@ -2996,7 +2977,11 @@ export class Entity {
      * @throws This property can throw when used.
      */
     readonly velocity: Vector;
-    readonly viewDirection: Vector3;
+    /**
+     * Vector of the current view of the entity.
+     * @throws This property can throw when used.
+     */
+    readonly viewVector: Vector;
     /**
      * @remarks
      * Adds an effect, like poison, to the entity.
@@ -3045,7 +3030,15 @@ export class Entity {
      * @throws This function can throw errors.
      */
     addTag(tag: string): boolean;
-    getBlockFromViewDirection(options?: BlockRaycastOptions): Block;
+    /**
+     * @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;
     /**
      * @remarks
      * Gets a component (that represents additional capabilities)
@@ -3084,7 +3077,15 @@ export class Entity {
      * @throws This function can throw errors.
      */
     getEffect(effectType: EffectType): Effect;
-    getEntitiesFromViewDirection(options?: EntityRaycastOptions): Entity[];
+    /**
+     * @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[];
     /**
      * @remarks
      * Returns all tags associated with an entity.
@@ -3437,6 +3438,60 @@ 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
@@ -5392,15 +5447,6 @@ 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.
  */
@@ -5682,6 +5728,10 @@ 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.
@@ -5691,7 +5741,6 @@ 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.
      */
@@ -5761,7 +5810,6 @@ 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.
      */
@@ -5970,8 +6018,6 @@ 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
@@ -5988,7 +6034,6 @@ export class InventoryComponentContainer extends Container {
      * ```
      */
     getItem(slot: number): ItemStack;
-    getSlot(slot: number): ContainerSlot;
     /**
      * @remarks
      * Sets an item stack within a particular slot.
@@ -5998,7 +6043,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.
@@ -6883,7 +6928,6 @@ 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;
@@ -9465,7 +9509,6 @@ 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.
      */
@@ -11016,7 +11059,6 @@ export class MinecraftItemTypes {
      * Minecraft.
      */
     static readonly enderChest: ItemType;
-    static readonly enderDragonSpawnEgg: ItemType;
     static readonly enderEye: ItemType;
     static readonly endermanSpawnEgg: ItemType;
     static readonly endermiteSpawnEgg: ItemType;
@@ -11302,7 +11344,6 @@ export class MinecraftItemTypes {
      * Minecraft.
      */
     static readonly ironDoor: ItemType;
-    static readonly ironGolemSpawnEgg: ItemType;
     static readonly ironHelmet: ItemType;
     static readonly ironHoe: ItemType;
     static readonly ironHorseArmor: ItemType;
@@ -12184,7 +12225,6 @@ 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.
@@ -12686,7 +12726,6 @@ 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
@@ -12964,7 +13003,11 @@ export class Player extends Entity {
      * @throws This property can throw when used.
      */
     readonly velocity: Vector;
-    readonly viewDirection: Vector3;
+    /**
+     * Vector of the current view of the player.
+     * @throws This property can throw when used.
+     */
+    readonly viewVector: Vector;
     /**
      * @remarks
      * Adds an effect, like poison, to the entity.
@@ -12986,7 +13029,15 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     addTag(tag: string): boolean;
-    getBlockFromViewDirection(options?: BlockRaycastOptions): Block;
+    /**
+     * @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;
     /**
      * @remarks
      * Gets a component (that represents additional capabilities)
@@ -13025,7 +13076,15 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     getEffect(effectType: EffectType): Effect;
-    getEntitiesFromViewDirection(options?: EntityRaycastOptions): Entity[];
+    /**
+     * @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[];
     /**
      * @remarks
      * Gets the current item cooldown time for a particular
@@ -13187,7 +13246,7 @@ export class Player extends Entity {
      * @param message
      * @throws This function can throw errors.
      */
-    tell(message: RawMessage | string): void;
+    tell(message: IRawMessage | string): void;
     /**
      * @remarks
      * Triggers an entity type event. For every entity, a number of
@@ -13228,8 +13287,6 @@ 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
@@ -13240,7 +13297,6 @@ 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.
@@ -13250,7 +13306,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.
@@ -13299,8 +13355,10 @@ export class PlayerIterator implements Iterable<Player> {
  */
 export class PlayerJoinEvent {
     protected constructor();
-    readonly playerId: string;
-    readonly playerName: string;
+    /**
+     * Player that has joined the world.
+     */
+    player: Player;
 }
 /**
  * Manages callbacks that are connected to a player joining the
@@ -13330,7 +13388,6 @@ export class PlayerJoinEventSignal {
  */
 export class PlayerLeaveEvent {
     protected constructor();
-    readonly playerId: string;
     /**
      * Player that has left the world.
      */
@@ -13358,16 +13415,6 @@ 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.
@@ -14116,7 +14163,7 @@ export class World {
      * @param message
      * @throws This function can throw errors.
      */
-    say(message: RawMessage | string): void;
+    say(message: IRawMessage | string): void;
     /**
      * @remarks
      * Sets a specified property to a value.
@@ -14445,6 +14492,33 @@ 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.
@@ -14463,12 +14537,6 @@ 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.60.20",
+  "version": "1.1.0-beta.release.1.19.50",
   "description": "",
   "contributors": [
     {