@minecraft/server 1.1.0-beta.1.19.70-preview.22 → 1.1.0-beta.1.19.70-preview.24

package/index.d.ts

@@ -16,7 +16,7 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "1.1.0-internal.1.19.70-preview.22"
+ *   "version": "1.1.0-internal.1.19.70-preview.24"
  * }
  * ```
  *
@@ -996,117 +996,17 @@ export class BlockInventoryComponent extends BlockComponent {
      */
     static readonly componentId = 'minecraft:inventory';
 }
-/**
- * @beta
- * Represents the inventory of a {@link Block} in the world.
- * Used with blocks like chests.
- */
 export class BlockInventoryComponentContainer extends Container {
     protected constructor();
-    /**
-     * Contains a count of the slots in the container that are
-     * empty.
-     * @throws This property can throw when used.
-     */
     readonly emptySlotsCount: number;
-    /**
-     * Returns the size capacity of the inventory container on this
-     * block.
-     * @throws This property can throw when used.
-     */
     readonly size: number;
-    /**
-     * @remarks
-     * Adds an item to the specified container. Item will be placed
-     * in the first available empty slot. (use .setItem if you wish
-     * to set items in a particular slot.)
-     * @param itemStack
-     * The stack of items to add.
-     * @throws This function can throw errors.
-     */
     addItem(itemStack: ItemStack): void;
-    /**
-     * @remarks
-     * Clears the entirety of the inventory of this block (i.e.,
-     * chest)
-     * @throws This function can throw errors.
-     */
     clearAll(): void;
-    /**
-     * @remarks
-     * Clears a specific item within the chest.
-     * @param slot
-     * @throws This function can throw errors.
-     */
     clearItem(slot: number): void;
-    /**
-     * @remarks
-     * Gets the item stack for the set of items at the specified
-     * slot. If the slot is empty, returns undefined. This method
-     * does not change or clear the contents of the specified slot.
-     * @param slot
-     * Zero-based index of the slot to retrieve items from.
-     * @throws This function can throw errors.
-     * @example getItem.js
-     * ```typescript
-     *        const itemStack = rightChestContainer.getItem(0);
-     *        test.assert(itemStack.id === "apple", "Expected apple");
-     *        test.assert(itemStack.amount === 10, "Expected 10 apples");
-     * ```
-     */
     getItem(slot: number): ItemStack;
-    /**
-     * @remarks
-     * Gets a container slot within the chest.
-     * @param slot
-     * @throws This function can throw errors.
-     */
     getSlot(slot: number): ContainerSlot;
-    /**
-     * @remarks
-     * Sets an item stack within a particular slot.
-     * @param slot
-     * Zero-based index of the slot to set an item at.
-     * @param itemStack
-     * Stack of items to place within the specified slot.
-     * @throws This function can throw errors.
-     */
     setItem(slot: number, itemStack?: ItemStack): void;
-    /**
-     * @remarks
-     * Swaps items between two different slots within containers.
-     * @param slot
-     * Zero-based index of the slot to swap from this container.
-     * @param otherSlot
-     * Zero-based index of the slot to swap with.
-     * @param otherContainer
-     * Target container to swap with. Note this can be the same
-     * container as this source.
-     * @throws This function can throw errors.
-     * @example swapItems.js
-     * ```typescript
-     *        rightChestContainer.swapItems(1, 0, leftChestContainer); // swap item in slot 1 of rightChestContainer with item in slot 0 of leftChestContainer
-     *
-     * ```
-     */
     swapItems(slot: number, otherSlot: number, otherContainer: Container): boolean;
-    /**
-     * @remarks
-     * Moves an item from one slot to another, potentially across
-     * containers.
-     * @param fromSlot
-     * @param toSlot
-     * Zero-based index of the slot to move to.
-     * @param toContainer
-     * Target container to transfer to. Note this can be the same
-     * container as the source.
-     * @throws This function can throw errors.
-     * @example transferItem.js
-     * ```typescript
-     *        rightChestContainer.transferItem(0, 4, chestCartContainer); // transfer the apple from the right chest to a chest cart
-     *
-     * ```
-     */
     transferItem(fromSlot: number, toSlot: number, toContainer: Container): boolean;
 }
 /**
@@ -1160,16 +1060,15 @@ export class BlockPermutation {
      * Returns the list of all of the properties that the
      * permutation has.
      */
-    getAllProperties(): IBlockProperty[];
+    getAllProperties(): Record<string, boolean | number | string>;
     /**
      * @remarks
      * Gets a property for the permutation.
      * @param propertyName
      * @returns
      * Returns the property if the permutation has it, else `null`.
-     * @throws This function can throw errors.
      */
-    getProperty(propertyName: string): IBlockProperty;
+    getProperty(propertyName: string): boolean | number | string | undefined;
     /**
      * @remarks
      * Creates a copy of the permutation.
@@ -1196,6 +1095,9 @@ export class BlockPermutation {
      * ```
      */
     hasTag(tag: string): boolean;
