@minecraft/debug-utilities 1.0.0-beta.1.21.80-preview.28 → 1.0.0-beta.1.21.90-preview.21

package/index.d.ts

@@ -21,6 +21,192 @@
  *
  */
 import * as minecraftcommon from '@minecraft/common';
+import * as minecraftserver from '@minecraft/server';
+/**
+ * The length of the arrow's head/tip.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class DebugArrow extends DebugLine {
+    /**
+     * @remarks
+     * Adds a new debug shape to the world.
+     *
+     */
+    headLength: number;
+    /**
+     * @remarks
+     * The radius of the arrow's head/tip.
+     *
+     */
+    headRadius: number;
+    /**
+     * @remarks
+     * The number of segments for the base circle of the arrow's
+     * head/tip (default: 4).
+     *
+     */
+    headSegments: number;
+    constructor(location: minecraftserver.Vector3, endLocation: minecraftserver.Vector3);
+}
+
+/**
+ * A debug shape class that represents a box or cuboid.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class DebugBox extends DebugShape {
+    /**
+     * @remarks
+     * The bounding box of the shape. The final box will be this
+     * bound multiplied by the shape's scale.
+     *
+     */
+    bound: minecraftserver.Vector3;
+    constructor(location: minecraftserver.Vector3);
+}
+
+/**
+ * A debug shape class that represents a circle (2D).
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class DebugCircle extends DebugShape {
+    constructor(location: minecraftserver.Vector3);
+}
+
+/**
+ * Debug Drawing class used to allow adding and removing
+ * wireframe shapes in world space.
+ */
+export class DebugDrawer {
+    private constructor();
+    /**
+     * @remarks
+     * Adds a new debug shape to the world.
+     *
+     * @param shape
+     * The debug shape to be added. Should be of type DebugBox,
+     * DebugLine, DebugCircle, DebugSphere, DebugArrow or
+     * DebugText.
+     */
+    addShape(shape: DebugShape): void;
+    /**
+     * @remarks
+     * Removes all debug shapes from the world.
+     *
+     */
+    removeAll(): void;
+    /**
+     * @remarks
+     * Removes an instance of a debug shape from the world. This is
+     * equivalent to calling remove on the shape itself.
+     *
+     */
+    removeShape(shape: DebugShape): void;
+}
+
+/**
+ * A debug shape class that represents a line segment.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class DebugLine extends DebugShape {
+    /**
+     * @remarks
+     * The end location of the line segment. The final line will
+     * spawn between location and endLocation.
+     *
+     */
+    endLocation: minecraftserver.Vector3;
+    constructor(location: minecraftserver.Vector3, endLocation: minecraftserver.Vector3);
+}
+
+/**
+ * The base class for all debug shapes. Represents an object in
+ * the world and its base properties.
+ */
+export class DebugShape {
+    private constructor();
+    /**
+     * @remarks
+     * The color of the shape.
+     *
+     */
+    color: minecraftserver.RGB;
+    /**
+     * @remarks
+     * Returns true if the shape has a limited time span before
+     * being removed.
+     *
+     */
+    readonly hasDuration: boolean;
+    /**
+     * @remarks
+     * The location of the shape. For most shapes this is the
+     * centre of the shape, except DebugLine and DebugArrow where
+     * this represents the start point of the line.
+     *
+     */
+    location: minecraftserver.Vector3;
+    /**
+     * @remarks
+     * The rotation of the shape (Euler angles - [Pitch, Yaw,
+     * Roll]).
+     *
+     */
+    rotation: minecraftserver.Vector3;
+    /**
+     * @remarks
+     * The scale of the shape. This does not apply to DebugLine or
+     * DebugArrow.
+     *
+     */
+    scale: number;
+    /**
+     * @remarks
+     * The time left (in seconds) until this shape is automatically
+     * removed. Returns 0 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 0 if the shape does not have
+     * a limited life-span.
+     *
+     */
+    readonly totalTimeLeft?: number;
+    /**
+     * @remarks
+     * Removes this shape from the world. The shape can be re-added
+     * via the DebugDrawer's addShape method.
+     *
+     */
+    remove(): void;
+}
+
+/**
+ * A debug shape class that represents a sphere.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class DebugSphere extends DebugShape {
+    constructor(location: minecraftserver.Vector3);
+}
+
+/**
+ * A debug shape class that a text label. The text label
+ * automatically faces the screen.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class DebugText extends DebugShape {
+    /**
+     * @remarks
+     * The text of the shape to display.
+     *
+     */
+    text: string;
+    constructor(location: minecraftserver.Vector3, text: string);
+}
+
 export interface HandleCounts {
     handleCounts: Record<string, number>;
     name: string;
@@ -80,3 +266,10 @@ export function collectRuntimeStats(): RuntimeStats;
  * @throws This function can throw errors.
  */
 export function disableWatchdogTimingWarnings(disable: boolean): void;
+/**
+ * @remarks
+ * Debug Drawing class used to allow adding and removing
+ * wireframe shapes in world space.
+ *
+ */
+export const debugDrawer: DebugDrawer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/debug-utilities",
-  "version": "1.0.0-beta.1.21.80-preview.28",
+  "version": "1.0.0-beta.1.21.90-preview.21",
   "description": "",
   "contributors": [
     {
@@ -13,7 +13,8 @@
     }
   ],
   "dependencies": {
-    "@minecraft/common": "^1.0.0"
+    "@minecraft/common": "^1.0.0",
+    "@minecraft/server": "^1.17.0 || ^2.0.0-rc.1.21.90-preview.21"
   },
   "license": "MIT"
 }