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

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',
 }
 
 /**
@@ -4343,6 +4350,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.
@@ -12586,6 +12609,34 @@ 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[];
+}
+
 /**
  * Used to differentiate the component group of a variant of an
  * entity from others. (e.g. ocelot, villager).
@@ -18126,6 +18177,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.
@@ -20132,6 +20328,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
@@ -20553,6 +20816,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 +21043,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
@@ -21725,6 +22005,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
@@ -24631,6 +24915,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.28",
   "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.28"
   },
   "license": "MIT"
 }