@minecraft/server 2.8.0-rc.1.26.30-preview.27 → 2.8.0-rc.1.26.30-preview.30

package/index.d.ts

@@ -1438,6 +1438,13 @@ export enum EntityHealCause {
      *
      */
     SelfHeal = 'SelfHeal',
+    /**
+     * @rc
+     * @remarks
+     * Healing caused when Totem of Undying is activated.
+     *
+     */
+    TotemOfUndying = 'TotemOfUndying',
 }
 
 /**
@@ -2258,6 +2265,34 @@ export enum LiquidType {
     Water = 'Water',
 }
 
+/**
+ * @rc
+ * Enum representing the different reasons why a locator bar
+ * operation may fail.
+ */
+export enum LocatorBarErrorReason {
+    /**
+     * @remarks
+     * The waypoint already exists in the locator bar and cannot be
+     * added again.
+     *
+     */
+    WaypointAlreadyExists = 'WaypointAlreadyExists',
+    /**
+     * @remarks
+     * The maximum number of waypoints has been reached and no more
+     * can be added.
+     *
+     */
+    WaypointLimitExceeded = 'WaypointLimitExceeded',
+    /**
+     * @remarks
+     * The specified waypoint does not exist in the locator bar.
+     *
+     */
+    WaypointNotFound = 'WaypointNotFound',
+}
+
 /**
  * Describes the memory of a device.
  */
@@ -2902,6 +2937,38 @@ export enum TintMethod {
     Water = 'Water',
 }
 
