@minecraft/server 2.2.0-beta.1.21.100-preview.21 → 2.2.0-beta.1.21.100-preview.23

package/index.d.ts

@@ -132,6 +132,35 @@ export enum BlockVolumeIntersection {
     Intersects = 2,
 }
 
+/**
+ * @beta
+ * An enum of error reasons relating to using {@link
+ * ItemBookComponent}.
+ */
+export enum BookErrorReason {
+    /**
+     * @remarks
+     * The requested page content exceeds the max page length of
+     * 256.
+     *
+     */
+    ExceedsMaxPageLength = 'ExceedsMaxPageLength',
+    /**
+     * @remarks
+     * The page could not be created as it would exceed the max
+     * page count of 50.
+     *
+     */
+    ExceedsMaxPages = 'ExceedsMaxPages',
+    /**
+     * @remarks
+     * The title being signed exceeds the maximum title length of
+     * 16.
+     *
+     */
+    ExceedsTitleLength = 'ExceedsTitleLength',
+}
+
 /**
  * The state of a button on a keyboard, controller, or touch
  * interface.
@@ -1050,15 +1079,27 @@ export enum EntityComponentTypes {
      */
     OnFire = 'minecraft:onfire',
     /**
-     * @beta
+     * @rc
+     * @remarks
+     * Use this component to read the exhaustion of a player. This
+     * is only available on players.
+     *
      */
     Exhaustion = 'minecraft:player.exhaustion',
     /**
-     * @beta
+     * @rc
+     * @remarks
+     * Use this component to read the hunger of a player. This is
+     * only available on players.
+     *
      */
     Hunger = 'minecraft:player.hunger',
     /**
-     * @beta
+     * @rc
+     * @remarks
+     * Use this component to read the saturation of a player. This
+     * is only available on players.
+     *
      */
     Saturation = 'minecraft:player.saturation',
     /**
@@ -2037,6 +2078,13 @@ export enum InputPermissionCategory {
  * function ItemStack.getComponent.
  */
 export enum ItemComponentTypes {
+    /**
+     * @beta
+     * @remarks
+     * The minecraft:book component.
+     *
+     */
+    Book = 'minecraft:book',
     Compostable = 'minecraft:compostable',
     /**
      * @remarks
@@ -2983,6 +3031,7 @@ export type ItemComponentReturnType<T extends string> = T extends keyof ItemComp
     : ItemCustomComponentInstance;
 
 export type ItemComponentTypeMap = {
+    book: ItemBookComponent;
     compostable: ItemCompostableComponent;
     cooldown: ItemCooldownComponent;
     durability: ItemDurabilityComponent;
@@ -2990,6 +3039,7 @@ export type ItemComponentTypeMap = {
     enchantable: ItemEnchantableComponent;
     food: ItemFoodComponent;
     inventory: ItemInventoryComponent;
+    'minecraft:book': ItemBookComponent;
     'minecraft:compostable': ItemCompostableComponent;
     'minecraft:cooldown': ItemCooldownComponent;
     'minecraft:durability': ItemDurabilityComponent;
@@ -5639,6 +5689,14 @@ export class Camera {
      * @throws This function can throw errors.
      */
     setDefaultCamera(cameraPreset: string, easeOptions?: EaseOptions): void;
+    /**
+     * @beta
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    setFov(fovCameraOptions?: CameraFovOptions): void;
 }
 
 /**
@@ -6722,6 +6780,21 @@ export class ContainerSlot {
      * {@link InvalidContainerSlotError}
      */
     getLore(): string[];
+    /**
+     * @beta
+     * @remarks
+     * Returns the lore value - a secondary display string - for an
+     * ItemStack. String lore lines will be converted to a {@link
+     * RawMessage} and put under {@link RawMessage.text}.
+     *
+     * @returns
+     * An array of lore lines. If the item does not have lore,
+     * returns an empty array.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidContainerSlotError}
+     */
+    getRawLore(): RawMessage[];
     /**
      * @remarks
      * Returns all tags for the item in the slot.
@@ -6827,9 +6900,11 @@ export class ContainerSlot {
      * set.
      * @throws This function can throw errors.
      *
-     * {@link Error}
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
      *
      * {@link InvalidContainerSlotError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     setDynamicProperties(values: Record<string, boolean | number | string | Vector3>): void;
     /**
@@ -6843,9 +6918,11 @@ export class ContainerSlot {
      * @throws
      * Throws if the slot's container is invalid.
      *
-     * {@link Error}
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
      *
      * {@link InvalidContainerSlotError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     setDynamicProperty(identifier: string, value?: boolean | number | string | Vector3): void;
     /**
@@ -6880,9 +6957,11 @@ export class ContainerSlot {
      *
      * {@link minecraftcommon.ArgumentOutOfBoundsError}
      *
+     * {@link Error}
+     *
      * {@link InvalidContainerSlotError}
      */
-    setLore(loreList?: string[]): void;
+    setLore(loreList?: (RawMessage | string)[]): void;
 }
 
 /**
@@ -7317,6 +7396,10 @@ export class Dimension {
      * @returns
      * An entity array.
      * @throws This function can throw errors.
+     *
+     * {@link CommandError}
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
      * @example bounceSkeletons.ts
      * ```typescript
      * import { EntityQueryOptions, DimensionLocation } from "@minecraft/server";
@@ -7405,6 +7488,14 @@ export class Dimension {
      * @param options
      * Additional options for processing this raycast query.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link InvalidEntityError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     getEntitiesFromRay(location: Vector3, direction: Vector3, options?: EntityRaycastOptions): EntityRaycastHit[];
     /**
@@ -7418,6 +7509,10 @@ export class Dimension {
      * @returns
      * A player array.
      * @throws This function can throw errors.
+     *
+     * {@link CommandError}
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
      */
     getPlayers(options?: EntityQueryOptions): Player[];
     /**
@@ -7515,6 +7610,8 @@ export class Dimension {
      * An error will be thrown if fade is less than 0.0.
      * An error will be thrown if pitch is less than 0.01.
      * An error will be thrown if volume is less than 0.0.
+     *
+     * {@link minecraftcommon.PropertyOutOfBoundsError}
      */
     playSound(soundId: string, location: Vector3, soundOptions?: WorldSoundOptions): void;
     /**
@@ -7614,10 +7711,12 @@ export class Dimension {
      * Newly created entity at the specified location.
      * @throws This function can throw errors.
      *
-     * {@link Error}
+     * {@link EntitySpawnError}
      *
      * {@link minecraftcommon.InvalidArgumentError}
      *
+     * {@link InvalidEntityError}
+     *
      * {@link LocationInUnloadedChunkError}
      *
      * {@link LocationOutOfWorldBoundariesError}
@@ -8101,6 +8200,10 @@ export class Entity {
      * Dimension that the entity is currently within.
      *
      * @throws This property can throw when used.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link InvalidEntityError}
      */
     readonly dimension: Dimension;
     /**
@@ -8121,6 +8224,8 @@ export class Entity {
      * stone wall.
      *
      * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
      */
     readonly isClimbing: boolean;
     /**
@@ -8129,6 +8234,8 @@ export class Entity {
      * greater than 1 while gliding.
      *
      * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
      */
     readonly isFalling: boolean;
     /**
@@ -8136,6 +8243,8 @@ export class Entity {
      * Whether any part of the entity is inside a water block.
      *
      * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
      */
     readonly isInWater: boolean;
     /**
@@ -8146,6 +8255,8 @@ export class Entity {
      * no gravity this property may be incorrect.
      *
      * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
      */
     readonly isOnGround: boolean;
     /**
@@ -8153,6 +8264,8 @@ export class Entity {
      * If true, the entity is currently sleeping.
      *
      * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
      */
     readonly isSleeping: boolean;
     /**
@@ -8171,6 +8284,8 @@ export class Entity {
      * with Carrot on a Stick.
      *
      * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
      */
     readonly isSprinting: boolean;
     /**
@@ -8179,6 +8294,8 @@ export class Entity {
      * player using the swim action or a fish in water.
      *
      * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
      */
     readonly isSwimming: boolean;
     /**
@@ -8205,6 +8322,8 @@ export class Entity {
      * Current location of the entity.
      *
      * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
      */
     readonly location: Vector3;
     /**
@@ -8230,6 +8349,8 @@ export class Entity {
      * currently has no target returns undefined.
      *
      * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
      */
     readonly target?: Entity;
     /**
@@ -8261,6 +8382,12 @@ export class Entity {
      * amplifier are outside of the valid ranges, or if the effect
      * does not exist.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link InvalidEntityError}
      * @example spawnPoisonedVillager.ts
      * ```typescript
      * import { DimensionLocation } from "@minecraft/server";
@@ -8320,6 +8447,10 @@ export class Entity {
      * 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.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link InvalidEntityError}
      * @example tagsQuery.ts
      * ```typescript
      * import { EntityQueryOptions, DimensionLocation } from "@minecraft/server";
@@ -8362,6 +8493,12 @@ export class Entity {
      * if the entity is invulnerable or if the damage applied is
      * less than or equal to 0.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link InvalidEntityError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      * @example applyDamageThenHeal.ts
      * ```typescript
      * import { system, EntityHealthComponent, EntityComponentTypes, DimensionLocation } from "@minecraft/server";
@@ -8398,7 +8535,7 @@ export class Entity {
      *
      * {@link minecraftcommon.ArgumentOutOfBoundsError}
      *
-     * {@link Error}
+     * {@link InvalidEntityError}
      * @example applyImpulse.ts
      * ```typescript
      * import { DimensionLocation } from "@minecraft/server";
@@ -8425,6 +8562,10 @@ export class Entity {
      * @param verticalStrength
      * Knockback strength for the vertical vector.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      * @example bounceSkeletons.ts
      * ```typescript
      * import { EntityQueryOptions, DimensionLocation } from "@minecraft/server";
@@ -8454,6 +8595,8 @@ export class Entity {
      * entity.
      *
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     clearDynamicProperties(): void;
     /**
@@ -8463,6 +8606,8 @@ export class Entity {
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      * @example applyImpulse.ts
      * ```typescript
      * import { DimensionLocation } from "@minecraft/server";
@@ -8494,6 +8639,8 @@ export class Entity {
      * @returns
      * Returns whether the entity was on fire.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      * @example setOnFire.ts
      * ```typescript
      * import { system, EntityOnFireComponent, EntityComponentTypes, DimensionLocation } from "@minecraft/server";
@@ -8526,6 +8673,8 @@ export class Entity {
      * Returns the first intersecting block from the direction that
      * this entity is looking at.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     getBlockFromViewDirection(options?: BlockRaycastOptions): BlockRaycastHit | undefined;
     /**
@@ -8569,6 +8718,8 @@ export class Entity {
      * Returns the value for the property, or undefined if the
      * property has not been set.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     getDynamicProperty(identifier: string): boolean | number | string | Vector3 | undefined;
     /**
@@ -8579,6 +8730,8 @@ export class Entity {
      * @returns
      * A string array of the dynamic properties set on this entity.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     getDynamicPropertyIds(): string[];
     /**
@@ -8591,6 +8744,8 @@ export class Entity {
      * properties, it may be slow to load on various devices.
      *
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     getDynamicPropertyTotalByteCount(): number;
     /**
@@ -8606,6 +8761,10 @@ export class Entity {
      * effect is not present, or throws an error if the effect does
      * not exist.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link InvalidEntityError}
      */
     getEffect(effectType: EffectType | string): Effect | undefined;
     /**
@@ -8615,6 +8774,8 @@ export class Entity {
      * @returns
      * List of effects.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     getEffects(): Effect[];
     /**
@@ -8628,6 +8789,14 @@ export class Entity {
      * Returns a set of entities from the direction that this
      * entity is looking at.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link InvalidEntityError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     getEntitiesFromViewDirection(options?: EntityRaycastOptions): EntityRaycastHit[];
     /**
@@ -8639,6 +8808,8 @@ export class Entity {
      * Returns the current location of the head component of this
      * entity.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     getHeadLocation(): Vector3;
     /**
@@ -8656,6 +8827,8 @@ export class Entity {
      * returned.
      * @throws
      * Throws if the entity is invalid.
+     *
+     * {@link InvalidEntityError}
      */
     getProperty(identifier: string): boolean | number | string | undefined;
     /**
@@ -8666,6 +8839,8 @@ export class Entity {
      * Returns a Vec2 containing the rotation of this entity (in
      * degrees).
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     getRotation(): Vector2;
     /**
@@ -8675,6 +8850,8 @@ export class Entity {
      * @returns
      * An array containing all tags as strings.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     getTags(): string[];
     /**
@@ -8684,6 +8861,8 @@ export class Entity {
      * @returns
      * Returns the current velocity vector of the entity.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      * @example getFireworkVelocity.ts
      * ```typescript
      * import { system, DimensionLocation } from "@minecraft/server";
@@ -8711,6 +8890,8 @@ export class Entity {
      * @returns
      * Returns the current view direction of the entity.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     getViewDirection(): Vector3;
     /**
@@ -8739,6 +8920,8 @@ export class Entity {
      * @returns
      * Returns whether an entity has a particular tag.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     hasTag(tag: string): boolean;
     /**
@@ -8751,6 +8934,8 @@ export class Entity {
      * Returns true if entity can be killed (even if it is already
      * dead), otherwise it returns false.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      * @example tagsQuery.ts
      * ```typescript
      * import { EntityQueryOptions, DimensionLocation } from "@minecraft/server";
@@ -8789,6 +8974,10 @@ export class Entity {
      * The target location that this entity should face/look
      * towards.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     lookAt(targetLocation: Vector3): void;
     /**
@@ -8804,6 +8993,12 @@ export class Entity {
      * passed in EntityQueryOptions, otherwise it returns false.
      * @throws
      * Throws if the query options are misconfigured.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link InvalidEntityError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     matches(options: EntityQueryOptions): boolean;
     /**
@@ -8818,6 +9013,8 @@ export class Entity {
      * Additional options to control the playback and transitions
      * of the animation.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     playAnimation(animationName: string, options?: PlayAnimationOptions): void;
     /**
@@ -8829,6 +9026,10 @@ export class Entity {
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     remove(): void;
     /**
@@ -8844,6 +9045,10 @@ export class Entity {
      * Returns true if the effect has been removed. Returns false
      * if the effect is not found or does not exist.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link InvalidEntityError}
      */
     removeEffect(effectType: EffectType | string): boolean;
     /**
@@ -8857,6 +9062,8 @@ export class Entity {
      * @returns
      * Returns whether the tag existed on the entity.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     removeTag(tag: string): boolean;
     /**
@@ -8880,6 +9087,8 @@ export class Entity {
      * {@link minecraftcommon.EngineError}
      *
      * {@link Error}
+     *
+     * {@link InvalidEntityError}
      */
     resetProperty(identifier: string): boolean | number | string;
     /**
@@ -8910,6 +9119,10 @@ export class Entity {
      * A Record of key value pairs of the dynamic properties to
      * set.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link InvalidEntityError}
      */
     setDynamicProperties(values: Record<string, boolean | number | string | Vector3>): void;
     /**
@@ -8921,6 +9134,10 @@ export class Entity {
      * @param value
      * Data value of the property to set.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link InvalidEntityError}
      */
     setDynamicProperty(identifier: string, value?: boolean | number | string | Vector3): void;
     /**
@@ -8943,6 +9160,8 @@ export class Entity {
      * is less than or equal to zero, the entity is wet or the
      * entity is immune to fire.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      * @example setOnFire.ts
      * ```typescript
      * import { system, EntityOnFireComponent, EntityComponentTypes, DimensionLocation } from "@minecraft/server";
@@ -8985,6 +9204,12 @@ export class Entity {
      * (int, float properties).
      * Throws if the provided string value does not match the set
      * of accepted enum values (enum properties
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link InvalidEntityError}
      */
     setProperty(identifier: string, value: boolean | number | string): void;
     /**
@@ -8998,6 +9223,8 @@ export class Entity {
      * mobs, the x rotation controls the head tilt and the y
      * rotation controls the body rotation.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
      */
     setRotation(rotation: Vector2): void;
     /**
@@ -9011,6 +9238,10 @@ export class Entity {
      * @param teleportOptions
      * Options regarding the teleport operation.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      * @example teleport.ts
      * ```typescript
      * import { system, DimensionLocation } from "@minecraft/server";
@@ -9070,6 +9301,10 @@ export class Entity {
      * @throws
      * If the event is not defined in the definition of the entity,
      * an error will be thrown.
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
+     *
+     * {@link InvalidEntityError}
      * @example triggerEvent.ts
      * ```typescript
      * // A function that spawns a creeper and triggers it to explode immediately
@@ -9112,6 +9347,10 @@ export class Entity {
      * destination chunk is unloaded or if the teleport would
      * result in intersecting with blocks.
      * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     tryTeleport(location: Vector3, teleportOptions?: TeleportOptions): boolean;
 }
@@ -9566,7 +9805,7 @@ export class EntityDieAfterEventSignal {
 
 /**
  * Provides access to a mob's equipment slots. This component
- * exists for all mob entities.
+ * exists on player entities.
  * @example givePlayerElytra.ts
  * ```typescript
  * // Gives the player Elytra
@@ -9585,7 +9824,7 @@ export class EntityDieAfterEventSignal {
 export class EntityEquippableComponent extends EntityComponent {
     private constructor();
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns the total Armor level of the owner.
      *
@@ -9595,7 +9834,7 @@ export class EntityEquippableComponent extends EntityComponent {
      */
     readonly totalArmor: number;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns the total Toughness level of the owner.
      *
