@minecraft/server 1.13.0-rc.1.21.30-preview.21 → 1.13.0

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

@@ -7,7 +7,6 @@
    Copyright (c) Microsoft Corporation.
    ***************************************************************************** */
 /**
- * @preview
  * @packageDocumentation
  * Contains many types related to manipulating a Minecraft
  * world, including entities, blocks, dimensions, and more.
@@ -79,9 +78,6 @@ export enum BlockPistonState {
     Retracting = 'Retracting',
 }
 
-/**
- * @rc
- */
 export enum CustomComponentNameErrorReason {
     NoNamespace = 1,
     DisallowedNamespace = 2,
@@ -325,7 +321,6 @@ export enum EntityComponentTypes {
      */
     AddRider = 'minecraft:addrider',
     /**
-     * @rc
      * @remarks
      * Adds a timer for the entity to grow up. It can be
      * accelerated by giving the entity the items it likes as
@@ -530,14 +525,12 @@ export enum EntityComponentTypes {
      */
     Item = 'minecraft:item',
     /**
-     * @rc
      * @remarks
      * Defines the base movement speed in lava of this entity.
      *
      */
     LavaMovement = 'minecraft:lava_movement',
     /**
-     * @rc
      * @remarks
      * Allows this entity to be leashed and defines the conditions
      * and events for this entity when is leashed.
@@ -553,7 +546,6 @@ export enum EntityComponentTypes {
      */
     MarkVariant = 'minecraft:mark_variant',
     /**
-     * @rc
      * @remarks
      * Defines the general movement speed of this entity.
      *
@@ -586,7 +578,6 @@ export enum EntityComponentTypes {
      */
     MovementGeneric = 'minecraft:movement.generic',
     /**
-     * @rc
      * @remarks
      * When added, this movement control allows the mob to glide.
      *
@@ -613,7 +604,6 @@ export enum EntityComponentTypes {
      */
     MovementSkip = 'minecraft:movement.skip',
     /**
-     * @rc
      * @remarks
      * When added, this move control causes the mob to sway side to
      * side giving the impression it is swimming.
@@ -713,14 +703,6 @@ export enum EntityComponentTypes {
      */
     SkinId = 'minecraft:skin_id',
     /**
-     * @rc
-     * @remarks
-     * Defines the entity's strength to carry items.
-     *
-     */
-    Strength = 'minecraft:strength',
-    /**
-     * @rc
      * @remarks
      * Defines the rules for an entity to be tamed by the player.
      *
@@ -740,7 +722,6 @@ export enum EntityComponentTypes {
      */
     TypeFamily = 'minecraft:type_family',
     /**
-     * @rc
      * @remarks
      * Defines the general movement speed underwater of this
      * entity.
@@ -1373,7 +1354,6 @@ export enum GameRule {
      */
     ShowCoordinates = 'showCoordinates',
     /**
-     * @rc
      * @remarks
      * Controls whether the days a player has played is displayed.
      *
@@ -1461,7 +1441,6 @@ export enum HudVisibility {
 }
 
 /**
- * @rc
  * Input permission categories. Used by
  * @minecraft/server.PlayerInputPermissionCategoryChangeAfterEvent
  * to specify which category was changed.
@@ -2365,7 +2344,6 @@ export class BlockComponent extends Component {
 }
 
 /**
- * @rc
  * Contains information regarding an entity falling onto a
  * specific block.
  */
@@ -2387,7 +2365,6 @@ export class BlockComponentEntityFallOnEvent extends BlockEvent {
 }
 
 /**
- * @rc
  * Contains information regarding a specific block that was
  * placed.
  */
@@ -2403,7 +2380,6 @@ export class BlockComponentOnPlaceEvent extends BlockEvent {
 }
 
 /**
- * @rc
  * Contains information regarding a specific block being
  * destroyed.
  */
@@ -2426,7 +2402,6 @@ export class BlockComponentPlayerDestroyEvent extends BlockEvent {
 }
 
 /**
- * @rc
  * Contains information regarding a specific block being
  * interacted with.
  */
@@ -2455,7 +2430,6 @@ export class BlockComponentPlayerInteractEvent extends BlockEvent {
 }
 
 /**
- * @rc
  * Contains information regarding an event before a player
  * places a block.
  */
@@ -2491,7 +2465,6 @@ export class BlockComponentPlayerPlaceBeforeEvent extends BlockEvent {
 }
 
 /**
- * @rc
  * Contains information regarding a specific block randomly
  * ticking.
  */
@@ -2500,9 +2473,6 @@ export class BlockComponentRandomTickEvent extends BlockEvent {
     private constructor();
 }
 
-/**
- * @rc
- */
 export class BlockComponentRegistry {
     private constructor();
     /**
@@ -2526,7 +2496,6 @@ export class BlockComponentRegistry {
 }
 
 /**
- * @rc
  * Contains information regarding an entity stepping off a
  * specific block.
  */
@@ -2542,7 +2511,6 @@ export class BlockComponentStepOffEvent extends BlockEvent {
 }
 
 /**
- * @rc
  * Contains information regarding an entity stepping onto a
  * specific block.
  */
@@ -2558,7 +2526,6 @@ export class BlockComponentStepOnEvent extends BlockEvent {
 }
 
 /**
- * @rc
  * Contains information regarding a specific block ticking.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -2588,7 +2555,6 @@ export class BlockEvent {
 }
 
 /**
- * @rc
  * Contains information regarding an explosion that has
  * occurred for a specific block.
  */
@@ -2610,7 +2576,6 @@ export class BlockExplodeAfterEvent extends BlockEvent {
 }
 
 /**
- * @rc
  * Manages callbacks that are connected to when an explosion
  * occurs, as it impacts individual blocks.
  */
@@ -2743,14 +2708,12 @@ export class BlockPermutation {
      */
     getState(stateName: string): boolean | number | string | undefined;
     /**
-     * @rc
      * @remarks
      * Creates a copy of the permutation.
      *
      */
     getTags(): string[];
     /**
-     * @rc
      * @remarks
      * Checks to see if the permutation has a specific tag.
      *
@@ -4270,17 +4233,9 @@ export class Dimension {
      */
     getPlayers(options?: EntityQueryOptions): Player[];
     /**
-     * @rc
      * @remarks
-     * Returns the highest block at the given XZ location.
-     *
      * This function can't be called in read-only mode.
      *
-     * @param locationXZ
-     * Location to retrieve the topmost block for.
-     * @param minHeight
-     * The Y height to begin the search from. Defaults to the
-     * maximum dimension height.
      * @throws This function can throw errors.
      */
     getTopmostBlock(locationXZ: VectorXZ, minHeight?: number): Block | undefined;
@@ -4382,7 +4337,6 @@ export class Dimension {
      */
     runCommandAsync(commandString: string): Promise<CommandResult>;
     /**
-     * @rc
      * @remarks
      * Sets a block in the world using a BlockPermutation.
      * BlockPermutations are blocks with a particular state.
@@ -4403,7 +4357,6 @@ export class Dimension {
      */
     setBlockPermutation(location: Vector3, permutation: BlockPermutation): void;
     /**
-     * @rc
      * @remarks
      * Sets a block at a given location within the dimension.
      *
@@ -4789,8 +4742,6 @@ export class EffectTypes {
      *
      * This function can't be called in read-only mode.
      *
-     * @param identifier
-     * The identifier for the effect.
      * @returns
      * Effect type for the given identifier or undefined if the
      * effect does not exist.
@@ -4849,7 +4800,6 @@ export class EnchantmentTypes {
      */
     static get(enchantmentId: string): EnchantmentType | undefined;
     /**
-     * @rc
      * @remarks
      * Returns a collection of all available enchantment types.
      *
@@ -5816,7 +5766,6 @@ export class EntityAddRiderComponent extends EntityComponent {
 }
 
 /**
- * @rc
  * Adds a timer for the entity to grow up. It can be
  * accelerated by giving the entity the items it likes as
  * defined by feedItems.
@@ -6045,7 +5994,6 @@ export class EntityComponent extends Component {
 }
 
 /**
- * @rc
  * As part of the Ageable component, represents a set of items
  * that can be fed to an entity and the rate at which that
  * causes them to grow.
@@ -6418,7 +6366,6 @@ export class EntityHitBlockAfterEvent {
      */
     readonly hitBlock: Block;
     /**
-     * @rc
      * @remarks
      * Block permutation that was hit by the attack.
      *
@@ -6793,7 +6740,6 @@ export class EntityItemComponent extends EntityComponent {
 }
 
 /**
- * @rc
  * Defines the base movement speed in lava of this entity.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -6803,7 +6749,6 @@ export class EntityLavaMovementComponent extends EntityAttributeComponent {
 }
 
 /**
- * @rc
  * Allows the entity to be leashed. Defines the conditions and
  * events for when an entity is leashed.
  */
@@ -6974,7 +6919,6 @@ export class EntityMovementBasicComponent extends EntityBaseMovementComponent {
 }
 
 /**
- * @rc
  * Defines the general movement speed of this entity.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -7003,7 +6947,6 @@ export class EntityMovementGenericComponent extends EntityBaseMovementComponent
 }
 
 /**
- * @rc
  * When added, this movement control allows the mob to glide.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -7056,7 +6999,6 @@ export class EntityMovementSkipComponent extends EntityBaseMovementComponent {
 }
 
 /**
- * @rc
  * When added, this move control causes the mob to sway side to
  * side giving the impression it is swimming.
  */
@@ -7878,35 +7820,6 @@ export class EntitySpawnAfterEventSignal {
 }
 
 /**
- * @rc
- * Defines the entity's ability to carry items. An entity with
- * a higher strength would have higher potential carry capacity
- * and more item slots.
- */
-// @ts-ignore Class inheritance allowed for native defined classes
-export class EntityStrengthComponent extends EntityComponent {
-    private constructor();
-    /**
-     * @remarks
-     * Maximum strength of this entity, as defined in the entity
-     * type definition.
-     *
-     * @throws This property can throw when used.
-     */
-    readonly max: number;
-    /**
-     * @remarks
-     * Current value of the strength component that has been set
-     * for entities.
-     *
-     * @throws This property can throw when used.
-     */
-    readonly value: number;
-    static readonly componentId = 'minecraft:strength';
-}
-
-/**
- * @rc
  * Defines the rules for an entity to be tamed by the player.
  */
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -7974,7 +7887,6 @@ export class EntityTameableComponent extends EntityComponent {
 export class EntityTameMountComponent extends EntityComponent {
     private constructor();
     /**
-     * @rc
      * @remarks
      * Returns true if the entity is tamed.
      *
@@ -7982,7 +7894,6 @@ export class EntityTameMountComponent extends EntityComponent {
      */
     readonly isTamed: boolean;
     /**
-     * @rc
      * @remarks
      * Returns true if the entity is tamed by a player.
      *
@@ -7990,7 +7901,6 @@ export class EntityTameMountComponent extends EntityComponent {
      */
     readonly isTamedToPlayer: boolean;
     /**
-     * @rc
      * @remarks
      * Returns the player that has tamed the entity, or 'undefined'
      * if entity is not tamed by a player.
@@ -7999,7 +7909,6 @@ export class EntityTameMountComponent extends EntityComponent {
      */
     readonly tamedToPlayer?: Player;
     /**
-     * @rc
      * @remarks
      * Returns the id of player that has tamed the entity, or
      * 'undefined' if entity is not tamed.
@@ -8020,7 +7929,6 @@ export class EntityTameMountComponent extends EntityComponent {
      */
     tame(showParticles: boolean): void;
     /**
-     * @rc
      * @remarks
      * Sets this rideable entity as tamed by the given player.
      *
@@ -8086,7 +7994,6 @@ export class EntityTypes {
 }
 
 /**
- * @rc
  * Defines the general movement speed underwater of this
  * entity.
  */
@@ -8528,7 +8435,6 @@ export class GameRules {
      */
     showCoordinates: boolean;
     /**
-     * @rc
      * @remarks
      * This property can't be edited in read-only mode.
      *
@@ -8746,7 +8652,6 @@ export class ItemCompleteUseAfterEventSignal {
 }
 
 /**
- * @rc
  * Contains information related to a chargeable item completing
  * being charged.
  */
@@ -8775,7 +8680,6 @@ export class ItemComponent extends Component {
 }
 
 /**
- * @rc
  * Contains information regarding an item before it is damaged
  * from hitting an entity.
  */
@@ -8809,7 +8713,6 @@ export class ItemComponentBeforeDurabilityDamageEvent {
 }
 
 /**
- * @rc
  * Contains information related to a chargeable item completing
  * being charged via a component.
  */
@@ -8819,7 +8722,6 @@ export class ItemComponentCompleteUseEvent extends ItemCompleteUseEvent {
 }
 
 /**
- * @rc
  * Contains information related to a food item being consumed.
  */
 export class ItemComponentConsumeEvent {
@@ -8839,7 +8741,6 @@ export class ItemComponentConsumeEvent {
 }
 
 /**
- * @rc
  * Contains information regarding when an item is used to hit
  * an entity.
  */
@@ -8872,7 +8773,6 @@ export class ItemComponentHitEntityEvent {
 }
 
 /**
- * @rc
  * Contains information regarding the mining of a block using
  * an item.
  */
@@ -8905,7 +8805,6 @@ export class ItemComponentMineBlockEvent {
 }
 
 /**
- * @rc
  * Provides the functionality for registering custom components
  * for items.
  */
@@ -8944,7 +8843,6 @@ export class ItemComponentRegistry {
 }
 
 /**
- * @rc
  * Contains information regarding the use of an item.
  */
 export class ItemComponentUseEvent {
@@ -8964,7 +8862,6 @@ export class ItemComponentUseEvent {
 }
 
 /**
- * @rc
  * Contains information regarding the use of an item on a block
  * via a component.
  */
@@ -10067,7 +9964,6 @@ export class ItemType {
 }
 
 /**
- * @rc
  * Returns the set of item types registered within Minecraft.
  */
 export class ItemTypes {
@@ -10276,7 +10172,6 @@ export class ItemUseOnBeforeEventSignal {
 }
 
 /**
- * @rc
  * Contains information regarding the use of an item on a
  * block.
  */
@@ -10584,7 +10479,6 @@ export class Player extends Entity {
      */
     readonly camera: Camera;
     /**
-     * @rc
      * @remarks
      * Input permissions of the player.
      *
@@ -11166,7 +11060,6 @@ export class PlayerGameModeChangeBeforeEventSignal {
 }
 
 /**
- * @rc
  * Contains information regarding an event after a players
  * input permissions change.
  */
@@ -11193,7 +11086,6 @@ export class PlayerInputPermissionCategoryChangeAfterEvent {
 }
 
 /**
- * @rc
  * Manages callbacks that are connected to after a players
  * input permissions change.
  */
@@ -11222,7 +11114,6 @@ export class PlayerInputPermissionCategoryChangeAfterEventSignal {
 }
 
 /**
- * @rc
  * Contains properties for enabling/disabling player input
  * permissions.
  */
@@ -11246,7 +11137,7 @@ export class PlayerInputPermissions {
 
 /**
  * Contains information regarding an event after a player
- * successfully interacts with a block.
+ * interacts with a block.
  */
 export class PlayerInteractWithBlockAfterEvent {
     private constructor();
@@ -11271,8 +11162,8 @@ export class PlayerInteractWithBlockAfterEvent {
     readonly faceLocation: Vector3;
     /**
      * @remarks
-     * The ItemStack after the interaction succeeded, or undefined
-     * if hand is empty.
+     * The item stack that is being used in the interaction, or
+     * undefined if empty hand.
      *
      */
     readonly itemStack?: ItemStack;
@@ -11388,14 +11279,14 @@ export class PlayerInteractWithBlockBeforeEventSignal {
 
 /**
  * Contains information regarding an event after a player
- * successfully interacts with an entity.
+ * interacts with an entity.
  */
 export class PlayerInteractWithEntityAfterEvent {
     private constructor();
     /**
      * @remarks
-     * The ItemStack after the interaction succeeded, or undefined
-     * if hand is empty.
+     * The item stack that is being used in the interaction, or
+     * undefined if empty hand.
      *
      */
     readonly itemStack?: ItemStack;
@@ -12759,7 +12650,6 @@ export class System {
      */
     readonly currentTick: number;
     /**
-     * @rc
      * @remarks
      * Cancels the execution of a job queued via {@link
      * System.runJob}.
@@ -12837,7 +12727,6 @@ export class System {
      */
     runInterval(callback: () => void, tickInterval?: number): number;
     /**
-     * @rc
      * @remarks
      * Queues a generator to run until completion.  The generator
      * will be given a time slice each tick, and will be run until
@@ -12895,7 +12784,6 @@ export class System {
      */
     runTimeout(callback: () => void, tickDelay?: number): number;
     /**
-     * @rc
      * @throws This function can throw errors.
      *
      * {@link minecraftcommon.EngineError}
@@ -12979,7 +12867,6 @@ export class TargetBlockHitAfterEventSignal {
 }
 
 /**
- * @rc
  * Represents a trigger for firing an event.
  */
 export class Trigger {
@@ -13731,7 +13618,6 @@ export class World {
 export class WorldAfterEvents {
     private constructor();
     /**
-     * @rc
      * @remarks
      * This event fires for each BlockLocation destroyed by an
      * explosion. It is fired after the blocks have already been
@@ -13907,7 +13793,6 @@ export class WorldAfterEvents {
     readonly playerDimensionChange: PlayerDimensionChangeAfterEventSignal;
     readonly playerGameModeChange: PlayerGameModeChangeAfterEventSignal;
     /**
-     * @rc
      * @remarks
      * This event fires when a players input permissions change.
      *
@@ -14053,7 +13938,6 @@ export class WorldBeforeEvents {
     readonly playerLeave: PlayerLeaveBeforeEventSignal;
     readonly weatherChange: WeatherChangeBeforeEventSignal;
     /**
-     * @rc
      * @remarks
      * This event fires immediately when the script environment is
      * initialized on a World. Not all script functionality may be
@@ -14100,7 +13984,6 @@ export class WorldInitializeAfterEventSignal {
 }
 
 /**
- * @rc
  * Contains information and methods that can be used at the
  * initialization of the scripting environment for a World.
  * Also, use the supplied blockRegistry object to register
@@ -14120,7 +14003,6 @@ export class WorldInitializeBeforeEvent {
 }
 
 /**
- * @rc
  * Manages callbacks that are run at the initialization of the
  * scripting environment for a World. Do note that this event
  * may run multiple times within a session in the case that the
@@ -14149,7 +14031,6 @@ export class WorldInitializeBeforeEventSignal {
 }
 
 /**
- * @rc
  * Contains a set of events that will be raised for a block.
  * This object must be bound using the BlockRegistry.
  */
@@ -15071,7 +14952,6 @@ export interface EntityRaycastHit {
 // @ts-ignore Class inheritance allowed for native defined classes
 export interface EntityRaycastOptions extends EntityFilter {
     /**
-     * @rc
      * @remarks
      * If true, blocks will not be considered as blocks that 'stop'
      * the raycast.
@@ -15079,7 +14959,6 @@ export interface EntityRaycastOptions extends EntityFilter {
      */
     ignoreBlockCollision?: boolean;
     /**
-     * @rc
      * @remarks
      * If true, liquid blocks will be considered as blocks that
      * 'stop' the raycast.
@@ -15087,7 +14966,6 @@ export interface EntityRaycastOptions extends EntityFilter {
      */
     includeLiquidBlocks?: boolean;
     /**
-     * @rc
      * @remarks
      * If true, passable blocks like vines and flowers will be
      * considered as blocks that 'stop' the raycast.
@@ -15152,7 +15030,6 @@ export interface ExplosionOptions {
 }
 
 /**
- * @rc
  * Contains a set of events that will be raised for an item.
  * This object must be bound using the ItemComponentRegistry.
  */
@@ -15764,9 +15641,6 @@ export interface Vector3 {
     z: number;
 }
 
-/**
- * @rc
- */
 export interface VectorXZ {
     x: number;
     z: number;
@@ -15790,33 +15664,21 @@ export interface WorldSoundOptions {
     volume?: number;
 }
 
-/**
- * @rc
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class BlockCustomComponentAlreadyRegisteredError extends Error {
     private constructor();
 }
 
-/**
- * @rc
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class BlockCustomComponentReloadNewComponentError extends Error {
     private constructor();
 }
 
-/**
- * @rc
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class BlockCustomComponentReloadNewEventError extends Error {
     private constructor();
 }
 
-/**
- * @rc
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class BlockCustomComponentReloadVersionError extends Error {
     private constructor();
@@ -15827,17 +15689,11 @@ export class CommandError extends Error {
     private constructor();
 }
 
-/**
- * @rc
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class CustomComponentInvalidRegistryError extends Error {
     private constructor();
 }
 
-/**
- * @rc
- */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class CustomComponentNameError extends Error {
     private constructor();
@@ -15878,7 +15734,6 @@ export class InvalidStructureError extends Error {
 }
 
 /**
- * @rc
  * Thrown when trying to register an item custom component with
  * a name that has already been registered.
  */
@@ -15888,7 +15743,6 @@ export class ItemCustomComponentAlreadyRegisteredError extends Error {
 }
 
 /**
- * @rc
  * Thrown after using the /reload command when trying to
  * register a previously unregistered item custom component.
  */
@@ -15898,7 +15752,6 @@ export class ItemCustomComponentReloadNewComponentError extends Error {
 }
 
 /**
- * @rc
  * Thrown after using the /reload command when trying to
  * register a previously registered item custom component that
  * handles a new event.
@@ -15909,7 +15762,6 @@ export class ItemCustomComponentReloadNewEventError extends Error {
 }
 
 /**
- * @rc
  * Thrown after using the /reload command when trying to
  * register a previously registered item custom component with
  * a newer API version.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "1.13.0-rc.1.21.30-preview.21",
+  "version": "1.13.0",
   "description": "",
   "contributors": [
     {