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

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.
@@ -92,7 +130,7 @@ export class GameTestSequence {
      * sequence. Exceptions thrown within the callback will end
      * sequence execution.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param callback
      * Callback function to execute.
@@ -107,7 +145,7 @@ export class GameTestSequence {
      * GameTest sequence. Exceptions thrown within the callback
      * will end sequence execution.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param delayTicks
      * Number of ticks to wait before executing the callback.
@@ -123,7 +161,7 @@ export class GameTestSequence {
      * Runs the given callback every tick for the given number of
      * ticks.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param callback
      * Callback function to execute.
@@ -137,7 +175,7 @@ export class GameTestSequence {
      * Causes the test to fail if this step in the GameTest
      * sequence is reached.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param errorMessage
      * Error message summarizing the failure condition.
@@ -147,7 +185,7 @@ export class GameTestSequence {
      * @remarks
      * Idles the GameTest sequence for the specified delayTicks.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param delayTicks
      * Number of ticks to delay for this step in the GameTest
@@ -162,7 +200,7 @@ export class GameTestSequence {
      * Marks the GameTest a success if this step is reached in the
      * GameTest sequence.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      */
     thenSucceed(): void;
@@ -172,7 +210,7 @@ export class GameTestSequence {
      * Exceptions thrown within the callback will end sequence
      * execution.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param callback
      * Testing callback function to execute. Typically, this
@@ -188,7 +226,7 @@ export class GameTestSequence {
      * callback every tick until it succeeds. Exceptions thrown
      * within the callback will end sequence execution.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param delayTicks
      * Tick (after the previous step in the GameTest sequence) to
@@ -219,7 +257,7 @@ export class RegistrationBuilder {
      * @remarks
      * Sets the batch for the test to run in.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -235,7 +273,7 @@ export class RegistrationBuilder {
      * Sets the maximum number of times a test will try to rerun if
      * it fails.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -249,7 +287,7 @@ export class RegistrationBuilder {
      * Sets the maximum number of ticks a test will run for before
      * timing out and failing.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -263,7 +301,7 @@ export class RegistrationBuilder {
      * Size around the GameTest, in blocks, that should be reserved
      * for the test when running multiple tests together.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -280,7 +318,7 @@ export class RegistrationBuilder {
      * Whether this test is required to pass as part of its broader
      * set of tests.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -297,7 +335,7 @@ export class RegistrationBuilder {
      * Sets the number of successful test runs to be considered
      * successful.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -311,7 +349,7 @@ export class RegistrationBuilder {
      * If true, runs the test in all four rotations when run via
      * /gametest runset.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -322,7 +360,7 @@ export class RegistrationBuilder {
      * Sets the number of ticks for a test to wait before executing
      * when the structure is spawned.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -339,7 +377,7 @@ export class RegistrationBuilder {
      * ground. If the dimension is not specified, it will run in
      * the dimension the command was run from.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -362,7 +400,7 @@ export class RegistrationBuilder {
      * will load `/structures/xyz/bar.mcstructure` from the
      * behavior pack stack.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -391,7 +429,7 @@ export class RegistrationBuilder {
      * Adds a tag to a test. You can run all tests with a given tag
      * with `/gametest runset <tag>`.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * This function can be called in early-execution mode.
      *
@@ -436,7 +474,7 @@ export class SculkSpreader {
      * Adds a cursor - which is a notional waypoint that the sculk
      * will spread in the direction of.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      */
     addCursorsWithOffset(offset: minecraftserver.Vector3, charge: number): void;
@@ -444,7 +482,7 @@ export class SculkSpreader {
      * @remarks
      * Retrieves the current position of the specified cursor.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -453,7 +491,7 @@ export class SculkSpreader {
      * @remarks
      * Returns a number of overall cursors for this sculk spreader.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -462,7 +500,7 @@ export class SculkSpreader {
      * @remarks
      * Gets the total current charge of the sculk spreader.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -493,7 +531,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Returns whether the simulated player is sprinting.
      *
-     * This property can't be edited in read-only mode.
+     * This property can't be edited in restricted-execution mode.
      *
      */
     isSprinting: boolean;
@@ -504,7 +542,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * player was not on cooldown and had a valid target. Target
      * selection is performed by raycasting from the player's head.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -517,7 +555,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * attack can be performed at any distance and does not require
      * line of sight to the target entity.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -529,7 +567,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * broken, an item is used or stopBreakingBlock is called.
      * Returns true if the block at blockLocation is solid.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * Location of the block to interact with.
@@ -537,11 +575,15 @@ 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;
     /**
      * @remarks
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -551,7 +593,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Simulates and performs a disconnection of the simulated
      * player from the world.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -560,7 +602,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Drops the simulated player's selected item
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -571,7 +613,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * were flying in creative mode. For flying with Elytra, see
      * function glide.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -580,7 +622,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Gives the simulated player a particular item stack.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param itemStack
      * Item to give.
@@ -595,7 +637,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Causes the simulated player to start gliding. Elytra must be
      * equipped and the player must be in the air.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @returns
      * Returns true if the simulated player begins to glide.
@@ -611,7 +653,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * the first intersected block or entity. Returns true if the
      * interaction was successful. Maximum range is 6 blocks.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -622,7 +664,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * block at the specified block location must be solid. Returns
      * true if the interaction was performed.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * Location of the block to interact with.
@@ -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;
     /**
@@ -637,18 +683,22 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Causes the simulated player to interact with a mob. Returns
      * true if the interaction was performed.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param entity
      * Entity to interact with.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     interactWithEntity(entity: minecraftserver.Entity): boolean;
     /**
      * @remarks
      * Causes the simulated player to jump.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @returns
      * True if a jump was performed.
@@ -660,11 +710,15 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Rotates the simulated player's head/body to look at the
      * given block location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param duration
      * Defaults to: 2
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     lookAtBlock(blockLocation: minecraftserver.Vector3, duration?: LookDuration): void;
     /**
@@ -672,7 +726,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Rotates the simulated player's head/body to look at the
      * given entity.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param duration
      * Defaults to: 2
@@ -684,7 +738,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Rotates the simulated player's head/body to look at the
      * given location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param duration
      * Defaults to: 2
@@ -696,7 +750,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Orders the simulated player to walk in the given direction
      * relative to the GameTest.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param speed
      * Defaults to: 1
@@ -708,7 +762,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Orders the simulated player to walk in the given direction
      * relative to the player's current rotation.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param speed
      * Defaults to: 1
@@ -722,7 +776,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * already playing, this will override the last
      * move/navigation.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -733,9 +787,15 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * a straight line. If a move or navigation is already playing,
      * this will override the last move/navigation.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
+     *
+     * {@link Error}
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     moveToLocation(location: minecraftserver.Vector3, options?: MoveToOptions): void;
     /**
@@ -747,11 +807,15 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * player will stop. The player must be touching the ground in
      * order to start navigation.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param speed
      * Defaults to: 1
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     navigateToBlock(blockLocation: minecraftserver.Vector3, speed?: number): NavigationResult;
     /**
@@ -760,11 +824,15 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * a one block radius. If a move or navigation is already
      * playing, this will override the last move/navigation.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param speed
      * Defaults to: 1
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     navigateToEntity(entity: minecraftserver.Entity, speed?: number): NavigationResult;
     /**
@@ -776,11 +844,15 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * stop. The player must be touching the ground in order to
      * start navigation.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param speed
      * Defaults to: 1
      * @throws This function can throw errors.
+     *
+     * {@link GameTestError}
+     *
+     * {@link minecraftserver.InvalidEntityError}
      */
     navigateToLocation(location: minecraftserver.Vector3, speed?: number): NavigationResult;
     /**
@@ -789,7 +861,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * locations parameter. If a move or navigation is already
      * playing, this will override the last move/navigation.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param locations
      * A list of locations to use for routing.
@@ -797,13 +869,17 @@ 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;
     /**
      * @remarks
      * Respawns the particular simulated player.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -813,7 +889,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Causes the simulated player to turn by the provided angle,
      * relative to the player's current rotation.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -823,7 +899,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Causes the simulated player to turn to face the provided
      * angle, relative to the GameTest.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -832,7 +908,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Sets a particular item for the simulated player.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param itemStack
      * Item to set.
@@ -846,7 +922,20 @@ export class SimulatedPlayer extends minecraftserver.Player {
     setItem(itemStack: minecraftserver.ItemStack, slot: number, selectSlot?: boolean): boolean;
     /**
      * @remarks
-     * This function can't be called in read-only mode.
+     * Updates information about the player's skin.
+     *
+     * This function can't be called in restricted-execution 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 restricted-execution mode.
      *
      * @param slot
      * Defaults to: 0
@@ -857,14 +946,14 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Stops destroying the block that is currently being hit.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
     stopBreakingBlock(): void;
     /**
      * @remarks
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -873,7 +962,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Causes the simulated player to stop flying.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -882,7 +971,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Causes the simulated player to stop gliding.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -891,7 +980,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Stops interacting with entities or blocks.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -901,7 +990,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Stops moving/walking/following if the simulated player is
      * moving.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -910,7 +999,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Causes the simulated player to stop swimming.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -919,7 +1008,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Stops using the currently active item.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @returns
      * Returns the item that was in use. Undefined if no item was
@@ -931,7 +1020,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * @remarks
      * Causes the simulated player to start swimming.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -941,7 +1030,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Causes the simulated player to use an item. Does not consume
      * the item. Returns false if the item is on cooldown.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param itemStack
      * Item to use.
@@ -953,7 +1042,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * Causes the simulated player to hold and use an item in their
      * inventory.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param slot
      * Index of the inventory slot.
@@ -966,7 +1055,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * inventory on a block. The block at the specified block
      * location must be solid. Returns true if the item was used.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param slot
      * Index of the slot to use.
@@ -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,
@@ -993,7 +1086,7 @@ export class SimulatedPlayer extends minecraftserver.Player {
      * block at the specified block location must be solid. Returns
      * true if the item was used.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param itemStack
      * Item to use.
@@ -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;
@@ -1523,7 +1656,7 @@ export class Test {
      * @remarks
      * Destroys a block at a particular location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * Location of the block to destroy.
@@ -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;
@@ -1560,12 +1695,14 @@ export class Test {
      * @remarks
      * Gets a block at the specified block location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * 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;
@@ -1584,12 +1723,14 @@ export class Test {
      * this returns a helper object with details on how a fence is
      * connected.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * Location of the block to retrieve.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     getFenceConnectivity(blockLocation: minecraftserver.Vector3): FenceConnectivity;
@@ -1598,7 +1739,7 @@ export class Test {
      * Retrieves a sculk spreader object that can be used to
      * control and manage how sculk grows from a block.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * Location of the block to retrieve a sculk spreader from.
@@ -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;
     /**
@@ -1623,29 +1769,53 @@ export class Test {
      * This asynchronous function will wait for the specified time
      * in ticks before continuing execution.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @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 restricted-execution mode.
+     *
+     */
+    isCleaningUp(): boolean;
+    /**
+     * @remarks
+     * Returns whether or not the test has already completed
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     */
+    isCompleted(): boolean;
     /**
      * @remarks
      * Kills all entities within the GameTest structure.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     killAllEntities(): void;
     /**
      * @remarks
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     onPlayerJump(mob: minecraftserver.Entity, jumpAmount: number): void;
@@ -1653,7 +1823,7 @@ export class Test {
      * @remarks
      * Presses a button at a block location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * Location to push the button at.
@@ -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;
@@ -1668,12 +1840,14 @@ export class Test {
      * @remarks
      * Displays the specified message to all players.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param text
      * Message to display.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     print(text: string): void;
@@ -1681,7 +1855,7 @@ export class Test {
      * @remarks
      * Pulls a lever at a block location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * Location to pull the lever at.
@@ -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;
@@ -1697,7 +1873,7 @@ export class Test {
      * Sends a Redstone pulse at a particular location by creating
      * a temporary Redstone block.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * Location to pulse Redstone at.
@@ -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;
@@ -1734,7 +1914,7 @@ export class Test {
      * structure block are (0, 1, 0). Rotation of the GameTest
      * structure is also taken into account.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param worldLocation
      * Absolute location in the world to convert to a relative
@@ -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;
@@ -1750,10 +1932,13 @@ export class Test {
      * @remarks
      * Removes a simulated player from the world.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param simulatedPlayer
      * Simulated player to remove.
+     * @throws This function can throw errors.
+     *
+     * {@link GameTestCompletedError}
      */
     removeSimulatedPlayer(simulatedPlayer: SimulatedPlayer): void;
     /**
@@ -1763,7 +1948,7 @@ export class Test {
      * test direction; Passing in Direction.north will return the
      * opposite of the test direction, and so on.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param direction
      * Direction to translate into a direction relative to the
@@ -1772,15 +1957,19 @@ 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;
     /**
      * @remarks
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     rotateVector(vector: minecraftserver.Vector3): minecraftserver.Vector3;
@@ -1788,7 +1977,7 @@ export class Test {
      * @remarks
      * Runs a specific callback after a specified delay of ticks
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param delayTicks
      * Number of ticks to delay before running the specified
@@ -1803,7 +1992,7 @@ export class Test {
      * Runs the given callback after a delay of _tick_ ticks from
      * the start of the GameTest.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param tick
      * Tick (after the start of the GameTest) to run the callback
@@ -1813,12 +2002,28 @@ 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 restricted-execution 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
      * BlockPermutation) at the specified block location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockData
      * Permutation that contains the configuration data for 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;
@@ -1835,7 +2042,7 @@ export class Test {
      * Sets a block to a particular type at the specified block
      * location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockType
      * Type of block to set.
@@ -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
@@ -1871,7 +2080,7 @@ export class Test {
      * For blocks that are fluid containers - like a cauldron -
      * changes the type of fluid within that container.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param location
      * Location of the fluid container block.
@@ -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;
@@ -1887,7 +2098,7 @@ export class Test {
      * @remarks
      * Sets the fuse of an explodable entity.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param entity
      * Entity that is explodable.
@@ -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;
@@ -1902,7 +2115,7 @@ export class Test {
      * @remarks
      * Spawns an entity at a location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param entityTypeIdentifier
      * Type of entity to create. If no namespace is provided,
@@ -1914,6 +2127,8 @@ export class Test {
      * undefined.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      * @example simpleMobTest.ts
      * ```typescript
@@ -1997,7 +2212,7 @@ export class Test {
      * @remarks
      * Spawns an entity at a location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param entityTypeIdentifier
      * Type of entity to create. If no namespace is provided,
@@ -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;
@@ -2016,7 +2233,7 @@ export class Test {
      * @remarks
      * Spawns an item entity at a specified location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param itemStack
      * ItemStack that describes the item entity to create.
@@ -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;
@@ -2031,7 +2250,7 @@ export class Test {
      * @remarks
      * Creates a new simulated player within the world.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * Location where to spawn the simulated player.
@@ -2042,6 +2261,8 @@ export class Test {
      * Defaults to: 0
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     spawnSimulatedPlayer(
@@ -2055,12 +2276,14 @@ export class Test {
      * This method is frequently used in conjunction with methods
      * like .walkTo to create predictable mob actions.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * 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;
@@ -2070,12 +2293,14 @@ export class Test {
      * This method is frequently used in conjunction with methods
      * like .walkTo to create predictable mob actions.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param location
      * Location where the entity should be spawned.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     spawnWithoutBehaviorsAtLocation(
@@ -2087,7 +2312,7 @@ export class Test {
      * Tests that a particular item entity is present at a
      * particular location. If not, an exception is thrown.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockLocation
      * BlockLocation containing a multiface block.
@@ -2098,6 +2323,8 @@ export class Test {
      * specify a direction.
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     spreadFromFaceTowardDirection(
@@ -2110,18 +2337,21 @@ export class Test {
      * Creates a new GameTestSequence - A set of steps that play
      * out sequentially within a GameTest.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @returns
      * A new GameTestSequence with chaining methods that facilitate
      * creating a set of steps.
+     * @throws This function can throw errors.
+     *
+     * {@link GameTestCompletedError}
      */
     startSequence(): GameTestSequence;
     /**
      * @remarks
      * Marks the current test as a success case.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @throws This function can throw errors.
      */
@@ -2131,7 +2361,7 @@ export class Test {
      * Runs the given callback. If the callback does not throw an
      * exception, the test is marked as a success.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param callback
      * Callback function that runs. If the function runs
@@ -2144,7 +2374,7 @@ export class Test {
      * @remarks
      * Marks the test as a success at the specified tick.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param tick
      * Tick after the start of the GameTest to mark the test as
@@ -2158,7 +2388,7 @@ export class Test {
      * the test. If the callback does not throw an exception, the
      * test is marked as a failure.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param tick
      * Tick after the start of the GameTest to run the testing
@@ -2176,7 +2406,7 @@ export class Test {
      * Specifically, the test will succeed when the callback does
      * not throw an exception.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param callback
      * Testing callback function that runs. If the function runs
@@ -2211,7 +2441,7 @@ export class Test {
      * the specified block of a type is found or not found
      * (depending on isPresent), the test is marked as a success.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param blockType
      * Type of block to test for.
@@ -2224,6 +2454,8 @@ export class Test {
      * Defaults to: true
      * @throws This function can throw errors.
      *
+     * {@link GameTestCompletedError}
+     *
      * {@link GameTestError}
      */
     succeedWhenBlockPresent(
@@ -2237,7 +2469,7 @@ export class Test {
      * Depending on the value of hasComponent, when the specified
      * component is found, the test is marked as a success.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param entityTypeIdentifier
      * Type of entity to look for. If no namespace is specified,
@@ -2266,7 +2498,7 @@ export class Test {
      * type is found or not found (depending on isPresent), the
      * test is marked as a success.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param entityTypeIdentifier
      * Type of entity to test for (e.g., 'minecraft:skeleton'). If
@@ -2326,7 +2558,7 @@ export class Test {
      * Triggers a block event from a fixed list of available block
      * events.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param event
      * Event to trigger. Valid values include minecraft:drip,
@@ -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;
@@ -2347,10 +2581,13 @@ export class Test {
      * in conjunction with .assert functions to evaluate that a
      * condition is true.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param callback
      * Function with code to evaluate.
+     * @throws This function can throw errors.
+     *
+     * {@link GameTestCompletedError}
      */
     until(callback: () => void): Promise<void>;
     /**
@@ -2360,7 +2597,7 @@ export class Test {
      * have more predictable mob behaviors. Mobs will stop
      * navigation as soon as they intersect the target location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param mob
      * Mob entity to give orders to.
@@ -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;
@@ -2381,7 +2620,7 @@ export class Test {
      * have more predictable mob behaviors. Mobs will stop
      * navigation as soon as they intersect the target location.
      *
-     * This function can't be called in read-only mode.
+     * This function can't be called in restricted-execution mode.
      *
      * @param mob
      * Mob entity to give orders to.
@@ -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,13 +2739,28 @@ export class GameTestError extends Error {
     type: GameTestErrorType;
 }
 
+/**
+ * @remarks
+ * Returns data about a player's skin.
+ *
+ * This function can't be called in restricted-execution 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
  * available in Minecraft via /gametest run
  * [testClassName]:[testName].
  *
- * This function can't be called in read-only mode.
+ * This function can't be called in restricted-execution mode.
  *
  * This function can be called in early-execution mode.
  *
@@ -2515,7 +2806,7 @@ export function register(
  * asynchronous execution. This GameTest will become available
  * in Minecraft via /gametest run [testClassName]:[testName].
  *
- * This function can't be called in read-only mode.
+ * This function can't be called in restricted-execution mode.
  *
  * This function can be called in early-execution mode.
  *
@@ -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 restricted-execution 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 restricted-execution 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 restricted-execution 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;