@minecraft/server-gametest 1.0.0-beta.1.21.30-preview.21 → 1.0.0-beta.1.21.30-preview.23

package/index.d.ts

@@ -24,6 +24,9 @@
  */
 import * as minecraftcommon from '@minecraft/common';
 import * as minecraftserver from '@minecraft/server';
+/**
+ * @beta
+ */
 export enum GameTestErrorType {
     Assert = 'Assert',
     AssertAtPosition = 'AssertAtPosition',
@@ -37,6 +40,9 @@ export enum GameTestErrorType {
     Waiting = 'Waiting',
 }
 
+/**
+ * @beta
+ */
 export enum LookDuration {
     Continuous = 'Continuous',
     Instant = 'Instant',
@@ -44,6 +50,7 @@ export enum LookDuration {
 }
 
 /**
+ * @beta
  * Returns information about whether this fence is connected to
  * other fences in several directions.
  */
@@ -80,6 +87,7 @@ export class FenceConnectivity {
 }
 
 /**
+ * @beta
  * Executes a set of steps defined via chained .thenXyz
  * methods, sequentially. This facilitates a 'script' of
  * GameTest setup methods and assertions over time.
@@ -203,6 +211,9 @@ export class GameTestSequence {
     thenWaitAfter(delayTicks: number, callback: () => void): GameTestSequence;
 }
 
+/**
+ * @beta
+ */
 export class NavigationResult {
     private constructor();
     readonly isFullPath: boolean;
@@ -210,6 +221,7 @@ export class NavigationResult {
 }
 
 /**
+ * @beta
  * A utility class to set GameTest parameters for a test.
  * Methods can be chained together to set multiple properties.
  */
@@ -343,6 +355,7 @@ export class RegistrationBuilder {
 }
 
 /**
+ * @beta
  * Implements a class that can be used for testing sculk
  * spreading behaviors. This sculk spreader class can drive the
  * growth of sculk around a particular block.
@@ -408,6 +421,7 @@ export class SculkSpreader {
 export class SimulatedPlayer extends minecraftserver.Player {
     private constructor();
     /**
+     * @beta
      * @remarks
      * Rotation of the head across pitch and yaw angles.
      *
@@ -415,6 +429,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     readonly headRotation: minecraftserver.Vector2;
     /**
+     * @beta
      * @remarks
      * Returns whether the simulated player is sprinting.
      *
@@ -423,6 +438,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     isSprinting: boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to make an attack 'swipe'.
      * Returns true if the attack was performed - for example, the
@@ -435,6 +451,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     attack(): boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to attack the provided target.
      * Returns true if the attack was performed - for example, the
@@ -448,6 +465,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     attackEntity(entity: minecraftserver.Entity): boolean;
     /**
+     * @beta
      * @remarks
      * Destroys the block at blockLocation, respecting the rules of
      * the server player's game mode. The block will be hit until
@@ -464,6 +482,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     breakBlock(blockLocation: minecraftserver.Vector3, direction?: minecraftserver.Direction): boolean;
     /**
+     * @beta
      * @remarks
      * This function can't be called in read-only mode.
      *
@@ -471,6 +490,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     chat(message: string): void;
     /**
+     * @beta
      * @remarks
      * Simulates and performs a disconnection of the simulated
      * player from the world.
@@ -481,6 +501,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     disconnect(): void;
     /**
+     * @beta
      * @remarks
      * Drops the simulated player's selected item
      *
@@ -490,6 +511,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     dropSelectedItem(): boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to start flying as though they
      * were flying in creative mode. For flying with Elytra, see
@@ -501,6 +523,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     fly(): void;
     /**
+     * @beta
      * @remarks
      * Gives the simulated player a particular item stack.
      *
@@ -514,6 +537,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     giveItem(itemStack: minecraftserver.ItemStack, selectSlot?: boolean): boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to start gliding. Elytra must be
      * equipped and the player must be in the air.
@@ -529,6 +553,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     glide(): boolean;
     /**
+     * @beta
      * @remarks
      * Performs a raycast from the player’s head and interacts with
      * the first intersected block or entity. Returns true if the
@@ -540,6 +565,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     interact(): boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to interact with a block. The
      * block at the specified block location must be solid. Returns
@@ -555,6 +581,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     interactWithBlock(blockLocation: minecraftserver.Vector3, direction?: minecraftserver.Direction): boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to interact with a mob. Returns
      * true if the interaction was performed.
@@ -567,6 +594,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     interactWithEntity(entity: minecraftserver.Entity): boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to jump.
      *
@@ -578,6 +606,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     jump(): boolean;
     /**
+     * @beta
      * @remarks
      * Rotates the simulated player's head/body to look at the
      * given block location.
@@ -588,6 +617,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     lookAtBlock(blockLocation: minecraftserver.Vector3, duration?: LookDuration): void;
     /**
+     * @beta
      * @remarks
      * Rotates the simulated player's head/body to look at the
      * given entity.
@@ -598,6 +628,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     lookAtEntity(entity: minecraftserver.Entity, duration?: LookDuration): void;
     /**
+     * @beta
      * @remarks
      * Rotates the simulated player's head/body to look at the
      * given location.
@@ -608,6 +639,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     lookAtLocation(location: minecraftserver.Vector3, duration?: LookDuration): void;
     /**
+     * @beta
      * @remarks
      * Orders the simulated player to walk in the given direction
      * relative to the GameTest.
@@ -618,6 +650,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     move(westEast: number, northSouth: number, speed?: number): void;
     /**
+     * @beta
      * @remarks
      * Orders the simulated player to walk in the given direction
      * relative to the player's current rotation.
@@ -628,6 +661,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     moveRelative(leftRight: number, backwardForward: number, speed?: number): void;
     /**
+     * @beta
      * @remarks
      * Orders the simulated player to move to the given block
      * location in a straight line. If a move or navigation is
@@ -640,6 +674,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     moveToBlock(blockLocation: minecraftserver.Vector3, options?: MoveToOptions): void;
     /**
+     * @beta
      * @remarks
      * Orders the simulated player to move to the given location in
      * a straight line. If a move or navigation is already playing,
@@ -651,6 +686,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     moveToLocation(location: minecraftserver.Vector3, options?: MoveToOptions): void;
     /**
+     * @beta
      * @remarks
      * Orders the simulated player to move to a specific block
      * location using navigation. If a move or navigation is
@@ -665,6 +701,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     navigateToBlock(blockLocation: minecraftserver.Vector3, speed?: number): NavigationResult;
     /**
+     * @beta
      * @remarks
      * Will use navigation to follow the selected entity to within
      * a one block radius. If a move or navigation is already
@@ -676,6 +713,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     navigateToEntity(entity: minecraftserver.Entity, speed?: number): NavigationResult;
     /**
+     * @beta
      * @remarks
      * Orders the simulated player to move to a specific location
      * using navigation. If a move or navigation is already
@@ -690,6 +728,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     navigateToLocation(location: minecraftserver.Vector3, speed?: number): NavigationResult;
     /**
+     * @beta
      * @remarks
      * Use navigation to follow the route provided via the
      * locations parameter. If a move or navigation is already
@@ -705,6 +744,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     navigateToLocations(locations: minecraftserver.Vector3[], speed?: number): void;
     /**
+     * @beta
      * @remarks
      * Respawns the particular simulated player.
      *
@@ -714,6 +754,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     respawn(): boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to turn by the provided angle,
      * relative to the player's current rotation.
@@ -724,6 +765,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     rotateBody(angleInDegrees: number): void;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to turn to face the provided
      * angle, relative to the GameTest.
@@ -734,6 +776,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     setBodyRotation(angleInDegrees: number): void;
     /**
+     * @beta
      * @remarks
      * Sets a particular item for the simulated player.
      *
@@ -749,6 +792,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     setItem(itemStack: minecraftserver.ItemStack, slot: number, selectSlot?: boolean): boolean;
     /**
+     * @beta
      * @remarks
      * This function can't be called in read-only mode.
      *
@@ -756,6 +800,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     startBuild(slot?: number): void;
     /**
+     * @beta
      * @remarks
      * Stops destroying the block that is currently being hit.
      *
@@ -765,6 +810,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     stopBreakingBlock(): void;
     /**
+     * @beta
      * @remarks
      * This function can't be called in read-only mode.
      *
@@ -772,6 +818,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     stopBuild(): void;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to stop flying.
      *
@@ -781,6 +828,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     stopFlying(): void;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to stop gliding.
      *
@@ -790,6 +838,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     stopGliding(): void;
     /**
+     * @beta
      * @remarks
      * Stops interacting with entities or blocks.
      *
@@ -799,6 +848,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     stopInteracting(): void;
     /**
+     * @beta
      * @remarks
      * Stops moving/walking/following if the simulated player is
      * moving.
@@ -809,6 +859,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     stopMoving(): void;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to stop swimming.
      *
@@ -818,6 +869,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     stopSwimming(): void;
     /**
+     * @beta
      * @remarks
      * Stops using the currently active item.
      *
@@ -830,6 +882,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     stopUsingItem(): minecraftserver.ItemStack | undefined;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to start swimming.
      *
@@ -839,6 +892,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     swim(): void;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to use an item. Does not consume
      * the item. Returns false if the item is on cooldown.
@@ -851,6 +905,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     useItem(itemStack: minecraftserver.ItemStack): boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to hold and use an item in their
      * inventory.
@@ -863,6 +918,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      */
     useItemInSlot(slot: number): boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to use an item in their
      * inventory on a block. The block at the specified block
@@ -888,6 +944,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
         faceLocation?: minecraftserver.Vector3,
     ): boolean;
     /**
+     * @beta
      * @remarks
      * Causes the simulated player to use an item on a block. The
      * block at the specified block location must be solid. Returns
@@ -915,6 +972,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
 }
 
 /**
+ * @beta
  * These well-known tags can be used to classify different
  * tests into suites to run.
  */
@@ -952,6 +1010,7 @@ export class Tags {
 }
 
 /**
+ * @beta
  * Main class for GameTest functions, with helpers and data for
  * manipulating the respective test. Note that all methods of
  * this class expect BlockLocations and Locations relative to
@@ -2222,17 +2281,26 @@ export class Test {
     worldLocation(relativeLocation: minecraftserver.Vector3): minecraftserver.Vector3;
 }
 
+/**
+ * @beta
+ */
 export interface GameTestErrorContext {
     absolutePosition: minecraftserver.Vector3;
     relativePosition: minecraftserver.Vector3;
     tickCount: number;
 }
 
+/**
+ * @beta
+ */
 export interface MoveToOptions {
     faceTarget?: boolean;
     speed?: number;
 }
 
+/**
+ * @beta
+ */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class GameTestError extends Error {
     private constructor();
@@ -2242,6 +2310,7 @@ export class GameTestError extends Error {
 }
 
 /**
+ * @beta
  * @remarks
  * Registers a new GameTest function. This GameTest will become
  * available in Minecraft via /gametest run
@@ -2287,6 +2356,7 @@ export function register(
     testFunction: (arg: Test) => void,
 ): RegistrationBuilder;
 /**
+ * @beta
  * @remarks
  * Registers a new GameTest function that is designed for
  * asynchronous execution. This GameTest will become available

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server-gametest",
-  "version": "1.0.0-beta.1.21.30-preview.21",
+  "version": "1.0.0-beta.1.21.30-preview.23",
   "description": "",
   "contributors": [
     {