@minecraft/server 1.1.0-rc.1.20.0-preview.22 → 1.1.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.
    ***************************************************************************** */
 /**
- * @beta
  * @packageDocumentation
  * Contains many types related to manipulating a Minecraft
  * world, including entities, blocks, dimensions, and more.
@@ -16,18 +15,16 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "1.3.0-internal.1.20.0-preview.22"
+ *   "version": "1.1.0"
  * }
  * ```
  *
  */
 /**
- * @beta
  * Represents a game mode for the current world experience.
  */
 export enum GameMode {
     /**
-     * @beta
      * @remarks
      * World is in a more locked-down experience, where blocks may
      * not be manipulated.
@@ -35,7 +32,6 @@ export enum GameMode {
      */
     adventure = 'adventure',
     /**
-     * @beta
      * @remarks
      * World is in a full creative mode. In creative mode, the
      * player has all the resources available in the item selection
@@ -49,7 +45,6 @@ export enum GameMode {
     creative = 'creative',
     spectator = 'spectator',
     /**
-     * @beta
      * @remarks
      * World is in a survival mode, where players can take damage
      * and entities may not be peaceful. Survival mode is where the
@@ -62,7 +57,6 @@ export enum GameMode {
 }
 
 /**
- * @beta
  * Represents a block in a dimension. A block represents a
  * unique X, Y, and Z within a dimension and get/sets the state
  * of the block at that location. This type was significantly
@@ -125,7 +119,6 @@ export class Block {
 }
 
 /**
- * @beta
  * Contains the combination of type {@link BlockType} and
  * properties (also sometimes called block state) which
  * describe a block (but does not belong to a specific {@link
@@ -139,21 +132,27 @@ export class BlockPermutation {
      * this permutation. If states is not specified, matches checks
      * against the set of types more broadly.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param blockName
      * An optional set of states to compare against.
      */
-    matches(blockName: string, states?: Record<string, boolean | number | string>): boolean;
+    matches(blockName: string, properties?: Record<string, boolean | number | string>): boolean;
     /**
      * @remarks
      * Given a type identifier and an optional set of properties,
      * will return a BlockPermutation object that is usable in
      * other block APIs (e.g., block.setPermutation)
      *
+     * This function can't be called in read-only mode.
+     *
      * @param blockName
      * Identifier of the block to check.
+     * @param properties
+     * Optional additional set of properties to check against.
      * @throws This function can throw errors.
      */
-    static resolve(blockName: string, states?: Record<string, boolean | number | string>): BlockPermutation;
+    static resolve(blockName: string, properties?: Record<string, boolean | number | string>): BlockPermutation;
 }
 
 /**
@@ -185,24 +184,26 @@ export class Dimension {
      */
     readonly id: string;
     /**
-     * @beta
      * @remarks
      * Returns a block instance at the given location. This method
      * was introduced as of version 1.17.10.21.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param location
      * The location at which to return a block.
      * @returns
      * Block at the specified location.
      * @throws This function can throw errors.
      */
-    getBlock(location: Vector3): Block | undefined;
+    getBlock(location: Vector3): Block;
     /**
-     * @beta
      * @remarks
      * Returns a set of entities based on a set of conditions
      * defined via the EntityQueryOptions set of filter criteria.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param options
      * Additional options that can be used to filter the set of
      * entities returned.
@@ -231,10 +232,11 @@ export class Dimension {
      */
     getEntities(options?: EntityQueryOptions): Entity[];
     /**
-     * @beta
      * @remarks
      * Returns a set of entities at a particular location.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param location
      * The location at which to return entities.
      * @returns
@@ -242,11 +244,12 @@ export class Dimension {
      */
     getEntitiesAtBlockLocation(location: Vector3): Entity[];
     /**
-     * @beta
      * @remarks
      * Returns a set of players based on a set of conditions
      * defined via the EntityQueryOptions set of filter criteria.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param options
      * Additional options that can be used to filter the set of
      * players returned.
@@ -262,6 +265,8 @@ export class Dimension {
      * of 128 asynchronous commands that can be run in a given
      * tick.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param commandString
      * Command to run. Note that command strings should not start
      * with slash.
@@ -280,7 +285,6 @@ export class Dimension {
 export class Entity {
     protected constructor();
     /**
-     * @beta
      * @remarks
      * Dimension that the entity is currently within.
      *
@@ -298,7 +302,6 @@ export class Entity {
      */
     readonly id: string;
     /**
-     * @beta
      * @remarks
      * Current location of the entity.
      *
@@ -306,7 +309,6 @@ export class Entity {
      */
     readonly location: Vector3;
     /**
-     * @beta
      * @remarks
      * Given name of the entity.
      *
@@ -323,27 +325,30 @@ export class Entity {
      */
     readonly typeId: string;
     /**
-     * @beta
      * @remarks
      * Returns the current location of the head component of this
      * entity.
      *
+     * This function can't be called in read-only mode.
+     *
      * @throws This function can throw errors.
      */
     getHeadLocation(): Vector3;
     /**
-     * @beta
      * @remarks
      * Returns the current velocity vector of the entity.
      *
+     * This function can't be called in read-only mode.
+     *
      * @throws This function can throw errors.
      */
     getVelocity(): Vector3;
     /**
-     * @beta
      * @remarks
      * Returns the current view direction of the entity.
      *
+     * This function can't be called in read-only mode.
+     *
      * @throws This function can throw errors.
      */
     getViewDirection(): Vector3;
