@minecraft/server 1.3.0-beta.1.20.0-preview.23 → 1.3.0-beta.1.20.0-preview.25

package/index.d.ts

@@ -16,7 +16,7 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "1.3.0-internal.1.20.0-preview.23"
+ *   "version": "1.3.0-internal.1.20.0-preview.25"
  * }
  * ```
  *
@@ -792,15 +792,14 @@ export class Block {
      * @throws This function can throw errors.
      * @example check_block_tags.js
      * ```typescript
-     *        import { world } from "@minecraft/server";
+     * import { world } from "@minecraft/server";
      *
-     *        // Fetch the block
-     *        const block = world.getDimension("overworld").getBlock({ x: 1, y: 2, z: 3 });
-     *
-     *        console.log(`Block is dirt: ${block.hasTag("dirt")}`);
-     *        console.log(`Block is wood: ${block.hasTag("wood")}`);
-     *        console.log(`Block is stone: ${block.hasTag("stone")}`);
+     * // Fetch the block
+     * const block = world.getDimension("overworld").getBlock({ x: 1, y: 2, z: 3 });
      *
+     * console.log(`Block is dirt: ${block.hasTag("dirt")}`);
+     * console.log(`Block is wood: ${block.hasTag("wood")}`);
+     * console.log(`Block is stone: ${block.hasTag("stone")}`);
      * ```
      */
     hasTag(tag: string): boolean;
@@ -1072,6 +1071,21 @@ export class BlockLiquidContainerComponent extends BlockComponent {
 
 /**
  * @beta
+ * A BlockLocationIterator returns the next block location of
+ * the block volume across which it is iterating.
+ * The BlockLocationIterator is used to abstract the shape of
+ * the block volume it was fetched from (so it can represent
+ * all the block locations that make up rectangles, cubes,
+ * spheres, lines and complex shapes).
+ * Each iteration pass returns the next valid block location in
+ * the parent shape.
+ * Unless otherwise specified by the parent shape - the
+ * BlockLocationIterator will iterate over a 3D space in the
+ * order of increasing X, followed by increasing Z followed by
+ * increasing Y.
+ * (Effectively stepping across the XZ plane, and when all the
+ * locations in that plane are exhausted, increasing the Y
+ * coordinate to the next XZ slice)
  */
 export class BlockLocationIterator implements Iterable<Vector3> {
     protected constructor();
@@ -1165,16 +1179,15 @@ export class BlockPermutation {
      * Returns `true` if the permutation has the tag, else `false`.
      * @example check_block_tags.js
      * ```typescript
-     *        import { world } from "@minecraft/server";
-     *
-     *        // Fetch the block
-     *        const block = world.getDimension("overworld").getBlock({ x: 1, y: 2, z: 3 });
-     *        const blockPerm = block.getPermutation();
+     * import { world } from "@minecraft/server";
      *
-     *        console.log(`Block is dirt: ${blockPerm.hasTag("dirt")}`);
-     *        console.log(`Block is wood: ${blockPerm.hasTag("wood")}`);
-     *        console.log(`Block is stone: ${blockPerm.hasTag("stone")}`);
+     * // Fetch the block
+     * const block = world.getDimension("overworld").getBlock({ x: 1, y: 2, z: 3 });
+     * const blockPerm = block.getPermutation();
      *
+     * console.log(`Block is dirt: ${blockPerm.hasTag("dirt")}`);
+     * console.log(`Block is wood: ${blockPerm.hasTag("wood")}`);
+     * console.log(`Block is stone: ${blockPerm.hasTag("stone")}`);
      * ```
      */
     hasTag(tag: string): boolean;
@@ -1441,27 +1454,27 @@ export class BlockSignComponent extends BlockComponent {
      * @throws This function can throw errors.
      * @example SetRawMessage.ts
      * ```typescript
-     *        const helloWorldMessage: RawMessage = { text: 'Hello World' };
-     *        sign.setText(helloWorldMessage);
+     * const helloWorldMessage: RawMessage = { text: 'Hello World' };
+     * sign.setText(helloWorldMessage);
      *
-     *        // Sign text will be saved as a RawText
-     *        const result: RawText = sign.getRawText();
-     *        JSON.stringify(result); // { rawtext: [{ text: 'Hello World' }] };
+     * // Sign text will be saved as a RawText
+     * const result: RawText = sign.getRawText();
+     * JSON.stringify(result); // { rawtext: [{ text: 'Hello World' }] };
      * ```
      * @example SetRawText.ts
      * ```typescript
-     *        const helloWorldText: RawText = { rawtext: [{ text: 'Hello World' }] };
-     *        sign.setText(helloWorldText);
+     * const helloWorldText: RawText = { rawtext: [{ text: 'Hello World' }] };
+     * sign.setText(helloWorldText);
      *
-     *        // There will be no data transformation unlike calling setText with a RawMessage
-     *        const result: RawText = sign.getRawText();
-     *        JSON.stringify(result); // { rawtext: [{ text: 'Hello World' }] };
+     * // There will be no data transformation unlike calling setText with a RawMessage
+     * const result: RawText = sign.getRawText();
+     * JSON.stringify(result); // { rawtext: [{ text: 'Hello World' }] };
      * ```
      * @example SetString.ts
      * ```typescript