@@ -9646,7 +9885,7 @@ export class EntityEquippableComponent extends EntityComponent {
 }
 
 /**
- * @beta
+ * @rc
  * Defines the interactions with this entity for Exhaustion.
  * Wraps the `minecraft.player.exhaustion` attribute.
  */
@@ -9944,7 +10183,7 @@ export class EntityHitEntityAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Defines the interactions with this entity for hunger. Wraps
  * the `minecraft.player.hunger` attribute.
  */
@@ -11312,7 +11551,7 @@ export class EntityRidingComponent extends EntityComponent {
 }
 
 /**
- * @beta
+ * @rc
  * Defines the interactions with this entity for Saturation.
  * Wraps the `minecraft.player.saturation` attribute.
  */
@@ -12232,6 +12471,214 @@ export class InputInfo {
     getMovementVector(): Vector2;
 }
 
+/**
+ * @beta
+ * When present on an item, this item is a book item. Can
+ * access and modify the contents of the book and sign it.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class ItemBookComponent extends ItemComponent {
+    private constructor();
+    /**
+     * @remarks
+     * The name of the author of the book if it is signed,
+     * otherwise undefined.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidItemStackError}
+     */
+    readonly author?: string;
+    /**
+     * @remarks
+     * The contents of pages in the book that are in string format.
+     * Entries not in string format will be undefined.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidItemStackError}
+     */
+    readonly contents: (string | undefined)[];
+    /**
+     * @remarks
+     * Determines whether the book has been signed or not.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidItemStackError}
+     */
+    readonly isSigned: boolean;
+    /**
+     * @remarks
+     * The amount of pages the book has.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidItemStackError}
+     */
+    readonly pageCount: number;
+    /**
+     * @remarks
+     * The contents of pages in the book that are in {@link
+     * RawMessage} format. Entries not in {@link RawMessage} format
+     * will be undefined.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidItemStackError}
+     */
+    readonly rawContents: (RawMessage | undefined)[];
+    /**
+     * @remarks
+     * The title of the book if it is signed, otherwise undefined.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidItemStackError}
+     */
+    readonly title?: string;
+    static readonly componentId = 'minecraft:book';
+    /**
+     * @remarks
+     * Gets the string format content of a page for a given index.
+     *
+     * @param pageIndex
+     * The index of the page.
+     * @returns
+     * The content of the page if a valid index is provided and it
+     * is in string format, otherwise returns undefined.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidItemStackError}
+     */
+    getPageContent(pageIndex: number): string | undefined;
+    /**
+     * @remarks
+     * Gets the {@link RawMessage} format content of a page for a
+     * given index.
+     *
+     * @param pageIndex
+     * The index of the page.
+     * @returns
+     * The content of the page if a valid index is provided and it
+     * is in {@link RawMessage} format, otherwise returns
+     * undefined.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidItemStackError}
+     */
+    getRawPageContent(pageIndex: number): RawMessage | undefined;
+    /**
+     * @remarks
+     * Inserts a page at a given index. Empty pages will be created
+     * if the index is greater than the current book size.
+     * Pages have a maximum limit of 256 characters for strings as
+     * well as the JSON representation of a {@link RawMessage}.
+     * Books have a maximum limit of 50 pages.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param pageIndex
+     * The index of the page.
+     * @param content
+     * The content to set for the page. Can be a single string or
+     * {@link RawMessage} or an array of strings and/or {@link
+     * RawMessage}s
+     * @throws This function can throw errors.
+     *
+     * {@link BookError}
+     *
+     * {@link BookPageContentError}
+     *
+     * {@link InvalidItemStackError}
+     */
+    insertPage(pageIndex: number, content: (RawMessage | string)[] | RawMessage | string): void;
+    /**
+     * @remarks
+     * Removes a page at a given index. Existing pages following
+     * this page will be moved backward to fill the empty space.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param pageIndex
+     * The index of the page.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidItemStackError}
+     */
+    removePage(pageIndex: number): void;
+    /**
+     * @remarks
+     * Sets the contents of the book's pages. Pre-existing pages
+     * will be cleared.
+     * Pages have a maximum limit of 256 characters for strings as
+     * well as the JSON representation of a {@link RawMessage}.
+     * Books have a maximum limit of 50 pages.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param contents
+     * An array of each page's contents. Each page can be a single
+     * string or {@link RawMessage} or an array of strings and/or
+     * {@link RawMessage}s.
+     * @throws This function can throw errors.
+     *
+     * {@link BookError}
+     *
+     * {@link BookPageContentError}
+     *
+     * {@link InvalidItemStackError}
+     */
+    setContents(contents: ((RawMessage | string)[] | RawMessage | string)[]): void;
+    /**
+     * @remarks
+     * Sets or creates the content of a specific page. Empty pages
+     * will be created if the index is greater than the current
+     * book size.
+     * Pages have a maximum limit of 256 characters for strings as
+     * well as the JSON representation of a {@link RawMessage}.
+     * Books have a maximum limit of 50 pages.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param pageIndex
+     * The index of the page.
+     * @param content
+     * The content to set for the page. Can be a single string or
+     * {@link RawMessage} or an array of strings and/or {@link
+     * RawMessage}s
+     * @throws This function can throw errors.
+     *
+     * {@link BookError}
+     *
+     * {@link BookPageContentError}
+     *
+     * {@link InvalidItemStackError}
+     */
+    setPageContent(pageIndex: number, content: (RawMessage | string)[] | RawMessage | string): void;
+    /**
+     * @remarks
+     * Signs a book giving it a title and author name. Once signed
+     * players can no longer directly edit the book.
+     * Titles have a maximum character limit of 16.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param title
+     * The title to give the book.
+     * @param author
+     * The name of the book's author.
+     * @throws This function can throw errors.
+     *
+     * {@link BookError}
+     *
+     * {@link InvalidEntityError}
+     *
+     * {@link InvalidItemStackError}
+     */
+    signBook(title: string, author: string): void;
+}
+
 /**
  * Contains information related to a chargeable item completing
  * being charged.
@@ -13337,6 +13784,18 @@ export class ItemStack {
      * returns an empty array.
      */
     getLore(): string[];