+/**
+ * @rc
+ * Enum representing different texture icons that can be
+ * displayed for waypoints on the locator bar.
+ */
+export enum WaypointTexture {
+    /**
+     * @remarks
+     * Circle waypoint icon texture.
+     *
+     */
+    Circle = 'minecraft:circle',
+    /**
+     * @remarks
+     * Small square waypoint icon texture.
+     *
+     */
+    SmallSquare = 'minecraft:small_square',
+    /**
+     * @remarks
+     * Small star waypoint icon texture.
+     *
+     */
+    SmallStar = 'minecraft:small_star',
+    /**
+     * @remarks
+     * Square waypoint icon texture.
+     *
+     */
+    Square = 'minecraft:square',
+}
+
 /**
  * Used to specify the type of weather condition within the
  * world.
@@ -4343,6 +4410,22 @@ export class BlockComponentBlockBreakEvent extends BlockEvent {
     readonly entitySource?: Entity;
 }
 
+/**
+ * @rc
+ * Contains information regarding a specific block permutation
+ * that was changed from a previous permutation.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class BlockComponentBlockStateChangeEvent extends BlockEvent {
+    private constructor();
+    /**
+     * @remarks
+     * The previous BlockPermutation.
+     *
+     */
+    readonly previousPermutation: BlockPermutation;
+}
+
 /**
  * Contains information regarding an event sent by an entity to
  * this block in the world.
@@ -7946,6 +8029,43 @@ export class Dimension {
     spawnParticle(effectName: string, location: Vector3, molangVariables?: MolangVariableMap): void;
 }
 
+/**
+ * @rc
+ * Provides the functionality for registering custom
+ * dimensions. Custom dimensions can only be registered during
+ * the system startup event.
+ */
+export class DimensionRegistry {
+    private constructor();
+    /**
+     * @remarks
+     * Registers a new custom dimension type. Must be called during
+     * the system startup event. The dimension will be created
+     * using the void generator.
+     *
+     * This function can be called in early-execution mode.
+     *
+     * @param typeId
+     * The namespaced identifier for the custom dimension (e.g.,
+     * 'mypack:my_dimension'). Must include a namespace and use
+     * only valid identifier characters.
+     * @throws This function can throw errors.
+     *
+     * {@link CustomDimensionAlreadyRegisteredError}
+     *
+     * {@link CustomDimensionInvalidRegistryError}
+     *
+     * {@link CustomDimensionNameError}
+     *
+     * {@link CustomDimensionReloadNewDimensionError}
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link NamespaceNameError}
+     */
+    registerCustomDimension(typeId: string): void;
+}
+
 /**
  * Represents a type of dimension. Currently only works with
  * Vanilla dimensions.
@@ -12586,6 +12706,68 @@ export class EntityUnderwaterMovementComponent extends EntityAttributeComponent
     static readonly componentId = 'minecraft:underwater_movement';
 }
 
+/**
+ * @rc
+ * Contains information related to firing of a data driven
+ * entity version upgrade.
+ */
+export class EntityUpgradeAfterEvent {
+    private constructor();
+    /**
+     * @remarks
+     * Entity that the upgrade triggered on.
+     *
+     */
+    readonly entity: Entity;
+    /**
+     * @remarks
+     * Name of the data driven upgrade being triggered.
+     *
+     */
+    readonly upgradeId: string;
+    /**
+     * @remarks
+     * An updateable list of modifications to component state that
+     * are the effect of this triggered upgrade.
+     *
+     */
+    getModifiers(): DefinitionModifier[];
+}
+
+/**
+ * @rc
+ * Contains event registration related to firing of a data
+ * driven entity version upgrade.
+ */
+export class EntityUpgradeAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a callback that will be called after a data driven
+     * entity version upgrade is triggered.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    subscribe(
+        callback: (arg0: EntityUpgradeAfterEvent) => void,
+        options?: EntityDataDrivenTriggerEventOptions,
+    ): (arg0: EntityUpgradeAfterEvent) => void;
+    /**
+     * @remarks
+     * Removes a callback that will be called after a data driven
+     * entity version upgrade is triggered.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    unsubscribe(callback: (arg0: EntityUpgradeAfterEvent) => void): void;
+}
+
 /**
  * Used to differentiate the component group of a variant of an
  * entity from others. (e.g. ocelot, villager).
@@ -12614,6 +12796,51 @@ export class EntityWantsJockeyComponent extends EntityComponent {
     static readonly componentId = 'minecraft:wants_jockey';
 }
 
+/**
+ * @rc
+ * Waypoint that tracks an entity's position. The waypoint
+ * automatically updates as the entity moves and becomes
+ * invalid when the entity is removed.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class EntityWaypoint extends Waypoint {
+    /**
+     * @remarks
+     * The entity being tracked by this waypoint.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidWaypointError}
+     *
+     * {@link InvalidWaypointTextureSelectorError}
+     */
+    readonly entity: Entity;
+    /**
+     * @remarks
+     * The visibility rules that control when the waypoint is shown
+     * based on the entity's state (e.g., sneaking, invisible,
+     * dead).
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidWaypointError}
+     *
+     * {@link InvalidWaypointTextureSelectorError}
+     */
+    readonly entityRules: EntityVisibilityRules;
+    /**
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidWaypointTextureSelectorError}
+     */
+    constructor(
+        entity: Entity,
+        textureSelector: WaypointTextureSelector,
+        entityRules: EntityVisibilityRules,
+        color?: RGB,
+    );
+}
+
 /**
  * Loot item function that modifies a dropped treasure map to
  * mark a location.
@@ -13200,6 +13427,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.
@@ -15364,6 +15595,175 @@ export class ListBlockVolume extends BlockVolumeBase {
     remove(locations: Vector3[]): void;
 }
 
+/**
+ * @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.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class LocationWaypoint extends Waypoint {
+    /**
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidWaypointTextureSelectorError}
+     */
+    constructor(dimensionLocation: DimensionLocation, textureSelector: WaypointTextureSelector, color?: RGB);
+    /**
+     * @remarks
+     * Updates the dimension and location that this waypoint points
+     * to.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @param dimensionLocation
+     * The new {@link DimensionLocation} (dimension and
+     * coordinates) for the waypoint.
+     */
+    setDimensionLocation(dimensionLocation: DimensionLocation): void;
+}
+
+/**
+ * @rc
+ * Manages the collection of waypoints displayed on a player's
+ * locator bar. Allows adding, removing, and querying waypoints
+ * with a maximum capacity limit.
+ *
+ * Invalid waypoints in the locator bar will be automatically
+ * removed in the next tick. This includes waypoints tied to
+ * entities that have been removed from the world.
+ *
+ * Note: You can control whether vanilla player waypoints are
+ * automatically added to the locator bar using the
+ * `playerWaypoints` {@link GameRule}. Accepted values are
+ * `off` (players are not shown on the locator bar) and
+ * `everyone` (all players are visible on the locator bar).
+ *
+ * Note: You can only modify, remove, or query waypoints that
+ * were added by this pack.
+ * @example sharedWaypoint.ts
+ * ```typescript
+ * /\*
+ * import { world, LocationWaypoint, WaypointTextureSelector, WaypointTexture } from "@minecraft/server"
+ *
+ * function sharedWaypoint() {
+ *   const players = world.getAllPlayers();
+ *
+ *   if (players.length < 2) {
+ *     console.warn("Need at least 2 players for this example.");
+ *     return;
+ *   }
+ *
+ *   const playerA = players[0];
+ *   const playerB = players[1];
+ *
+ *   // Create a single waypoint at a specific location
+ *   const textureSelector: WaypointTextureSelector = {
+ *     textureBoundsList: [
+ *       { lowerBound: 0, texture: WaypointTexture.Circle }
+ *     ]
+ *   };
+ *
+ *   const waypoint = new LocationWaypoint(
+ *     { dimension: playerA.dimension, x: 100, y: 64, z: 100 },
+ *     textureSelector,
+ *     { red: 1, green: 0, blue: 0 } // Initially red
+ *   );
+ *
+ *   // Add the same waypoint to both players' locator bars
+ *   playerA.locatorBar.addWaypoint(waypoint);
+ *   playerB.locatorBar.addWaypoint(waypoint);
+ *
+ *   // Change the color - this affects both players
+ *   waypoint.color = { red: 0, green: 1, blue: 0 }; // Now green for both players
+ * }
+ * *\/
+ * ```
+ */
+export class LocatorBar {
+    private constructor();
+    /**
+     * @remarks
+     * The current number of waypoints in the locator bar.
+     *
+     */
+    readonly count: number;
+    /**
+     * @remarks
+     * The maximum number of waypoints that can be added to the
+     * locator bar.
+     *
+     */
+    readonly maxCount: number;
+    /**
+     * @remarks
+     * Adds a waypoint to the locator bar. Throws an error if the
+     * waypoint already exists, the maximum waypoint limit has been
+     * reached, or the waypoint is invalid.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @param waypoint
+     * The {@link Waypoint} to add to the locator bar.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link InvalidWaypointError}
+     *
+     * {@link LocatorBarError}
+     */
+    addWaypoint(waypoint: Waypoint): void;
+    /**
+     * @remarks
+     * Returns an array of all waypoints currently in the locator
+     * bar.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     */
+    getAllWaypoints(): Waypoint[];
+    /**
+     * @remarks
+     * Checks whether the specified waypoint exists in the locator
+     * bar.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @param waypoint
+     * The {@link Waypoint} to check for.
+     */
+    hasWaypoint(waypoint: Waypoint): boolean;
+    /**
+     * @remarks
+     * Removes all waypoints from the locator bar, clearing it
+     * completely.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     */
+    removeAllWaypoints(): void;
+    /**
+     * @remarks
+     * Removes a specific waypoint from the locator bar. Returns an
+     * error if the waypoint does not exist in the locator bar.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @param waypoint
+     * The {@link Waypoint} to remove from the locator bar.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link LocatorBarError}
+     */
+    removeWaypoint(waypoint: Waypoint): void;
+}
+
 /**
  * Loot item function that drops extra items if the provided
  * tool has the looting enchant.
@@ -16051,6 +16451,14 @@ export class Player extends Entity {
      * @throws This property can throw when used.
      */
     readonly level: number;