-     *        // Set sign to say 'Hello'
-     *        sign.setText('Hello');
-     *        sign.getText(); // 'Hello'
+     * // Set sign to say 'Hello'
+     * sign.setText('Hello');
+     * sign.getText(); // 'Hello'
      * ```
      */
     setText(message: RawMessage | RawText | string, side?: SignSide): void;
@@ -1575,79 +1588,139 @@ export class BlockType {
 
 /**
  * @beta
+ * Block Volume Utils is a utility class that provides a number
+ * of useful functions for the creation and utility of {@link
+ * @minecraft-server.BlockVolume} objects
  */
 export class BlockVolumeUtils {
     protected constructor();
     /**
      * @remarks
+     * Check to see if the given location is directly adjacent to
+     * the outer surface of a BlockVolume.
+     *
+     *
      * This function can't be called in read-only mode.
      *
+     * @param volume
+     * The volume to test against
+     * @param pos
+     * The world block location to test
+     * @returns
+     * If the location is either inside or more than 0 blocks away,
+     * the function will return false.
+     * If the location is directly contacting the outer surface of
+     * the BlockVolume, the function will return true.
      */
     static doesLocationTouchFaces(volume: BlockVolume, pos: Vector3): boolean;
     /**
      * @remarks
+     * Check to see if a two block volumes are directly adjacent
+     * and two faces touch.
+     *
      * This function can't be called in read-only mode.
      *
+     * @param volume
+     * The volume to test against
+     * @param other
+     * The volume to test
+     * @returns
+     * If the outer faces of both block volumes touch and are
+     * directly adjacent at any point, return true.
      */
     static doesVolumeTouchFaces(volume: BlockVolume, other: BlockVolume): boolean;
     /**
      * @remarks
+     * Test the equality of two block volumes
+     *
      * This function can't be called in read-only mode.
      *
+     * @returns
+     * Return true if two block volumes are identical
      */
     static equals(volume: BlockVolume, other: BlockVolume): boolean;
     /**
      * @remarks
+     * Fetch a {@link BlockLocationIterator} that represents all of
+     * the block world locations within the specified volume
+     *
      * This function can't be called in read-only mode.
      *
      */
     static getBlockLocationIterator(volume: BlockVolume): BlockLocationIterator;
     /**
      * @remarks
+     * Return a {@link BoundingBox} object which represents the
+     * validated min and max coordinates of the volume
+     *
      * This function can't be called in read-only mode.
      *
      */
     static getBoundingBox(volume: BlockVolume): BoundingBox;
     /**
      * @remarks
+     * Return the capacity (volume) of the BlockVolume (W*D*H)
+     *
      * This function can't be called in read-only mode.
      *
      */
     static getCapacity(volume: BlockVolume): number;
     /**
      * @remarks
+     * Get the largest corner position of the volume (guaranteed to
+     * be >= min)
+     *
      * This function can't be called in read-only mode.
      *
      */
     static getMax(volume: BlockVolume): Vector3;
     /**
      * @remarks
+     * Get the smallest corner position of the volume (guaranteed
+     * to be <= max)
+     *
      * This function can't be called in read-only mode.
      *
      */
     static getMin(volume: BlockVolume): Vector3;
     /**
      * @remarks
+     * Get a {@link Vector3} object where each component represents
+     * the number of blocks along that axis
+     *
      * This function can't be called in read-only mode.
      *
      */
     static getSpan(volume: BlockVolume): Vector3;
     /**
      * @remarks
+     * Return an enumeration which represents the intersection
+     * between two BlockVolume objects
+     *
      * This function can't be called in read-only mode.
      *
      */
     static intersects(volume: BlockVolume, other: BlockVolume): BlockVolumeIntersection;
     /**
      * @remarks
+     * Check to see if a given world block location is inside a
+     * BlockVolume
+     *
      * This function can't be called in read-only mode.
      *
      */
     static isInside(volume: BlockVolume, pos: Vector3): number;
     /**
      * @remarks
+     * Move a BlockVolume by a specified amount
+     *
      * This function can't be called in read-only mode.
      *
+     * @param delta
+     * Amount of blocks to move by
+     * @returns
+     * Returns a new BlockVolume object which represents the new
+     * volume
      */
     static translate(volume: BlockVolume, delta: Vector3): BlockVolume;
 }
@@ -1697,41 +1770,86 @@ export class BlockWaterContainerComponent extends BlockLiquidContainerComponent
 
 /**
  * @beta
+ * Bounding Box Utils is a utility class that provides a number
+ * of useful functions for the creation and utility of {@link
+ * @minecraft-server.BoundingBox} objects
  */
 export class BoundingBoxUtils {
     protected constructor();
     /**
      * @remarks
+     * Create a validated instance of a {@link
+     * @minecraft-server.BoundingBox} where the min and max
+     * components are guaranteed to be (min <= max)
+     *
      * This function can't be called in read-only mode.
      *
+     * @param min
+     * A corner world location
+     * @param max
+     * A corner world location diametrically opposite
      */
     static createValid(min: Vector3, max: Vector3): BoundingBox;
     /**
      * @remarks
+     * Expand a {@link @minecraft-server.BoundingBox} by a given
+     * amount along each axis.
+     * Sizes can be negative to perform contraction.
+     * Note: corners can be inverted if the contraction size is
+     * greater than the span, but the min/max relationship will
+     * remain correct
+     *
      * This function can't be called in read-only mode.
      *
+     * @returns
+     * Return a new {@link @minecraft-server.BoundingBox} object
+     * representing the changes
      */
     static dilate(box: BoundingBox, size: Vector3): BoundingBox;
     /**
      * @remarks
+     * Check if two {@link @minecraft-server.BoundingBox} objects
+     * are identical
+     *
      * This function can't be called in read-only mode.
      *
      */
     static equals(box: BoundingBox, other: BoundingBox): boolean;
     /**
      * @remarks
+     * Expand the initial box object bounds to include the 2nd box
+     * argument.  The resultant {@link
+     * @minecraft-server.BoundingBox} object will be a BoundingBox
+     * which exactly encompasses the two boxes.
+     *
      * This function can't be called in read-only mode.
      *
+     * @returns
+     * A new {@link @minecraft-server.BoundingBox} instance
+     * representing the smallest possible bounding box which can
+     * encompass both
      */
     static expand(box: BoundingBox, other: BoundingBox): BoundingBox;
     /**
      * @remarks
+     * Calculate the center block of a given {@link
+     * @minecraft-server.BoundingBox} object.
+     *
      * This function can't be called in read-only mode.
      *
+     * @returns
+     * Note that {@link @minecraft-server.BoundingBox} objects
+     * represent whole blocks, so the center of boxes which have
+     * odd numbered bounds are not mathematically centered...
+     * i.e. a BoundingBox( 0,0,0 -> 3,3,3 )  would have a center of
+     * (1,1,1)  (not (1.5, 1.5, 1.5) as expected)
      */
     static getCenter(box: BoundingBox): Vector3;
     /**
      * @remarks
+     * Calculate the BoundingBox which represents the union area of
+     * two intersecting BoundingBoxes
+     *
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
@@ -1739,32 +1857,44 @@ export class BoundingBoxUtils {
     static getIntersection(box: BoundingBox, other: BoundingBox): BoundingBox;
     /**
      * @remarks
+     * Get the Span of each of the BoundingBox Axis components
+     *
      * This function can't be called in read-only mode.
      *
      */
     static getSpan(box: BoundingBox): Vector3;
     /**
      * @remarks
+     * Check to see if two BoundingBox objects intersect
+     *
      * This function can't be called in read-only mode.
      *
      */
     static intersects(box: BoundingBox, other: BoundingBox): boolean;
     /**
      * @remarks
+     * Check to see if a given coordinate is inside a BoundingBox
+     *
      * This function can't be called in read-only mode.
      *
      */
     static isInside(box: BoundingBox, pos: Vector3): boolean;
     /**
      * @remarks
+     * Check to see if a BoundingBox is valid (i.e. (min <= max))
+     *
      * This function can't be called in read-only mode.
      *
      */
     static isValid(box: BoundingBox): boolean;
     /**
      * @remarks
+     * Move a BoundingBox by a given amount
+     *
      * This function can't be called in read-only mode.
      *
+     * @returns
+     * Return a new BoundingBox object which represents the change
      */
     static translate(box: BoundingBox, delta: Vector3): BoundingBox;
 }
@@ -1902,74 +2032,164 @@ export class Component {
 
 /**
  * @beta
+ * The Compound Block Volume is a collection of individual
+ * block volume definitions which, as a collection, define a
+ * larger volume of (sometimes non-contiguous) irregular
+ * shapes.
+ * This class is loosely based on the concept of CSG
+ * (Computational Solid Geometry) and allows a user to create
+ * complex volumes by building a stack of volumes and voids to
+ * make a larger single volume.
+ * For example - normally a creator would create a hollow cube
+ * by creating 6 "wall" surfaces for each face.
+ * With a Compound Block Volume, a creator can define a hollow
+ * cube by creating a single outer solid cube, and then
+ * defining a further single 'void' cube inside the larger one.
+ * Similarly, the Compound Block Volume can represent irregular
+ * shaped volumes (e.g. a tree consists of a trunk and lots of
+ * leaf cubes which are not necessarily contiguously placed)
  */
 export class CompoundBlockVolume {
+    /**
+     * @remarks
+     * Return the 'capacity' of the bounding rectangle which
+     * represents the collection of volumes in the stack
+     *
+     */
     readonly capacity: number;
+    /**
+     * @remarks
+     * Return the number of volumes (positive and negative) in the
+     * volume stack
+     *
+     */
     readonly volumeCount: number;
     /**
      * @remarks
+     * Clear the contents of the volume stack
+     *
      * This function can't be called in read-only mode.
      *
      */
     clear(): void;
     /**
      * @remarks
+     * Fetch a Block Location Iterator for the Compound Block
+     * Volume.  This iterator will allow a creator to iterate
+     * across all of the selected volumes within the larger
+     * bounding area.
+     * Areas of a volume which have been overridden by a
+     * subtractive volume will not be included in the iterator
+     * step.
+     * (i.e. if you push a cube to the stack, and then push a
+     * subtractive volume to the same location, then the iterator
+     * will step over the initial volume because it is considered
+     * negative space)
+     *
+     *
      * This function can't be called in read-only mode.
      *
      */
     getBlockLocationIterator(): BlockLocationIterator;
     /**
      * @remarks
+     * Get the largest bounding box that represents a container for
+     * all of the volumes on the stack
+     *
      * This function can't be called in read-only mode.
      *
      */
     getBoundingBox(): BoundingBox;
     /**
      * @remarks
+     * Get the max block location of the outermost bounding
+     * rectangle which represents the volumes on the stack
+     *
      * This function can't be called in read-only mode.
      *
      */
     getMax(): Vector3;
     /**
      * @remarks
+     * Get the min block location of the outermost bounding
+     * rectangle which represents the volumes on the stack
+     *
      * This function can't be called in read-only mode.
      *
      */
     getMin(): Vector3;
     /**
      * @remarks
+     * Return a boolean representing whether or not a given block
+     * location is inside a positive block volume.
+     * E.g. if the stack contains a large cube followed by a
+     * slightly smaller negative cube, and the test location is
+     * within the negative cube - the function will return false
+     * because it's not 'inside' a volume (it IS inside the
+     * bounding rectangle, but it is not inside a positively
+     * defined location)
+     *
      * This function can't be called in read-only mode.
      *
+     * @param delta
+     * block location to test
      */
     isInside(delta: Vector3): boolean;
     /**
      * @remarks
+     * Inspect the last entry pushed to the volume stack without
+     * affecting the stack contents
+     *
      * This function can't be called in read-only mode.
      *
+     * @returns
+     * Returns undefined if the stack is empty
      */
     peekLastVolume(): CompoundBlockVolumeItem | undefined;
     /**
      * @remarks
+     * Remove the last entry from the volume stack.  This will
+     * reduce the stack size by one
+     *
      * This function can't be called in read-only mode.
      *
      */
     popVolume(): boolean;
     /**
      * @remarks
+     * Push a volume item to the stack.  The volume item contains
+     * an 'action' parameter which determines whether this volume
+     * is a positive or negative space
+     *
      * This function can't be called in read-only mode.
      *
+     * @param item
+     * Item to push to the end of the stack
      */
     pushVolume(item: CompoundBlockVolumeItem): void;
     /**
      * @remarks
+     * If the volume stack is empty, this function will push the
+     * specified item to the stack.
+     * If the volume stack is NOT empty, this function will replace
+     * the last item on the stack with the new item.
+     *
      * This function can't be called in read-only mode.
      *
+     * @param item
+     * Item to add or replace
      */
     replaceOrAddLastVolume(item: CompoundBlockVolumeItem): boolean;
     /**
      * @remarks
+     * Move the root block location of the volume by a given
+     * amount.  This effectively adds the specified delta to the
+     * block location of all of the volumes in the stack
+     *
      * This function can't be called in read-only mode.
      *
+     * @param delta
+     * Amount to move
      */
     translate(delta: Vector3): void;
 }
@@ -2040,10 +2260,9 @@ export class Container {
      * out of bounds.
      * @example getItem.ts
      * ```typescript