@@ -353,6 +358,8 @@ export class Entity {
      * this entity. Note that there is a maximum queue of 128
      * asynchronous commands that can be run in a given tick.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param commandString
      * Command to run. Note that command strings should not start
      * with slash.
@@ -417,10 +424,11 @@ export class Player extends Entity {
      */
     readonly name: string;
     /**
-     * @beta
      * @remarks
      * Sends a message to the player.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param message
      * The message to be displayed.
      * @throws
@@ -467,18 +475,18 @@ export class Player extends Entity {
 export class System {
     protected constructor();
     /**
-     * @beta
      * @remarks
      * Represents the current world tick of the server.
      *
      */
     readonly currentTick: number;
     /**
-     * @beta
      * @remarks
      * Cancels the execution of a function run that was previously
      * scheduled via the `run` function.
      *
+     * This function can't be called in read-only mode.
+     *
      */
     clearRun(runId: number): void;
     /**
@@ -487,6 +495,8 @@ export class System {
      * frequently used to implement delayed behaviors and game
      * loops.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param callback
      * Function callback to run when the tickDelay time criteria is
      * met.
@@ -496,10 +506,11 @@ export class System {
      */
     run(callback: () => void): number;
     /**
-     * @beta
      * @remarks
      * Runs a set of code on an interval.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param callback
      * Functional code that will run when this interval occurs.
      * @param tickInterval
@@ -511,10 +522,11 @@ export class System {
      */
     runInterval(callback: () => void, tickInterval?: number): number;
     /**
-     * @beta
      * @remarks
      * Runs a set of code at a future time specified by tickDelay.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param callback
      * Functional code that will run when this timeout occurs.
      * @param tickDelay
@@ -537,6 +549,8 @@ export class World {
      * @remarks
      * Returns an array of all active players within the world.
      *
+     * This function can't be called in read-only mode.
+     *
      * @throws This function can throw errors.
      */
     getAllPlayers(): Player[];
@@ -544,6 +558,8 @@ export class World {
      * @remarks
      * Returns a dimension object.
      *
+     * This function can't be called in read-only mode.
+     *
      * @returns
      * The requested dimension
      * @throws
@@ -551,11 +567,12 @@ export class World {
      */
     getDimension(dimensionId: string): Dimension;
     /**
-     * @beta
      * @remarks
      * Returns a set of players based on a set of conditions
      * defined via the EntityQueryOptions set of filter criteria.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param options
      * Additional options that can be used to filter the set of
      * players returned.
@@ -565,10 +582,11 @@ export class World {
      */
     getPlayers(options?: EntityQueryOptions): Player[];
     /**
-     * @beta
      * @remarks
      * Sends a message to all players.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param message
      * The message to be displayed.
      * @throws
@@ -610,7 +628,6 @@ export class World {
 }
 
 /**
- * @beta
  * Contains options for selecting entities within an area.
  */
 export interface EntityQueryOptions {
@@ -773,7 +790,6 @@ export interface EntityQueryOptions {
 }
 
 /**
- * @beta
  * Contains additional options for filtering players based on
  * their score for an objective.
  */
@@ -807,9 +823,6 @@ export interface EntityQueryScoreOptions {
     objective?: string;
 }
 
-/**
- * @beta
- */
 export interface RawMessage {
     rawtext?: RawMessage[];
     score?: RawMessageScore;
@@ -818,16 +831,12 @@ export interface RawMessage {
     with?: string[] | RawMessage;
 }
 
-/**
- * @beta
- */
 export interface RawMessageScore {
     name?: string;
     objective?: string;
 }
 
 /**
- * @beta
  * Contains a description of a vector.
  */
 export interface Vector3 {

package/package.json

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