@minecraft/server 2.8.0-beta.1.26.20-preview.28 → 2.9.0-beta.1.26.30-preview.21

package/index.d.ts

@@ -16,7 +16,7 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "2.8.0-beta"
+ *   "version": "2.9.0-beta"
  * }
  * ```
  *
@@ -837,7 +837,7 @@ export enum EntityComponentTypes {
     Color2 = 'minecraft:color2',
     CursorInventory = 'minecraft:cursor_inventory',
     /**
-     * @beta
+     * @rc
      * @remarks
      * Represents this entity's ender inventory properties.
      *
@@ -1866,10 +1866,6 @@ export enum GameRule {
      *
      */
     KeepInventory = 'keepInventory',
-    /**
-     * @beta
-     */
-    LocatorBar = 'locatorBar',
     /**
      * @remarks
      * The maximum number of chained commands that can execute per
@@ -1897,6 +1893,14 @@ export enum GameRule {
      *
      */
     PlayersSleepingPercentage = 'playersSleepingPercentage',
+    /**
+     * @beta
+     * @remarks
+     * Controls which player waypoints are automatically added to
+     * the players locator bar.
+     *
+     */
+    PlayerWaypoints = 'playerWaypoints',
     /**
      * @remarks
      * Controls whether projectiles (entities with a projectile
@@ -2687,6 +2691,14 @@ export enum PlayerPermissionLevel {
     Custom = 3,
 }
 
+/**
+ * @beta
+ */
+export enum PlayerWaypointsMode {
+    Everyone = 'Everyone',
+    Off = 'Off',
+}
+
 /**
  * Contains objectives and participants for the scoreboard.
  */
@@ -5050,7 +5062,7 @@ export class BlockComponentTickEvent extends BlockEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Contains information regarding a specific container block
  * being closed.
  */
@@ -5068,7 +5080,7 @@ export class BlockContainerClosedAfterEvent extends BlockEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Manages callbacks that are connected to when a block
  * container is closed.
  */
@@ -5102,7 +5114,7 @@ export class BlockContainerClosedAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Contains information regarding a specific container block
  * being opened.
  */
@@ -5120,7 +5132,7 @@ export class BlockContainerOpenedAfterEvent extends BlockEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Manages callbacks that are connected to when a block
  * container is opened.
  */
@@ -6759,7 +6771,7 @@ export class ChatSendBeforeEventSignal {
 export class ClientSystemInfo extends SystemInfo {
     private constructor();
     /**
-     * @beta
+     * @rc
      * @remarks
      * The locale selected by the client (e.g., en_US, fr_FR,
      * ja_JP). Note that in most cases, server scripts should not
@@ -10974,7 +10986,7 @@ export class EntityComponent extends Component {
 }
 
 /**
- * @beta
+ * @rc
  * Contains information regarding a specific entity container
  * being closed.
  */
@@ -10990,7 +11002,7 @@ export class EntityContainerClosedAfterEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Manages callbacks that are connected to when an entity
  * container is closed.
  */
@@ -11024,7 +11036,7 @@ export class EntityContainerClosedAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Contains information regarding a specific entity container
  * being opened.
  */
@@ -11040,7 +11052,7 @@ export class EntityContainerOpenedAfterEvent {
 }
 
 /**
- * @beta
+ * @rc
  * Manages callbacks that are connected to when an entity
  * container is opened.
  */
@@ -11167,7 +11179,7 @@ export class EntityDieAfterEventSignal {
 }
 
 /**
- * @beta
+ * @rc
  * Represents this entity's ender inventory properties. This
  * component is always present on players and any items in its
  * container will display for the player when they access an
@@ -13721,6 +13733,68 @@ export class EntityUnderwaterMovementComponent extends EntityAttributeComponent
     static readonly componentId = 'minecraft:underwater_movement';
 }
 
+/**
+ * @beta
+ * 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[];
+}
+
+/**
+ * @beta
+ * 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).
@@ -14214,36 +14288,36 @@ export class GameRules {
      */
     keepInventory: boolean;
     /**
-     * @beta
      * @remarks
      * This property can't be edited in restricted-execution mode.
      *
      */
-    locatorBar: boolean;
+    maxCommandChainLength: number;
     /**
      * @remarks
      * This property can't be edited in restricted-execution mode.
      *
      */
-    maxCommandChainLength: number;
+    mobGriefing: boolean;
     /**
      * @remarks
      * This property can't be edited in restricted-execution mode.
      *
      */
-    mobGriefing: boolean;
+    naturalRegeneration: boolean;
     /**
      * @remarks
      * This property can't be edited in restricted-execution mode.
      *
      */
-    naturalRegeneration: boolean;
+    playersSleepingPercentage: number;
     /**
+     * @beta
      * @remarks
      * This property can't be edited in restricted-execution mode.
      *
      */
-    playersSleepingPercentage: number;
+    playerWaypoints: PlayerWaypointsMode;
     /**
      * @remarks
      * This property can't be edited in restricted-execution mode.
@@ -16591,9 +16665,9 @@ export class LocationWaypoint extends Waypoint {
  *
  * Note: You can control whether vanilla player waypoints are
  * automatically added to the locator bar using the
- * `locatorbar` {@link GameRule}. This game rule is currently
- * named `locatorbar` but will likely be renamed in a future
- * update to be more descriptive.
+ * `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.
@@ -17573,6 +17647,18 @@ export class Player extends Entity {
      * {@link InvalidEntityError}
      */
     readonly playerPermissionLevel: PlayerPermissionLevel;
+    /**
+     * @beta
+     * @remarks
+     * Gets the player's Playfab ID.
+     *
+     * @throws This property can throw when used.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link InvalidEntityError}
+     */
+    readonly playfabId: string;
     /**
      * @remarks
      * This property can't be edited in restricted-execution mode.
@@ -17687,6 +17773,22 @@ export class Player extends Entity {
      * @throws This function can throw errors.
      */
     getItemCooldown(cooldownCategory: string): number;
+    /**
+     * @beta
+     * @remarks
+     * Gets the player's ping in milliseconds.
+     *
+     * This function can't be called in restricted-execution mode.
+     *
+     * @returns
+     * The player's ping in milliseconds.
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     *
+     * {@link InvalidEntityError}
+     */
+    getPing(): number;
     /**
      * @remarks
      * Gets the current spawn point of the player.
@@ -21587,7 +21689,7 @@ export class StructureManager {
      */
     get(identifier: string): Structure | undefined;
     /**
-     * @beta
+     * @rc
      * @remarks
      * Returns a list of all structures contained in behavior
      * packs. Does not include structures saved to the world or in
@@ -23233,7 +23335,7 @@ export class World {
 export class WorldAfterEvents {
     private constructor();
     /**
-     * @beta
+     * @rc
      * @remarks
      * This event fires when a block container is closed.
      *
@@ -23242,7 +23344,7 @@ export class WorldAfterEvents {
      */
     readonly blockContainerClosed: BlockContainerClosedAfterEventSignal;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This event fires when a block container is opened.
      *
@@ -23298,7 +23400,7 @@ export class WorldAfterEvents {
      */
     readonly effectAdd: EffectAddAfterEventSignal;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This event fires when an entity container is closed.
      *
@@ -23307,7 +23409,7 @@ export class WorldAfterEvents {
      */
     readonly entityContainerClosed: EntityContainerClosedAfterEventSignal;
     /**
-     * @beta
+     * @rc
      * @remarks
      * This event fires when an entity container is opened.
      *
@@ -23404,6 +23506,13 @@ export class WorldAfterEvents {
      *
      */
     readonly entitySpawn: EntitySpawnAfterEventSignal;
+    /**
+     * @beta
+     * @remarks
+     * This property can be read in early-execution mode.
+     *
+     */
+    readonly entityUpgrade: EntityUpgradeAfterEventSignal;
     /**
      * @remarks
      * This event is fired after an explosion occurs.
@@ -23998,7 +24107,7 @@ export interface BlockBoundingBox {
 }
 
 /**
- * @beta
+ * @rc
  * Options used to filter block container access events.
  */
 export interface BlockContainerAccessEventOptions {
@@ -24456,7 +24565,7 @@ export interface CompoundBlockVolumeItem {
 }
 
 /**
- * @beta
+ * @rc
  * Represents the source of a container access.
  */
 export interface ContainerAccessSource {
@@ -24469,7 +24578,7 @@ export interface ContainerAccessSource {
 }
 
 /**
- * @beta
+ * @rc
  * Options for use when filtering container access sources.
  */
 export interface ContainerAccessSourceFilter {
@@ -24773,7 +24882,7 @@ export interface EntityApplyDamageOptions {
 }
 
 /**
- * @beta
+ * @rc
  * Options used to filter entity container access events.
  */
 export interface EntityContainerAccessEventOptions {

package/package.json

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