-     *        // Get a copy of the first item in the player's hotbar
-     *        const inventory = player.getComponent("inventory") as EntityInventoryComponent;
-     *        const itemStack = inventory.container.getItem(0);
-     *
+     * // Get a copy of the first item in the player's hotbar
+     * const inventory = player.getComponent("inventory") as EntityInventoryComponent;
+     * const itemStack = inventory.container.getItem(0);
      * ```
      */
     getItem(slot: number): ItemStack | undefined;
@@ -2082,11 +2301,10 @@ export class Container {
      * or if the `fromSlot` or `toSlot` indices out of bounds.
      * @example moveItem.ts
      * ```typescript
-     *        // Move an item from the first slot of fromPlayer's inventory to the fifth slot of toPlayer's inventory
-     *        const fromInventory = fromPlayer.getComponent('inventory') as EntityInventoryComponent;
-     *        const toInventory = toPlayer.getComponent('inventory') as EntityInventoryComponent;
-     *        fromInventory.container.moveItem(0, 4, toInventory.container);
-     *
+     * // Move an item from the first slot of fromPlayer's inventory to the fifth slot of toPlayer's inventory
+     * const fromInventory = fromPlayer.getComponent('inventory') as EntityInventoryComponent;
+     * const toInventory = toPlayer.getComponent('inventory') as EntityInventoryComponent;
+     * fromInventory.container.moveItem(0, 4, toInventory.container);
      * ```
      */
     moveItem(fromSlot: number, toSlot: number, toContainer: Container): void;
@@ -2124,10 +2342,9 @@ export class Container {
      * invalid or if the `slot` or `otherSlot` are out of bounds.
      * @example swapItems.ts
      * ```typescript
-     *        // Swaps an item between slots 0 and 4 in the player's inventory
-     *        const inventory = fromPlayer.getComponent('inventory') as EntityInventoryComponent;
-     *        inventory.container.swapItems(0, 4, inventory);
-     *
+     * // Swaps an item between slots 0 and 4 in the player's inventory
+     * const inventory = fromPlayer.getComponent('inventory') as EntityInventoryComponent;
+     * inventory.container.swapItems(0, 4, inventory);
      * ```
      */
     swapItems(slot: number, otherSlot: number, otherContainer: Container): void;
@@ -2149,11 +2366,10 @@ export class Container {
      * or if the `fromSlot` or `toSlot` indices out of bounds.
      * @example transferItem.ts
      * ```typescript
-     *        // Transfer an item from the first slot of fromPlayer's inventory to toPlayer's inventory
-     *        const fromInventory = fromPlayer.getComponent('inventory') as EntityInventoryComponent;
-     *        const toInventory = toPlayer.getComponent('inventory') as EntityInventoryComponent;
-     *        fromInventory.container.transferItem(0, toInventory.container);
-     *
+     * // Transfer an item from the first slot of fromPlayer's inventory to toPlayer's inventory
+     * const fromInventory = fromPlayer.getComponent('inventory') as EntityInventoryComponent;
+     * const toInventory = toPlayer.getComponent('inventory') as EntityInventoryComponent;
+     * fromInventory.container.transferItem(0, toInventory.container);
      * ```
      */
     transferItem(fromSlot: number, toContainer: Container): ItemStack;
@@ -2188,6 +2404,13 @@ export class ContainerSlot {
      * Throws if the slot's container is invalid.
      */
     readonly isStackable: boolean;
+    /**
+     * @remarks
+     * Returns whether the ContainerSlot is valid. The container
+     * slot is valid if the container exists and is loaded, and the
+     * slot index is valid.
+     *
+     */
     readonly isValid: boolean;
     /**
      * @remarks
@@ -2258,10 +2481,23 @@ export class ContainerSlot {
      *
      * This function can't be called in read-only mode.
      *
+     * @returns
+     * Returns a copy of the item in the slot. Returns undefined if
+     * the slot is empty.
      * @throws
      * Throws if the slot's container is invalid.
      */
     clone(): ItemStack;
+    /**
+     * @remarks
+     * Creates an exact copy of the item stack, including any
+     * custom data or properties.
+     *
+     * @returns
+     * Returns a copy of the item in the slot. Returns undefined if
+     * the slot is empty.
+     * @throws This function can throw errors.
+     */
     getItem(): ItemStack | undefined;
     /**
      * @remarks
@@ -2275,7 +2511,27 @@ export class ContainerSlot {
      * Throws if the slot's container is invalid.
      */
     getLore(): string[];
+    /**
+     * @remarks
+     * Returns all tags for the item in the slot.
+     *
+     * @returns
+     * Returns all tags for the item in the slot. Return an empty
+     * array if the the slot is empty.
+     * @throws This function can throw errors.
+     */
     getTags(): string[];
+    /**
+     * @remarks
+     * Returns whether the item in the slot slot has the given tag.
+     *
+     * @param tag
+     * The item tag.
+     * @returns
+     * Returns false when the slot is empty or the item in the slot
+     * does not have the given tag.
+     * @throws This function can throw errors.
+     */
     hasTag(tag: string): boolean;
     /**
      * @remarks
@@ -2285,6 +2541,11 @@ export class ContainerSlot {
      * item stacks. The amount of each item stack is not taken into
      * consideration.
      *
+     * @param itemStack
+     * The ItemStack that is being compared.
+     * @returns
+     * Returns whether this item stack can be stacked with the
+     * given `itemStack`.
      * @throws
      * Throws if the slot's container is invalid.
      */
@@ -2297,6 +2558,8 @@ export class ContainerSlot {
      *
      * This function can't be called in read-only mode.
      *
+     * @param blockIdentifiers
+     * The list of blocks, given by their identifiers.
      * @throws
      * Throws if the slot's container is invalid. Also throws if
      * any of the provided block identifiers are invalid.
@@ -2311,6 +2574,8 @@ export class ContainerSlot {
      *
      * This function can't be called in read-only mode.
      *
+     * @param blockIdentifiers
+     * The list of blocks, given by their identifiers.
      * @throws
      * Throws if the slot's container is invalid. Also throws if
      * any of the provided block identifiers are invalid.
@@ -2318,8 +2583,13 @@ export class ContainerSlot {
     setCanPlaceOn(blockIdentifiers?: string[]): void;
     /**
      * @remarks
+     * Sets the given ItemStack in the slot, replacing any existing
+     * item.
+     *
      * This function can't be called in read-only mode.
      *
+     * @param itemStack
+     * The ItemStack to be placed in the slot.
      * @throws This function can throw errors.
      */
     setItem(itemStack?: ItemStack): void;
@@ -2330,6 +2600,9 @@ export class ContainerSlot {
      *
      * This function can't be called in read-only mode.
      *
+     * @param loreList
+     * A list of lore strings. Setting this argument to undefined
+     * will clear the lore.
      * @throws
      * Throws if the slot's container is invalid.
      */
@@ -2510,43 +2783,41 @@ export class Dimension {
      * @throws This function can throw errors.
      * @example createExplosion.ts
      * ```typescript
