@minecraft/server 2.9.0-beta.1.26.30-preview.27 → 2.9.0-beta.1.26.30-preview.30

package/index.d.ts

@@ -47,6 +47,10 @@ export enum AimAssistTargetMode {
  * function Block.getComponent.
  */
 export enum BlockComponentTypes {
+    /**
+     * @beta
+     */
+    DynamicProperties = 'minecraft:dynamic_properties',
     FluidContainer = 'minecraft:fluid_container',
     /**
      * @remarks
@@ -1145,6 +1149,15 @@ export enum EntityComponentTypes {
      *
      */
     Exhaustion = 'minecraft:player.exhaustion',
+    /**
+     * @beta
+     * @remarks
+     * Use this component to access and manipulate the fog
+     * definitions stack of a player. This is only available on
+     * players.
+     *
+     */
+    Fog = 'minecraft:player.fog',
     /**
      * @remarks
      * Use this component to read the hunger of a player. This is
@@ -1503,7 +1516,7 @@ export enum EntityHealCause {
      */
     SelfHeal = 'SelfHeal',
     /**
-     * @beta
+     * @rc
      * @remarks
      * Healing caused when Totem of Undying is activated.
      *
@@ -2346,7 +2359,7 @@ export enum LiquidType {
 }
 
 /**
- * @beta
+ * @rc
  * Enum representing the different reasons why a locator bar
  * operation may fail.
  */
@@ -3049,7 +3062,7 @@ export enum WatchdogTerminateReason {
 }
 
 /**
- * @beta
+ * @rc
  * Enum representing different texture icons that can be
  * displayed for waypoints on the locator bar.
  */
@@ -3110,9 +3123,11 @@ export type BlockComponentReturnType<T extends string> = T extends keyof BlockCo
     : BlockCustomComponentInstance;
 
 export type BlockComponentTypeMap = {
+    dynamic_properties: BlockDynamicPropertiesComponent;
     fluid_container: BlockFluidContainerComponent;
     inventory: BlockInventoryComponent;
     map_color: BlockMapColorComponent;
+    'minecraft:dynamic_properties': BlockDynamicPropertiesComponent;
     'minecraft:fluid_container': BlockFluidContainerComponent;
     'minecraft:inventory': BlockInventoryComponent;
     'minecraft:map_color': BlockMapColorComponent;
@@ -3236,6 +3251,7 @@ export type EntityComponentTypeMap = {
     'minecraft:npc': EntityNpcComponent;
     'minecraft:onfire': EntityOnFireComponent;
     'minecraft:player.exhaustion': EntityExhaustionComponent;
+    'minecraft:player.fog': EntityFogComponent;
     'minecraft:player.hunger': EntityHungerComponent;
     'minecraft:player.saturation': EntitySaturationComponent;
     'minecraft:projectile': EntityProjectileComponent;
@@ -3270,6 +3286,7 @@ export type EntityComponentTypeMap = {
     npc: EntityNpcComponent;
     onfire: EntityOnFireComponent;
     'player.exhaustion': EntityExhaustionComponent;
+    'player.fog': EntityFogComponent;
     'player.hunger': EntityHungerComponent;
     'player.saturation': EntitySaturationComponent;
     projectile: EntityProjectileComponent;
@@ -4789,7 +4806,7 @@ export class BlockComponentBlockBreakEvent extends BlockEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Contains information regarding a specific block permutation
  * that was changed from a previous permutation.
  */
@@ -5171,6 +5188,108 @@ export class BlockCustomComponentInstance extends BlockComponent {
     readonly customComponentParameters: CustomComponentParameters;
 }
 
+/**
+ * @beta
+ * Represents the dynamic properties of a block in the world.
+ * Only available with block entities. Up to 1KBytes of data
+ * can be stored per block entity in their dynamic properties
+ * storage.
+ * @example rememberPlayerInteraction.ts
+ * ```typescript
+ * import { system } from '@minecraft/server-wrapper';
+ *
+ * system.beforeEvents.startup.subscribe(initEvent => {
+ *   initEvent.blockComponentRegistry.registerCustomComponent('scripting_demo_pack:block_entity_onPlayerInteract', {
+ *     onPlayerInteract: e => {
+ *       if (e.player === undefined) {
+ *         return;
+ *       }
+ *
+ *       const dynamicProperties = e.block.getComponent('minecraft:dynamic_properties');
+ *       if (!dynamicProperties) {
+ *         return;
+ *       }
+ *
+ *       const lastInteractorValue = dynamicProperties.get('last_interactor');
+ *       const lastVisitor = typeof lastInteractorValue === 'string' ? lastInteractorValue : 'unknown';
+ *       const lastTick = Number(dynamicProperties.get('last_interact_tick') ?? system.currentTick);
+ *       const ticksAgo = Math.max(0, system.currentTick - lastTick);
+ *
+ *       if (lastVisitor === e.player.name) {
+ *         e.player.sendMessage("do you remember that player? I 'member, it was here " + String(ticksAgo) + ' ticks ago!');
+ *       } else {
+ *         e.player.sendMessage("oh, I don't remember that player");
+ *       }
+ *
+ *       dynamicProperties.set('last_interactor', e.player.name);
+ *       dynamicProperties.set('last_interact_tick', system.currentTick);
+ *     },
+ *   });
+ * });
+ * ```
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class BlockDynamicPropertiesComponent extends BlockComponent {
+    private constructor();
+    static readonly componentId = 'minecraft:dynamic_properties';
+    /**
+     * @remarks
+     * Returns a DynamicProperty that was stored with the provided
+     * key. Keys are unique to each content pack and cannot be used
+     * to retrieve dynamic properties set from other content packs.
+     * Returns undefined if the key was not found.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link Error}
+     *
+     * {@link InvalidBlockComponentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    get(key: string): boolean | number | string | Vector3 | undefined;
+    /**
+     * @remarks
+     * Sets a dynamic property with the provided key and value.
+     * Keys are unique to each content pack and cannot be used to
+     * set dynamic properties for other content packs. Values can
+     * be either a Number, a String or a Vector3. Setting a
+     * property with an undefined value will remove it from the
+     * storage.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link Error}
+     *
+     * {@link InvalidBlockComponentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    set(key: string, value?: boolean | number | string | Vector3): void;
+    /**
+     * @remarks
+     * Returns the current size, in bytes, of the dynamic
+     * properties storage for this block entity.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link Error}
+     *
+     * {@link InvalidBlockComponentError}
+     *
+     * {@link LocationInUnloadedChunkError}
+     *
+     * {@link LocationOutOfWorldBoundariesError}
+     */
+    totalByteCount(): number;
+}
+
 /**
  * Contains information regarding an event that impacts a
  * specific block.
@@ -8967,7 +9086,7 @@ export class Dimension {
 }
 
 /**
- * @beta
+ * @rc
  * Provides the functionality for registering custom
  * dimensions. Custom dimensions can only be registered during
  * the system startup event.
@@ -11325,6 +11444,140 @@ export class EntityFlyingSpeedComponent extends EntityComponent {
     static readonly componentId = 'minecraft:flying_speed';
 }
 
+/**
+ * @beta
+ * Provides access to the fog definitions stack of a player
+ * entity, allowing scripts to push, pop, remove, and query
+ * active fog definitions.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class EntityFogComponent extends EntityComponent {
+    private constructor();
+    static readonly componentId = 'minecraft:player.fog';
+    /**
+     * @remarks
+     * Sets the player's fog stack to the given list of fog
+     * identifiers, replacing any existing entries.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @param fogIds
+     * A stack of fog definition identifiers to set on the player's
+     * fog stack (e.g. ['minecraft:fog_bamboo_jungle']). Maximum of
+     * 16 entries.
+     * @param tag
+     * An optional tag to associate with the new entries, used to
+     * target them with pop or remove.
+     * @throws
+     * Throws if the entity is invalid, if more than 16 fog
+     * identifiers are provided, or if any fog identifier is
+     * invalid.
+     *
+     * {@link EntityFogComponentError}
+     *
+     * {@link InvalidEntityError}
+     */
+    applyStack(fogIds: string[], tag?: string): void;
+    /**
+     * @remarks
+     * Returns the list of fog identifiers currently on the
+     * player's fog stack, ordered from bottom to top.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @returns
+     * An array of fog definition identifiers currently on the
+     * stack.
+     * @throws
+     * Throws if the entity is invalid.
+     *
+     * {@link InvalidEntityError}
+     */
+    getStack(): string[];
+    /**
+     * @remarks
+     * Returns the list of tags currently present on the player's
+     * fog stack.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @returns
+     * An array of tag strings associated with fog settings on the
+     * stack.
+     * @throws
+     * Throws if the entity is invalid.
+     *
+     * {@link InvalidEntityError}
+     */
+    getTags(): string[];
+    /**
+     * @remarks
+     * Removes the most recently pushed fog definition from the
+     * player's fog stack.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @param tag
+     * An optional tag identifying which entry to pop. If provided,
+     * searches the stack from top to bottom and removes the most
+     * recently pushed entry with this tag. If omitted, removes the
+     * most recently pushed entry regardless of tag.
+     * @returns
+     * Returns the identifier of the popped fog definition, or
+     * undefined if the stack was unchanged.
+     * @throws
+     * Throws if the entity is invalid.
+     *
+     * {@link InvalidEntityError}
+     */
+    pop(tag?: string): string | undefined;
+    /**
+     * @remarks
+     * Pushes a new fog definition onto the player's fog stack.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @param fogId
+     * The identifier of the fog definition to push onto the stack
+     * (e.g. 'minecraft:fog_bamboo_jungle').
+     * @param tag
+     * An optional tag used to label this fog definition on the
+     * stack, allowing it to be targeted by pop or remove. If
+     * omitted, the entry is stored with the tag 'untagged'.
+     * @returns
+     * Returns the zero-based index at which the fog definition was
+     * inserted into the stack.
+     * @throws
+     * Throws if the entity is invalid, the fog identifier is
+     * invalid, or if the stack limit of 16 has been exceeded.
+     *
+     * {@link EntityFogComponentError}
+     *
+     * {@link InvalidEntityError}
+     */
+    push(fogId: string, tag?: string): number;
+    /**
+     * @remarks
+     * Removes all fog definitions with the given tag from the
+     * player's fog stack. If no tag is provided, clears all fog
+     * definitions.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @param tag
+     * An optional tag identifying which the entries to remove. If
+     * omitted, clears all fog definitions regardless of tag.
+     * @returns
+     * Returns true if at least one entry was removed, or false if
+     * the stack was unchanged.
+     * @throws
+     * Throws if the entity is invalid.
+     *
+     * {@link InvalidEntityError}
+     */
+    remove(tag?: string): boolean;
+}
+
 /**
  * Defines how much friction affects this entity.
  */
@@ -13780,7 +14033,7 @@ export class EntityUnderwaterMovementComponent extends EntityAttributeComponent
 }
 
 /**
- * @beta
+ * @rc
  * Contains information related to firing of a data driven
  * entity version upgrade.
  */
@@ -13808,7 +14061,7 @@ export class EntityUpgradeAfterEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Contains event registration related to firing of a data
  * driven entity version upgrade.
  */
@@ -13870,7 +14123,7 @@ export class EntityWantsJockeyComponent extends EntityComponent {
 }
 
 /**
- * @beta
+ * @rc
  * Waypoint that tracks an entity's position. The waypoint
  * automatically updates as the entity moves and becomes
  * invalid when the entity is removed.
@@ -14507,6 +14760,10 @@ export class IsBabyCondition extends LootItemCondition {
     private constructor();
 }
 
+export class ISerializable {
+    private constructor();
+}
+
 /**
  * When present on an item, this item is a book item. Can
  * access and modify the contents of the book and sign it.
@@ -16672,7 +16929,7 @@ export class ListBlockVolume extends BlockVolumeBase {
 }
 
 /**
- * @beta
+ * @rc
  * Waypoint that points to a fixed location in the world.
  * Unlike entity waypoints, location waypoints always remain
  * valid and their position can be updated.
@@ -16700,7 +16957,7 @@ export class LocationWaypoint extends Waypoint {
 }
 
 /**
- * @beta
+ * @rc
  * Manages the collection of waypoints displayed on a player's
  * locator bar. Allows adding, removing, and querying waypoints
  * with a maximum capacity limit.
@@ -16863,6 +17120,10 @@ export class LootingEnchantFunction extends LootItemFunction {
 // @ts-ignore Class inheritance allowed for native defined classes
 export class LootItem extends LootPoolEntry {
     private constructor();
+    /**
+     * @beta
+     */
+    readonly conditions: LootItemCondition[];
     readonly functions: LootItemFunction[];
     /**
      * @remarks
@@ -17654,7 +17915,7 @@ export class Player extends Entity {
      */
     readonly level: number;
     /**
-     * @beta
+     * @rc
      * @remarks
      * The player's Locator Bar. This property is used for managing
      * waypoints displayed on the HUD.
@@ -17676,17 +17937,6 @@ export class Player extends Entity {
      * @throws This property can throw when used.
      */
     readonly onScreenDisplay: ScreenDisplay;
-    /**
-     * @beta
-     * @remarks
-     * The party information for this player, or undefined if the
-     * player is not in a party.
-     *
-     * @throws This property can throw when used.
-     *
-     * {@link InvalidEntityError}
-     */
-    readonly partyInfo?: PartyInfo;
     /**
      * @throws This property can throw when used.
      *
@@ -18461,6 +18711,83 @@ export class PlayerButtonInputAfterEventSignal {
     unsubscribe(callback: (arg0: PlayerButtonInputAfterEvent) => void): void;
 }
 
+/**
+ * @beta
+ * Contains information regarding an event after a player
+ * cancels breaking a block.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class PlayerCancelBreakingBlockAfterEvent extends BlockEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The permutation of the block that the player cancelled
+     * breaking.
+     *
+     */
+    readonly blockPermutation: BlockPermutation;
+    /**
+     * @remarks
+     * The progress of breaking the block when the player cancelled
+     * in the exclusive range (0, 1).
+     *
+     */
+    readonly breakProgress: number;
+    /**
+     * @remarks
+     * The face of the block that was being broken.
+     *
+     */
+    readonly face: Direction;
+    /**
+     * @remarks
+     * The item stack that the player was using to break the block,
+     * or undefined if empty hand.
+     *
+     */
+    readonly heldItemStack?: ItemStack;
+    /**
+     * @remarks
+     * Player that cancelled breaking the block for this event.
+     *
+     */
+    readonly player: Player;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to when a player
+ * cancels breaking a block.
+ */
+export class PlayerCancelBreakingBlockAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when a player cancels
+     * breaking a block.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    subscribe(
+        callback: (arg0: PlayerCancelBreakingBlockAfterEvent) => void,
+        options?: PlayerBreakingBlockEventOptions,
+    ): (arg0: PlayerCancelBreakingBlockAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when a player cancels
+     * breaking a block.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    unsubscribe(callback: (arg0: PlayerCancelBreakingBlockAfterEvent) => void): void;
+}
+
 /**
  * Represents the players cursor inventory. Used when moving
  * items between between containers in the inventory UI. Not
@@ -19648,6 +19975,76 @@ export class PlayerSpawnAfterEventSignal {
     unsubscribe(callback: (arg0: PlayerSpawnAfterEvent) => void): void;
 }
 
+/**
+ * @beta
+ * Contains information regarding an event after a player
+ * starts breaking a block.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class PlayerStartBreakingBlockAfterEvent extends BlockEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The permutation of the block that the player is starting to
+     * break.
+     *
+     */
+    readonly blockPermutation: BlockPermutation;
+    /**
+     * @remarks
+     * The face of the block being broken.
+     *
+     */
+    readonly face: Direction;
+    /**
+     * @remarks
+     * The item stack that the player is using to break the block,
+     * or undefined if empty hand.
+     *
+     */
+    readonly heldItemStack?: ItemStack;
+    /**
+     * @remarks
+     * Player that started breaking the block for this event.
+     *
+     */
+    readonly player: Player;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to when a player starts
+ * breaking a block.
+ */
+export class PlayerStartBreakingBlockAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when a player starts
+     * breaking a block.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    subscribe(
+        callback: (arg0: PlayerStartBreakingBlockAfterEvent) => void,
+        options?: PlayerBreakingBlockEventOptions,
+    ): (arg0: PlayerStartBreakingBlockAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when a player starts
+     * breaking a block.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    unsubscribe(callback: (arg0: PlayerStartBreakingBlockAfterEvent) => void): void;
+}
+
 /**
  * Contains information regarding a player starting to swing
  * their arm.
@@ -19787,7 +20184,7 @@ export class PlayerUseNameTagAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Waypoint that tracks a player's position. Extends {@link
  * EntityWaypoint} with additional player-specific visibility
  * rules such as hidden state and spectator mode.
@@ -20021,7 +20418,7 @@ export class PressurePlatePushAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * The base class for a text primitive. Represents an object in
  * the world and its base properties.
  */
@@ -20125,7 +20522,7 @@ export class PrimitiveShape {
 }
 
 /**
- * @beta
+ * @rc
  * Primitive Shapes class used to allow adding and removing
  * text primitives to the world.
  */
@@ -21500,7 +21897,7 @@ export class StartupEvent {
      */
     readonly customCommandRegistry: CustomCommandRegistry;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This property can be read in early-execution mode.
      *
@@ -21519,7 +21916,8 @@ export class StartupEvent {
  * Structures can be placed in a world using the /structure
  * command or the {@link StructureManager} APIs.
  */
-export class Structure {
+// @ts-ignore Class inheritance allowed for native defined classes
+export class Structure extends ISerializable {
     private constructor();
     /**
      * @remarks
@@ -22255,7 +22653,7 @@ export class TargetBlockHitAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * A primitive shape class that represents a text label in the
  * world with a background.
  */
@@ -22628,7 +23026,7 @@ export class WatchdogTerminateBeforeEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Base class for waypoints displayed on the player's locator
  * bar. Waypoints can track locations or entities and are
  * rendered with customizable textures and colors.
@@ -22897,7 +23295,7 @@ export class World {
     readonly gameRules: GameRules;
     readonly isHardcore: boolean;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Manager for adding and removing primitive text objects in
      * the world.
@@ -23138,7 +23536,7 @@ export class World {
      */
     getMoonPhase(): MoonPhase;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns a map of pack setting name and value pairs.
      *
@@ -23582,7 +23980,7 @@ export class WorldAfterEvents {
      */
     readonly entityStartSneaking: EntityStartSneakingAfterEventSignal;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This property can be read in early-execution mode.
      *
@@ -23721,6 +24119,15 @@ export class WorldAfterEvents {
      *
      */
     readonly playerButtonInput: PlayerButtonInputAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires when a player cancels breaking a block.
+     *
+     * This property can be read in early-execution mode.
+     *
+     */
+    readonly playerCancelBreakingBlock: PlayerCancelBreakingBlockAfterEventSignal;
     /**
      * @remarks
      * Fires when a player moved to a different dimension.
@@ -23826,6 +24233,15 @@ export class WorldAfterEvents {
      *
      */
     readonly playerSpawn: PlayerSpawnAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires when a player starts breaking a block.
+     *
+     * This property can be read in early-execution mode.
+     *
+     */
+    readonly playerStartBreakingBlock: PlayerStartBreakingBlockAfterEventSignal;
     /**
      * @remarks
      * This property can be read in early-execution mode.
@@ -24215,7 +24631,7 @@ export interface BlockCustomComponent {
      */
     beforeOnPlayerPlace?: (arg0: BlockComponentPlayerPlaceBeforeEvent, arg1: CustomComponentParameters) => void;
     /**
-     * @beta
+     * @rc
      */
     onBlockStateChange?: (arg0: BlockComponentBlockStateChangeEvent, arg1: CustomComponentParameters) => void;
     /**
@@ -24793,7 +25209,7 @@ export interface CustomCommandResult {
 }
 
 /**
- * @beta
+ * @rc
  */
 export interface CustomTexture {
     /**
@@ -25659,7 +26075,7 @@ export interface EntitySneakingChangedEventOptions {
 }
 
 /**
- * @beta
+ * @rc
  * Controls when a waypoint is visible based on the state of
  * the entity it tracks. These rules allow filtering waypoint
  * visibility by entity conditions like sneaking, invisibility,
@@ -26095,27 +26511,6 @@ export interface NotEqualsComparison {
     notEquals: boolean | number | string;
 }
 
-/**
- * @beta
- * Contains information about a player's party membership. This
- * object is a snapshot of the player's party state at the time
- * it was retrieved and is not kept up to date.
- */
-export interface PartyInfo {
-    /**
-     * @remarks
-     * Whether this player is the leader of their party.
-     *
-     */
-    isLeader: boolean;
-    /**
-     * @remarks
-     * The unique identifier of the party this player belongs to.
-     *
-     */
-    partyId: string;
-}
-
 /**
  * Contains additional options for how an animation is played.
  */
@@ -26185,6 +26580,33 @@ export interface PlayerAimAssistSettings {
     viewAngle?: Vector2;
 }
 
+/**
+ * @beta
+ * An interface that is passed into {@link
+ * PlayerStartBreakingBlockAfterEventSignal.subscribe} or
+ * {@link PlayerCancelBreakingBlockAfterEventSignal.subscribe}
+ * that filters out which events are passed to the provided
+ * callback.
+ */
+export interface PlayerBreakingBlockEventOptions {
+    /**
+     * @remarks
+     * The {@link BlockFilter} that the callback should be called
+     * for. If undefined, the callback will be called for all
+     * blocks.
+     *
+     */
+    blockFilter?: BlockFilter;
+    /**
+     * @remarks
+     * The {@link EntityFilter} that the callback should be called
+     * for. If undefined, the callback will be called for all
+     * players.
+     *
+     */
+    playerFilter?: EntityFilter;
+}
+
 /**
  * Additional options for how a sound plays for a player.
  */
@@ -26236,7 +26658,7 @@ export interface PlayerSwingEventOptions {
 }
 
 /**
- * @beta
+ * @rc
  * Controls when a waypoint is visible based on player-specific
  * states. Extends {@link EntityVisibilityRules} with
  * additional rules for player-only states like hidden mode and
@@ -26965,7 +27387,7 @@ export interface VectorXZ {
 }
 
 /**
- * @beta
+ * @rc
  * Defines a texture and the distance range in which it should
  * be displayed. Used within a {@link WaypointTextureSelector}
  * to create distance-based texture switching.
@@ -27000,7 +27422,7 @@ export interface WaypointTextureBounds {
 }
 
 /**
- * @beta
+ * @rc
  * Defines how waypoint textures change based on distance.
  * Contains a list of texture bounds that determine which
  * texture is displayed at different distance ranges.
@@ -27154,7 +27576,7 @@ export class CustomComponentNameError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Thrown when trying to register a custom dimension with a
  * name that has already been registered.
  */
@@ -27164,7 +27586,7 @@ export class CustomDimensionAlreadyRegisteredError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Thrown when trying to register a custom dimension outside of
  * the system startup event.
  */
@@ -27174,7 +27596,7 @@ export class CustomDimensionInvalidRegistryError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Thrown when trying to register a custom dimension with a
  * name that contains invalid characters.
  */
@@ -27184,7 +27606,7 @@ export class CustomDimensionNameError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Thrown after using the /reload command when trying to
  * register a custom dimension that was not previously
  * registered. New custom dimensions cannot be added during a
@@ -27210,6 +27632,17 @@ export class EnchantmentTypeUnknownIdError extends Error {
     private constructor();
 }
 
+/**
+ * @beta
+ * Error thrown by {@link EntityFogComponent} operations when
+ * the fog stack limit is exceeded or an invalid fog identifier
+ * is provided.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class EntityFogComponentError extends Error {
+    private constructor();
+}
+
 // @ts-ignore Class inheritance allowed for native defined classes
 export class EntitySpawnError extends Error {
     private constructor();
@@ -27319,7 +27752,7 @@ export class InvalidStructureError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Error thrown when attempting to perform operations on an
  * invalid waypoint. A waypoint becomes invalid when it is
  * removed or when the entity it tracks is no longer valid.
@@ -27330,7 +27763,7 @@ export class InvalidWaypointError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class InvalidWaypointTextureSelectorError extends Error {
@@ -27394,7 +27827,7 @@ export class LocationOutOfWorldBoundariesError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  * Error thrown when a locator bar operation fails. Contains a
  * reason code indicating the specific cause of the error.
  */
@@ -27433,7 +27866,7 @@ export class PlaceJigsawError extends Error {
 }
 
 /**
- * @beta
+ * @rc
  */
 // @ts-ignore Class inheritance allowed for native defined classes
 export class PrimitiveShapeError extends Error {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "2.9.0-beta.1.26.30-preview.27",
+  "version": "2.9.0-beta.1.26.30-preview.30",
   "description": "",
   "contributors": [
     {
@@ -14,7 +14,7 @@
   ],
   "peerDependencies": {
     "@minecraft/common": "^1.2.0",
-    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.30-preview.27"
+    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.30-preview.30"
   },
   "license": "MIT"
 }