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

package/index.d.ts

@@ -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
@@ -17717,7 +17754,7 @@ export class PackSettingChangeAfterEvent {
      * The value of the setting.
      *
      */
-    readonly settingValue: boolean | number | string;
+    readonly settingValue: string[] | boolean | number | string;
 }
 
 /**
@@ -20360,6 +20397,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.
  */
@@ -23993,7 +24339,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
@@ -27282,6 +27628,56 @@ export interface PlayerVisibilityRules extends EntityVisibilityRules {
     showSpectatorToSpectator?: boolean;
 }
 
+/**
+ * @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[];
+}
+
 /**
  * @beta
  * Contains optional filters that control which primitive
@@ -28202,6 +28598,10 @@ export interface WaypointTextureSelector {
  * Contains additional options for a playSound occurrence.
  */
 export interface WorldSoundOptions {
+    /**
+     * @beta
+     */
+    isBroadcast?: boolean;
     /**
      * @beta
      * @remarks

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.25",
   "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.25"
   },
   "license": "MIT"
 }