-     *          overworld.createExplosion(targetLocation, 10, new mc.ExplosionOptions());
+     *   overworld.createExplosion(targetLocation, 10, new mc.ExplosionOptions());
      * ```
      * @example createFireAndWaterExplosions.ts
      * ```typescript
-     *        const explosionLoc: mc.Vector3 = { x: targetLocation.x + 0.5, y: targetLocation.y + 0.5, z: targetLocation.z + 0.5 };
-     *
-     *        const fireExplosionOptions = new mc.ExplosionOptions();
+     * const explosionLoc: mc.Vector3 = { x: targetLocation.x + 0.5, y: targetLocation.y + 0.5, z: targetLocation.z + 0.5 };
      *
-     *        // Explode with fire
-     *        fireExplosionOptions.causesFire = true;
+     * const fireExplosionOptions = new mc.ExplosionOptions();
      *
-     *        overworld.createExplosion(explosionLoc, 15, fireExplosionOptions);
-     *        const waterExplosionOptions = new mc.ExplosionOptions();
+     * // Explode with fire
+     * fireExplosionOptions.causesFire = true;
      *
-     *        // Explode in water
-     *        waterExplosionOptions.allowUnderwater = true;
+     * overworld.createExplosion(explosionLoc, 15, fireExplosionOptions);
+     * const waterExplosionOptions = new mc.ExplosionOptions();
      *
-     *        const belowWaterLoc: mc.Vector3 = { x: targetLocation.x + 3, y: targetLocation.y + 1, z: targetLocation.z + 3 };
+     * // Explode in water
+     * waterExplosionOptions.allowUnderwater = true;
      *
-     *        overworld.createExplosion(belowWaterLoc, 10, waterExplosionOptions);
+     * const belowWaterLoc: mc.Vector3 = { x: targetLocation.x + 3, y: targetLocation.y + 1, z: targetLocation.z + 3 };
      *
+     * overworld.createExplosion(belowWaterLoc, 10, waterExplosionOptions);
      * ```
      * @example createNoBlockExplosion.ts
      * ```typescript
-     *        const explosionOptions = new mc.ExplosionOptions();
+     * const explosionOptions = new mc.ExplosionOptions();
      *
-     *        // Start by exploding without breaking blocks
-     *        explosionOptions.breaksBlocks = false;
+     * // Start by exploding without breaking blocks
+     * explosionOptions.breaksBlocks = false;
      *
-     *        const explodeNoBlocksLoc: mc.Vector3 = {
-     *          x: Math.floor(targetLocation.x + 1),
-     *          y: Math.floor(targetLocation.y + 2),
-     *          z: Math.floor(targetLocation.z + 1),
-     *        };
-     *
-     *        overworld.createExplosion(explodeNoBlocksLoc, 15, explosionOptions);
+     * const explodeNoBlocksLoc: mc.Vector3 = {
+     *   x: Math.floor(targetLocation.x + 1),
+     *   y: Math.floor(targetLocation.y + 2),
+     *   z: Math.floor(targetLocation.z + 1),
+     * };
      *
+     * overworld.createExplosion(explodeNoBlocksLoc, 15, explosionOptions);
      * ```
      */
     createExplosion(location: Vector3, radius: number, explosionOptions?: ExplosionOptions): void;
@@ -2613,22 +2884,21 @@ export class Dimension {
      * @throws This function can throw errors.
      * @example testThatEntityIsFeatherItem.ts
      * ```typescript
-     *        const query = {
-     *          type: "item",
-     *          location: targetLocation,
-     *        };
-     *        const items = overworld.getEntities(query);
-     *
-     *        for (const item of items) {
-     *          const itemComp = item.getComponent("item") as any;
-     *
-     *          if (itemComp) {
-     *            if (itemComp.itemStack.id.endsWith("feather")) {
-     *              console.log("Success! Found a feather", 1);
-     *            }
-     *          }
-     *        }
-     *
+     * const query = {
+     *   type: "item",
+     *   location: targetLocation,
+     * };
+     * const items = overworld.getEntities(query);
+     *
+     * for (const item of items) {
+     *   const itemComp = item.getComponent("item") as any;
+     *
+     *   if (itemComp) {
+     *     if (itemComp.itemStack.id.endsWith("feather")) {
+     *       console.log("Success! Found a feather", 1);
+     *     }
+     *   }
+     * }
      * ```
      */
     getEntities(options?: EntityQueryOptions): Entity[];
@@ -2717,41 +2987,40 @@ export class Dimension {
      * @throws This function can throw errors.
      * @example createOldHorse.ts
      * ```typescript
-     *          // create a horse and trigger the 'ageable_grow_up' event, ensuring the horse is created as an adult
-     *          overworld.spawnEntity("minecraft:horse<minecraft:ageable_grow_up>", targetLocation);
+     *   // create a horse and trigger the 'ageable_grow_up' event, ensuring the horse is created as an adult
+     *   overworld.spawnEntity("minecraft:horse<minecraft:ageable_grow_up>", targetLocation);
      * ```
      * @example quickFoxLazyDog.ts
      * ```typescript
-     *        const fox = overworld.spawnEntity("minecraft:fox", {
-     *          x: targetLocation.x + 1,
-     *          y: targetLocation.y + 2,
-     *          z: targetLocation.z + 3,
-     *        });
-     *        fox.addEffect(mc.MinecraftEffectTypes.speed, 10, 20);
-     *        log("Created a fox.");
-     *
-     *        const wolf = overworld.spawnEntity("minecraft:wolf", {
-     *          x: targetLocation.x + 4,
-     *          y: targetLocation.y + 2,
-     *          z: targetLocation.z + 3,
-     *        });
-     *        wolf.addEffect(mc.MinecraftEffectTypes.slowness, 10, 20);
-     *        wolf.isSneaking = true;
-     *        log("Created a sneaking wolf.", 1);
-     *
+     * const fox = overworld.spawnEntity("minecraft:fox", {
+     *   x: targetLocation.x + 1,
+     *   y: targetLocation.y + 2,
+     *   z: targetLocation.z + 3,
+     * });
+     * fox.addEffect(mc.MinecraftEffectTypes.speed, 10, 20);
+     * log("Created a fox.");
+     *
+     * const wolf = overworld.spawnEntity("minecraft:wolf", {
+     *   x: targetLocation.x + 4,
+     *   y: targetLocation.y + 2,
+     *   z: targetLocation.z + 3,
+     * });
+     * wolf.addEffect(mc.MinecraftEffectTypes.slowness, 10, 20);
+     * wolf.isSneaking = true;
+     * log("Created a sneaking wolf.", 1);
      * ```
      * @example trapTick.ts
      * ```typescript
-     *          let ticks = 0;
+     *   let ticks = 0;
      *
-     *          mc.world.events.tick.subscribe((event: mc.TickEvent) => {
-     *            ticks++;
+     *   mc.world.events.tick.subscribe((event: mc.TickEvent) => {
+     *     ticks++;
      *
-     *            // Minecraft runs at 20 ticks per second
-     *            if (ticks % 1200 === 0) {
-     *              overworld.runCommand("say Another minute passes...");
-     *            }
-     *          });
+     *     // Minecraft runs at 20 ticks per second
+     *     if (ticks % 1200 === 0) {
+     *       overworld.runCommand("say Another minute passes...");
+     *     }
+     *   });
      * ```
      */
     spawnEntity(identifier: string, location: Vector3): Entity;
@@ -2770,25 +3039,24 @@ export class Dimension {
      * @throws This function can throw errors.
      * @example itemStacks.ts
      * ```typescript