+    /**
+     * @beta
+     * @remarks
+     * Returns the lore value - a secondary display string - for an
+     * ItemStack. String lore lines will be converted to a {@link
+     * RawMessage} and put under {@link RawMessage.text}.
+     *
+     * @returns
+     * An array of lore lines. If the item does not have lore,
+     * returns an empty array.
+     */
+    getRawLore(): RawMessage[];
     /**
      * @remarks
      * Returns a set of tags associated with this item stack.
@@ -13476,6 +13935,10 @@ export class ItemStack {
      * A Record of key value pairs of the dynamic properties to
      * set.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     setDynamicProperties(values: Record<string, boolean | number | string | Vector3>): void;
     /**
@@ -13489,6 +13952,10 @@ export class ItemStack {
      * Data value of the property to set.
      * @throws
      * Throws if the item stack is stackable.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link minecraftcommon.UnsupportedFunctionalityError}
      */
     setDynamicProperty(identifier: string, value?: boolean | number | string | Vector3): void;
     /**
@@ -13506,6 +13973,8 @@ export class ItemStack {
      * @throws This function can throw errors.
      *
      * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link Error}
      * @example diamondAwesomeSword.ts
      * ```typescript
      * import { EntityComponentTypes, ItemStack, Player } from '@minecraft/server';
@@ -13528,7 +13997,7 @@ export class ItemStack {
      * }
      * ```
      */
