@minecraft/server 2.0.0-beta.1.21.70-preview.22 → 2.0.0-beta.1.21.70-preview.24

package/index.d.ts

@@ -1677,7 +1677,6 @@ export enum InputButton {
 }
 
 /**
- * @rc
  * Describes the type of input of a device.
  */
 export enum InputMode {
@@ -1729,7 +1728,6 @@ export enum InputPermissionCategory {
      */
     Movement = 2,
     /**
-     * @rc
      * @remarks
      * Player input for moving laterally in the world. This would
      * be WASD on a keyboard or the movement joystick on gamepad or
@@ -1738,7 +1736,6 @@ export enum InputPermissionCategory {
      */
     LateralMovement = 4,
     /**
-     * @rc
      * @remarks
      * Player input relating to sneak. This also affects flying
      * down.
@@ -1746,7 +1743,6 @@ export enum InputPermissionCategory {
      */
     Sneak = 5,
     /**
-     * @rc
      * @remarks
      * Player input relating to jumping. This also affects flying
      * up.
@@ -1754,14 +1750,12 @@ export enum InputPermissionCategory {
      */
     Jump = 6,
     /**
-     * @rc
      * @remarks
      * Player input relating to mounting vehicles.
      *
      */
     Mount = 7,
     /**
-     * @rc
      * @remarks
      * Player input relating to dismounting. When disabled, the
      * player can still dismount vehicles by other means, for
@@ -1771,28 +1765,24 @@ export enum InputPermissionCategory {
      */
     Dismount = 8,
     /**
-     * @rc
      * @remarks
      * Player input relating to moving the player forward.
      *
      */
     MoveForward = 9,
     /**
-     * @rc
      * @remarks
      * Player input relating to moving the player backward.
      *
      */
     MoveBackward = 10,
     /**
-     * @rc
      * @remarks
      * Player input relating to moving the player left.
      *
      */
     MoveLeft = 11,
     /**
-     * @rc
      * @remarks
      * Player input relating to moving the player right.
      *
@@ -1805,9 +1795,6 @@ export enum InputPermissionCategory {
  * function ItemStack.getComponent.
  */
 export enum ItemComponentTypes {
-    /**
-     * @rc
-     */
     Compostable = 'minecraft:compostable',
     /**
      * @remarks
@@ -1869,7 +1856,7 @@ export enum ItemLockMode {
 }
 
 /**
- * @beta
+ * @rc
  * Represents the type of liquid that can be placed on a block
  * or flow dynamically in the world.
  */
@@ -2392,6 +2379,7 @@ export enum TimeOfDay {
 export enum TintMethod {
     BirchFoliage = 'BirchFoliage',
     DefaultFoliage = 'DefaultFoliage',
+    DryFoliage = 'DryFoliage',
     EvergreenFoliage = 'EvergreenFoliage',
     Grass = 'Grass',
     None = 'None',
@@ -2639,10 +2627,6 @@ export type ItemComponentTypeMap = {
  * @beta
  * Handle to an aim-assist category that exists in the
  * world.aimAssist registry.
- *
- * Required Experiments:
- * - Camera Aim Assist
- *
  */
 export class AimAssistCategory {
     private constructor();
@@ -2702,10 +2686,6 @@ export class AimAssistCategory {
  * @beta
  * Settings used with AimAssistRegistry.addCategory for
  * creation of the AimAssistCategory.
- *
- * Required Experiments:
- * - Camera Aim Assist
- *
  */
 export class AimAssistCategorySettings {
     /**
@@ -2738,6 +2718,8 @@ export class AimAssistCategorySettings {
      * Constructor that takes a unique Id to associate with the
      * created AimAssistCategory. Must have a namespace.
      *
+     * This function can't be called in read-only mode.
+     *
      */
     constructor(identifier: string);
     /**
@@ -2762,6 +2744,8 @@ export class AimAssistCategorySettings {
      * @remarks
      * Sets the priority settings used for block targeting.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param blockPriorities
      * A record mapping block Ids to their priority settings.
      * Larger numbers have greater priority.
@@ -2773,6 +2757,8 @@ export class AimAssistCategorySettings {
      * @remarks
      * Sets the priority settings used for entity targeting.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param entityPriorities
      * A record mapping entity Ids to their priority settings.
      * Larger numbers have greater priority.
@@ -2786,10 +2772,6 @@ export class AimAssistCategorySettings {
  * @beta
  * Handle to an aim-assist preset that exists in the
  * world.aimAssist registry.
- *
- * Required Experiments:
- * - Camera Aim Assist
- *
  */
 export class AimAssistPreset {
     private constructor();
@@ -2859,10 +2841,6 @@ export class AimAssistPreset {
  * @beta
  * Settings used with AimAssistRegistry.addPreset for creation
  * of the AimAssistPreset.
- *
- * Required Experiments:
- * - Camera Aim Assist
- *
  */
 export class AimAssistPresetSettings {
     /**
@@ -2894,6 +2872,8 @@ export class AimAssistPresetSettings {
      * Constructor that takes a unique Id to associate with the
      * created AimAssistPreset. Must have a namespace.
      *
+     * This function can't be called in read-only mode.
+     *
      */
     constructor(identifier: string);
     /**
@@ -2927,6 +2907,8 @@ export class AimAssistPresetSettings {
      * Sets the list of block/entity Ids to exclude from aim assist
      * targeting.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param targets
      * An array of block/entity Ids.
      */
@@ -2941,6 +2923,8 @@ export class AimAssistPresetSettings {
      * @remarks
      * Sets the per-item aim-assist category Ids.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param itemSettings
      * A record mapping item Ids to aim-assist category Ids.
      * Category Ids must have a namespace.
@@ -2951,6 +2935,8 @@ export class AimAssistPresetSettings {
      * Sets the list of item Ids that will target liquid blocks
      * with aim-assist when being held.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param items
      * An array of item Ids.
      */
@@ -2961,10 +2947,6 @@ export class AimAssistPresetSettings {
  * @beta
  * A container for APIs related to the world's aim-assist
  * settings.
- *
- * Required Experiments:
- * - Camera Aim Assist
- *
  */
 export class AimAssistRegistry {
     private constructor();
@@ -3163,7 +3145,6 @@ export class Block {
      */
     readonly isValid: boolean;
     /**
-     * @rc
      * @remarks
      * Returns or sets whether this block has water on it.
      *
@@ -3271,7 +3252,7 @@ export class Block {
      */
     bottomCenter(): Vector3;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block is removed when touched by
      * liquid.
@@ -3290,7 +3271,7 @@ export class Block {
      */
     canBeDestroyedByLiquidSpread(liquidType: LiquidType): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block can have a liquid placed over it,
      * i.e. be waterlogged.
@@ -3359,6 +3340,8 @@ export class Block {
      * for a block - for example, an inventory component of a chest
      * block.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param componentId
      * The identifier of the component (e.g.,
      * 'minecraft:inventory'). If no namespace prefix is specified,
@@ -3465,7 +3448,7 @@ export class Block {
      */
     hasTag(tag: string): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block stops liquid from flowing.
      *
@@ -3483,7 +3466,18 @@ export class Block {
      */
     isLiquidBlocking(liquidType: LiquidType): boolean;
     /**
-     * @beta
+     * @rc
+     * @remarks
+     * Returns whether liquid can flow into the block from the
+     * provided direction, or flow out from the provided direction
+     * when liquid is placed into it with a bucket.
+     *
+     * @param liquidType
+     * The type of liquid this function should be called for.
+     * @returns
+     * Whether liquid can flow into the block from the provided
+     * direction, or flow out from the provided direction when
+     * liquid is placed into it with a bucket
      * @throws This function can throw errors.
      *
      * {@link Error}
@@ -3494,7 +3488,7 @@ export class Block {
      */
     liquidCanFlowFromDirection(liquidType: LiquidType, flowDirection: Direction): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block is removed and spawns its item
      * when touched by liquid.
@@ -3598,7 +3592,6 @@ export class Block {
      */
     setType(blockType: BlockType | string): void;
     /**
-     * @rc
      * @remarks
      * Sets whether this block has a water logged state - for
      * example, whether stairs are submerged within water.
@@ -4192,7 +4185,7 @@ export class BlockPermutation {
      */
     readonly 'type': BlockType;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block is removed when touched by
      * liquid.
@@ -4207,7 +4200,7 @@ export class BlockPermutation {
      */
     canBeDestroyedByLiquidSpread(liquidType: LiquidType): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block can have a liquid placed over it,
      * i.e. be waterlogged.
@@ -4246,6 +4239,8 @@ export class BlockPermutation {
      * @remarks
      * Gets a state for the permutation.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param stateName
      * Name of the block state who's value is to be returned.
      * @returns
@@ -4286,7 +4281,7 @@ export class BlockPermutation {
      */
     hasTag(tag: string): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block stops liquid from flowing.
      *
@@ -4300,7 +4295,7 @@ export class BlockPermutation {
      */
     isLiquidBlocking(liquidType: LiquidType): boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns whether this block is removed and spawns its item
      * when touched by liquid.
@@ -4321,6 +4316,8 @@ export class BlockPermutation {
      * this permutation. If states is not specified, matches checks
      * against the set of types more broadly.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param blockName
      * An optional set of states to compare against.
      */
@@ -4333,6 +4330,8 @@ export class BlockPermutation {
      * Returns a derived BlockPermutation with a specific property
      * set.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param name
      * Identifier of the block property.
      * @param value
@@ -4349,6 +4348,8 @@ export class BlockPermutation {
      * will return a BlockPermutation object that is usable in
      * other block APIs (e.g., block.setPermutation)
      *
+     * This function can't be called in read-only mode.
+     *
      * @param blockName
      * Identifier of the block to check.
      * @throws This function can throw errors.
@@ -4844,6 +4845,11 @@ export class BlockVolume extends BlockVolumeBase {
      *
      */
     to: Vector3;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
     constructor(from: Vector3, to: Vector3);
     /**
      * @remarks
@@ -5501,6 +5507,8 @@ export class CompoundBlockVolume {
      * @remarks
      * Create a CompoundBlockVolume object
      *
+     * This function can't be called in read-only mode.
+     *
      * @param origin
      * An optional world space origin on which to center the
      * compound volume.
@@ -7421,6 +7429,9 @@ export class EnchantmentType {
      */
     readonly maxLevel: number;
     /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
      * @throws This function can throw errors.
      */
     constructor(enchantmentType: string);
@@ -7881,6 +7892,8 @@ export class Entity {
      * Gets a component (that represents additional capabilities)
      * for an entity.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param componentId
      * The identifier of the component (e.g., 'minecraft:health').
      * If no namespace prefix is specified, 'minecraft:' is
@@ -11553,7 +11566,6 @@ export class GameRules {
 }
 
 /**
- * @rc
  * Contains the input information for a client instance.
  */
 export class InputInfo {
@@ -11888,7 +11900,6 @@ export class ItemComponentUseOnEvent extends ItemUseOnEvent {
 }
 
 /**
- * @rc
  * When present, the item can be composted in the composter
  * block if the composting chance is in the range [1 - 100].
  */
@@ -12522,6 +12533,8 @@ export class ItemStack {
      * Creates a new instance of a stack of items for use in the
      * world.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param itemType
      * Type of item to create. See the {@link
      * @minecraft/vanilla-data.MinecraftItemTypes} enumeration for
@@ -12575,6 +12588,8 @@ export class ItemStack {
      * Gets a component (that represents additional capabilities)
      * for an item stack.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param componentId
      * The identifier of the component (e.g., 'minecraft:food'). If
      * no namespace prefix is specified, 'minecraft:' is assumed.
@@ -13515,6 +13530,8 @@ export class ListBlockVolume extends BlockVolumeBase {
      * @remarks
      * Creates a new instance of ListBlockVolume.
      *
+     * This function can't be called in read-only mode.
+     *
      * @param locations
      * Initial array of block locations that ListBlockVolume will
      * be constructed with.
@@ -13793,7 +13810,6 @@ export class Player extends Entity {
      */
     readonly graphicsMode: GraphicsMode;
     /**
-     * @rc
      * @remarks
      * Contains the player's input information.
      *
@@ -13908,6 +13924,22 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     addLevels(amount: number): number;
+    /**
+     * @beta
+     * @remarks
+     * For this player, removes all overrides of any Entity
+     * Properties on the target Entity. This change is not applied
+     * until the next tick and will not apply to other players.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param targetEntity
+     * The Entity whose Entity Property overrides are being
+     * cleared.
+     * @throws
+     * Throws if the entity is invalid.
+     */
+    clearPropertyOverridesForEntity(targetEntity: Entity): void;
     /**
      * @beta
      * @remarks
@@ -13927,10 +13959,6 @@ export class Player extends Entity {
      * @remarks
      * The player's aim-assist settings.
      *
-     *
-     * Required Experiments:
-     * - Camera Aim Assist
-     *
      */
     getAimAssist(): PlayerAimAssist;
     /**
@@ -14055,6 +14083,26 @@ export class Player extends Entity {
      *
      */
     queueMusic(trackId: string, musicOptions?: MusicOptions): void;
+    /**
+     * @beta
+     * @remarks
+     * For this player, removes the override on an Entity Property.
+     * This change is not applied until the next tick and will not
+     * apply to other players.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param targetEntity
+     * The Entity whose Entity Property override is being removed.
+     * @param identifier
+     * The Entity Property identifier.
+     * @throws
+     * Throws if the entity is invalid.
+     * Throws if an invalid identifier is provided.
+     * Throws if the provided value type does not match the
+     * property type.
+     */
+    removePropertyOverrideForEntity(targetEntity: Entity, identifier: string): void;
     /**
      * @remarks
      * Resets the level of the player.
@@ -14172,6 +14220,34 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     setOp(isOp: boolean): void;
+    /**
+     * @beta
+     * @remarks
+     * For this player, overrides an Entity Property on the target
+     * Entity to the provided value. This property must be client
+     * synced. This change is not applied until the next tick and
+     * will not apply to other players.
+     *
+     * This function can't be called in read-only mode.
+     *
+     * @param targetEntity
+     * The Entity whose Entity Property is being overriden.
+     * @param identifier
+     * The Entity Property identifier.
+     * @param value
+     * The override value. The provided type must be compatible
+     * with the type specified in the entity's definition.
+     * @throws
+     * Throws if the entity is invalid.
+     * Throws if an invalid identifier is provided.
+     * Throws if the provided value type does not match the
+     * property type.
+     * Throws if the provided value is outside the expected range
+     * (int, float properties).
+     * Throws if the provided string value does not match the set
+     * of accepted enum values (enum properties)
+     */
+    setPropertyOverrideForEntity(targetEntity: Entity, identifier: string, value: boolean | number | string): void;
     /**
      * @remarks
      * Sets the current starting spawn point for this particular
@@ -14187,7 +14263,7 @@ export class Player extends Entity {
      */
     setSpawnPoint(spawnPoint?: DimensionLocation): void;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Creates a new particle emitter at a specified location in
      * the world. Only visible to the target player.
@@ -14264,10 +14340,6 @@ export class Player extends Entity {
 /**
  * @beta
  * A container for APIs related to player aim-assist.
- *
- * Required Experiments:
- * - Camera Aim Assist
- *
  */
 export class PlayerAimAssist {
     private constructor();
@@ -14738,7 +14810,6 @@ export class PlayerGameModeChangeBeforeEventSignal {
 }
 
 /**
- * @rc
  * Event data for when a player input mode changes.
  */
 export class PlayerInputModeChangeAfterEvent {
@@ -14764,7 +14835,6 @@ export class PlayerInputModeChangeAfterEvent {
 }
 
 /**
- * @rc
  * Manages callbacks that are connected to player input mode.
  */
 export class PlayerInputModeChangeAfterEventSignal {
@@ -14859,7 +14929,6 @@ export class PlayerInputPermissionCategoryChangeAfterEventSignal {
 export class PlayerInputPermissions {
     private constructor();
     /**
-     * @rc
      * @remarks
      * Returns true if an input permission is enabled.
      *
@@ -14871,7 +14940,6 @@ export class PlayerInputPermissions {
      */
     isPermissionCategoryEnabled(permissionCategory: InputPermissionCategory): boolean;
     /**
-     * @rc
      * @remarks
      * Enable or disable an input permission. When enabled the
      * input will work, when disabled will not work.
@@ -16631,7 +16699,17 @@ export class StartupBeforeEventSignal {
  */
 export class StartupEvent {
     private constructor();
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly blockComponentRegistry: BlockComponentRegistry;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly itemComponentRegistry: ItemComponentRegistry;
 }
 
@@ -17005,6 +17083,8 @@ export class System {
      * Returns a collection of after-events for system-level
      * operations.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly afterEvents: SystemAfterEvents;
     /**
@@ -17013,12 +17093,16 @@ export class System {
      * Returns a collection of before-events for system-level
      * operations.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly beforeEvents: SystemBeforeEvents;
     /**
      * @remarks
      * Represents the current world tick of the server.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly currentTick: number;
     /**
@@ -17027,12 +17111,16 @@ export class System {
      * Returns true if this is a world where the editor is
      * currently loaded, returns false otherwise.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly isEditorWorld: boolean;
     /**
      * @remarks
      * Contains the device information for the server.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly serverSystemInfo: SystemInfo;
     /**
@@ -17232,6 +17320,8 @@ export class SystemAfterEvents {
      * provides a way for commands and other systems to trigger
      * behavior within script.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly scriptEventReceive: ScriptEventCommandMessageAfterEventSignal;
 }
@@ -17246,7 +17336,17 @@ export class SystemAfterEvents {
  */
 export class SystemBeforeEvents {
     private constructor();
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly shutdown: ShutdownBeforeEventSignal;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly startup: StartupBeforeEventSignal;
     /**
      * @remarks
@@ -17256,6 +17356,8 @@ export class SystemBeforeEvents {
      * To prevent shutdown, set the event's cancel property to
      * true.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly watchdogTerminate: WatchdogTerminateBeforeEventSignal;
 }
@@ -17350,6 +17452,8 @@ export class Trigger {
      * @remarks
      * Creates a new trigger.
      *
+     * This function can't be called in read-only mode.
+     *
      */
     constructor(eventName: string);
 }
@@ -17659,6 +17763,8 @@ export class World {
      * of the world.  Event callbacks are called in a deferred
      * manner. Event callbacks are executed in read-write mode.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly afterEvents: WorldAfterEvents;
     /**
@@ -17667,6 +17773,8 @@ export class World {
      * of the world. Event callbacks are called immediately. Event
      * callbacks are executed in read-only mode.
      *
+     * This property can be read in early-execution mode.
+     *
      * @example customCommand.ts
      * ```typescript
      * import { world, DimensionLocation } from "@minecraft/server";
@@ -17749,10 +17857,6 @@ export class World {
      * The aim-assist presets and categories that can be used in
      * the world.
      *
-     *
-     * Required Experiments:
-     * - Camera Aim Assist
-     *
      */
     getAimAssist(): AimAssistRegistry;
     /**
@@ -18169,12 +18273,16 @@ export class WorldAfterEvents {
      * explosion. It is fired after the blocks have already been
      * destroyed.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly blockExplode: BlockExplodeAfterEventSignal;
     /**
      * @remarks
      * This event fires when a button is pushed.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly buttonPush: ButtonPushAfterEventSignal;
     /**
@@ -18183,6 +18291,8 @@ export class WorldAfterEvents {
      * This event is triggered after a chat message has been
      * broadcast or sent to players.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly chatSend: ChatSendAfterEventSignal;
     /**
@@ -18191,6 +18301,8 @@ export class WorldAfterEvents {
      * that will update the component definition state of an
      * entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly dataDrivenEntityTrigger: DataDrivenEntityTriggerAfterEventSignal;
     /**
@@ -18198,18 +18310,24 @@ export class WorldAfterEvents {
      * This event fires when an effect, like poisoning, is added to
      * an entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly effectAdd: EffectAddAfterEventSignal;
     /**
      * @remarks
      * This event fires when an entity dies.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityDie: EntityDieAfterEventSignal;
     /**
      * @remarks
      * This event fires when entity health changes in any degree.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityHealthChanged: EntityHealthChangedAfterEventSignal;
     /**
@@ -18217,6 +18335,8 @@ export class WorldAfterEvents {
      * This event fires when an entity hits (that is, melee
      * attacks) a block.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityHitBlock: EntityHitBlockAfterEventSignal;
     /**
@@ -18224,18 +18344,24 @@ export class WorldAfterEvents {
      * This event fires when an entity hits (that is, melee
      * attacks) another entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityHitEntity: EntityHitEntityAfterEventSignal;
     /**
      * @remarks
      * This event fires when an entity is hurt (takes damage).
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityHurt: EntityHurtAfterEventSignal;
     /**
      * @remarks
      * Fires when an entity is loaded.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityLoad: EntityLoadAfterEventSignal;
     /**
@@ -18243,18 +18369,24 @@ export class WorldAfterEvents {
      * Fires when an entity is removed (for example, potentially
      * unloaded, or removed after being killed).
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityRemove: EntityRemoveAfterEventSignal;
     /**
      * @remarks
      * This event fires when an entity is spawned.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entitySpawn: EntitySpawnAfterEventSignal;
     /**
      * @remarks
      * This event is fired after an explosion occurs.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly explosion: ExplosionAfterEventSignal;
     /**
@@ -18262,12 +18394,16 @@ export class WorldAfterEvents {
      * This event fires when a world.gameRules property has
      * changed.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly gameRuleChange: GameRuleChangeAfterEventSignal;
     /**
      * @remarks
      * This event fires when a chargeable item completes charging.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemCompleteUse: ItemCompleteUseAfterEventSignal;
     /**
@@ -18275,12 +18411,16 @@ export class WorldAfterEvents {
      * This event fires when a chargeable item is released from
      * charging.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemReleaseUse: ItemReleaseUseAfterEventSignal;
     /**
      * @remarks
      * This event fires when a chargeable item starts charging.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemStartUse: ItemStartUseAfterEventSignal;
     /**
@@ -18291,12 +18431,16 @@ export class WorldAfterEvents {
      * occur once at the beginning of the block placement. Note:
      * This event cannot be used with Hoe or Axe items.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemStartUseOn: ItemStartUseOnAfterEventSignal;
     /**
      * @remarks
      * This event fires when a chargeable item stops charging.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemStopUse: ItemStopUseAfterEventSignal;
     /**
@@ -18305,6 +18449,8 @@ export class WorldAfterEvents {
      * Block button after successfully using an item. Note: This
      * event cannot be used with Hoe or Axe items.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemStopUseOn: ItemStopUseOnAfterEventSignal;
     /**
@@ -18312,6 +18458,8 @@ export class WorldAfterEvents {
      * This event fires when an item is successfully used by a
      * player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemUse: ItemUseAfterEventSignal;
     /**
@@ -18319,12 +18467,16 @@ export class WorldAfterEvents {
      * This event fires when an item is used on a block by a
      * player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemUseOn: ItemUseOnAfterEventSignal;
     /**
      * @remarks
      * A lever has been pulled.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly leverAction: LeverActionAfterEventSignal;
     /**
@@ -18333,18 +18485,24 @@ export class WorldAfterEvents {
      * This event is an internal implementation detail, and is
      * otherwise not currently functional.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly messageReceive: ServerMessageAfterEventSignal;
     /**
      * @remarks
      * This event fires when a piston expands or retracts.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly pistonActivate: PistonActivateAfterEventSignal;
     /**
      * @remarks
      * This event fires for a block that is broken by a player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerBreakBlock: PlayerBreakBlockAfterEventSignal;
     /**
@@ -18353,39 +18511,60 @@ export class WorldAfterEvents {
      * This event fires when an {@link InputButton} state is
      * changed.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerButtonInput: PlayerButtonInputAfterEventSignal;
     /**
      * @remarks
      * Fires when a player moved to a different dimension.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerDimensionChange: PlayerDimensionChangeAfterEventSignal;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly playerEmote: PlayerEmoteAfterEventSignal;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly playerGameModeChange: PlayerGameModeChangeAfterEventSignal;
     /**
-     * @rc
      * @remarks
      * This event fires when a player's {@link InputMode} changes.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInputModeChange: PlayerInputModeChangeAfterEventSignal;
     /**
      * @remarks
      * This event fires when a players input permissions change.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInputPermissionCategoryChange: PlayerInputPermissionCategoryChangeAfterEventSignal;
     /**
      * @remarks
      * An event for when a player interacts with a block.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInteractWithBlock: PlayerInteractWithBlockAfterEventSignal;
     /**
      * @remarks
      * This event fires when a player interacts with an entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInteractWithEntity: PlayerInteractWithEntityAfterEventSignal;
     /**
@@ -18394,18 +18573,24 @@ export class WorldAfterEvents {
      * playerSpawn for another related event you can trap for when
      * a player is spawned the first time within a world.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerJoin: PlayerJoinAfterEventSignal;
     /**
      * @remarks
      * This event fires when a player leaves a world.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerLeave: PlayerLeaveAfterEventSignal;
     /**
      * @remarks
      * This event fires for a block that is placed by a player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerPlaceBlock: PlayerPlaceBlockAfterEventSignal;
     /**
@@ -18414,6 +18599,8 @@ export class WorldAfterEvents {
      * an additional flag within this event will tell you whether
      * the player is spawning right after join vs. a respawn.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerSpawn: PlayerSpawnAfterEventSignal;
     /**
@@ -18421,6 +18608,8 @@ export class WorldAfterEvents {
      * A pressure plate has popped back up (i.e., there are no
      * entities on the pressure plate.)
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly pressurePlatePop: PressurePlatePopAfterEventSignal;
     /**
@@ -18428,30 +18617,40 @@ export class WorldAfterEvents {
      * A pressure plate has pushed (at least one entity has moved
      * onto a pressure plate.)
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly pressurePlatePush: PressurePlatePushAfterEventSignal;
     /**
      * @remarks
      * This event fires when a projectile hits a block.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly projectileHitBlock: ProjectileHitBlockAfterEventSignal;
     /**
      * @remarks
      * This event fires when a projectile hits an entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly projectileHitEntity: ProjectileHitEntityAfterEventSignal;
     /**
      * @remarks
      * A target block was hit.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly targetBlockHit: TargetBlockHitAfterEventSignal;
     /**
      * @remarks
      * A trip wire was tripped.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly tripWireTrip: TripWireTripAfterEventSignal;
     /**
@@ -18459,10 +18658,15 @@ export class WorldAfterEvents {
      * This event will be triggered when the weather changes within
      * Minecraft.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly weatherChange: WeatherChangeAfterEventSignal;
     /**
      * @beta
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
      */
     readonly worldLoad: WorldLoadAfterEventSignal;
 }
@@ -18482,6 +18686,8 @@ export class WorldBeforeEvents {
      * This event is triggered after a chat message has been
      * broadcast or sent to players.
      *
+     * This property can be read in early-execution mode.
+     *
      * @example customCommand.ts
      * ```typescript
      * import { world, DimensionLocation } from "@minecraft/server";
@@ -18516,6 +18722,8 @@ export class WorldBeforeEvents {
      * This event is triggered after an event has been added to an
      * entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly effectAdd: EffectAddBeforeEventSignal;
     /**
@@ -18523,12 +18731,16 @@ export class WorldBeforeEvents {
      * Fires before an entity is removed from the world (for
      * example, unloaded or removed after being killed.)
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly entityRemove: EntityRemoveBeforeEventSignal;
     /**
      * @remarks
      * This event is fired after an explosion occurs.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly explosion: ExplosionBeforeEventSignal;
     /**
@@ -18536,6 +18748,8 @@ export class WorldBeforeEvents {
      * This event fires when an item is successfully used by a
      * player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemUse: ItemUseBeforeEventSignal;
     /**
@@ -18543,31 +18757,46 @@ export class WorldBeforeEvents {
      * This event fires when an item is used on a block by a
      * player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly itemUseOn: ItemUseOnBeforeEventSignal;
     /**
      * @remarks
      * This event fires before a block is broken by a player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerBreakBlock: PlayerBreakBlockBeforeEventSignal;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly playerGameModeChange: PlayerGameModeChangeBeforeEventSignal;
     /**
      * @remarks
      * Fires before a player interacts with a block.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInteractWithBlock: PlayerInteractWithBlockBeforeEventSignal;
     /**
      * @remarks
      * Fires before a player interacts with an entity.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerInteractWithEntity: PlayerInteractWithEntityBeforeEventSignal;
     /**
      * @remarks
      * Fires when a player leaves the game.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerLeave: PlayerLeaveBeforeEventSignal;
     /**
@@ -18575,8 +18804,15 @@ export class WorldBeforeEvents {
      * @remarks
      * This event fires before a block is placed by a player.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     readonly playerPlaceBlock: PlayerPlaceBlockBeforeEventSignal;
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     readonly weatherChange: WeatherChangeBeforeEventSignal;
 }
 
@@ -18969,14 +19205,22 @@ export interface CameraFadeTimeOptions {
 }
 
 /**
- * @beta
- *
- * Required Experiments:
- * - Third Person Cameras
- *
+ * Options to control pivot points and offsets of the third
+ * person boom preset.
  */
 export interface CameraFixedBoomOptions {
+    /**
+     * @remarks
+     * Changes the pivot point to be <x, y, z> away from the
+     * player.
+     *
+     */
     entityOffset?: Vector3;
+    /**
+     * @remarks
+     * Offsets the camera from center by <x, y>.
+     *
+     */
     viewOffset?: Vector2;
 }
 
@@ -20061,10 +20305,6 @@ export interface PlayAnimationOptions {
 /**
  * @beta
  * Settings relating to a player's aim-assist targeting.
- *
- * Required Experiments:
- * - Camera Aim Assist
- *
  */
 export interface PlayerAimAssistSettings {
     /**
@@ -20745,6 +20985,11 @@ export class CustomComponentInvalidRegistryError extends Error {
 // @ts-ignore Class inheritance allowed for native defined classes
 export class CustomComponentNameError extends Error {
     private constructor();
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     reason: CustomComponentNameErrorReason;
 }
 
@@ -20773,7 +21018,6 @@ export class InvalidContainerSlotError extends Error {
 }
 
 /**
- * @rc
  * The error called when an entity is invalid. This can occur
  * when accessing components on a removed entity.
  */
@@ -20784,12 +21028,16 @@ export class InvalidEntityError extends Error {
      * @remarks
      * The id of the entity that is now invalid.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     id: string;
     /**
      * @remarks
      * The type of the entity that is now invalid.
      *
+     * This property can be read in early-execution mode.
+     *
      */
     type: string;
 }
@@ -20872,6 +21120,11 @@ export class LocationOutOfWorldBoundariesError extends Error {
 // @ts-ignore Class inheritance allowed for native defined classes
 export class NamespaceNameError extends Error {
     private constructor();
+    /**
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
     reason: NamespaceNameErrorReason;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "2.0.0-beta.1.21.70-preview.22",
+  "version": "2.0.0-beta.1.21.70-preview.24",
   "description": "",
   "contributors": [
     {