-     *        const oneItemLoc: mc.Vector3 = { x: 3, y: 2, z: 1 };
-     *        const fiveItemsLoc: mc.Vector3 = { x: 1, y: 2, z: 1 };
-     *        const diamondPickaxeLoc: mc.Vector3 = { x: 2, y: 2, z: 4 };
-     *
-     *        const oneEmerald = new mc.ItemStack(mc.MinecraftItemTypes.emerald, 1, 0);
-     *        const onePickaxe = new mc.ItemStack(mc.MinecraftItemTypes.diamondPickaxe, 1, 0);
-     *        const fiveEmeralds = new mc.ItemStack(mc.MinecraftItemTypes.emerald, 5, 0);
+     * const oneItemLoc: mc.Vector3 = { x: 3, y: 2, z: 1 };
+     * const fiveItemsLoc: mc.Vector3 = { x: 1, y: 2, z: 1 };
+     * const diamondPickaxeLoc: mc.Vector3 = { x: 2, y: 2, z: 4 };
      *
-     *        overworld.spawnItem(oneEmerald, oneItemLoc);
-     *        overworld.spawnItem(fiveEmeralds, fiveItemsLoc);
-     *        overworld.spawnItem(onePickaxe, diamondPickaxeLoc);
+     * const oneEmerald = new mc.ItemStack(mc.MinecraftItemTypes.emerald, 1, 0);
+     * const onePickaxe = new mc.ItemStack(mc.MinecraftItemTypes.diamondPickaxe, 1, 0);
+     * const fiveEmeralds = new mc.ItemStack(mc.MinecraftItemTypes.emerald, 5, 0);
      *
+     * overworld.spawnItem(oneEmerald, oneItemLoc);
+     * overworld.spawnItem(fiveEmeralds, fiveItemsLoc);
+     * overworld.spawnItem(onePickaxe, diamondPickaxeLoc);
      * ```
      * @example spawnItem.ts
      * ```typescript
-     *          const featherItem = new mc.ItemStack(mc.MinecraftItemTypes.feather, 1, 0);
+     *   const featherItem = new mc.ItemStack(mc.MinecraftItemTypes.feather, 1, 0);
      *
-     *          overworld.spawnItem(featherItem, targetLocation);
-     *          log("New feather created!");
+     *   overworld.spawnItem(featherItem, targetLocation);
+     *   log("New feather created!");
      * ```
      */
     spawnItem(itemStack: ItemStack, location: Vector3): Entity;
@@ -3247,7 +3515,7 @@ export class Entity {
     /**
      * @beta
      * @remarks
-     * Adds an effect, like poison, to the entity.
+     * Adds or updates an effect, like poison, to the entity.
      *
      * This function can't be called in read-only mode.
      *
@@ -3256,39 +3524,43 @@ export class Entity {
      * @param duration
      * Amount of time, in ticks, for the effect to apply. There are
      * 20 ticks per second. Use {@link TicksPerSecond} constant to
-     * convert between ticks and seconds.
+     * convert between ticks and seconds. The value must be within
+     * the range [0, 20000000].
      * @param options
      * Additional options for the effect.
+     * @returns
+     * Returns nothing if the effect was added or updated
+     * successfully. This can throw an error if the duration or
+     * amplifier are outside of the valid ranges, or if the effect
+     * does not exist.
      * @throws This function can throw errors.
      * @example addEffect.js
      * ```typescript
-     *        const villagerId = 'minecraft:villager_v2<minecraft:ageable_grow_up>';
-     *        const villagerLoc: mc.Vector3 = { x: 1, y: 2, z: 1 };
-     *        const villager = test.spawn(villagerId, villagerLoc);
-     *        const duration = 20;
-     *
-     *        villager.addEffect(EffectTypes.get('poison'), duration, { amplifier: 1 });
+     * const villagerId = 'minecraft:villager_v2<minecraft:ageable_grow_up>';
+     * const villagerLoc: mc.Vector3 = { x: 1, y: 2, z: 1 };
+     * const villager = test.spawn(villagerId, villagerLoc);
+     * const duration = 20;
      *
+     * villager.addEffect(EffectTypes.get('poison'), duration, { amplifier: 1 });
      * ```
      * @example quickFoxLazyDog.ts
      * ```typescript