+    /**
+     * @rc
+     * @remarks
+     * The player's Locator Bar. This property is used for managing
+     * waypoints displayed on the HUD.
+     *
+     */
+    readonly locatorBar: LocatorBar;
     /**
      * @remarks
      * Name of the player.
@@ -17927,14 +18335,48 @@ export class PlayerSwingStartAfterEventSignal {
 }
 
 /**
- * Represents how the potion effect is delivered.
+ * @rc
+ * Waypoint that tracks a player's position. Extends {@link
+ * EntityWaypoint} with additional player-specific visibility
+ * rules such as hidden state and spectator mode.
  */
-export class PotionDeliveryType {
-    private constructor();
-    readonly id: string;
-}
-
-/**
+// @ts-ignore Class inheritance allowed for native defined classes
+export class PlayerWaypoint extends EntityWaypoint {
+    /**
+     * @remarks
+     * The {@link PlayerVisibilityRules} that control when the
+     * waypoint is shown based on the player's state (e.g., hidden,
+     * spectator mode, spectator viewing another spectator).
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link InvalidWaypointError}
+     *
+     * {@link InvalidWaypointTextureSelectorError}
+     */
+    readonly playerRules: PlayerVisibilityRules;
+    /**
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidWaypointTextureSelectorError}
+     */
+    constructor(
+        player: Player,
+        textureSelector: WaypointTextureSelector,
+        playerRules: PlayerVisibilityRules,
+        color?: RGB,
+    );
+}
+
+/**
+ * Represents how the potion effect is delivered.
+ */
+export class PotionDeliveryType {
+    private constructor();
+    readonly id: string;
+}
+
+/**
  * Represents a type of potion effect - like healing or
  * leaping.
  */