+    matches(blockName: string, properties?: Record<string, boolean | number | string>): boolean;
+    withProperty(name: string, value: boolean | number | string): BlockPermutation;
+    static resolve(blockName: string, properties?: Record<string, boolean | number | string>): BlockPermutation;
 }
 /**
  * @beta
@@ -1324,603 +1226,13 @@ export class BlockPotionContainerComponent extends BlockComponent {
 // tslint:disable-next-line:no-unnecessary-class
 export class BlockProperties {
     protected constructor();
-    static readonly active = 'active';
-    /**
-     * Integer property that represents the age of the block. Valid
-     * values are between 0 and 15 inclusive.
-     */
-    static readonly age = 'age';
-    /**
-     * Boolean property that determines if saplings should grow.
-     */
-    static readonly ageBit = 'age_bit';
-    /**
-     * Boolean property that determines if an explosion propagates
-     * underwater.
-     */
-    static readonly allowUnderwaterBit = 'allow_underwater_bit';
-    /**
-     * Boolean property that determines if a tripwire is attached
-     * to another tripwire.
-     */
-    static readonly attachedBit = 'attached_bit';
-    /**
-     * String property that represents the type of attachment used
-     * by a bell or grindstone block. Valid values are 'standing',
-     * 'hanging', 'side' and 'multiple'.
-     */
-    static readonly attachment = 'attachment';
-    /**
-     * String property that determines the thickness of a bamboo
-     * stalk. Valid values are 'thin' and 'thick'.
-     */
-    static readonly bambooLeafSize = 'bamboo_leaf_size';
-    /**
-     * String property that determines the size of bamboo leaves.
-     * Valid values are 'no_leaves', 'small_leaves', and
-     * 'large_leaves'.
-     */
-    static readonly bambooStalkThickness = 'bamboo_stalk_thickness';
-    static readonly bigDripleafHead = 'big_dripleaf_head';
-    /**
-     * String property that represents the tilt state of big
-     * dripleaf block. Valid values are 'none', 'unstable',
-     * 'partial_tilt' and 'full_tilt'.
-     */
-    static readonly bigDripleafTilt = 'big_dripleaf_tilt';
-    /**
-     * Integer property that tracks how many bites of cake have
-     * been taken. Valid values are between 0 and 6 inclusive.
-     */
-    static readonly biteCounter = 'bite_counter';
-    static readonly blockLightLevel = 'block_light_level';
-    static readonly bloom = 'bloom';
-    static readonly booksStored = 'books_stored';
-    /**
-     * Boolean property that determines if a bottle is shown in the
-     * first slot of the brewing stand.
-     */
-    static readonly brewingStandSlotABit = 'brewing_stand_slot_a_bit';
-    /**
-     * Boolean property that determines if a bottle is shown in the
-     * second slot of the brewing stand.
-     */
-    static readonly brewingStandSlotBBit = 'brewing_stand_slot_b_bit';
-    /**
-     * Boolean property that determines if a bottle is shown in the
-     * third slot of the brewing stand.
-     */
-    static readonly brewingStandSlotCBit = 'brewing_stand_slot_c_bit';
-    /**
-     * Boolean property that determines if a button is in a pressed
-     * state or not.
-     */
-    static readonly buttonPressedBit = 'button_pressed_bit';
-    /**
-     * Integer property that describes how many extra candles are
-     * in the same block space. Valid values are between 0 and 3
-     * inclusive.
-     */
-    static readonly candles = 'candles';
-    static readonly canSummon = 'can_summon';
-    /**
-     * String property that represents the type of liquid in a
-     * cauldron. Valid values are 'water', 'powder_snow', and
-     * 'lava'.
-     */
-    static readonly cauldronLiquid = 'cauldron_liquid';
-    /**
-     * String property that represents the type of work benches
-     * that are within Minecraft Education experiences. Valid
-     * values are 'compound_creator', 'material_reducer',
-     * 'element_constructor' and 'lab_table'.
-     */
-    static readonly chemistryTableType = 'chemistry_table_type';
-    /**
-     * String property determines the pattern of quartz and purpur
-     * blocks. Valid values are 'default', 'chiseled', 'lines',
-     * 'smooth'.
-     */
-    static readonly chiselType = 'chisel_type';
-    /**
-     * Integer property that describes how many sea pickles are in
-     * a cluster. Valid values are between 0 and 3 inclusive.
-     */
-    static readonly clusterCount = 'cluster_count';
-    /**
-     * String property that represents the color of a block, like
-     * wool. Valid values are 'white', 'orange', 'magenta',
-     * 'light_blue', 'yellow', 'lime', 'pink', 'gray', 'silver',
-     * 'cyan', 'purple', 'blue', 'brown', 'green', 'red' and
-     * 'black'.
-     */
-    static readonly color = 'color';
-    /**
-     * Boolean property that determines if a torch has a particular
-     * color.
-     */
-    static readonly colorBit = 'color_bit';
-    static readonly composterFillLevel = 'composter_fill_level';
-    /**
-     * Boolean property that determines if a command block is
-     * conditional or not.
-     */
-    static readonly conditionalBit = 'conditional_bit';
-    /**
-     * String property that represents the color of a coral block.
-     * Valid values are 'blue', 'pink', 'purple', 'red', 'yellow',
-     * 'blue dead', 'pink dead', 'red dead', and 'yellow dead'.
-     */
-    static readonly coralColor = 'coral_color';
-    /**
-     * Integer property that describes the rotation of coral fans.
-     * Valid values are between 0 and 3 inclusive.
-     */
-    static readonly coralDirection = 'coral_direction';
-    static readonly coralFanDirection = 'coral_fan_direction';
-    /**
-     * Boolean property that represents the type of hanging for
-     * coral fan.
-     */
-    static readonly coralHangTypeBit = 'coral_hang_type_bit';
-    /**
-     * Boolean property that describes if a top snow block is
-     * covering another block.
-     */
-    static readonly coveredBit = 'covered_bit';
-    /**
-     * String property that determines the cracked state of turtle
-     * eggs. Valid values are 'no_cracks', 'cracked', and
-     * 'max_cracked'.
-     */
-    static readonly crackedState = 'cracked_state';
-    /**
-     * String property that determines the damage state of an
-     * anvil. Valid values are 'undamaged', 'slightly_damaged',
-     * 'very_damaged', and 'broken'
-     */
-    static readonly damage = 'damage';
-    /**
-     * Boolean property that determines if coral, coral fans, or
-     * sea pickles are dead.
-     */
-    static readonly deadBit = 'dead_bit';
-    static readonly deprecated = 'deprecated';
-    /**
-     * Integer property determines the north, south, east, or west
-     * direction of a block. Valid values include are south = 0,
-     * west = 1, north = 2, east = 3.
-     */
-    static readonly direction = 'direction';
-    /**
-     * String property that determines the dirt type of a block.
-     * Valid values are 'normal' and 'coarse'.
-     */
-    static readonly dirtType = 'dirt_type';
-    /**
-     * Boolean property that determines if a tripwire is disarmed
-     * or not.
-     */
-    static readonly disarmedBit = 'disarmed_bit';
-    /**
-     * Boolean property that determines if a door's hinge is
-     * mirrored or not.
-     */
-    static readonly doorHingeBit = 'door_hinge_bit';
-    /**
-     * String property that represents the type of a double plant
-     * block. Valid values are 'sunflower', 'syringa', 'grass',
-     * 'fern', 'rose', and 'paeonia'.
-     */
-    static readonly doublePlantType = 'double_plant_type';
-    /**
-     * Boolean property that describes if bubble columns drag
-     * entities down or push them up.
-     */
-    static readonly dragDown = 'drag_down';
-    /**
-     * String property that represents the type of a pointed
-     * dripstone block. Valid values are 'tip', 'frustum', 'base',
-     * 'middle' and 'merge'.
-     */
-    static readonly dripstoneThickness = 'dripstone_thickness';
-    /**
-     * Boolean property that determines if an end portal block has
-     * an Eye of Ender in it.
-     */
-    static readonly endPortalEyeBit = 'end_portal_eye_bit';
-    /**
-     * Boolean property that determines if a TNT block should start
-     * its explode sequence.
-     */
-    static readonly explodeBit = 'explode_bit';
-    static readonly extinguished = 'extinguished';
-    /**
-     * Integer property that determines the facing direction of
-     * some types of blocks. Valid values include down = 0, up = 1,
-     * north = 2, south = 3, west = 4, east = 5.
-     */
-    static readonly facingDirection = 'facing_direction';
-    /**
-     * Integer property that determines the fill level of a
-     * cauldron block. Valid values are between 0 and 6 inclusive.
-     */
-    static readonly fillLevel = 'fill_level';
-    /**
-     * String property that represents the type of flow. Valid
-     * values are 'poppy', 'orchid', 'allium', 'houstonia',
-     * 'tulip_red', 'tulip_orange', 'tulip_white', 'tulip_pink',
-     * 'oxeye', 'cornflower' and 'lily_of_the_valley'.
-     */
-    static readonly flowerType = 'flower_type';
-    /**
-     * Integer property that represents the rotation of signs and
-     * standing banners. Valid values are between 0 and 15
-     * inclusive.
-     */
-    static readonly groundSignDirection = 'ground_sign_direction';
-    static readonly growingPlantAge = 'growing_plant_age';
-    /**
-     * Integer property that determines the growth level of crops.
-     * Valid values are between 0 and 7 inclusive.
-     */
-    static readonly growth = 'growth';
-    /**
-     * Boolean property that represents if a lantern block is
-     * hanging or not.
-     */
-    static readonly hanging = 'hanging';
-    /**
-     * Boolean property that determines if a block is the pillow
-     * side of a bed.
-     */
-    static readonly headPieceBit = 'head_piece_bit';
-    /**
-     * Integer property that determines the height of a top snow
-     * block. Valid values are between 0 and 7 inclusive.
-     */
-    static readonly height = 'height';
-    static readonly honeyLevel = 'honey_level';
-    /**
-     * Integer property that determines which huge mushroom block
-     * should be displayed. Valid values are between 0 and 15
-     * inclusive.
-     */
-    static readonly hugeMushroomBits = 'huge_mushroom_bits';
-    /**
-     * Boolean property that determines if a block should burn
-     * infinitely.
-     */
-    static readonly infiniburnBit = 'infiniburn_bit';
-    /**
-     * Boolean property that determines if a fence block is
-     * connected to a wall block.
-     */
-    static readonly inWallBit = 'in_wall_bit';
-    /**
-     * Boolean property that describes if an item frame block has a
-     * map in it.
-     */
-    static readonly itemFrameMapBit = 'item_frame_map_bit';
-    static readonly itemFramePhotoBit = 'item_frame_photo_bit';
-    static readonly kelpAge = 'kelp_age';
-    static readonly leverDirection = 'lever_direction';
-    /**
-     * Integer property that represents the level of liquid blocks.
-     * Valid values are between 0 and 15 inclusive.
-     */
-    static readonly liquidDepth = 'liquid_depth';
-    /**
-     * Boolean property that determines if a block is lit or not.
-     */
-    static readonly lit = 'lit';
-    /**
-     * Integer property that represents the moisture level of crop.
-     * Valid values are between 0 and 7 inclusive.
-     */
-    static readonly moisturizedAmount = 'moisturized_amount';
-    /**
-     * String property that represents the stone type of an
-     * Infested Stone block. Valid values are 'stone',
-     * 'cobblestone', 'stone_brick', 'mossy_stone_brick',
-     * 'cracked_stone_brick' and 'chiseled_stone_brick'.
-     */
-    static readonly monsterEggStoneType = 'monster_egg_stone_type';
-    static readonly multiFaceDirectionBits = 'multi_face_direction_bits';
-    /**
-     * String property that represents the leaf type of some block
-     * types. Valid values are 'acacia' and 'dark_oak'.
-     */
-    static readonly newLeafType = 'new_leaf_type';
-    /**
-     * String property that represents the wood type of certain
-     * types of blocks. Valid values are 'acacia' and 'dark_oak'.
-     */
-    static readonly newLogType = 'new_log_type';
-    /**
-     * Boolean property that determines if a skull block should
-     * drop loot.
-     */
-    static readonly noDropBit = 'no_drop_bit';
-    /**
-     * Boolean property that determines if a bed block is occupied.
-     */
-    static readonly occupiedBit = 'occupied_bit';
-    /**
-     * String property that represents the leaf type of some block
-     * types. Valid values are 'oak', 'spruce', 'birch', and
-     * 'jungle'.
-     */
-    static readonly oldLeafType = 'old_leaf_type';
-    /**
-     * String property that determines the wood type of certain
-     * types of blocks. Valid values are 'oak', 'spruce', 'birch'
-     * and 'jungle'.
-     */
-    static readonly oldLogType = 'old_log_type';
-    /**
-     * Boolean property that determines if a door, gate, or
-     * trapdoor is open.
-     */
-    static readonly openBit = 'open_bit';
-    /**
-     * Boolean property that determines if a comparator's output is
-     * lit.
-     */
-    static readonly outputLitBit = 'output_lit_bit';
-    /**
-     * Boolean property that determines if a comparator is set to
-     * subtract output.
-     */
-    static readonly outputSubtractBit = 'output_subtract_bit';
-    /**
-     * Boolean property that determines if a leaf block is
-     * persistent.
-     */
-    static readonly persistentBit = 'persistent_bit';
-    static readonly pillarAxis = 'pillar_axis';
-    /**
-     * String property that determines the orientation of portal
-     * blocks. Valid values include 'unknown', 'x', and 'z'.
-     */
-    static readonly portalAxis = 'portal_axis';
-    /**
-     * Boolean property that is true when an observer or tripwire
-     * sends a redstone signal.
-     */
-    static readonly poweredBit = 'powered_bit';
-    static readonly prismarineBlockType = 'prismarine_block_type';
-    static readonly propaguleStage = 'propagule_stage';
-    /**
-     * Boolean property that returns true if a rail has a redstone
-     * signal.
-     */
-    static readonly railDataBit = 'rail_data_bit';
-    /**
-     * Integer property determines the orientation of a placed rail
-     * block. Valid values are between 0 and 8 inclusive.
-     */
-    static readonly railDirection = 'rail_direction';
-    /**
-     * Integer property that determines the signal strength of a
-     * redstone signal. Valid values are between 0 and 15
-     * inclusive.
-     */
-    static readonly redstoneSignal = 'redstone_signal';
-    /**
-     * Integer property that represents the amount of delay of a
-     * repeater. Valid values are between 0 and 3 inclusive.
-     */
-    static readonly repeaterDelay = 'repeater_delay';
-    static readonly respawnAnchorCharge = 'respawn_anchor_charge';
-    static readonly rotation = 'rotation';
-    /**
-     * String property that represents the pattern of a sandstone
-     * block. Valid values are 'default', 'heiroglyphs', 'cut', and
-     * 'smooth'.
-     */
-    static readonly sandStoneType = 'sand_stone_type';
-    /**
-     * String property that represents the sand type of a block.
-     * Valid values are 'normal' and 'red'.
-     */
-    static readonly sandType = 'sand_type';
-    /**
-     * String property that determines the type of the sapling
-     * block. Valid values are 'evergreen', 'birch', 'jungle',
-     * 'acacia', and 'roofed_oak'.
-     */
-    static readonly saplingType = 'sapling_type';
-    /**
-     * String property that determines the type of a sea grass
-     * block. Valid values are 'default', 'double_top' and
-     * 'double_bot'.
-     */
-    static readonly seaGrassType = 'sea_grass_type';
-    /**
-     * String property that represents the type of a sponge block.
-     * Valid values are 'dry' and 'wet'.
-     */
-    static readonly spongeType = 'sponge_type';
-    /**
-     * Integer property that determines the stability of a
-     * scaffolding block. Valid values are between 0 and 5
-     * inclusive.
-     */
-    static readonly stability = 'stability';
-    /**
-     * Boolean property that describes if a scaffolding block has
-     * been checked for stability.
-     */
-    static readonly stabilityCheck = 'stability_check';
-    /**
-     * String property that determines the type of a stone brick
-     * block. Valid values are 'default', 'mossy', 'cracked',
-     * 'chiseled' and 'smooth'.
-     */
-    static readonly stoneBrickType = 'stone_brick_type';
-    /**
-     * String property that represents the type of certain types of
-     * stone slab blocks. Valid values are 'smooth_stone',
-     * 'sandstone', 'wood', 'cobblestone', 'brick', 'stone_brick',
-     * 'quartz' and 'nether_brick'.
-     */
-    static readonly stoneSlabType = 'stone_slab_type';
-    /**
-     * String property that represents the type of certain types of
-     * stone slab blocks. Valid values are 'red_sandstone',
-     * 'purpur', 'prismarine_rough', 'prismarine_dark',
-     * 'prismarine_brick', 'mossy_cobblestone', 'smooth_sandstone'
-     * and 'red_nether_brick'.
-     */
-    static readonly stoneSlabType2 = 'stone_slab_type_2';
-    /**
-     * String property that represents the type of certain types of
-     * stone slab blocks. Valid values are 'end_stone_brick',
-     * 'smooth_red_sandstone', 'polished_andesite', 'andesite',
-     * 'diorite', 'polished_diorite', 'granite', and
-     * 'polished_granite'.
-     */
-    static readonly stoneSlabType3 = 'stone_slab_type_3';
-    /**
-     * String property that represents the type of certain types of
-     * stone slab blocks. Valid values are 'mossy_stone_brick',
-     * 'smooth_quartz', 'stone', 'cut_sandstone', and
-     * 'cut_red_sandstone'.
-     */
-    static readonly stoneSlabType4 = 'stone_slab_type_4';
-    /**
-     * String property that determines the type of a stone block.
-     * Valid values are 'stone', 'granite', 'granite_smooth',
-     * 'diorite', 'diorite_smooth', 'andesite', and
-     * 'andesite_smooth'.
-     */
-    static readonly stoneType = 'stone_type';
-    /**
-     * Boolean property that represents if a wood log has been
-     * stripped of bark.
-     */
-    static readonly strippedBit = 'stripped_bit';
-    /**
-     * String property that represents the state of a structure
-     * block. Valid values are 'data', 'save', 'load', 'corner',
-     * 'invalid' and 'export'.
-     */
-    static readonly structureBlockType = 'structure_block_type';
-    /**
-     * String property that determines which void mode to draw for
-     * structure blocks. Valid values are 'void' and 'air'.
-     */
-    static readonly structureVoidType = 'structure_void_type';
-    /**
-     * Boolean property that indicates if a tripwire block is
-     * suspended.
-     */
-    static readonly suspendedBit = 'suspended_bit';
-    /**
-     * String property that represents the type of a tall grass
-     * block. Valid values are 'default', 'tall', 'fern', and
-     * 'snow'.
-     */
-    static readonly tallGrassType = 'tall_grass_type';
-    /**
-     * Boolean property that determines if a hopper block is active
-     * or not.
-     */
-    static readonly toggleBit = 'toggle_bit';
-    /**
-     * Boolean property that determines if a slab is the top half
-     * of the block or not
-     */
-    static readonly topSlotBit = 'top_slot_bit';
-    /**
-     * String property that determines the direction of a torch in
-     * relation to the block it is attached to. Valid values are
-     * 'unknown', 'west', 'east', 'north', 'south', 'top'.
-     */
-    static readonly torchFacingDirection = 'torch_facing_direction';
-    /**
-     * Boolean property that determines if a dispenser is
-     * triggered.
-     */
-    static readonly triggeredBit = 'triggered_bit';
-    /**
-     * String property that represents the amount of turtle eggs in
-     * an egg block. Valid values are 'one_egg', 'two_egg',
-     * 'three_egg' and 'four_egg'.
-     */
-    static readonly turtleEggCount = 'turtle_egg_count';
-    static readonly twistingVinesAge = 'twisting_vines_age';
-    /**
-     * Boolean property that determines if a leaf block or flower
-     * block should be updated.
-     */
-    static readonly updateBit = 'update_bit';
-    /**
-     * Boolean property that determines if a block is the upper
-     * half of an object like a door or a tall plant.
-     */
-    static readonly upperBlockBit = 'upper_block_bit';
-    /**
-     * Boolean property that determines if a stair block or
-     * trapdoor block is upside-down.
-     */
-    static readonly upsideDownBit = 'upside_down_bit';
-    /**
-     * Integer property that represents the facing direction for
-     * vines. Valid values are between 0 and 15 inclusive.
-     */
-    static readonly vineDirectionBits = 'vine_direction_bits';
-    /**
-     * String property that represents the type of stone used in a
-     * wall block. Valid values are 'cobblestone',
-     * 'mossy_cobblestone', 'granite', 'diorite', 'andesite',
-     * 'sandstone', 'brick', 'stone_brick', 'mossy_stone_brick',
-     * 'nether_brick', 'end_brick', 'prismarine', 'red_sandstone'
-     * and 'red_nether_brick'.
-     */
-    static readonly wallBlockType = 'wall_block_type';
-    /**
-     * String property that determines what kind of connection a
-     * wall has to the east. Valid values are 'none', 'short' and
-     * 'tall'.
-     */
-    static readonly wallConnectionTypeEast = 'wall_connection_type_east';
-    /**
-     * String property that determines what kind of connection a
-     * wall has to the north. Valid values are 'none', 'short' and
-     * 'tall'.
-     */
-    static readonly wallConnectionTypeNorth = 'wall_connection_type_north';
-    /**
-     * String property that determines what kind of connection a
-     * wall has to the south. Valid values are 'none', 'short' and
-     * 'tall'.
-     */
-    static readonly wallConnectionTypeSouth = 'wall_connection_type_south';
-    /**
-     * String property that determines what kind of connection a
-     * wall has to the west. Valid values are 'none', 'short' and
-     * 'tall'.
-     */
-    static readonly wallConnectionTypeWest = 'wall_connection_type_west';
-    /**
-     * Boolean property that determines if a wall should contain a
-     * post.
-     */
-    static readonly wallPostBit = 'wall_post_bit';
-    static readonly weepingVinesAge = 'weeping_vines_age';
-    /**
-     * Integer property that represents the rotation of stairs.
-     * Valid values are between 0 and 3 inclusive.
-     */
-    static readonly weirdoDirection = 'weirdo_direction';
-    /**
-     * String property that determines the wood type of a block.
-     * Valid values are 'oak', 'spruce', 'birch', 'jungle',
-     * 'acacia', and 'dark_oak'.
-     */
-    static readonly woodType = 'wood_type';
+    static get(propertyName: string): BlockPropertyType;
+    static getAll(): BlockPropertyType[];
+}
+export class BlockPropertyType {
+    protected constructor();
+    readonly id: string;
+    readonly validValues: (boolean | number | string)[];
 }
 /**
  * @beta
@@ -2023,15 +1335,6 @@ export class BlockType {
      * Block type name - for example, `minecraft:acacia_stairs`.
      */
     readonly id: string;