-     *        const fox = overworld.spawnEntity('minecraft:fox', {
-     *            x: targetLocation.x + 1,
-     *            y: targetLocation.y + 2,
-     *            z: targetLocation.z + 3,
-     *        });
-     *        fox.addEffect(mc.MinecraftEffectTypes.speed, 10, { amplifier: 20 });
-     *        log('Created a fox.');
-     *
-     *        const wolf = overworld.spawnEntity('minecraft:wolf', {
-     *            x: targetLocation.x + 4,
-     *            y: targetLocation.y + 2,
-     *            z: targetLocation.z + 3,
-     *        });
-     *        wolf.addEffect(mc.MinecraftEffectTypes.slowness, 10, { amplifier: 20 });
-     *        wolf.isSneaking = true;
-     *        log('Created a sneaking wolf.', 1);
-     *
+     * const fox = overworld.spawnEntity('minecraft:fox', {
+     *     x: targetLocation.x + 1,
+     *     y: targetLocation.y + 2,
+     *     z: targetLocation.z + 3,
+     * });
+     * fox.addEffect(mc.MinecraftEffectTypes.speed, 10, { amplifier: 20 });
+     * log('Created a fox.');
+     *
+     * const wolf = overworld.spawnEntity('minecraft:wolf', {
+     *     x: targetLocation.x + 4,
+     *     y: targetLocation.y + 2,
+     *     z: targetLocation.z + 3,
+     * });
+     * wolf.addEffect(mc.MinecraftEffectTypes.slowness, 10, { amplifier: 20 });
+     * wolf.isSneaking = true;
+     * log('Created a sneaking wolf.', 1);
      * ```
      */
     addEffect(effectType: EffectType | string, duration: number, options?: EntityEffectOptions): boolean;
@@ -3301,6 +3573,9 @@ export class Entity {
      *
      * @param tag
      * Content of the tag to add.
+     * @returns
+     * Returns true if the tag was added successfully. This can
+     * fail if the tag already exists on the entity.
      * @throws This function can throw errors.
      */
     addTag(tag: string): boolean;
@@ -3317,6 +3592,10 @@ export class Entity {
      * Additional options about the source of damage, which may add
      * additional effects or spur additional behaviors on this
      * entity.
+     * @returns
+     * Whether the entity takes any damage. This can return false
+     * if the entity is invulnerable or if the damage applied is
+     * less than or equal to 0.
      * @throws This function can throw errors.
      */
     applyDamage(amount: number, options?: EntityApplyDamageByProjectileOptions | EntityApplyDamageOptions): boolean;
@@ -3375,6 +3654,8 @@ export class Entity {
      * @param useEffects
      * Whether to show any visual effects connected to the
      * extinguishing.
+     * @returns
+     * Returns whether the entity was on fire.
      * @throws This function can throw errors.
      */
     extinguishFire(useEffects?: boolean): boolean;
@@ -3384,6 +3665,11 @@ export class Entity {
      * Returns the first intersecting block from the direction that
      * this entity is looking at.
      *
+     * @param options
+     * Additional configuration options for the ray cast.
+     * @returns
+     * Returns the first intersecting block from the direction that
+     * this entity is looking at.
      * @throws This function can throw errors.
      */
     getBlockFromViewDirection(options?: BlockRaycastOptions): Block;
@@ -3398,6 +3684,9 @@ export class Entity {
      * to retrieve. If no namespace prefix is specified,
      * 'minecraft:' is assumed. If the component is not present on
      * the entity, undefined is returned.
+     * @returns
+     * Returns the component if it exists on the entity, otherwise
+     * undefined.
      */
     getComponent(componentId: string): EntityComponent | undefined;
     /**
@@ -3406,6 +3695,9 @@ export class Entity {
      * Returns all components that are both present on this entity
      * and supported by the API.
      *
+     * @returns
+     * Returns all components that are both present on this entity
+     * and supported by the API.
      */
     getComponents(): EntityComponent[];
     /**
@@ -3413,6 +3705,8 @@ export class Entity {
      * @remarks
      * Returns a property value.
      *
+     * @param identifier
+     * The property identifier.
      * @returns
      * Returns the value for the property, or undefined if the
      * property has not been set.
@@ -3423,11 +3717,15 @@ export class Entity {
      * @beta
      * @remarks
      * Returns the effect for the specified EffectType on the
-     * entity, or undefined if the effect is not present.
+     * entity, undefined if the effect is not present, or throws an
+     * error if the effect does not exist.
      *
+     * @param effectType
+     * The effect identifier.
      * @returns
-     * Effect object for the specified effect, or undefined if the
-     * effect is not present.
+     * Effect object for the specified effect, undefined if the
+     * effect is not present, or throws an error if the effect does
+     * not exist.
      * @throws This function can throw errors.
      */
     getEffect(effectType: EffectType | string): Effect | undefined;
@@ -3444,9 +3742,14 @@ export class Entity {
     /**
      * @beta
      * @remarks
-     * Returns a potential set of entities from the direction that
-     * this entity is looking at.
+     * Gets the entities that this entity is looking at by
+     * performing a ray cast from the view of this entity.
      *
+     * @param options
+     * Additional configuration options for the ray cast.
+     * @returns
+     * Returns a set of entities from the direction that this
+     * entity is looking at.
      * @throws This function can throw errors.
      */
     getEntitiesFromViewDirection(options?: EntityRaycastOptions): Entity[];
@@ -3456,6 +3759,9 @@ export class Entity {
      * Returns the current location of the head component of this
      * entity.
      *
+     * @returns
+     * Returns the current location of the head component of this
+     * entity.
      * @throws This function can throw errors.
      */
     getHeadLocation(): Vector3;
@@ -3464,6 +3770,8 @@ export class Entity {
      * @remarks
      * Returns the current rotation component of this entity.
      *
+     * @returns
+     * Returns the current rotation component of this entity.
      * @throws This function can throw errors.
      */
     getRotation(): Vector2;
@@ -3472,6 +3780,8 @@ export class Entity {
      * @remarks
      * Returns all tags associated with an entity.
      *
+     * @returns
+     * Returns the current rotation component of this entity.
      * @throws This function can throw errors.
      */
     getTags(): string[];
@@ -3480,6 +3790,8 @@ export class Entity {
      * @remarks
      * Returns the current velocity vector of the entity.
      *
+     * @returns
+     * Returns the current velocity vector of the entity.
      * @throws This function can throw errors.
      */
     getVelocity(): Vector3;
@@ -3488,6 +3800,8 @@ export class Entity {
      * @remarks
      * Returns the current view direction of the entity.
      *
+     * @returns
+     * Returns the current view direction of the entity.
      * @throws This function can throw errors.
      */
     getViewDirection(): Vector3;
@@ -3501,15 +3815,20 @@ export class Entity {
      * The identifier of the component (e.g., 'minecraft:rideable')
      * to retrieve. If no namespace prefix is specified,
      * 'minecraft:' is assumed.
+     * @returns
+     * Returns true if the specified component is present on this
+     * entity.
      */
     hasComponent(componentId: string): boolean;
     /**
      * @beta
      * @remarks
-     * Tests whether an entity has a particular tag.
+     * Returns whether an entity has a particular tag.
      *
      * @param tag
      * Identifier of the tag to test for.
+     * @returns
+     * Returns whether an entity has a particular tag.
      * @throws This function can throw errors.
      */
     hasTag(tag: string): boolean;
@@ -3529,8 +3848,15 @@ export class Entity {
     /**
      * @beta
      * @remarks
+     * Cause the entity to play the given animation.
+     *
      * This function can't be called in read-only mode.
      *
+     * @param animationName
+     * The animation identifier. e.g. animation.creeper.swelling
+     * @param options
+     * Additional options to control the playback and transitions
+     * of the animation.
      * @throws This function can throw errors.
      */
     playAnimation(animationName: string, options?: PlayAnimationOptions): void;
@@ -3539,6 +3865,10 @@ export class Entity {
      * @remarks
      * Removes a specified property.
      *
+     * @param identifier
+     * The property identifier.
+     * @returns
+     * Returns whether the given property existed on the entity.
      * @throws This function can throw errors.
      */
     removeDynamicProperty(identifier: string): boolean;
@@ -3550,9 +3880,12 @@ export class Entity {
      *
      * This function can't be called in read-only mode.
      *
+     * @param effectType
+     * The effect identifier.
      * @returns
-     * Returns true if the effect has been removed and false if the
-     * effect is not present.
+     * Returns true if the effect has been removed, false if the
+     * effect is not present, or will throw an error if the effect
+     * does not exist.
      * @throws This function can throw errors.
      */
     removeEffect(effectType: EffectType | string): boolean;
@@ -3565,6 +3898,8 @@ export class Entity {
      *
      * @param tag
      * Content of the tag to remove.
+     * @returns
+     * Returns whether the tag existed on the entity.
      * @throws This function can throw errors.
      */
     removeTag(tag: string): boolean;
@@ -3575,6 +3910,12 @@ export class Entity {
      *
      * This function can't be called in read-only mode.
      *
+     * @param commandString
+     * The command string. Note: This should not include a leading
+     * forward slash.
+     * @returns
+     * A command result containing whether the command was
+     * successful.
      * @throws This function can throw errors.
      */
     runCommand(commandString: string): CommandResult;
@@ -3598,6 +3939,8 @@ export class Entity {
      * @remarks
      * Sets a specified property to a value.
      *
+     * @param identifier
+     * The property identifier.
      * @param value
      * Data value of the property to set.
      * @throws This function can throw errors.
@@ -3614,6 +3957,14 @@ export class Entity {
      *
      * @param seconds
      * Length of time to set the entity on fire.
+     * @param useEffects
+     * Whether side-effects should be applied (e.g. thawing freeze)
+     * and other conditions such as rain or fire protection should
+     * be taken into consideration.
+     * @returns
+     * Whether the entity was set on fire. This can fail if seconds
+     * is less than or equal to zero, the entity is wet or the
+     * entity is immune to fire.
      * @throws This function can throw errors.
      */
     setOnFire(seconds: number, useEffects?: boolean): boolean;
@@ -3624,6 +3975,10 @@ export class Entity {
      *
      * This function can't be called in read-only mode.
      *
+     * @param rotation
+     * The x and y rotation of the entity. For most mobs, the x
+     * rotation controls the head tilt and the y rotation controls
+     * the body rotation.
      * @throws This function can throw errors.
      */
     setRotation(rotation: Vector2): void;
@@ -3636,6 +3991,8 @@ export class Entity {
      *
      * @param location
      * New location for the entity.
+     * @param teleportOptions
+     * Options regarding the teleport operation.
      * @throws This function can throw errors.
      */
     teleport(location: Vector3, teleportOptions?: TeleportOptions): void;
@@ -3668,6 +4025,10 @@ export class Entity {
      * Location to teleport the entity to.
      * @param teleportOptions
      * Options regarding the teleport operation.
+     * @returns
+     * Returns whether the teleport succeeded. This can fail if the
+     * destination chunk is unloaded or if the teleport would
+     * result in intersecting with blocks.
      * @throws This function can throw errors.
      */
     tryTeleport(location: Vector3, teleportOptions?: TeleportOptions): boolean;
@@ -4025,28 +4386,51 @@ export class EntityDieAfterEventSignal extends IEntityDieAfterEventSignal {
 
 /**
  * @beta
+ * Provides access to a mob's equipment slots. This component
+ * exists for all mob entities.
  */
 export class EntityEquipmentInventoryComponent extends EntityComponent {
     protected constructor();
     static readonly componentId = 'minecraft:equipment_inventory';
     /**
      * @remarks
+     * Gets the equipped item for the given EquipmentSlot.
+     *
      * This function can't be called in read-only mode.
      *
+     * @param equipmentSlot
+     * The equipment slot. e.g. "head", "chest", "offhand"
+     * @returns
+     * Returns the item equipped to the given EquipmentSlot. If
+     * empty, returns undefined.
      * @throws This function can throw errors.
      */
     getEquipment(equipmentSlot: EquipmentSlot): ItemStack | undefined;
     /**
      * @remarks
+     * Gets the ContainerSlot corresponding to the given
+     * EquipmentSlot.
+     *
      * This function can't be called in read-only mode.
      *
+     * @param equipmentSlot
+     * The equipment slot. e.g. "head", "chest", "offhand".
+     * @returns
+     * Returns the ContainerSlot corresponding to the given
+     * EquipmentSlot.
      * @throws This function can throw errors.
      */
     getEquipmentSlot(equipmentSlot: EquipmentSlot): ContainerSlot;
     /**
      * @remarks
+     * Replaces the item in the given EquipmentSlot.
+     *
      * This function can't be called in read-only mode.
      *
+     * @param equipmentSlot
+     * The equipment slot. e.g. "head", "chest", "offhand".
+     * @param itemStack
+     * The item to equip. If undefined, clears the slot.
      * @throws This function can throw errors.
      */
     setEquipment(equipmentSlot: EquipmentSlot, itemStack?: ItemStack): void;
@@ -6603,36 +6987,16 @@ export class IServerMessageAfterEventSignal {
 
 /**
  * @beta
- * Contains information related to a chargeable item completing
- * being charged.
  */
 export class ItemCompleteChargeAfterEvent {
     protected constructor();
-    /**
-     * @remarks
-     * Returns the item stack that has completed charging.
-     *
-     */
     readonly itemStack: ItemStack;
-    /**
-     * @remarks
-     * Returns the source entity that triggered this item event.
-     *
-     */
     readonly source: Entity;
-    /**
-     * @remarks
-     * Returns the time, in ticks, for the remaining duration left
-     * before the charge completes its cycle.
-     *
-     */
     readonly useDuration: number;
 }
 
 /**
  * @beta
- * Manages callbacks that are connected to the completion of
- * charging for a chargeable item.
  */
 export class ItemCompleteChargeAfterEventSignal extends IItemCompleteChargeAfterEventSignal {
     protected constructor();
@@ -6887,37 +7251,16 @@ export class ItemFoodComponent extends ItemComponent {
 
 /**
  * @beta
- * Contains information related to a chargeable item when the
- * player has finished using the item and released the build
- * action.
  */
 export class ItemReleaseChargeAfterEvent {
     protected constructor();
-    /**
-     * @remarks
-     * Returns the item stack that triggered this item event.
-     *
-     */
     readonly itemStack: ItemStack;
-    /**
-     * @remarks
-     * Returns the source entity that triggered this item event.
-     *
-     */
     readonly source: Entity;
-    /**
-     * @remarks
-     * Returns the time, in ticks, for the remaining duration left
-     * before the charge completes its cycle.
-     *
-     */
     readonly useDuration: number;
 }
 
 /**
  * @beta
- * Manages callbacks that are connected to the releasing of
- * charging for a chargeable item.
  */
 export class ItemReleaseChargeAfterEventSignal extends IItemReleaseChargeAfterEventSignal {
     protected constructor();
@@ -7040,11 +7383,10 @@ export class ItemStack {
      * stack, undefined is returned.
      * @example durability.ts
      * ```typescript