@@ -18126,6 +18568,151 @@ export class PressurePlatePushAfterEventSignal {
     unsubscribe(callback: (arg0: PressurePlatePushAfterEvent) => void): void;
 }
 
+/**
+ * @rc
+ * The base class for a text primitive. Represents an object in
+ * the world and its base properties.
+ */
+export class PrimitiveShape {
+    private constructor();
+    /**
+     * @remarks
+     * The entity this shape is attached to. When set, this shape
+     * will copy the root location of the attached entity and the
+     * shape's position will be used as an offset.
+     *
+     */
+    attachedTo?: Entity;
+    /**
+     * @remarks
+     * The color of the shape.
+     *
+     */
+    color: RGBA;
+    /**
+     * @remarks
+     * The dimension the shape is visible within. If the dimension
+     * is undefined, it will display in all dimensions.
+     *
+     */
+    readonly dimension: Dimension;
+    /**
+     * @remarks
+     * Returns true if the shape has a limited time span before
+     * being removed.
+     *
+     */
+    readonly hasDuration: boolean;
+    /**
+     * @remarks
+     * The location of the shape.
+     *
+     */
+    readonly location: Vector3;
+    /**
+     * @remarks
+     * If defined, this distance will be used to determine how far
+     * away this primitive will be rendered for each client. By
+     * default the distance will match the client's render distance
+     * setting.
+     *
+     * Minimum Value: 0
+     */
+    maximumRenderDistance?: number;
+    /**
+     * @remarks
+     * The rotation of the shape (Euler angles - [Pitch, Yaw,
+     * Roll]).
+     *
+     */
+    rotation: Vector3;
+    /**
+     * @remarks
+     * The scale of the shape.
+     *
+     * Bounds: [-1000, 1000]
+     */
+    scale: number;
+    /**
+     * @remarks
+     * The time left (in seconds) until this shape is automatically
+     * removed. Returns undefined if the shape does not have a
+     * limited life-span.
+     *
+     */
+    timeLeft?: number;
+    /**
+     * @remarks
+     * The total initial time-span (in seconds) until this shape is
+     * automatically removed. Returns undefined if the shape does
+     * not have a limited life-span.
+     *
+     */
+    readonly totalTimeLeft?: number;
+    /**
+     * @remarks
+     * The list of players that this shape will be visible to. If
+     * left empty, the shape will be visible to all players.
+     *
+     */
+    visibleTo: Player[];
+    /**
+     * @remarks
+     * Removes this shape from the world. The shape can be re-added
+     * via the PrimitiveShapesManager's addText method.
+     *
+     */
+    remove(): void;
+    /**
+     * @remarks
+     * Set the location and dimension of the shape. If the
+     * dimension is undefined, it will display in all dimensions.
+     *
+     */
+    setLocation(location: DimensionLocation | Vector3): void;
+}
+
+/**
+ * @rc
+ * Primitive Shapes class used to allow adding and removing
+ * text primitives to the world.
+ */
+export class PrimitiveShapesManager {
+    private constructor();
+    /**
+     * @remarks
+     * This is the maximum number of allowed primitive shapes.
+     *
+     */
+    readonly maxShapes: number;
+    /**
+     * @remarks
+     * Adds a new text primitive to the world.
+     *
+     * @param text
+     * The text primitive to be added.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link PrimitiveShapeError}
+     */
+    addText(text: TextPrimitive, dimension?: Dimension): void;
+    /**
+     * @remarks
+     * Removes all text primitives from the world.
+     *
+     */
+    removeAll(): void;
+    /**
+     * @remarks
+     * Removes an instance of a text primitive from the world. This
+     * is equivalent to calling remove on the text itself.
+     *
+     */
+    removeText(text: TextPrimitive): void;
+}
+
 /**
  * Contains information related to a projectile hitting a
  * block.
@@ -19397,6 +19984,13 @@ export class StartupEvent {
      *
      */
     readonly customCommandRegistry: CustomCommandRegistry;