-    setLore(loreList?: string[]): void;
+    setLore(loreList?: (RawMessage | string)[]): void;
     /**
      * @beta
      * @remarks
@@ -14095,6 +14564,92 @@ export class ListBlockVolume extends BlockVolumeBase {
     remove(locations: Vector3[]): void;
 }
 
+/**
+ * @beta
+ * Manager for Loot Table related APIs. Allows for generation
+ * of drops from blocks and entities according to their loot
+ * tables.
+ */
+export class LootTableManager {
+    private constructor();
+    /**
+     * @remarks
+     * Generates loot from a given block as if it had been mined.
+     *
+     * @param block
+     * The block to generate loot from.
+     * @param tool
+     * Optional. The tool to use in the looting operation.
+     * @returns
+     * An array of item stacks dropped from the loot drop event.
+     * Can be empty if no loot dropped, or undefined if the
+     * provided tool is insufficient to mine the block.
+     * @throws
+     * Throws if the block is in an unloaded chunk, or if the
+     * block's position is outside of world bounds.
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     *
+     * {@link UnloadedChunksError}
+     */
+    generateLootFromBlock(block: Block, tool?: ItemStack): ItemStack[] | undefined;
+    /**
+     * @remarks
+     * Generates loot from a given block permutation as if it had
+     * been mined.
+     *
+     * @param tool
+     * Optional. The tool to use in the looting operation.
+     * @returns
+     * An array of item stacks dropped from the loot drop event.
+     * Can be empty if no loot dropped, or undefined if the
+     * provided tool is insufficient to mine the block.
+     */
+    generateLootFromBlockPermutation(blockPermutation: BlockPermutation, tool?: ItemStack): ItemStack[] | undefined;
+    /**
+     * @remarks
+     * Generates loot from a given block type as if it had been
+     * mined.
+     *
+     * @param tool
+     * Optional. The tool to use in the looting operation.
+     * @returns
+     * An array of item stacks dropped from the loot drop event.
+     * Can be empty if no loot dropped, or undefined if the
+     * provided tool is insufficient to mine the block.
+     */
+    generateLootFromBlockType(scriptBlockType: BlockType, tool?: ItemStack): ItemStack[] | undefined;
+    /**
+     * @remarks
+     * Generates loot from given a entity as if it had been killed.
+     *
+     * @param tool
+     * Optional. The tool to use in the looting operation.
+     * @returns
+     * An array of item stacks dropped from the loot drop event.
+     * Can be empty if no loot dropped, or undefined if the entity
+     * was invalid.
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidEntityError}
+     */
+    generateLootFromEntity(entity: Entity, tool?: ItemStack): ItemStack[] | undefined;
+    /**
+     * @remarks
+     * Generates loot from given a entity type as if it had been
+     * killed.
+     *
+     * @param tool
+     * Optional. The tool to use in the looting operation.
+     * @returns
+     * An array of item stacks dropped from the loot drop event.
+     * Can be empty if no loot dropped.
+     */
+    generateLootFromEntityType(entityType: EntityType, tool?: ItemStack): ItemStack[] | undefined;
+}
+
 /**
  * @beta
  * A specific currently-internal event used for passing
@@ -17983,8 +18538,7 @@ export class System {
      * @param message
      * Data component of the message to send. This is custom and
      * dependent on the kinds of behavior packs and content you may
-     * have installed within the world. Message may not exceed 2048
-     * characters in length.
+     * have installed within the world.
      * @throws This function can throw errors.
      *
      * {@link minecraftcommon.EngineError}
@@ -18567,6 +19121,10 @@ export class World {
      * Returns an array of all active players within the world.
      *
      * @throws This function can throw errors.
+     *
+     * {@link CommandError}
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
      */
     getAllPlayers(): Player[];
     /**
@@ -18718,6 +19276,10 @@ export class World {
      * Throws if the given entity id is invalid.
      */
     getEntity(id: string): Entity | undefined;