-     *        // Get the maximum durability of a custom sword item
-     *        const itemStack = new ItemStack("custom:sword");
-     *        const durability = itemStack.getComponent("minecraft:durability") as ItemDurabilityComponent;
-     *        const maxDurability = durability.maxDurability;
-     *
+     * // Get the maximum durability of a custom sword item
+     * const itemStack = new ItemStack("custom:sword");
+     * const durability = itemStack.getComponent("minecraft:durability") as ItemDurabilityComponent;
+     * const maxDurability = durability.maxDurability;
      * ```
      */
     getComponent(componentId: string): ItemComponent | undefined;
@@ -7120,10 +7462,9 @@ export class ItemStack {
      * Throws if any of the provided block identifiers are invalid.
      * @example example.ts
      * ```typescript
-     *        // Creates a diamond pickaxe that can destroy cobblestone and obsidian
-     *        const specialPickaxe = new ItemStack("minecraft:diamond_pickaxe");
-     *        specialPickaxe.setCanDestroy(["minecraft:cobblestone", "minecraft:obsidian"]);
-     *
+     * // Creates a diamond pickaxe that can destroy cobblestone and obsidian
+     * const specialPickaxe = new ItemStack("minecraft:diamond_pickaxe");
+     * specialPickaxe.setCanDestroy(["minecraft:cobblestone", "minecraft:obsidian"]);
      * ```
      */
     setCanDestroy(blockIdentifiers?: string[]): void;
@@ -7141,10 +7482,9 @@ export class ItemStack {
      * Throws if any of the provided block identifiers are invalid.
      * @example example.ts
      * ```typescript
-     *        // Creates a gold block that can be placed on grass and dirt
-     *        const specialGoldBlock = new ItemStack("minecraft:gold_block");
-     *        specialPickaxe.setCanPlaceOn(["minecraft:grass", "minecraft:dirt"]);
-     *
+     * // Creates a gold block that can be placed on grass and dirt
+     * const specialGoldBlock = new ItemStack("minecraft:gold_block");
+     * specialPickaxe.setCanPlaceOn(["minecraft:grass", "minecraft:dirt"]);
      * ```
      */
     setCanPlaceOn(blockIdentifiers?: string[]): void;
@@ -7158,10 +7498,9 @@ export class ItemStack {
      *
      * @example multilineLore.ts
      * ```typescript
-     *        // Set the lore of an item to multiple lines of text
-     *        const itemStack = new ItemStack("minecraft:diamond_sword");
-     *        itemStack.setLore(["Line 1", "Line 2", "Line 3"]);
-     *
+     * // Set the lore of an item to multiple lines of text
+     * const itemStack = new ItemStack("minecraft:diamond_sword");
+     * itemStack.setLore(["Line 1", "Line 2", "Line 3"]);
      * ```
      */
     setLore(loreList?: string[]): void;
@@ -7183,36 +7522,16 @@ export class ItemStack {
 
 /**
  * @beta
- * Contains information related to a chargeable item starting
- * to be charged.
  */
 export class ItemStartChargeAfterEvent {
     protected constructor();
-    /**
-     * @remarks
-     * The impacted item stack that is starting to be charged.
-     *
-     */
     readonly itemStack: ItemStack;
-    /**
-     * @remarks
-     * Returns the source entity that triggered this item event.
-     *
-     */
     readonly source: Entity;
-    /**
-     * @remarks
-     * Returns the time, in ticks, for the remaining duration left
-     * before the charge completes its cycle.
-     *
-     */
     readonly useDuration: number;
 }
 
 /**
  * @beta
- * Manages callbacks that are connected to the start of
- * charging for a chargeable item.
  */
 export class ItemStartChargeAfterEventSignal extends IItemStartChargeAfterEventSignal {
     protected constructor();
@@ -7265,38 +7584,16 @@ export class ItemStartUseOnAfterEventSignal extends IItemStartUseOnAfterEventSig
 
 /**
  * @beta
- * Contains information related to a chargeable item has
- * finished an items use cycle, or when the player has released
- * the use action with the item.
  */
 export class ItemStopChargeAfterEvent {
     protected constructor();
-    /**
-     * @remarks
-     * The impacted item stack that is stopping being charged.
-     *
-     */
     readonly itemStack: ItemStack;
-    /**
-     * @remarks
-     * Returns the source entity that triggered this item event.
-     *
-     */
     readonly source: Entity;
-    /**
-     * @remarks
-     * Returns the time, in ticks, for the remaining duration left
-     * before the charge completes its cycle.
-     *
-     */
     readonly useDuration: number;
 }
 
 /**
  * @beta
- * Manages callbacks that are connected to the stopping of
- * charging for an item that has a registered
- * minecraft:chargeable component.
  */
 export class ItemStopChargeAfterEventSignal extends IItemStopChargeAfterEventSignal {
     protected constructor();
@@ -16395,33 +16692,29 @@ export class Player extends Entity {
      * is provided to `score`.
      * @example nestedTranslation.ts
      * ```typescript
-     *        // Displays "Apple or Coal"
-     *        let rawMessage = {
-     *          translate: "accessibility.list.or.two",
-     *          with: { rawtext: [{ translate: "item.apple.name" }, { translate: "item.coal.name" }] },
-     *        };
-     *        player.sendMessage(rawMessage);
-     *
+     * // Displays "Apple or Coal"
+     * let rawMessage = {
+     *   translate: "accessibility.list.or.two",
+     *   with: { rawtext: [{ translate: "item.apple.name" }, { translate: "item.coal.name" }] },
+     * };
+     * player.sendMessage(rawMessage);
      * ```
      * @example scoreWildcard.ts
      * ```typescript