+    /**
+     * @rc
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
+    readonly dimensionRegistry: DimensionRegistry;
     /**
      * @remarks
      * This property can be read in early-execution mode.
@@ -19410,7 +20004,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
@@ -20132,6 +20727,73 @@ export class TargetBlockHitAfterEventSignal {
     unsubscribe(callback: (arg0: TargetBlockHitAfterEvent) => void): void;
 }
 
+/**
+ * @rc
+ * A primitive shape class that represents a text label in the
+ * world with a background.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class TextPrimitive extends PrimitiveShape {
+    /**
+     * @remarks
+     * If set to true, the text primitive will render the back-face
+     * of the background. Defaults to true but will always be false
+     * if 'useRotation' is set to false.
+     *
+     */
+    backfaceVisible: boolean;
+    /**
+     * @remarks
+     * The color of the background plate of the text. If set to
+     * undefined, it will use the default color.
+     *
+     */
+    backgroundColorOverride?: RGBA;
+    /**
+     * @remarks
+     * If set to true, the text will be hidden behind blocks or
+     * entities. By default this is set to false (will always
+     * render).
+     *
+     */
+    depthTest: boolean;
+    /**
+     * @remarks
+     * Get the text of the debug text shape. Returns the RawText of
+     * the debug text if `setText` was called with a RawMessage or
+     * a RawText object, otherwise returns a string.
+     *
+     */
+    readonly text: RawMessage | string;
+    /**
+     * @remarks
+     * If set to true, the text primitive will render the back-face
+     * of the text. Defaults to true but will always be false if
+     * 'useRotation' is set to false.
+     *
+     */
+    textBackfaceVisible: boolean;
+    /**
+     * @remarks
+     * If set to true, the text will not face the camera and
+     * instead will use the rotation from the shape.
+     *
+     */
+    useRotation: boolean;
+    constructor(location: DimensionLocation | Vector3, text: RawMessage | string);
+    /**
+     * @remarks
+     * Sets the text to display.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.ArgumentOutOfBoundsError}
+     *
+     * {@link RawMessageError}
+     */
+    setText(text: RawMessage | string): void;
+}
+
 /**
  * This manager is used to add, remove or query temporary
  * ticking areas to a dimension. These ticking areas are
@@ -20373,6 +21035,86 @@ export class TripWireTripAfterEventSignal {
     unsubscribe(callback: (arg0: TripWireTripAfterEvent) => void): void;
 }
 
+/**
+ * @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.
+ *
+ * Waypoints act as shared handles that can be added to
+ * multiple players' locator bars. When you modify a waypoint's
+ * properties (such as color, texture, or enabled state), the
+ * changes are reflected for all players who have that waypoint
+ * in their locator bar. This allows you to efficiently manage
+ * waypoints across multiple players without creating separate
+ * instances for each player.
+ */
+export class Waypoint {
+    private constructor();
+    /**
+     * @remarks
+     * Optional {@link RGB} color tint applied to the waypoint
+     * icon. If not specified, the waypoint uses its default color.
+     *
+     * This property can't be edited in restricted-execution mode.
+     *
+     */
+    color?: RGB;
+    /**
+     * @remarks
+     * Controls whether the waypoint is currently displayed on the
+     * player's screen. When disabled, the waypoint is hidden but
+     * remains valid.
+     *
+     * This property can't be edited in restricted-execution mode.
+     *
+     */
+    isEnabled: boolean;
+    /**
+     * @remarks
+     * Returns whether the waypoint is currently valid. A waypoint
+     * becomes invalid when its tracked entity is no longer valid.
+     *
+     */
+    readonly isValid: boolean;
+    /**
+     * @remarks
+     * The {@link WaypointTextureSelector} that determines which
+     * icon texture is displayed for the waypoint based on distance
+     * or other criteria.
+     *
+     * This property can't be edited in restricted-execution mode.
+     *
+     */
+    textureSelector: WaypointTextureSelector;
+    /**
+     * @remarks
+     * Gets the current {@link DimensionLocation} of the waypoint.
+     * For entity waypoints, this returns the entity's current
+     * position. For location waypoints, this returns the stored
+     * location.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link InvalidWaypointError}
+     *
+     * {@link InvalidWaypointTextureSelectorError}
+     */
+    getDimensionLocation(): DimensionLocation;
+    /**
+     * @remarks
+     * Removes the waypoint from all locator bars it has been added
+     * to. This affects all players who have this waypoint in their
+     * locator bar.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     */
+    remove(): void;
+}
+
 /**
  * Contains information related to changes in weather in the
  * environment.
@@ -20553,6 +21295,14 @@ export class World {
      */
     readonly gameRules: GameRules;
     readonly isHardcore: boolean;
