@minecraft/server 2.11.0-beta.1.26.50-preview.24 → 2.11.0-beta.1.26.50-preview.26

package/index.d.ts

@@ -221,7 +221,7 @@ export enum CameraShakeType {
 }
 
 /**
- * @beta
+ * @rc
  * An enumeration for the clone modes used when cloning blocks.
  */
 export enum CloneMode {
@@ -2736,6 +2736,34 @@ export enum PlayerWaypointsMode {
     Off = 'Off',
 }
 
+/**
+ * @beta
+ * Specifies how a block point-of-interest query filters
+ * instances by ticket occupancy.
+ */
+export enum PoiBlockOccupancyFilter {
+    /**
+     * @remarks
+     * Includes POI instances regardless of their occupancy or
+     * available ticket count.
+     *
+     */
+    Any = 'Any',
+    /**
+     * @remarks
+     * Includes POI instances with no available tickets.
+     *
+     */
+    Full = 'Full',
+    /**
+     * @remarks
+     * Includes POI instances with at least one ticket available to
+     * be claimed.
+     *
+     */
+    HasVacancy = 'HasVacancy',
+}
+
 /**
  * Contains objectives and participants for the scoreboard.
  */
@@ -8098,6 +8126,15 @@ export class Dimension {
      *
      */
     readonly localizationKey: string;
+    /**
+     * @beta
+     * @remarks
+     * Provides access to point-of-interest (POI) managers for this
+     * dimension. This property is available only when the POI
+     * experiment is enabled.
+     *
+     */
+    readonly poiManager: PoiManager;
     /**
      * @remarks
      * Calculates the location of the closest biome of a particular
@@ -8130,7 +8167,7 @@ export class Dimension {
         options?: BiomeSearchOptions,
     ): Vector3 | undefined;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Clones a region of blocks from one area of the dimension to
      * another.
@@ -9081,7 +9118,9 @@ export class DimensionTypes {
     /**
      * @remarks
      * Retrieves a dimension type using a string-based identifier.
-     * Currently only works with Vanilla dimensions.
+     * Works with both vanilla dimensions and custom dimensions.
+     * Custom dimensions cannot be retrieved until after the system
+     * startup event has completed.
      *
      * @privilege early-execution-allowed - This function can be called in early-execution mode.
      *
@@ -9089,8 +9128,10 @@ export class DimensionTypes {
     static get(dimensionTypeId: string): DimensionType | undefined;
     /**
      * @remarks
-     * Retrieves an array of all dimension types. Currently only
-     * works with Vanilla dimensions.
+     * Retrieves an array of all dimension types. Includes both
+     * vanilla dimensions and custom dimensions. Custom dimensions
+     * are not included until after the system startup event has
+     * completed.
      *
      * @privilege early-execution-allowed - This function can be called in early-execution mode.
      *
@@ -12114,6 +12155,28 @@ export class EntityIsStunnedComponent extends EntityComponent {
 // @ts-ignore Class inheritance allowed for native defined classes
 export class EntityIsTamedComponent extends EntityComponent {
     private constructor();
+    /**
+     * @beta
+     * @remarks
+     * Returns the player that has tamed the entity, or 'undefined'
+     * if the entity has no player owner.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
+     */
+    readonly tamedToPlayer?: Player;
+    /**
+     * @beta
+     * @remarks
+     * Returns the id of the player that has tamed the entity, or
+     * 'undefined' if the entity has no player owner.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidEntityError}
+     */
+    readonly tamedToPlayerId?: string;
     static readonly componentId = 'minecraft:is_tamed';
 }
 
@@ -17717,7 +17780,7 @@ export class PackSettingChangeAfterEvent {
      * The value of the setting.
      *
      */
-    readonly settingValue: boolean | number | string;
+    readonly settingValue: string[] | boolean | number | string;
 }
 
 /**
@@ -20360,6 +20423,315 @@ export class PlayerWaypoint extends EntityWaypoint {
     );
 }
 
+/**
+ * @beta
+ * Describes a block point-of-interest instance returned by a
+ * query.
+ *
+ * Required Experiments:
+ * - Poi
+ *
+ */
+export class PoiBlockInstance {
+    private constructor();
+    /**
+     * @remarks
+     * Block position of this POI instance.
+     *
+     */
+    readonly position: Vector3;
+    /**
+     * @remarks
+     * Number of tickets currently available to be claimed from
+     * this POI instance.
+     *
+     */
+    readonly tickets: number;
+    /**
+     * @remarks
+     * Type of this POI instance.
+     *
+     */
+    readonly 'type': PoiBlockType;
+}
+
+/**
+ * @beta
+ * Provides methods for querying and managing block-based
+ * points of interest in a dimension.
+ *
+ * Required Experiments:
+ * - Poi
+ *
+ */
+export class PoiBlockManager {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a block point of interest at a position. This method is
+     * intended for temporary usage. Will be replaced when chunk is
+     * reloaded
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param position
+     * Block position at which to add the POI.
+     * @param poi
+     * POI type to add, specified by numeric type Id, type name, or
+     * POI type object.
+     */
+    addTemporary(position: Vector3, poi: PoiBlockType | string | number): void;
+    /**
+     * @remarks
+     * Gets the type of the block point of interest at a position.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param position
+     * Block position to inspect.
+     * @returns
+     * The POI type at the position, or undefined if no POI exists
+     * there.
+     */
+    at(position: Vector3): PoiBlockType | undefined;
+    /**
+     * @remarks
+     * Tests whether a block point of interest at a position
+     * matches a type filter.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param position
+     * Block position to inspect.
+     * @param filter
+     * Filter used to select the POI type. A callback receives the
+     * POI type and returns whether it matches; a name filter
+     * matches a type name; and a tag filter requires all specified
+     * tags.
+     * @returns
+     * True if a POI exists at the position and its type matches
+     * the filter; otherwise false.
+     */
+    exists(position: Vector3, filter: ((arg0: PoiBlockType) => boolean) | PoiNameFilter | PoiTagFilter): boolean;
+    /**
+     * @remarks
+     * Returns block points of interest that match the supplied
+     * type and occupancy filters within the specified distance of
+     * a location.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param filter
+     * Filter used to select POI types. A callback receives each
+     * POI type and returns whether it should be included; a name
+     * filter matches a type name; and a tag filter requires all
+     * specified tags.
+     * @param center
+     * Center of the search.
+     * @param blockRadius
+     * Maximum three-dimensional distance from the center, in
+     * blocks.
+     * @param occupancyFilter
+     * Optional filter applied to the occupancy state of matching
+     * POIs. If omitted, POIs in any occupancy state are returned.
+     * @returns
+     * The matching POI instances within range. The result order is
+     * not guaranteed.
+     */
+    getInRange(
+        filter: ((arg0: PoiBlockType) => boolean) | PoiNameFilter | PoiTagFilter,
+        center: Vector3,
+        blockRadius: number,
+        occupancyFilter?: PoiBlockOccupancyFilter,
+    ): PoiBlockInstance[];
+    /**
+     * @remarks
+     * Returns block points of interest that match the supplied
+     * type and occupancy filters within an axis-aligned square
+     * centered on the specified location, sorted from nearest to
+     * farthest.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param filter
+     * Filter used to select POI types. A callback receives each
+     * POI type and returns whether it should be included; a name
+     * filter matches a type name; and a tag filter requires all
+     * specified tags.
+     * @param center
+     * Center of the search and the location from which distances
+     * are calculated.
+     * @param blockRadius
+     * Maximum three-dimensional distance from the center, in
+     * blocks.
+     * @param occupancyFilter
+     * Optional filter applied to the occupancy state of matching
+     * POIs. If omitted, POIs in any occupancy state are returned.
+     * @returns
+     * The matching POI instances and their squared distances from
+     * the center, sorted in ascending distance order.
+     */
+    getInRangeSorted(
+        filter: ((arg0: PoiBlockType) => boolean) | PoiNameFilter | PoiTagFilter,
+        center: Vector3,
+        blockRadius: number,
+        occupancyFilter?: PoiBlockOccupancyFilter,
+    ): PoiDistancePair[];
+    /**
+     * @remarks
+     * Returns block points of interest that match the supplied
+     * type and occupancy filters within an axis-aligned square
+     * centered on the specified location.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param filter
+     * Filter used to select POI types. A callback receives each
+     * POI type and returns whether it should be included; a name
+     * filter matches a type name; and a tag filter requires all
+     * specified tags.
+     * @param center
+     * Center of the search volume.
+     * @param blockRadius
+     * Half-size of the search volume, in blocks, along each axis.
+     * @param occupancyFilter
+     * Optional filter applied to the occupancy state of matching
+     * POIs. If omitted, POIs in any occupancy state are returned.
+     * @returns
+     * The matching POI instances in the search volume.
+     */
+    getInSquare(
+        filter: ((arg0: PoiBlockType) => boolean) | PoiNameFilter | PoiTagFilter,
+        center: Vector3,
+        blockRadius: number,
+        occupancyFilter?: PoiBlockOccupancyFilter,
+    ): PoiBlockInstance[];
+    /**
+     * @remarks
+     * Releases one previously claimed ticket at a block point of
+     * interest.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param center
+     * Block position of the POI whose ticket should be released.
+     * @returns
+     * True if a ticket was released; false if no POI exists at the
+     * position or the POI has no claimed tickets.
+     */
+    release(center: Vector3): boolean;
+    /**
+     * @remarks
+     * Claims one available ticket from a matching block point of
+     * interest within range.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param filter
+     * Filter used to select the POI type to claim. A callback
+     * receives each POI type and returns whether it should be
+     * included; a name filter matches a type name; and a tag
+     * filter requires all specified tags.
+     * @param center
+     * Center of the search.
+     * @param blockRadius
+     * Maximum three-dimensional distance from the center, in
+     * blocks.
+     * @returns
+     * The block position of the claimed POI, or undefined if no
+     * matching POI has an available ticket.
+     */
+    take(
+        filter: ((arg0: PoiBlockType) => boolean) | PoiNameFilter | PoiTagFilter,
+        center: Vector3,
+        blockRadius: number,
+    ): Vector3 | undefined;
+}
+
+/**
+ * @beta
+ * Describes a block point-of-interest type.
+ *
+ * Required Experiments:
+ * - Poi
+ *
+ */
+export class PoiBlockType {
+    private constructor();
+    /**
+     * @remarks
+     * Numeric identifier of this POI type.
+     *
+     */
+    readonly id: number;
+    /**
+     * @remarks
+     * Namespaced identifier of this POI type.
+     *
+     */
+    readonly name: string;
+    /**
+     * @remarks
+     * Maximum number of tickets that can be claimed from each POI
+     * instance of this type.
+     *
+     */
+    readonly tickets: number;
+    /**
+     * @remarks
+     * Maximum range, in blocks, at which this POI type is
+     * considered usable.
+     *
+     */
+    readonly usableRange: number;
+    /**
+     * @remarks
+     * Tests whether this object and another object describe the
+     * same POI type.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param other
+     * POI type to compare with this type.
+     * @returns
+     * True if both objects describe the same POI type; otherwise
+     * false.
+     */
+    equals(other: PoiBlockType): boolean;
+    /**
+     * @remarks
+     * Tests whether the type has the provided tag attribute
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param tag
+     * POI tag to check.
+     * @returns
+     * True if the POI conatains the tag; otherwise false.
+     */
+    has(tag: string): boolean;
+}
+
+/**
+ * @beta
+ * Provides access to point-of-interest (POI) data in a
+ * dimension.
+ *
+ * Required Experiments:
+ * - Poi
+ *
+ */
+export class PoiManager {
+    private constructor();
+    /**
+     * @remarks
+     * Provides access to block-based points of interest in the
+     * dimension.
+     *
+     */
+    readonly blocks: PoiBlockManager;
+}
+
 /**
  * Represents how the potion effect is delivered.
  */
@@ -20689,7 +21061,7 @@ export class PrimitiveShapesManager {
      */
     addText(text: TextPrimitive, dimension?: Dimension): void;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Fetches and queries all primitive shapes stored in the
      * manager and returns the results as an array of shape
@@ -23251,6 +23623,45 @@ export class TickingAreaManager {
     removeTickingArea(identifier: string | TickingArea): void;
 }
 
+/**
+ * @beta
+ * A named point in time on a world clock that can occur once
+ * or periodically.
+ */
+export class TimeMarker {
+    private constructor();
+    /**
+     * @remarks
+     * The identifier that represents this time marker.
+     *
+     */
+    readonly name: string;
+    /**
+     * @remarks
+     * The interval (in ticks) at which the time marker repeats. If
+     * not specified, the time marker will only occur once.
+     *
+     * @throws
+     * WorldClockInvalidTimeMarkerError: If the time marker is
+     * invalid.
+     *
+     * {@link WorldClockInvalidTimeMarkerError}
+     */
+    readonly period?: number;
+    /**
+     * @remarks
+     * The time (in ticks) that the time marker occurs at on a
+     * world clock.
+     *
+     * @throws
+     * WorldClockInvalidTimeMarkerError: If the time marker is
+     * invalid.
+     *
+     * {@link WorldClockInvalidTimeMarkerError}
+     */
+    readonly time: number;
+}
+
 /**
  * Represents a trigger for firing an event.
  */
@@ -23993,7 +24404,7 @@ export class World {
      * @privilege early-execution-allowed - This function can be called in early-execution mode.
      *
      */
-    getPackSettings(): Record<string, boolean | number | string>;
+    getPackSettings(): Record<string, string[] | boolean | number | string>;
     /**
      * @remarks
      * Returns a set of players based on a set of conditions
@@ -24787,6 +25198,47 @@ export class WorldAfterEvents {
      *
      */
     readonly weatherChange: WeatherChangeAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires when a {@link WorldClock} is paused.
+     *
+     * @privilege early-execution-readable - This property can be read in early-execution mode.
+     *
+     */
+    readonly worldClockOnPaused: WorldClockOnPausedAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires when a {@link WorldClock} is resumed.
+     *
+     * @privilege early-execution-readable - This property can be read in early-execution mode.
+     *
+     */
+    readonly worldClockOnResumed: WorldClockOnResumedAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires when the time of a {@link WorldClock} hits
+     * a {@link TimeMarker} on the clock. This can happen during a
+     * regular level tick or when the time is set.
+     *
+     * @privilege early-execution-readable - This property can be read in early-execution mode.
+     *
+     */
+    readonly worldClockOnTimeMarker: WorldClockOnTimeMarkerAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This event fires when a {@link WorldClock} time is changed.
+     * This can happen when the time is directly set through
+     * scripts or commands or when the clock reaches the maximum
+     * time and restarts.
+     *
+     * @privilege early-execution-readable - This property can be read in early-execution mode.
+     *
+     */
+    readonly worldClockOnTimeModified: WorldClockOnTimeModifiedAfterEventSignal;
     /**
      * @remarks
      * @privilege early-execution-readable - This property can be read in early-execution mode.
@@ -24958,11 +25410,21 @@ export class WorldBeforeEvents {
      *
      */
     readonly weatherChange: WeatherChangeBeforeEventSignal;
-}
-
-/**
- * @beta
- * A class that represents a particular clock within a world.
+    /**
+     * @beta
+     * @remarks
+     * This event fires when a {@link WorldClock} reaches its
+     * maximum time and is about to restart.
+     *
+     * @privilege early-execution-readable - This property can be read in early-execution mode.
+     *
+     */
+    readonly worldClockOnRestart: WorldClockOnRestartBeforeEventSignal;
+}
+
+/**
+ * @beta
+ * A class that represents a particular clock within a world.
  */
 export class WorldClock {
     private constructor();
@@ -24991,6 +25453,373 @@ export class WorldClock {
      * Minimum Value: 0
      */
     time: number;
+    /**
+     * @remarks
+     * Retrieves the current time markers of the world clock.
+     *
+     */
+    readonly timeMarkers: TimeMarker[];
+    /**
+     * @remarks
+     * Adds a new time marker to the world clock.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param timeMarkerOptions
+     * Options for creating a time marker.
+     * @throws This function can throw errors.
+     *
+     * {@link WorldClockAddTimeMarkerError}
+     */
+    addTimeMarker(timeMarkerOptions: TimeMarkerOptions): void;
+    /**
+     * @remarks
+     * Removes an existing time marker from the world clock.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param timeMarker
+     * The time marker or time marker name to remove.
+     * @throws
+     * WorldClockTimeMarkerNotFoundError: If the time marker does
+     * not exist on the world clock.
+     * WorldClockRemoveMinecraftTimeMarkerError: If the time marker
+     * uses the 'minecraft' namespace.
+     *
+     * {@link WorldClockRemoveMinecraftTimeMarkerError}
+     *
+     * {@link WorldClockTimeMarkerNotFoundError}
+     */
+    removeTimeMarker(timeMarker: string | TimeMarker): void;
+    /**
+     * @remarks
+     * Rewinds the world clock's time to the previous occurrence of
+     * the specified time marker.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param timeMarker
+     * The time marker or time marker name to rewind the world
+     * clock's time to.
+     * @throws
+     * WorldClockTimeMarkerNotFoundError: If the time marker does
+     * not exist on the world clock.
+     * WorldClockRewindError: If the world clock's current time is
+     * before the time marker's first occurrence.
+     *
+     * {@link WorldClockRewindError}
+     *
+     * {@link WorldClockTimeMarkerNotFoundError}
+     */
+    rewindTo(timeMarker: string | TimeMarker): void;
+    /**
+     * @remarks
+     * Sets the world clock's time to the specified time marker.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param timeMarker
+     * The time marker or time marker name to set the world clock's
+     * time to.
+     * @throws
+     * WorldClockTimeMarkerNotFoundError: If the time marker does
+     * not exist on the world clock.
+     *
+     * {@link WorldClockTimeMarkerNotFoundError}
+     */
+    set(timeMarker: string | TimeMarker): void;
+    /**
+     * @remarks
+     * Skips the world clock's time to the next occurrence of the
+     * specified time marker.
+     * If the next occurrence overflows the world clock's time, the
+     * time is reset to the first occurrence.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @param timeMarker
+     * The time marker or time marker name to skip the world
+     * clock's time to.
+     * @throws
+     * WorldClockTimeMarkerNotFoundError: If the time marker does
+     * not exist on the world clock.
+     *
+     * {@link WorldClockTimeMarkerNotFoundError}
+     */
+    skipTo(timeMarker: string | TimeMarker): void;
+}
+
+/**
+ * @beta
+ * Contains information related to a {@link WorldClock} being
+ * paused.
+ */
+export class WorldClockOnPausedAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The world clock that was paused.
+     *
+     */
+    readonly clock: WorldClock;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to a {@link WorldClock}
+ * being paused.
+ */
+export class WorldClockOnPausedAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when a world clock is
+     * paused.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     */
+    subscribe(
+        callback: (arg0: WorldClockOnPausedAfterEvent) => void,
+        options?: WorldClockEventOptions,
+    ): (arg0: WorldClockOnPausedAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when a world clock is
+     * paused.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     */
+    unsubscribe(callback: (arg0: WorldClockOnPausedAfterEvent) => void): void;
+}
+
+/**
+ * @beta
+ * Contains information related to a {@link WorldClock}
+ * restarting.
+ */
+export class WorldClockOnRestartBeforeEvent {
+    private constructor();
+    /**
+     * @remarks
+     * If set to true, cancels the world clock restart event. This
+     * will keep the world clock at the maximum time value and
+     * prevent it from ticking forward.
+     *
+     */
+    cancel: boolean;
+    /**
+     * @remarks
+     * The world clock that is restarting.
+     *
+     */
+    readonly clock: WorldClock;
+    /**
+     * @remarks
+     * The time that the world clock will be set to after it
+     * restarts. If not set, the world clock will be set to 0.
+     *
+     * Minimum Value: 0
+     */
+    newTime: number;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to a {@link WorldClock}
+ * restarting.
+ */
+export class WorldClockOnRestartBeforeEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when a world clock is
+     * restarting.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     * @param callback
+     * This closure is called with restricted-execution privilege.
+     * @returns
+     * Closure that is called with restricted-execution privilege.
+     */
+    subscribe(
+        callback: (arg0: WorldClockOnRestartBeforeEvent) => void,
+        options?: WorldClockEventOptions,
+    ): (arg0: WorldClockOnRestartBeforeEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when a world clock is
+     * restarting.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     * @param callback
+     * This closure is called with restricted-execution privilege.
+     */
+    unsubscribe(callback: (arg0: WorldClockOnRestartBeforeEvent) => void): void;
+}
+
+/**
+ * @beta
+ * Contains information related to a {@link WorldClock} being
+ * resumed.
+ */
+export class WorldClockOnResumedAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The world clock that was resumed.
+     *
+     */
+    readonly clock: WorldClock;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to a {@link WorldClock}
+ * being resumed.
+ */
+export class WorldClockOnResumedAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when a world clock is
+     * resumed.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     */
+    subscribe(
+        callback: (arg0: WorldClockOnResumedAfterEvent) => void,
+        options?: WorldClockEventOptions,
+    ): (arg0: WorldClockOnResumedAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when a world clock is
+     * resumed.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     */
+    unsubscribe(callback: (arg0: WorldClockOnResumedAfterEvent) => void): void;
+}
+
+/**
+ * @beta
+ * Contains information related to when the time of a
+ * {@link WorldClock} hits a {@link TimeMarker}.
+ */
+export class WorldClockOnTimeMarkerAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The world clock that hit a time marker.
+     *
+     */
+    readonly clock: WorldClock;
+    /**
+     * @remarks
+     * The time marker that was hit by the world clock.
+     *
+     */
+    readonly timeMarker: TimeMarker;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to when the time of a
+ * {@link WorldClock} hits a {@link TimeMarker}.
+ */
+export class WorldClockOnTimeMarkerAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when a world clock's
+     * time hits a time marker.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     */
+    subscribe(
+        callback: (arg0: WorldClockOnTimeMarkerAfterEvent) => void,
+        options?: WorldClockTimeMarkerEventOptions,
+    ): (arg0: WorldClockOnTimeMarkerAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when a world clock's
+     * time hits a time marker.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     */
+    unsubscribe(callback: (arg0: WorldClockOnTimeMarkerAfterEvent) => void): void;
+}
+
+/**
+ * @beta
+ * Contains information related to changes to the time of a
+ * {@link WorldClock}.
+ */
+export class WorldClockOnTimeModifiedAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The world clock that had its time modified.
+     *
+     */
+    readonly clock: WorldClock;
+}
+
+/**
+ * @beta
+ * Manages callbacks that are connected to changes to the time
+ * of a {@link WorldClock}.
+ */
+export class WorldClockOnTimeModifiedAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called when a world clock's
+     * time is modified.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     */
+    subscribe(
+        callback: (arg0: WorldClockOnTimeModifiedAfterEvent) => void,
+        options?: WorldClockEventOptions,
+    ): (arg0: WorldClockOnTimeModifiedAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback from being called when a world clock's
+     * time is modified.
+     *
+     * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
+     *
+     * @privilege early-execution-allowed - This function can be called in early-execution mode.
+     *
+     */
+    unsubscribe(callback: (arg0: WorldClockOnTimeModifiedAfterEvent) => void): void;
 }
 
 /**
@@ -25012,6 +25841,9 @@ export class WorldClockRegistry {
      * The name that represents this world clock. Must have a
      * namespace and use only valid identifier characters. (e.g.,
      * 'mypack:my_clock').
+     * @param registrationOptions
+     * Additional options for registering a world clock, such as
+     * including time markers at registration time.
      * @throws This function can throw errors.
      *
      * {@link WorldClockInvalidRegistryError}
@@ -25019,8 +25851,10 @@ export class WorldClockRegistry {
      * {@link WorldClockRegistrationError}
      *
      * {@link WorldClockReloadNewWorldClockError}
+     *
+     * {@link WorldClockReloadTimeMarkerError}
      */
-    registerClock(name: string): void;
+    registerClock(name: string, registrationOptions?: WorldClockRegistrationOptions): void;
 }
 
 export class WorldLoadAfterEvent {
@@ -27284,6 +28118,56 @@ export interface PlayerVisibilityRules extends EntityVisibilityRules {
 
 /**
  * @beta
+ * Associates a block point-of-interest instance with its
+ * squared distance from a query center.
+ */
+export interface PoiDistancePair {
+    /**
+     * @remarks
+     * Squared three-dimensional distance, in blocks squared, from
+     * the query center to the POI position.
+     *
+     */
+    distance: number;
+    /**
+     * @remarks
+     * POI instance at this distance.
+     *
+     */
+    poi: PoiBlockInstance;
+}
+
+/**
+ * @beta
+ * Selects block point-of-interest types by their exact
+ * namespaced identifier.
+ */
+export interface PoiNameFilter {
+    /**
+     * @remarks
+     * Exact namespaced POI type identifier to match.
+     *
+     */
+    name: string;
+}
+
+/**
+ * @beta
+ * Selects block point-of-interest types that have all
+ * specified tags.
+ */
+export interface PoiTagFilter {
+    /**
+     * @remarks
+     * Namespaced POI tags that a matching type must contain. All
+     * tags in the array are required.
+     *
+     */
+    tags: string[];
+}
+
+/**
+ * @rc
  * Contains optional filters that control which primitive
  * shapes are returned from a primitive shapes query.
  */
@@ -28061,6 +28945,37 @@ export interface TickingAreaOptions {
     to: Vector3;
 }
 
+/**
+ * @beta
+ * Options for creating time markers for world clocks.
+ */
+export interface TimeMarkerOptions {
+    /**
+     * @remarks
+     * The name that the time marker will have. Must have a
+     * namespace and use only valid identifier characters. (e.g.,
+     * 'mypack:my_time_marker').
+     *
+     */
+    name: string;
+    /**
+     * @remarks
+     * The optional repeat period (in ticks) that the time marker
+     * will have. If not specified, the time marker will only occur
+     * once.
+     *
+     * Minimum Value: 0
+     */
+    period?: number;
+    /**
+     * @remarks
+     * The time (in ticks) that the time marker will occur at.
+     *
+     * Minimum Value: 0
+     */
+    time: number;
+}
+
 /**
  * Contains additional options for displaying a title and
  * optional subtitle.
@@ -28198,10 +29113,65 @@ export interface WaypointTextureSelector {
     textureBoundsList: WaypointTextureBounds[];
 }
 
+/**
+ * @beta
+ * Contains parameters for world clock events that filters out
+ * which events are passed to the provided callback.
+ */
+export interface WorldClockEventOptions {
+    /**
+     * @remarks
+     * The name of the clock that this event should fire for.
+     *
+     */
+    clock: string;
+}
+
+/**
+ * @beta
+ * Contains additional options for registering world clocks.
+ */
+export interface WorldClockRegistrationOptions {
+    /**
+     * @remarks
+     * Set of options to include time markers during world clock
+     * registration.
+     *
+     */
+    timeMarkers?: TimeMarkerOptions[];
+}
+
+/**
+ * @beta
+ * Contains parameters for world clock time marker events that
+ * filters out which events are passed to the provided
+ * callback.
+ */
+export interface WorldClockTimeMarkerEventOptions {
+    /**
+     * @remarks
+     * The name of the world clock that this event should fire for.
+     *
+     */
+    clock: string;
+    /**
+     * @remarks
+     * The name of the time marker that this event should fire for.
+     * If undefined, the event will fire for all time markers on
+     * the world clock.
+     *
+     */
+    timeMarker?: string;
+}
+
 /**
  * Contains additional options for a playSound occurrence.
  */
 export interface WorldSoundOptions {
+    /**
+     * @beta
+     */
+    isBroadcast?: boolean;
     /**
      * @beta
      * @remarks
@@ -28663,6 +29633,16 @@ export class UnloadedChunksError extends Error {
     private constructor();
 }
 
+/**
+ * @beta
+ * Error thrown by {@link WorldClock.addTimeMarker} when
+ * failing to add a time marker to a world clock.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class WorldClockAddTimeMarkerError extends Error {
+    private constructor();
+}
+
 /**
  * @beta
  * Thrown when trying to register a world clock outside of the
@@ -28673,6 +29653,17 @@ export class WorldClockInvalidRegistryError extends Error {
     private constructor();
 }
 
+/**
+ * @beta
+ * Error thrown when a time marker is invalid. This can occur
+ * when trying to access data on a time marker that has been
+ * removed.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class WorldClockInvalidTimeMarkerError extends Error {
+    private constructor();
+}
+
 /**
  * @beta
  * Error thrown when a world clock is not found in the world
@@ -28704,6 +29695,49 @@ export class WorldClockReloadNewWorldClockError extends Error {
     private constructor();
 }
 
+/**
+ * @beta
+ * Error thrown after using the /reload command when trying to
+ * re-register an existing world clock with an invalid time
+ * marker.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class WorldClockReloadTimeMarkerError extends Error {
+    private constructor();
+}
+
+/**
+ * @beta
+ * Error thrown by {@link WorldClock.removeTimeMarker} when
+ * trying to remove a time marker with the 'minecraft'
+ * namespace from a world clock.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class WorldClockRemoveMinecraftTimeMarkerError extends Error {
+    private constructor();
+}
+
+/**
+ * @beta
+ * Error thrown by {@link WorldClock.rewindTo} when the world
+ * clock's time is already before the time marker's first
+ * occurrence.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class WorldClockRewindError extends Error {
+    private constructor();
+}
+
+/**
+ * @beta
+ * Error thrown when performing actions on a world clock with a
+ * time marker that does not exist.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class WorldClockTimeMarkerNotFoundError extends Error {
+    private constructor();
+}
+
 export const HudElementsCount = 13;
 export const HudVisibilityCount = 2;
 /**

package/package.json

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