-    /**
-     * @remarks
-     * Creates the default {@link BlockPermutation} for this type
-     * which uses the default values for all properties.
-     * @returns
-     * Returns created permutation.
-     * @throws This function can throw errors.
-     */
-    createDefaultBlockPermutation(): BlockPermutation;
 }
 /**
  * @beta
@@ -2066,28 +1369,6 @@ export class BlockWaterContainerComponent extends BlockComponent {
     getCustomColor(): Color;
     setCustomColor(color: Color): void;
 }
-/**
- * @beta
- * Contains the state of a boolean-based property for a {@link
- * BlockPermutation}.
- */
-export class BoolBlockProperty extends IBlockProperty {
-    protected constructor();
-    /**
-     * The name of this property.
-     */
-    readonly name: string;
-    /**
-     * The current value of this property.
-     * @throws
-     * Setting this property can throw if the value passed is not
-     * valid for the property. Use {@link
-     * @minecraft/server.BoolBlockProperty.validValues} to check
-     * allowed values.
-     */
-    value: boolean;
-    getValidValues(): boolean[];
-}
 /**
  * @beta
  * Contains information related to changes to a button push.
@@ -2210,23 +1491,26 @@ export class CommandResult {
 export class Container {
     protected constructor();
     /**
-     * Contains a count of the slots in the container that are
-     * empty.
-     * @throws This property can throw when used.
+     * Count of the slots in the container that are empty.
+     * @throws
+     * Throws if the container is invalid.
      */
     readonly emptySlotsCount: number;
     /**
-     * Represents the size of the container. For example, a
-     * standard single-block chest has a size of 27, for the 27
-     * slots in their inventory.
-     * @throws This property can throw when used.
+     * The number of slots in this container. For example, a
+     * standard single-block chest has a size of 27. Note, a
+     * player's inventory container contains a total of 36 slots, 9
+     * hotbar slots plus 27 inventory slots.
+     * @throws
+     * Throws if the container is invalid.
      */
     readonly size: number;
     /**
      * @remarks
-     * Adds an item to the specified container. Item will be placed
-     * in the first available empty slot. (use .setItem if you wish
-     * to set items in a particular slot.)
+     * Adds an item to the container. The item is placed in the
+     * first available slot(s) and can be stacked with existing
+     * items of the same type. Note, use {@link Container.setItem}
+     * if you wish to set the item in a particular slot.
      * @param itemStack
      * The stack of items to add.
      * @throws This function can throw errors.
@@ -2235,41 +1519,49 @@ export class Container {
     /**
      * @remarks
      * Clears all inventory items in the container.
-     * @throws This function can throw errors.
+     * @throws
+     * Throws if the container is invalid.
      */
     clearAll(): void;
     /**
      * @remarks
      * Clears a specific item at a slot within the container.
      * @param slot
-     * @throws This function can throw errors.
+     * @throws
+     * Throws if the container is invalid.
      */
     clearItem(slot: number): void;
     /**
      * @remarks
-     * Gets the item stack for the set of items at the specified
-     * slot. If the slot is empty, returns undefined. This method
-     * does not change or clear the contents of the specified slot.
+     * Gets an {@link ItemStack} of the item at the specified slot.
+     * If the slot is empty, returns `undefined`. This method does
+     * not change or clear the contents of the specified slot. To
+     * get a reference to a particular slot, see {@link
+     * Container.getSlot}.
      * @param slot
      * Zero-based index of the slot to retrieve items from.
-     * @throws This function can throw errors.
-     * @example getItem.js
+     * @throws
+     * Throws if the container is invalid or if the `slot` index is
+     * out of bounds.
+     * @example getItem.ts
      * ```typescript
-     *        const rightInventoryComp = rightChestCart.getComponent("inventory");
-     *        const rightChestContainer = rightInventoryComp.container;
-     *
-     *        const itemStack = rightChestContainer.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);
      *
-     *        test.assert(itemStack.id === "apple", "Expected apple");
-     *        test.assert(itemStack.amount === 10, "Expected 10 apples");
      * ```
      */
     getItem(slot: number): ItemStack;
     /**
      * @remarks
-     * Returns a container slot item holder within the container.
+     * Returns a container slot. This acts as a reference to a slot
+     * at the given index for this container.
      * @param slot
-     * @throws This function can throw errors.
+     * The index of the slot to return. This index must be within
+     * the bounds of the container.
+     * @throws
+     * Throws if the container is invalid or if the `slot` index is
+     * out of bounds.
      */
     getSlot(slot: number): ContainerSlot;
     /**
@@ -2278,8 +1570,11 @@ export class Container {
      * @param slot
      * Zero-based index of the slot to set an item at.
      * @param itemStack
-     * Stack of items to place within the specified slot.
-     * @throws This function can throw errors.
+     * Stack of items to place within the specified slot. Setting
+     * `itemStack` to undefined will clear the slot.
+     * @throws
+     * Throws if the container is invalid or if the `slot` index is
+     * out of bounds.
      */
     setItem(slot: number, itemStack?: ItemStack): void;
     /**
@@ -2292,28 +1587,38 @@ export class Container {
      * @param otherContainer
      * Target container to swap with. Note this can be the same
      * container as this source.
-     * @throws This function can throw errors.
-     * @example swapItems.js
+     * @throws
+     * Throws if either this container or `otherContainer` are
+     * invalid or if the `slot` or `otherSlot` are out of bounds.
+     * @example swapItems.ts
      * ```typescript
-     *        rightChestContainer.swapItems(1, 0, leftChestContainer); // swap the cake and emerald
+     *        // 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): boolean;
     /**
      * @remarks
-     * Moves an item from one slot to another, potentially across
-     * containers.
+     * Moves an item from one slot to another container, or to the
+     * first available slot in the same container.
      * @param fromSlot
+     * Zero-based index of the slot to transfer an item from, on
+     * this container.
      * @param toSlot
-     * Zero-based index of the slot to move to.
      * @param toContainer
      * Target container to transfer to. Note this can be the same
      * container as the source.
-     * @throws This function can throw errors.
-     * @example transferItem.js
+     * @throws
+     * Throws if either this container or `toContainer` are invalid
+     * or if the `fromSlot` or `toSlot` indices out of bounds.
+     * @example transferItem.ts
      * ```typescript
-     *        rightChestContainer.transferItem(0, 4, chestCartContainer); // transfer the apple from the right chest to a chest cart
+     *        // 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);
      *
      * ```
      */