+    /**
+     * @rc
+     * @remarks
+     * Manager for adding and removing primitive text objects in
+     * the world.
+     *
+     */
+    readonly primitiveShapesManager: PrimitiveShapesManager;
     /**
      * @remarks
      * Returns the general global scoreboard that applies to the
@@ -20772,6 +21522,15 @@ export class World {
      *
      */
     getMoonPhase(): MoonPhase;
+    /**
+     * @rc
+     * @remarks
+     * Returns a map of pack setting name and value pairs.
+     *
+     * This function can be called in early-execution mode.
+     *
+     */
+    getPackSettings(): Record<string, boolean | number | string>;
     /**
      * @remarks
      * Returns a set of players based on a set of conditions
@@ -21188,6 +21947,13 @@ export class WorldAfterEvents {
      *
      */
     readonly entitySpawn: EntitySpawnAfterEventSignal;
+    /**
+     * @rc
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
+    readonly entityUpgrade: EntityUpgradeAfterEventSignal;
     /**
      * @remarks
      * This event is fired after an explosion occurs.
@@ -21725,6 +22491,10 @@ export interface BlockCustomComponent {
      *
      */
     beforeOnPlayerPlace?: (arg0: BlockComponentPlayerPlaceBeforeEvent, arg1: CustomComponentParameters) => void;
+    /**
+     * @rc
+     */
+    onBlockStateChange?: (arg0: BlockComponentBlockStateChangeEvent, arg1: CustomComponentParameters) => void;
     /**
      * @remarks
      * This function will be called when a specific block is
@@ -22256,6 +23026,35 @@ export interface CustomCommandResult {
     status: CustomCommandStatus;
 }
 
+/**
+ * @rc
+ */
+export interface CustomTexture {
+    /**
+     * @remarks
+     * The height of the icon, in relative units. Value must be
+     * between 0.0 and 1.0, inclusive.
+     *
+     * Bounds: [0, 1]
+     */
+    iconHeight: number;
+    /**
+     * @remarks
+     * The width of the icon, in relative units. Value must be
+     * between 0.0 and 1.0, inclusive.
+     *
+     * Bounds: [0, 1]
+     */
+    iconWidth: number;
+    /**
+     * @remarks
+     * The resource path to the custom texture. This should be a
+     * valid string path to a texture asset.
+     *
+     */
+    path: string;
+}
+
 /**
  * Contains a set of updates to the component definition state
  * of an entity.
@@ -23076,6 +23875,37 @@ export interface EntityRaycastOptions extends EntityFilter {
     maxDistance?: number;
 }
 
+/**
+ * @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,
+ * and death state.
+ */
+export interface EntityVisibilityRules {
+    /**
+     * @remarks
+     * Controls whether the waypoint is shown when the tracked
+     * entity is dead. If undefined, defaults to true.
+     *
+     */
+    showDead?: boolean;
+    /**
+     * @remarks
+     * Controls whether the waypoint is shown when the tracked
+     * entity is invisible. If undefined, defaults to true.
+     *
+     */
+    showInvisible?: boolean;
+    /**
+     * @remarks
+     * Controls whether the waypoint is shown when the tracked
+     * entity is sneaking. If undefined, defaults to true.
+     *
+     */
+    showSneaking?: boolean;
+}
+
 /**
  * Equal to operator.
  */
@@ -23601,6 +24431,39 @@ export interface PlayerSwingEventOptions {
     swingSource?: EntitySwingSource;
 }
 
+/**
+ * @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
+ * spectator mode.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export interface PlayerVisibilityRules extends EntityVisibilityRules {
+    /**
+     * @remarks
+     * Controls whether the waypoint is shown when the tracked
+     * player is hidden. If undefined, defaults to true.
+     *
+     */
+    showHidden?: boolean;
+    /**
+     * @remarks
+     * Controls whether the waypoint is shown when the tracked
+     * player is in spectator mode. If undefined, defaults to true.
+     *
+     */
+    showSpectator?: boolean;
+    /**
+     * @remarks
+     * Controls whether the waypoint is shown when a spectator is
+     * viewing another spectator player. If undefined, defaults to
+     * true.
+     *
+     */
+    showSpectatorToSpectator?: boolean;
+}
+
 /**
  * Key frame that holds the progress of the camera animation.
  */