-     *        // Displays the player's score for objective "obj". Each player will see their own score.
-     *        const rawMessage = { score: { name: "*", objective: "obj" } };
-     *        world.sendMessage(rawMessage);
-     *
+     * // Displays the player's score for objective "obj". Each player will see their own score.
+     * const rawMessage = { score: { name: "*", objective: "obj" } };
+     * world.sendMessage(rawMessage);
      * ```
      * @example simpleString.ts
      * ```typescript
-     *        // Displays "Hello, world!"
-     *        world.sendMessage("Hello, world!");
-     *
+     * // Displays "Hello, world!"
+     * world.sendMessage("Hello, world!");
      * ```
      * @example translation.ts
      * ```typescript
-     *        // Displays "First or Second"
-     *        const rawMessage = { translate: "accessibility.list.or.two", with: ["First", "Second"] };
-     *        player.sendMessage(rawMessage);
-     *
+     * // Displays "First or Second"
+     * const rawMessage = { translate: "accessibility.list.or.two", with: ["First", "Second"] };
+     * player.sendMessage(rawMessage);
      * ```
      */
     sendMessage(message: (RawMessage | string)[] | RawMessage | string): void;
@@ -17660,33 +17953,29 @@ export class World {
      * is provided to `score`.
      * @example nestedTranslation.ts
      * ```typescript
-     *        // Displays "Apple or Coal"
-     *        let rawMessage = {
-     *          translate: "accessibility.list.or.two",
-     *          with: { rawtext: [{ translate: "item.apple.name" }, { translate: "item.coal.name" }] },
-     *        };
-     *        world.sendMessage(rawMessage);
-     *
+     * // Displays "Apple or Coal"
+     * let rawMessage = {
+     *   translate: "accessibility.list.or.two",
+     *   with: { rawtext: [{ translate: "item.apple.name" }, { translate: "item.coal.name" }] },
+     * };
+     * world.sendMessage(rawMessage);
      * ```
      * @example scoreWildcard.ts
      * ```typescript
-     *        // Displays the player's score for objective "obj". Each player will see their own score.
-     *        const rawMessage = { score: { name: "*", objective: "obj" } };
-     *        world.sendMessage(rawMessage);
-     *
+     * // Displays the player's score for objective "obj". Each player will see their own score.
+     * const rawMessage = { score: { name: "*", objective: "obj" } };
+     * world.sendMessage(rawMessage);
      * ```
      * @example simpleString.ts
      * ```typescript
-     *        // Displays "Hello, world!"
-     *        world.sendMessage("Hello, world!");
-     *
+     * // Displays "Hello, world!"
+     * world.sendMessage("Hello, world!");
      * ```
      * @example translation.ts
      * ```typescript
-     *        // Displays "First or Second"
-     *        const rawMessage = { translate: "accessibility.list.or.two", with: ["First", "Second"] };
-     *        world.sendMessage(rawMessage);
-     *
+     * // Displays "First or Second"
+     * const rawMessage = { translate: "accessibility.list.or.two", with: ["First", "Second"] };
+     * world.sendMessage(rawMessage);
      * ```
      */
     sendMessage(message: (RawMessage | string)[] | RawMessage | string): void;
@@ -17754,18 +18043,17 @@ export class WorldInitializeAfterEvent {
      *
      * @example propertyRegistration.js
      * ```typescript
-     *        import { DynamicPropertiesDefinition, MinecraftEntityTypes, world } from "@minecraft/server";
+     * import { DynamicPropertiesDefinition, MinecraftEntityTypes, world } from "@minecraft/server";
      *
-     *        world.afterEvents.worldInitialize.subscribe((e) => {
-     *          let def = new DynamicPropertiesDefinition();
+     * world.afterEvents.worldInitialize.subscribe((e) => {
+     *   let def = new DynamicPropertiesDefinition();
      *
-     *          def.defineNumber("rpgStrength");
-     *          def.defineString("rpgRole", 16);
-     *          def.defineBoolean("rpgIsHero");
-     *
-     *          e.propertyRegistry.registerEntityTypeDynamicProperties(def, MinecraftEntityTypes.skeleton);
-     *        });
+     *   def.defineNumber("rpgStrength");
+     *   def.defineString("rpgRole", 16);
+     *   def.defineBoolean("rpgIsHero");
      *
+     *   e.propertyRegistry.registerEntityTypeDynamicProperties(def, MinecraftEntityTypes.skeleton);
+     * });
      * ```
      */
     readonly propertyRegistry: PropertyRegistry;
@@ -17852,17 +18140,83 @@ export interface BlockRaycastOptions {
 
 /**
  * @beta
+ * A BlockVolume is a simple interface to an object which
+ * represents a 3D rectangle of a given size (in blocks) at a
+ * world block location.
+ * Note that these are not analogous to "min" and "max" values,
+ * in that the vector components are not guaranteed to be in
+ * any order.
+ * In addition, these vector positions are not interchangeable
+ * with BlockLocation.
+ * If you want to get this volume represented as range of of
+ * BlockLocations, you can use the getBoundingBox utility
+ * function.
+ * This volume class will maintain the ordering of the corner
+ * indexes as initially set. imagine that each corner is
+ * assigned in Editor - as you move the corner around
+ * (potentially inverting the min/max relationship of the
+ * bounds) - what
+ * you had originally selected as the top/left corner would
+ * traditionally become the bottom/right.
+ * When manually editing these kinds of volumes, you need to
+ * maintain the identity of the corner as you edit - the
+ * BlockVolume utility functions do this.
+ *
+ * Important to note that this measures block sizes (to/from) -
+ * a normal AABB (0,0,0) to (0,0,0) would traditionally be of
+ * size (0,0,0)
+ * However, because we're measuring blocks - the size or span
+ * of a BlockVolume would actually be (1,1,1)
+ *
  */
 export interface BlockVolume {
+    /**
+     * @remarks
+     * A world block location that represents a corner in a 3D
+     * rectangle
+     *
+     */
     from: Vector3;
+    /**
+     * @remarks
+     * A world block location that represents the opposite corner
+     * in a 3D rectangle
+     *
+     */
     to: Vector3;
 }
 
 /**
  * @beta
+ * A BoundingBox is an interface to an object which represents
+ * an AABB aligned rectangle.
+ * The BoundingBox assumes that it was created in a valid state
+ * (min <= max) but cannot guarantee it (unless it was created
+ * using the associated {@link
+ * @minecraft-server.BoundingBoxUtils} utility functions.
+ * The min/max coordinates represent the diametrically opposite
+ * corners of the rectangle.
+ * The BoundingBox is not a representation of blocks - it has
+ * no association with any type, it is just a mathematical
+ * construct - so a rectangle with
+ * ( 0,0,0 ) -> ( 0,0,0 )
+ * has a size of ( 0,0,0 ) (unlike the very similar {@link
+ * BlockVolume} object)
  */
 export interface BoundingBox {
+    /**
+     * @remarks
+     * A {@link @minecraft-server.Vector3} that represents the
+     * largest corner of the rectangle
+     *
+     */
     max: Vector3;
+    /**
+     * @remarks
+     * A {@link @minecraft-server.Vector3} that represents the
+     * smallest corner of the rectangle
+     *
+     */
     min: Vector3;
 }
 
@@ -17903,9 +18257,27 @@ export interface Color {
 
 /**
  * @beta
+ * This interface defines an entry into the {@link
+ * @minecraft-server/CompoundBlockVolume} which represents a
+ * volume of positive or negative space.
+ *
  */
 export interface CompoundBlockVolumeItem {
+    /**
+     * @remarks
+     * The 'action' defines how the block volume is represented in
+     * the compound block volume stack.
+     * 'Add' creates a block volume which is positively selected
+     * 'Subtract' creates a block volume which represents a hole or
+     * negative space in the overall compound block volume.
+     *
+     */
     action: CompoundBlockVolumeAction;
+    /**
+     * @remarks
+     * The volume of space
+     *
+     */
     volume: BlockVolume;
 }