@@ -2327,65 +1632,130 @@ export class Container {
 export class ContainerSlot {
     protected constructor();
     /**
-     * Amount of the specified item within the container slot.
+     * Number of the items in the stack. Valid values range between
+     * 1-255. The provided value will be clamped to the item's
+     * maximum stack size.
+     * @throws
+     * Throws if the value is outside the range of 1-255.
      */
     amount: number;
+    data: number;
     /**
-     * Modifier value for the item type stored within the slot.
+     * Returns whether the item is stackable. An item is considered
+     * stackable if the item's maximum stack size is greater than 1
+     * and the item does not contain any custom data or properties.
+     * @throws
+     * Throws if the slot's container is invalid.
      */
-    data: number;
     readonly isStackable: boolean;
+    readonly isValid: boolean;
     /**
-     * If true, the state of this container slot is still valid
-     * (e.g., the underlying block or entity for this container
-     * slot still exists.)
+     * Gets or sets whether the item is kept on death.
+     * @throws
+     * Throws if the slot's container is invalid.
      */
-    readonly isValid: boolean;
     keepOnDeath: boolean;
+    /**
+     * Gets or sets the item's lock mode. The default value is
+     * `ItemLockMode.none`.
+     * @throws
+     * Throws if the slot's container is invalid.
+     */
     lockMode: ItemLockMode;
+    /**
+     * The maximum stack size. This value varies depending on the
+     * type of item. For example, torches have a maximum stack size
+     * of 64, while eggs have a maximum stack size of 16.
+     * @throws
+     * Throws if the slot's container is invalid.
+     */
     readonly maxAmount: number;
     /**
-     * Returns a name tag for the container slot.
+     * Given name of this stack of items. The name tag is displayed
+     * when hovering over the item. Setting the name tag to an
+     * empty string or `undefined` will remove the name tag.
+     * @throws
+     * Throws if the slot's container is invalid. Also throws if
+     * the length exceeds 255 characters.
      */
     nameTag?: string;
+    /**
+     * The type of the item.
+     * @throws
+     * Throws if the slot's container is invalid.
+     */
     readonly 'type': ItemType;
     /**
-     * Returns a string identifier of the type if item stored in
-     * this slot.
-     * @throws This property can throw when used.
+     * Identifier of the type of items for the stack. If a
+     * namespace is not specified, 'minecraft:' is assumed.
+     * Examples include 'wheat' or 'apple'.
+     * @throws
+     * Throws if the slot's container is invalid.
      */
     readonly typeId?: string;
-    clone(): ItemStack;
     /**
      * @remarks
-     * Returns the item stored within the container.
-     * @throws This function can throw errors.
+     * Creates an exact copy of the item stack, including any
+     * custom data or properties.
+     * @throws
+     * Throws if the slot's container is invalid.
      */
+    clone(): ItemStack;
     getItem(): ItemStack;
     /**
      * @remarks
-     * Returns the lore value for the item stored within this
-     * container slot.
-     * @throws This function can throw errors.
+     * Returns the lore value - a secondary display string - for an
+     * ItemStack.
+     * @returns
+     * An array of lore strings. If the item does not have lore,
+     * returns an empty array.
+     * @throws
+     * Throws if the slot's container is invalid.
      */
     getLore(): string[];
+    /**
+     * @remarks
+     * Returns whether this item stack can be stacked with the
+     * given `itemStack`. This is determined by comparing the item
+     * type and any custom data and properties associated with the
+     * item stacks. The amount of each item stack is not taken into
+     * consideration.
+     * @param itemStack
+     * @throws
+     * Throws if the slot's container is invalid.
+     */
     isStackableWith(itemStack: ItemStack): boolean;
+    /**
+     * @remarks
+     * The list of block types this item can break in Adventure
+     * mode. The block names are displayed in the item's tooltip.
+     * Setting the value to undefined will clear the list.
+     * @param blockIdentifiers
+     * @throws
+     * Throws if the slot's container is invalid. Also throws if
+     * any of the provided block identifiers are invalid.
+     */
     setCanDestroy(blockIdentifiers?: string[]): void;
-    setCanPlaceOn(blockIdentifiers?: string[]): void;
     /**
      * @remarks
-     * Sets the item within the slot to a new value.
-     * @param itemStack
-     * The item stack to set within this container slot.
-     * @throws This function can throw errors.
+     * The list of block types this item can be placed on in
+     * Adventure mode. This is only applicable to block items. The
+     * block names are displayed in the item's tooltip. Setting the
+     * value to undefined will clear the list.
+     * @param blockIdentifiers
+     * @throws
+     * Throws if the slot's container is invalid. Also throws if
+     * any of the provided block identifiers are invalid.
      */
+    setCanPlaceOn(blockIdentifiers?: string[]): void;
     setItem(itemStack?: ItemStack): void;
     /**
      * @remarks
-     * Sets the lore string for the item at the specified slot.
+     * Sets the lore value - a secondary display string - for an
+     * ItemStack.
      * @param loreList
-     * An array of strings for lines of text for this lore.
-     * @throws This function can throw errors.
+     * @throws
+     * Throws if the slot's container is invalid.
      */
     setLore(loreList?: string[]): void;
 }
@@ -2544,8 +1914,7 @@ export class Dimension {
      * defined via the EntityQueryOptions set of filter criteria.
      * @param getEntities
      * @returns
-     * An entity iterator that can be used to loop over the
-     * returned entities.
+     * An entity array.
      * @throws This function can throw errors.
      * @example testThatEntityIsFeatherItem.ts
      * ```typescript
@@ -2597,8 +1966,7 @@ export class Dimension {
      * defined via the EntityQueryOptions set of filter criteria.
      * @param getPlayers
      * @returns
-     * An entity iterator that can be used to loop over the
-     * returned players.
+     * A player array.
      * @throws This function can throw errors.
      */
     getPlayers(getPlayers?: EntityQueryOptions): PlayerIterator;
@@ -2727,7 +2095,7 @@ export class Dimension {
  * For block properties that take a direction, provides a
  * structured way to specify the direction of a block property.
  */
-export class DirectionBlockProperty extends IBlockProperty {
+export class DirectionBlockProperty {
     protected constructor();
     /**
      * Name of the property.
@@ -5429,14 +4797,26 @@ export class EntityRideableComponent extends IEntityComponent {
      * Entity that should be ejected from this entity.
      * @throws This function can throw errors.
      */
-    ejectRider(rider: Entity): void;
+    ejectRider(rider: Entity): void;
+    /**
+     * @remarks
+     * Ejects all riders of this entity.
+     * @throws This function can throw errors.
+     */
+    ejectRiders(): void;
+    /**
+     * @remarks
+     * A string-list of entity types that this entity can support
+     * as riders.
+     * @throws This function can throw errors.
+     */
+    getFamilyTypes(): string[];
     /**
      * @remarks
-     * Ejects all riders of this entity.
+     * Gets a list of positions and number of riders for each
+     * position for entities riding this entity.
      * @throws This function can throw errors.
      */
-    ejectRiders(): void;
-    getFamilyTypes(): string[];
     getSeats(): Seat[];
 }
 /**
@@ -6034,18 +5414,6 @@ export class FluidContainer {
      */
     static readonly minFillLevel = 0;
 }
-/**
- * @beta
- * Contains an interface for defining the state of a property
- * for a {@link BlockPermutation}.
- */
-export class IBlockProperty {
-    protected constructor();
-    /**
-     * The name of this property.
-     */
-    readonly name: string;
-}
 /**
  * @beta
  * Base interface that defines components associated with an
@@ -6058,141 +5426,17 @@ export class IEntityComponent {
      */
     readonly typeId: string;
 }
-/**
- * @beta
- * Contains the state of an integer-based property for a {@link
- * BlockPermutation}.
- */
-export class IntBlockProperty extends IBlockProperty {
-    protected constructor();
-    /**
-     * The name of this property.
-     */
-    readonly name: string;
-    /**
-     * The current value of this property.
-     * @throws
-     * Setting this property can throw if the value passed is not
-     * valid for the property. Use {@link
-     * @minecraft/server.IntBlockProperty.validValues} to check
-     * allowed values.
-     */
-    value: number;
-    getValidValues(): number[];
-}
-/**
- * @beta
- * Represents a container that can hold stacks of items. Used
- * for entities like players, chest minecarts, llamas, and
- * more.
- */
 export class InventoryComponentContainer extends Container {
     protected constructor();
-    /**
-     * The number of empty slots in the container.
-     * @throws This property can throw when used.
-     */
     readonly emptySlotsCount: number;
-    /**
-     * Represents the size of the container. For example, a
-     * standard single-block chest has a size of 27, for the 27
-     * slots in their inventory.
-     * @throws This property can throw when used.
-     */
     readonly size: number;
-    /**
-     * @remarks
-     * Adds an item to the specified container. Items will be
-     * placed in the first available empty slot. (Use {@link
-     * InventoryComponentContainer.setItem} if you wish to set
-     * items in a particular slot.)
-     * @param itemStack
-     * The stack of items to add.
-     * @throws This function can throw errors.
-     */
     addItem(itemStack: ItemStack): void;
-    /**
-     * @remarks
-     * Empties all items in this entities' inventory.
-     * @throws This function can throw errors.
-     */
     clearAll(): void;
-    /**
-     * @remarks
-     * Clears out a specific item at the specified slot index.
-     * @param slot
-     * @throws This function can throw errors.
-     */
     clearItem(slot: number): void;
-    /**
-     * @remarks
-     * Gets the item stack for the set of items at the specified
-     * slot. If the slot is empty, returns undefined. This method
-     * does not change or clear the contents of the specified slot.
-     * @param slot
-     * Zero-based index of the slot to retrieve items from.
-     * @throws This function can throw errors.
-     * @example getItem.js
-     * ```typescript
-     *        const itemStack = rightChestContainer.getItem(0);
-     *        test.assert(itemStack.id === "apple", "Expected apple");
-     *        test.assert(itemStack.amount === 10, "Expected 10 apples");
-     * ```
-     */
     getItem(slot: number): ItemStack;
-    /**
-     * @remarks
-     * Returns a slot object for specifically managing a slot
-     * within a broader inventory.
-     * @param slot
-     * @throws This function can throw errors.
-     */
     getSlot(slot: number): ContainerSlot;
-    /**
-     * @remarks
-     * Sets an item stack within a particular slot.
-     * @param slot
-     * Zero-based index of the slot to set an item at.
-     * @param itemStack
-     * Stack of items to place within the specified slot.
-     * @throws This function can throw errors.
-     */
     setItem(slot: number, itemStack?: ItemStack): void;
-    /**
-     * @remarks
-     * Swaps items between two different slots within containers.
-     * @param slot
-     * Zero-based index of the slot to swap from this container.
-     * @param otherSlot
-     * Zero-based index of the slot to swap with.
-     * @param otherContainer
-     * Target container to swap with. Note this can be the same
-     * container as this source.
-     * @throws This function can throw errors.
-     * @example swapItems.js
-     * ```typescript
-     *        rightChestContainer.swapItems(1, 0, leftChestContainer); // swap the cake and emerald
-     *
-     * ```
-     */
     swapItems(slot: number, otherSlot: number, otherContainer: Container): boolean;
-    /**
-     * @remarks
-     * Moves an item from one slot to another, potentially across
-     * containers.
-     * @param fromSlot
-     * @param toSlot
-     * Zero-based index of the slot to move to.
-     * @param toContainer
-     * Target container to transfer to. Note this can be the same
-     * container as the source.
-     * @throws This function can throw errors.
-     * @example transferItem.js
-     * ```typescript
-     *        rightChestContainer.transferItem(0, 4, chestCartContainer); // transfer the apple from the right chest to a chest cart
-     *
-     * ```
-     */
     transferItem(fromSlot: number, toSlot: number, toContainer: Container): boolean;
 }
 /**
@@ -6482,17 +5726,44 @@ export class Items {
 export class ItemStack {
     /**
      * Number of the items in the stack. Valid values range between
-     * 0 and 64.
+     * 1-255. The provided value will be clamped to the item's
+     * maximum stack size.
+     * @throws
+     * Throws if the value is outside the range of 1-255.
      */
     amount: number;
+    /**
+     * Returns whether the item is stackable. An item is considered
+     * stackable if the item's maximum stack size is greater than 1
+     * and the item does not contain any custom data or properties.
+     */
     readonly isStackable: boolean;
+    /**
+     * Gets or sets whether the item is kept on death.
+     */
     keepOnDeath: boolean;
+    /**
+     * Gets or sets the item's lock mode. The default value is
+     * `ItemLockMode.none`.
+     */
     lockMode: ItemLockMode;
+    /**
+     * The maximum stack size. This value varies depending on the
+     * type of item. For example, torches have a maximum stack size
+     * of 64, while eggs have a maximum stack size of 16.
+     */
     readonly maxAmount: number;
     /**
-     * Given name of this stack of items.
+     * Given name of this stack of items. The name tag is displayed
+     * when hovering over the item. Setting the name tag to an
+     * empty string or `undefined` will remove the name tag.
+     * @throws
+     * Throws if the length exceeds 255 characters.
      */
     nameTag?: string;
+    /**
+     * The type of the item.
+     */
     readonly 'type': ItemType;
     /**
      * Identifier of the type of items for the stack. If a
@@ -6509,11 +5780,20 @@ export class ItemStack {
      * enumeration for a list of standard item types in Minecraft
      * experiences.
      * @param amount
-     * Number of items to place in the stack, between 1 and 64.
-     * Note that certain items can only have one item in the stack.
-     * @throws This function can throw errors.
+     * Number of items to place in the stack, between 1-255. The
+     * provided value will be clamped to the item's maximum stack
+     * size. Note that certain items can only have one item in the
+     * stack.
+     * @throws
+     * Throws if `itemType` is invalid, or if `amount` is outside
+     * the range of 1-255.
      */
     constructor(itemType: ItemType | string, amount?: number);
+    /**
+     * @remarks
+     * Creates an exact copy of the item stack, including any
+     * custom data or properties.
+     */
     clone(): ItemStack;
     /**
      * @remarks
@@ -6524,6 +5804,14 @@ export class ItemStack {
      * retrieve. If no namespace prefix is specified, 'minecraft:'
      * is assumed. If the component is not present on the item
      * 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;
+     *
+     * ```
      */
     getComponent(componentId: string): any;
     /**
@@ -6536,6 +5824,9 @@ export class ItemStack {
      * @remarks
      * Returns the lore value - a secondary display string - for an
      * ItemStack.
+     * @returns
+     * An array of lore strings. If the item does not have lore,
+     * returns an empty array.
      */
     getLore(): string[];
     /**
@@ -6548,14 +5839,63 @@ export class ItemStack {
      * is assumed.
      */
     hasComponent(componentId: string): boolean;
+    /**
+     * @remarks
+     * Returns whether this item stack can be stacked with the
+     * given `itemStack`. This is determined by comparing the item
+     * type and any custom data and properties associated with the
+     * item stacks. The amount of each item stack is not taken into
+     * consideration.
+     * @param itemStack
+     */
     isStackableWith(itemStack: ItemStack): boolean;
+    /**
+     * @remarks
+     * The list of block types this item can break in Adventure
+     * mode. The block names are displayed in the item's tooltip.
+     * Setting the value to undefined will clear the list.
+     * @param blockIdentifiers
+     * @throws
+     * 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"]);
+     *
+     * ```
+     */
     setCanDestroy(blockIdentifiers?: string[]): void;
+    /**
+     * @remarks
+     * The list of block types this item can be placed on in
+     * Adventure mode. This is only applicable to block items. The
+     * block names are displayed in the item's tooltip. Setting the
+     * value to undefined will clear the list.
+     * @param blockIdentifiers
+     * @throws
+     * 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"]);
+     *
+     * ```
+     */
     setCanPlaceOn(blockIdentifiers?: string[]): void;
     /**
      * @remarks
      * Sets the lore value - a secondary display string - for an
      * ItemStack.
      * @param loreList
+     * @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"]);
+     *
+     * ```
      */
     setLore(loreList?: string[]): void;
     /**
@@ -7627,6 +6967,7 @@ export class MinecraftBlockTypes {
      * Represents a dead bush within Minecraft.
      */
     static readonly deadbush: BlockType;
+    static readonly decoratedPot: BlockType;
     /**
      * Represents a block of deepslate within Minecraft.
      */
@@ -9668,6 +9009,7 @@ export class MinecraftBlockTypes {
      * Represents a structure void within Minecraft.
      */
     static readonly structureVoid: BlockType;
+    static readonly suspiciousSand: BlockType;
     /**
      * Represents a sweet berry bush within Minecraft.
      */
@@ -9692,6 +9034,8 @@ export class MinecraftBlockTypes {
      * Represents a torch within Minecraft.
      */
     static readonly torch: BlockType;
+    static readonly torchflower: BlockType;
+    static readonly torchflowerCrop: BlockType;
     /**
      * Represents a trapdoor within Minecraft.
      */
@@ -10975,7 +10319,6 @@ export class MinecraftItemTypes {
      * Minecraft.
      */
     static readonly deadbush: ItemType;
-    static readonly debugStick: ItemType;
     /**
      * Represents an item that can place a block of deepslate
      * within Minecraft.
@@ -13343,6 +12686,47 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     runCommandAsync(commandString: string): Promise<CommandResult>;
+    /**
+     * @beta
+     * @remarks
+     * Sends a message to the player.
+     * @param message
+     * The message to be displayed.
+     * @throws
+     * This method can throw if the provided {@link RawMessage} is
+     * in an invalid format. For example, if an empty `name` string
+     * 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);
+     *
+     * ```
+     * @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);
+     *
+     * ```
+     * @example simpleString.ts
+     * ```typescript
+     *        // 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);
+     *
+     * ```
+     */
     sendMessage(message: (RawMessage | string)[] | RawMessage | string): void;
     /**
      * @beta
@@ -13438,100 +12822,17 @@ export class Player extends Entity {
      */
     triggerEvent(eventName: string): void;
 }
-/**
- * @beta
- * Represents the inventory of a {@link Player} in the world.
- */
 export class PlayerInventoryComponentContainer extends InventoryComponentContainer {
     protected constructor();
-    /**
-     * Contains a count of the slots in the container that are
-     * empty.
-     * @throws This property can throw when used.
-     */
     readonly emptySlotsCount: number;
-    /**
-     * Returns the size capacity of the inventory container on this
-     * block.
-     * @throws This property can throw when used.
-     */
     readonly size: number;
-    /**
-     * @remarks
-     * Adds an item to the specified container. Item will be placed
-     * in the first available empty slot. (use .setItem if you wish
-     * to set items in a particular slot.)
-     * @param itemStack
-     * The stack of items to add.
-     * @throws This function can throw errors.
-     */
     addItem(itemStack: ItemStack): void;
-    /**
-     * @remarks
-     * Empties all items in this players' inventory.
-     * @throws This function can throw errors.
-     */
     clearAll(): void;
-    /**
-     * @remarks
-     * Clears out a specific item at the specified slot index.
-     * @param slot
-     * @throws This function can throw errors.
-     */
     clearItem(slot: number): void;
-    /**
-     * @remarks
-     * Gets the item stack for the set of items at the specified
-     * slot. If the slot is empty, returns undefined. This method
-     * does not change or clear the contents of the specified slot.
-     * @param slot
-     * Zero-based index of the slot to retrieve items from.
-     * @throws This function can throw errors.
-     */
     getItem(slot: number): ItemStack;
-    /**
-     * @remarks
-     * Returns a slot object for specifically managing a slot
-     * within a broader inventory.
-     * @param slot
-     * @throws This function can throw errors.
-     */
     getSlot(slot: number): ContainerSlot;
-    /**
-     * @remarks
-     * Sets an item stack within a particular slot.
-     * @param slot
-     * Zero-based index of the slot to set an item at.
-     * @param itemStack
-     * Stack of items to place within the specified slot.
-     * @throws This function can throw errors.
-     */
     setItem(slot: number, itemStack?: ItemStack): void;
-    /**
-     * @remarks
-     * Swaps items between two different slots within containers.
-     * @param slot
-     * Zero-based index of the slot to swap from this container.
-     * @param otherSlot
-     * Zero-based index of the slot to swap with.
-     * @param otherContainer
-     * Target container to swap with. Note this can be the same
-     * container as this source.
-     * @throws This function can throw errors.
-     */
     swapItems(slot: number, otherSlot: number, otherContainer: Container): boolean;
-    /**
-     * @remarks
-     * Moves an item from one slot to another, potentially across
-     * containers.
-     * @param fromSlot
-     * @param toSlot
-     * Zero-based index of the slot to move to.
-     * @param toContainer
-     * Target container to transfer to. Note this can be the same
-     * container as the source.
-     * @throws This function can throw errors.
-     */
     transferItem(fromSlot: number, toSlot: number, toContainer: Container): boolean;
 }
 /**
@@ -14032,28 +13333,6 @@ export class ServerMessageSignal {
      */
     unsubscribe(callback: (arg: MessageReceiveEvent) => void): void;
 }
-/**
- * @beta
- * Contains the state of a string-based property for a {@link
- * BlockPermutation}.
- */
-export class StringBlockProperty extends IBlockProperty {
-    protected constructor();
-    /**
-     * Name of this property.
-     */
-    readonly name: string;
-    /**
-     * The current value of this property.
-     * @throws
-     * Setting this property can throw if the value passed is not
-     * valid for the property. Use {@link
-     * @minecraft/server.StringBlockProperty.validValues} to check
-     * allowed values.
-     */
-    value: string;
-    getValidValues(): string[];
-}
 /**
  * A class that provides system-level events and functions.
  */
@@ -14428,10 +13707,13 @@ export class World {
     /**
      * @beta
      * @remarks
-     * Returns all players currently in the world.
+     * Returns a set of players based on a set of conditions
+     * defined via the EntityQueryOptions set of filter criteria.
      * @param options
+     * Additional options that can be used to filter the set of
+     * players returned.
      * @returns
-     * All players currently in the world.
+     * A player array.
      * @throws This function can throw errors.
      */
     getPlayers(options?: EntityQueryOptions): PlayerIterator;
@@ -14474,6 +13756,47 @@ export class World {
      * @throws This function can throw errors.
      */
     removeDynamicProperty(identifier: string): boolean;
+    /**
+     * @beta
+     * @remarks
+     * Sends a message to all players.
+     * @param message
+     * The message to be displayed.
+     * @throws
+     * This method can throw if the provided {@link RawMessage} is
+     * in an invalid format. For example, if an empty `name` string
+     * 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);
+     *
+     * ```
+     * @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);
+     *
+     * ```
+     * @example simpleString.ts
+     * ```typescript
+     *        // 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);
+     *
+     * ```
+     */
     sendMessage(message: (RawMessage | string)[] | RawMessage | string): void;
     setDefaultSpawn(spawnPosition: Vector3): void;
     /**