@@ -24297,6 +25160,60 @@ export interface VectorXZ {
     z: number;
 }
 
+/**
+ * @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.
+ */
+export interface WaypointTextureBounds {
+    /**
+     * @remarks
+     * The lower distance bound for this texture. The texture is
+     * displayed when the distance to the waypoint is greater than
+     * this value. Value must be greater than or equal to 0.
+     *
+     * Minimum Value: 0
+     */
+    lowerBound: number;
+    /**
+     * @remarks
+     * The {@link WaypointTexture} or {@link CustomTexture} to
+     * display within this distance range.
+     *
+     */
+    texture: CustomTexture | WaypointTexture;
+    /**
+     * @remarks
+     * The upper distance bound for this texture. The texture is
+     * displayed when the distance to the waypoint is less than or
+     * equal to this value. If undefined, there is no upper limit.
+     * Value must be greater than or equal to 0.
+     *
+     * Minimum Value: 0
+     */
+    upperBound?: number;
+}
+
+/**
+ * @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.
+ */
+export interface WaypointTextureSelector {
+    /**
+     * @remarks
+     * An array of {@link WaypointTextureBounds} that define which
+     * textures are displayed at different distance ranges. The
+     * system evaluates these bounds to determine the appropriate
+     * texture based on the current distance to the waypoint. The
+     * list has a maximum size limit of 16.
+     *
+     */
+    textureBoundsList: WaypointTextureBounds[];
+}
+
 /**
  * Contains additional options for a playSound occurrence.
  */
@@ -24432,6 +25349,48 @@ export class CustomComponentNameError extends Error {
     readonly reason: CustomComponentNameErrorReason;
 }
 
+/**
+ * @rc
+ * Thrown when trying to register a custom dimension with a
+ * name that has already been registered.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class CustomDimensionAlreadyRegisteredError extends Error {
+    private constructor();
+}
+
+/**
+ * @rc
+ * Thrown when trying to register a custom dimension outside of
+ * the system startup event.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class CustomDimensionInvalidRegistryError extends Error {
+    private constructor();
+}
+
+/**
+ * @rc
+ * Thrown when trying to register a custom dimension with a
+ * name that contains invalid characters.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class CustomDimensionNameError extends Error {
+    private constructor();
+}
+
+/**
+ * @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
+ * reload.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class CustomDimensionReloadNewDimensionError extends Error {
+    private constructor();
+}
+
 // @ts-ignore Class inheritance allowed for native defined classes
 export class EnchantmentLevelOutOfBoundsError extends Error {
     private constructor();
@@ -24555,6 +25514,25 @@ export class InvalidStructureError extends Error {
     private constructor();
 }
 
+/**
+ * @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.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class InvalidWaypointError extends Error {
+    private constructor();
+}
+
+/**
+ * @rc
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class InvalidWaypointTextureSelectorError extends Error {
+    private constructor();
+}
+
 /**
  * Thrown when trying to register an item custom component with
  * a name that has already been registered.
@@ -24611,6 +25589,25 @@ export class LocationOutOfWorldBoundariesError extends Error {
     private constructor();
 }
 
+/**
+ * @rc
+ * Error thrown when a locator bar operation fails. Contains a
+ * reason code indicating the specific cause of the error.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class LocatorBarError extends Error {
+    private constructor();
+    /**
+     * @remarks
+     * The {@link LocatorBarErrorReason} code that indicates why
+     * the locator bar operation failed.
+     *
+     * This property can be read in early-execution mode.
+     *
+     */
+    readonly reason: LocatorBarErrorReason;
+}
+
 /**
  * Thrown when a name requires a namespace and an error occurs
  * when validating that namespace
@@ -24631,6 +25628,14 @@ export class PlaceJigsawError extends Error {
     private constructor();
 }
 
+/**
+ * @rc
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class PrimitiveShapeError extends Error {
+    private constructor();
+}
+
 // @ts-ignore Class inheritance allowed for native defined classes
 export class RawMessageError extends Error {
     private constructor();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "2.8.0-rc.1.26.30-preview.27",
+  "version": "2.8.0-rc.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"
 }