+    /**
+     * @beta
+     */
+    getLootTableManager(): LootTableManager;
     /**
      * @remarks
      * Returns the MoonPhase for the current time.
@@ -18736,6 +19298,10 @@ export class World {
      * A player array.
      * @throws
      * Throws if the provided EntityQueryOptions are invalid.
+     *
+     * {@link CommandError}
+     *
+     * {@link minecraftcommon.InvalidArgumentError}
      */
     getPlayers(options?: EntityQueryOptions): Player[];
     /**
@@ -18753,6 +19319,8 @@ export class World {
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.PropertyOutOfBoundsError}
      * @example playMusicAndSound.ts
      * ```typescript
      * import { world, MusicOptions, WorldSoundOptions, PlayerSoundOptions, DimensionLocation } from "@minecraft/server";
@@ -18798,6 +19366,8 @@ export class World {
      * An error will be thrown if volume is less than 0.0.
      * An error will be thrown if fade is less than 0.0.
      *
+     *
+     * {@link minecraftcommon.PropertyOutOfBoundsError}
      */
     queueMusic(trackId: string, musicOptions?: MusicOptions): void;
     /**
@@ -18858,6 +19428,8 @@ export class World {
      * A Record of key value pairs of the dynamic properties to
      * set.
      * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
      */
     setDynamicProperties(values: Record<string, boolean | number | string | Vector3>): void;
     /**
@@ -18871,6 +19443,8 @@ export class World {
      * @throws
      * Throws if the given dynamic property identifier is not
      * defined.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
      * @example incrementDynamicProperty.ts
      * ```typescript
      * import { world, DimensionLocation } from "@minecraft/server";
@@ -19884,6 +20458,24 @@ export interface CameraFixedBoomOptions {
     viewOffset?: Vector2;
 }
 
+/**
+ * @beta
+ * Used to change the field of view of the current camera.
+ *
+ * Required Experiments:
+ * - Required Experiment Toggle: Experimental Creator Cameras
+ *
+ */
+export interface CameraFovOptions {
+    easeOptions?: EaseOptions;
+    /**
+     * @remarks
+     * Set a value for the field of view.
+     *
+     */
+    fov?: number;
+}
+
 export interface CameraSetFacingOptions {
     easeOptions?: EaseOptions;
     facingEntity: Entity;
@@ -21877,6 +22469,51 @@ export class BlockCustomComponentReloadVersionError extends Error {
     private constructor();
 }
 
+/**
+ * @beta
+ * Errors that can be thrown when using {@link
+ * ItemBookComponent}.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class BookError extends Error {
+    private constructor();
+    /**
+     * @remarks
+     * The reason for the error.
+     *
+     * This property can be read in early-execution mode.
+     *
+     */
+    reason: BookErrorReason;
+}
+
+/**
+ * @beta
+ * The error called if page content being set on an {@link
+ * ItemBookComponent} are invalid ie. exceeding the maximum
+ * page length.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class BookPageContentError extends Error {
+    private constructor();
+    /**
+     * @remarks
+     * The index of the page requested to be modified.
+     *
+     * This property can be read in early-execution mode.
+     *
+     */
+    pageIndex: number;
+    /**
+     * @remarks
+     * The reason for the error.
+     *
+     * This property can be read in early-execution mode.
+     *
+     */
+    reason: BookErrorReason;
+}
+
 // @ts-ignore Class inheritance allowed for native defined classes
 export class CommandError extends Error {
     private constructor();
@@ -21948,6 +22585,11 @@ export class EnchantmentTypeUnknownIdError extends Error {
     private constructor();
 }
 
+// @ts-ignore Class inheritance allowed for native defined classes
+export class EntitySpawnError extends Error {
+    private constructor();
+}
+
 /**
  * @rc
  * The container is invalid. This can occur if the container is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "2.2.0-beta.1.21.100-preview.21",
+  "version": "2.2.0-beta.1.21.100-preview.23",
   "description": "",
   "contributors": [
     {
@@ -13,10 +13,10 @@
     }
   ],
   "dependencies": {
-    "@minecraft/common": "^1.1.0"
+    "@minecraft/common": "^1.2.0"
   },
   "peerDependencies": {
-    "@minecraft/vanilla-data": ">=1.20.70"
+    "@minecraft/vanilla-data": ">=1.20.70 || 1.21.100-preview.23"
   },
   "license": "MIT"
 }