@minecraft/server 2.11.0-beta.1.26.50-preview.25 → 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 {
@@ -8167,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.
@@ -9118,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.
      *
@@ -9126,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.
      *
@@ -12151,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';
 }
 
@@ -21035,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
@@ -23597,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.
  */
@@ -25133,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.
@@ -25304,6 +25410,16 @@ export class WorldBeforeEvents {
      *
      */
     readonly weatherChange: WeatherChangeBeforeEventSignal;
+    /**
+     * @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;
 }
 
 /**
@@ -25337,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;
 }
 
 /**
@@ -25358,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}
@@ -25365,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 {
@@ -27679,7 +28167,7 @@ export interface PoiTagFilter {
 }
 
 /**
- * @beta
+ * @rc
  * Contains optional filters that control which primitive
  * shapes are returned from a primitive shapes query.
  */
@@ -28457,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.
@@ -28594,6 +29113,57 @@ 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.
  */
@@ -29063,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
@@ -29073,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
@@ -29104,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.25",
+  "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.25"
+    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.50-preview.26"
   },
   "license": "MIT"
 }