@minecraft/server-gametest 1.0.0-beta.1.21.95-stable → 1.0.0-beta.1.26.0-preview.24

package/README.md

@@ -1,9 +1,9 @@
-# `@minecraft/server-gametest`
-
-The @minecraft/server-gametest module provides scriptable APIs for scaffolding and testing content experiences in Minecraft.
-
-## **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:
-
+# `@minecraft/server-gametest`
+
+The @minecraft/server-gametest module provides scriptable APIs for scaffolding and testing content experiences in Minecraft.
+
+## **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-gametest/minecraft-server-gametest

package/index.d.ts

@@ -24,6 +24,11 @@
  */
 import * as minecraftcommon from '@minecraft/common';
 import * as minecraftserver from '@minecraft/server';
+export enum GameTestCompletedErrorReason {
+    Cleanup = 'Cleanup',
+    Done = 'Done',
+}
+
 export enum GameTestErrorType {
     Assert = 'Assert',
     AssertAtPosition = 'AssertAtPosition',
@@ -43,6 +48,39 @@ export enum LookDuration {
     UntilMove = 'UntilMove',
 }
 
+export enum PersonaArmSize {
+    Slim = 'Slim',
+    Wide = 'Wide',
+}
+
+export enum PersonaPieceType {
+    Arms = 'Arms',
+    Back = 'Back',
+    Body = 'Body',
+    Bottom = 'Bottom',
+    Capes = 'Capes',
+    Dress = 'Dress',
+    Eyes = 'Eyes',
+    FaceAccessory = 'FaceAccessory',
+    FacialHair = 'FacialHair',
+    Feet = 'Feet',
+    Hair = 'Hair',
+    Hands = 'Hands',
+    Head = 'Head',
+    HighPants = 'HighPants',
+    Hood = 'Hood',
+    LeftArm = 'LeftArm',
+    LeftLeg = 'LeftLeg',
+    Legs = 'Legs',
+    Mouth = 'Mouth',
+    Outerwear = 'Outerwear',
+    RightArm = 'RightArm',
+    RightLeg = 'RightLeg',
+    Skeleton = 'Skeleton',
+    Skin = 'Skin',
+    Top = 'Top',
+}
+
 /**
  * Returns information about whether this fence is connected to
  * other fences in several directions.
@@ -537,6 +575,10 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Direction to place the specified item within.
      * Defaults to: 1
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     breakBlock(blockLocation: minecraftserver.Vector3, direction?: minecraftserver.Direction): boolean;
     /**
@@ -630,6 +672,10 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Direction to place the specified item within.
      * Defaults to: 1
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     interactWithBlock(blockLocation: minecraftserver.Vector3, direction?: minecraftserver.Direction): boolean;
     /**
@@ -642,6 +688,10 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @param entity
      * Entity to interact with.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     interactWithEntity(entity: minecraftserver.Entity): boolean;
     /**
@@ -665,6 +715,10 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @param duration
      * Defaults to: 2
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     lookAtBlock(blockLocation: minecraftserver.Vector3, duration?: LookDuration): void;
     /**
@@ -736,6 +790,12 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
+     *
+     * {@link Error}
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     moveToLocation(location: minecraftserver.Vector3, options?: MoveToOptions): void;
     /**
@@ -752,6 +812,10 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @param speed
      * Defaults to: 1
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     navigateToBlock(blockLocation: minecraftserver.Vector3, speed?: number): NavigationResult;
     /**
@@ -765,6 +829,10 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @param speed
      * Defaults to: 1
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     navigateToEntity(entity: minecraftserver.Entity, speed?: number): NavigationResult;
     /**
@@ -781,6 +849,10 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @param speed
      * Defaults to: 1
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     navigateToLocation(location: minecraftserver.Vector3, speed?: number): NavigationResult;
     /**
@@ -797,6 +869,10 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Net speed to use for doing the navigation.
      * Defaults to: 1
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     navigateToLocations(locations: minecraftserver.Vector3[], speed?: number): void;
     /**
@@ -844,6 +920,19 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @throws This function can throw errors.
      */
     setItem(itemStack: minecraftserver.ItemStack, slot: number, selectSlot?: boolean): boolean;
+    /**
+     * @remarks
+     * Updates information about the player's skin.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param options
+     * Options for the skin to set on the player.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftserver.InvalidEntityError}
+     */
+    setSkin(options: PlayerSkinData): void;
     /**
      * @remarks
      * This function can't be called in read-only mode.
@@ -980,6 +1069,10 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * block where the item is placed.
      * Defaults to: null
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     useItemInSlotOnBlock(
         slot: number,
@@ -1007,6 +1100,10 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * block where the item is placed.
      * Defaults to: null
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     useItemOnBlock(
         itemStack: minecraftserver.ItemStack,
@@ -1073,6 +1170,8 @@ export class Test {
      * to true.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assert(condition: boolean, message: string): void;
@@ -1092,6 +1191,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertBlockPresent(
@@ -1112,6 +1213,8 @@ export class Test {
      * the block at the specified location.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertBlockState(blockLocation: minecraftserver.Vector3, callback: (arg0: minecraftserver.Block) => boolean): void;
@@ -1133,6 +1236,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertCanReachLocation(
@@ -1155,6 +1260,8 @@ export class Test {
      * chest) to test the contents of.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertContainerContains(itemStack: minecraftserver.ItemStack, blockLocation: minecraftserver.Vector3): void;
@@ -1168,6 +1275,8 @@ export class Test {
      * chest) to test is empty of contents.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertContainerEmpty(blockLocation: minecraftserver.Vector3): void;
@@ -1193,6 +1302,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertEntityHasArmor(
@@ -1224,6 +1335,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertEntityHasComponent(
@@ -1249,6 +1362,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertEntityInstancePresent(
@@ -1270,6 +1385,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      * @example simpleMobTest.ts
      * ```typescript
@@ -1318,6 +1435,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertEntityPresent(
@@ -1342,6 +1461,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      * @example simpleMobTest.ts
      * ```typescript
@@ -1405,6 +1526,8 @@ export class Test {
      * is thrown.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertEntityState(
@@ -1431,6 +1554,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertEntityTouching(entityTypeIdentifier: string, location: minecraftserver.Vector3, isTouching?: boolean): void;
@@ -1449,6 +1574,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertIsWaterlogged(blockLocation: minecraftserver.Vector3, isWaterlogged?: boolean): void;
@@ -1468,6 +1595,8 @@ export class Test {
      * Number of items, at minimum, to look and test for.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertItemEntityCountIs(
@@ -1497,6 +1626,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertItemEntityPresent(
@@ -1516,6 +1647,8 @@ export class Test {
      * Expected power level.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     assertRedstonePower(blockLocation: minecraftserver.Vector3, power: number): void;
@@ -1532,6 +1665,8 @@ export class Test {
      * Defaults to: false
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     destroyBlock(blockLocation: minecraftserver.Vector3, dropResources?: boolean): void;
@@ -1566,6 +1701,8 @@ export class Test {
      * Location of the block to retrieve.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     getBlock(blockLocation: minecraftserver.Vector3): minecraftserver.Block;
@@ -1575,6 +1712,8 @@ export class Test {
      *
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     getDimension(): minecraftserver.Dimension;
@@ -1590,6 +1729,8 @@ export class Test {
      * Location of the block to retrieve.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     getFenceConnectivity(blockLocation: minecraftserver.Vector3): FenceConnectivity;
@@ -1607,6 +1748,8 @@ export class Test {
      * is present on the block.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     getSculkSpreader(blockLocation: minecraftserver.Vector3): SculkSpreader | undefined;
@@ -1616,6 +1759,9 @@ export class Test {
      * minecraftserver.Direction} enum for more information on
      * potential values (north, east, south, west - values 2-5).
      *
+     * @throws This function can throw errors.
+     *
+     * {@link GameTestCompletedError}
      */
     getTestDirection(): minecraftserver.Direction;
     /**
@@ -1627,8 +1773,28 @@ export class Test {
      *
      * @param tickDelay
      * Amount of time to wait, in ticks.
+     * @throws This function can throw errors.
+     *
+     * {@link GameTestCompletedError}
      */
     idle(tickDelay: number): Promise<void>;
+    /**
+     * @remarks
+     * Returns whether or not the test is currently in the Clean Up
+     * step after running.
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    isCleaningUp(): boolean;
+    /**
+     * @remarks
+     * Returns whether or not the test has already completed
+     *
+     * This function can't be called in read-only mode.
+     *
+     */
+    isCompleted(): boolean;
     /**
      * @remarks
      * Kills all entities within the GameTest structure.
@@ -1637,6 +1803,8 @@ export class Test {
      *
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     killAllEntities(): void;
@@ -1646,6 +1814,8 @@ export class Test {
      *
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     onPlayerJump(mob: minecraftserver.Entity, jumpAmount: number): void;
@@ -1661,6 +1831,8 @@ export class Test {
      * Will throw an error if a button is not present at the
      * specified position.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     pressButton(blockLocation: minecraftserver.Vector3): void;
@@ -1674,6 +1846,8 @@ export class Test {
      * Message to display.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     print(text: string): void;
@@ -1689,6 +1863,8 @@ export class Test {
      * Will throw an error if a lever is not present at the
      * specified position.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     pullLever(blockLocation: minecraftserver.Vector3): void;
@@ -1705,6 +1881,8 @@ export class Test {
      * Number of ticks to pulse Redstone.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     pulseRedstone(blockLocation: minecraftserver.Vector3, duration: number): void;
@@ -1723,6 +1901,8 @@ export class Test {
      * A location relative to the GameTest command block.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     relativeBlockLocation(worldBlockLocation: minecraftserver.Vector3): minecraftserver.Vector3;
@@ -1743,6 +1923,8 @@ export class Test {
      * A location relative to the GameTest command block.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     relativeLocation(worldLocation: minecraftserver.Vector3): minecraftserver.Vector3;
@@ -1754,6 +1936,9 @@ export class Test {
      *
      * @param simulatedPlayer
      * Simulated player to remove.
+     * @throws This function can throw errors.
+     *
+     * {@link GameTestCompletedError}
      */
     removeSimulatedPlayer(simulatedPlayer: SimulatedPlayer): void;
     /**
@@ -1772,6 +1957,8 @@ export class Test {
      * opposite of the test direction, and so on.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     rotateDirection(direction: minecraftserver.Direction): minecraftserver.Direction;
@@ -1781,6 +1968,8 @@ export class Test {
      *
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     rotateVector(vector: minecraftserver.Vector3): minecraftserver.Vector3;
@@ -1813,6 +2002,22 @@ export class Test {
      * @throws This function can throw errors.
      */
     runAtTickTime(tick: number, callback: () => void): void;
+    /**
+     * @remarks
+     * Runs the given callback after the GameTest has completed
+     * regardless if the test passed, failed, or timed out.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param callback
+     * Callback to execute.
+     * @throws This function can throw errors.
+     *
+     * {@link GameTestCompletedError}
+     *
+     * {@link GameTestError}
+     */
+    runOnFinish(callback: () => void): void;
     /**
      * @remarks
      * Sets a block to a particular configuration (a
@@ -1827,6 +2032,8 @@ export class Test {
      * Location of the block to set.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     setBlockPermutation(blockData: minecraftserver.BlockPermutation, blockLocation: minecraftserver.Vector3): void;
@@ -1843,6 +2050,8 @@ export class Test {
      * Location of the block to set.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      * @example minibiomes.ts
      * ```typescript
@@ -1880,6 +2089,8 @@ export class Test {
      * for a list of values.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     setFluidContainer(location: minecraftserver.Vector3, type: minecraftserver.FluidType): void;
@@ -1895,6 +2106,8 @@ export class Test {
      * Length of time, in ticks, before the entity explodes.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     setTntFuse(entity: minecraftserver.Entity, fuseLength: number): void;
@@ -1914,6 +2127,8 @@ export class Test {
      * undefined.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      * @example simpleMobTest.ts
      * ```typescript
@@ -2009,6 +2224,8 @@ export class Test {
      * undefined.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     spawnAtLocation(entityTypeIdentifier: string, location: minecraftserver.Vector3): minecraftserver.Entity;
@@ -2024,6 +2241,8 @@ export class Test {
      * Location to create the item entity at.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     spawnItem(itemStack: minecraftserver.ItemStack, location: minecraftserver.Vector3): minecraftserver.Entity;
@@ -2042,6 +2261,8 @@ export class Test {
      * Defaults to: 0
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     spawnSimulatedPlayer(
@@ -2061,6 +2282,8 @@ export class Test {
      * Location where the entity should be spawned.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     spawnWithoutBehaviors(entityTypeIdentifier: string, blockLocation: minecraftserver.Vector3): minecraftserver.Entity;
@@ -2076,6 +2299,8 @@ export class Test {
      * Location where the entity should be spawned.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     spawnWithoutBehaviorsAtLocation(
@@ -2098,6 +2323,8 @@ export class Test {
      * specify a direction.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     spreadFromFaceTowardDirection(
@@ -2115,6 +2342,9 @@ export class Test {
      * @returns
      * A new GameTestSequence with chaining methods that facilitate
      * creating a set of steps.
+     * @throws This function can throw errors.
+     *
+     * {@link GameTestCompletedError}
      */
     startSequence(): GameTestSequence;
     /**
@@ -2224,6 +2454,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     succeedWhenBlockPresent(
@@ -2337,6 +2569,8 @@ export class Test {
      * Defaults to: []
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     triggerInternalBlockEvent(blockLocation: minecraftserver.Vector3, event: string, eventParameters?: number[]): void;
@@ -2351,6 +2585,9 @@ export class Test {
      *
      * @param callback
      * Function with code to evaluate.
+     * @throws This function can throw errors.
+     *
+     * {@link GameTestCompletedError}
      */
     until(callback: () => void): Promise<void>;
     /**
@@ -2371,6 +2608,8 @@ export class Test {
      * Defaults to: 1
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     walkTo(mob: minecraftserver.Entity, blockLocation: minecraftserver.Vector3, speedModifier?: number): void;
@@ -2392,6 +2631,8 @@ export class Test {
      * Defaults to: 1
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     walkToLocation(mob: minecraftserver.Entity, location: minecraftserver.Vector3, speedModifier?: number): void;
@@ -2408,6 +2649,8 @@ export class Test {
      * An absolute location relative to the GameTest command block.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     worldBlockLocation(relativeBlockLocation: minecraftserver.Vector3): minecraftserver.Vector3;
@@ -2424,6 +2667,8 @@ export class Test {
      * An absolute location relative to the GameTest command block.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     worldLocation(relativeLocation: minecraftserver.Vector3): minecraftserver.Vector3;
@@ -2440,6 +2685,37 @@ export interface MoveToOptions {
     speed?: number;
 }
 
+/**
+ * Data pertaining to a specific player Persona piece.
+ */
+export interface PlayerPersonaPiece {
+    id: string;
+    isDefaultPiece?: boolean;
+    packId: string;
+    productId: string;
+    type: PersonaPieceType;
+}
+
+/**
+ * Data pertaining to a player's configured skin.
+ */
+export interface PlayerSkinData {
+    armSize?: PersonaArmSize;
+    personaPieces?: PlayerPersonaPiece[];
+    skinColor?: minecraftserver.RGB;
+}
+
+// @ts-ignore Class inheritance allowed for native defined classes
+export class GameTestCompletedError extends Error {
+    private constructor();
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
+    reason: GameTestCompletedErrorReason;
+}
+
 // @ts-ignore Class inheritance allowed for native defined classes
 export class GameTestError extends Error {
     private constructor();
@@ -2463,6 +2739,21 @@ export class GameTestError extends Error {
     type: GameTestErrorType;
 }
 
+/**
+ * @remarks
+ * Returns data about a player's skin.
+ *
+ * This function can't be called in read-only mode.
+ *
+ * @param player
+ * The player who's skin is returned.
+ * @throws This function can throw errors.
+ *
+ * {@link minecraftcommon.InvalidArgumentError}
+ *
+ * {@link minecraftserver.InvalidEntityError}
+ */
+export function getPlayerSkin(player: minecraftserver.Player): PlayerSkinData;
 /**
  * @remarks
  * Registers a new GameTest function. This GameTest will become
@@ -2556,3 +2847,58 @@ export function registerAsync(
     testName: string,
     testFunction: (arg0: Test) => Promise<void>,
 ): RegistrationBuilder;
+/**
+ * @remarks
+ * Sets a callback that is called after the batch gets called.
+ * This will overwrite previously set callbacks for this batch.
+ *
+ * This function can't be called in read-only mode.
+ *
+ * This function can be called in early-execution mode.
+ *
+ * @param batchName
+ * Name of the batch of tests the callback will run after.
+ * @throws This function can throw errors.
+ *
+ * {@link GameTestError}
+ */
+export function setAfterBatchCallback(batchName: string, batchCallback: () => void): void;
+/**
+ * @remarks
+ * Sets a callback that is called before the batch gets called.
+ * This will overwrite previously set callbacks for this batch.
+ *
+ * This function can't be called in read-only mode.
+ *
+ * This function can be called in early-execution mode.
+ *
+ * @param batchName
+ * Name of the batch of tests the callback will run before.
+ * @throws This function can throw errors.
+ *
+ * {@link GameTestError}
+ */
+export function setBeforeBatchCallback(batchName: string, batchCallback: () => void): void;
+/**
+ * @remarks
+ * Spawns a simulated player that isn't associated to a
+ * specific {@link Test}.  You can use {@link
+ * SimulatedPlayer.remove} to remove the player from the world.
+ *
+ * This function can't be called in read-only mode.
+ *
+ * @param location
+ * The location in which to spawn the player.
+ * @param name
+ * The name for the player.
+ * @param gameMode
+ * The game mode for the player.
+ * @throws This function can throw errors.
+ *
+ * {@link minecraftcommon.EngineError}
+ */
+export function spawnSimulatedPlayer(
+    location: minecraftserver.DimensionLocation,
+    name: string,
+    gameMode: minecraftserver.GameMode,
+): SimulatedPlayer;

package/package.json

@@ -1,20 +1,20 @@
-{
-  "name": "@minecraft/server-gametest",
-  "version": "1.0.0-beta.1.21.95-stable",
-  "description": "",
-  "contributors": [
-    {
-      "name": "Jake Shirley",
-      "email": "jake@xbox.com"
-    },
-    {
-      "name": "Mike Ammerlaan",
-      "email": "mikeam@microsoft.com"
-    }
-  ],
-  "dependencies": {
-    "@minecraft/common": "^1.0.0",
-    "@minecraft/server": "^1.17.0 || ^2.0.0"
-  },
-  "license": "MIT"
+{
+  "name": "@minecraft/server-gametest",
+  "version": "1.0.0-beta.1.26.0-preview.24",
+  "description": "",
+  "contributors": [
+    {
+      "name": "Jake Shirley",
+      "email": "jake@xbox.com"
+    },
+    {
+      "name": "Mike Ammerlaan",
+      "email": "mikeam@microsoft.com"
+    }
+  ],
+  "peerDependencies": {
+    "@minecraft/common": "^1.0.0",
+    "@minecraft/server": "^1.17.0 || ^2.0.0 || ^2.6.0-beta.1.26.0-preview.24"
+  },
+  "license": "MIT"
 }