@starktma/minecraft-utils 1.3.111 → 1.4.0

package/dist/math/index.js

@@ -1,30 +1,3 @@
-/**
- * Converts an angle in degrees to radians.
- *
- * @param degrees - The angle in degrees to be converted.
- * @returns The angle in radians.
- */
-export function toRadians(degrees) {
-    return degrees * (Math.PI / 180);
-}
-/**
- * Converts an angle in radians to degrees.
- *
- * @param radians - The angle in radians to be converted.
- * @returns The angle in degrees.
- */
-export function calculateDistance(position1, position2) {
-    return Math.sqrt(Math.pow(position1.x - position2.x, 2) + Math.pow(position1.y - position2.y, 2) + Math.pow(position1.z - position2.z, 2));
-}
-/**
- * Converts an angle in radians to degrees.
- *
- * @param radians - The angle in radians to be converted.
- * @returns The angle in degrees.
- */
-export function toDegrees(radians) {
-    return radians * (180 / Math.PI);
-}
 /**
  * Converts a hex color string to an RGBA object.
  *
@@ -63,46 +36,6 @@ export function hexToRgba(hex, stripAlpha = false) {
 export function clamp(value, min, max) {
     return Math.max(min, Math.min(max, value));
 }
-/**
- * Converts an angle in degrees to its signed equivalent in the range [-180, 180].
- *
- * @param angle - The angle in degrees to be converted.
- * @returns The signed angle in degrees, normalized to the range [-180, 180].
- */
-export function toSigned(angle) {
-    const wrapped = ((angle % 360) + 360) % 360;
-    return wrapped > 180 ? wrapped - 360 : wrapped;
-}
-/**
- * Converts an angle in degrees to its unsigned equivalent in the range [0, 360].
- *
- * @param angle - The angle in degrees to be converted.
- * @returns The unsigned angle in degrees, normalized to the range [0, 360].
- */
-export function toUnsigned(angle) {
-    return ((angle % 360) + 360) % 360;
-}
-/**
- * Calculates the shortest signed arc between two angles in degrees.
- *
- * @param from - The starting angle in degrees.
- * @param to - The target angle in degrees.
- * @returns The shortest arc in degrees from `from` to `to`.
- */
-export function shortestArc(from, to) {
-    return -toSigned((to - from + 360) % 360);
-}
-/**
- * Checks if two positions are equal within a specified tolerance.
- *
- * @param a - The first position.
- * @param b - The second position.
- * @param tolerance - The tolerance for comparison (default is 0.5).
- * @returns `true` if the positions are equal within the tolerance, otherwise `false`.
- */
-export function positionsEqual(a, b, tolerance = 0.5) {
-    return Math.abs(a.x - b.x) < tolerance && Math.abs(a.y - b.y) < tolerance && Math.abs(a.z - b.z) < tolerance;
-}
 /**
  * Checks if a value is within a specified range.
  *
@@ -117,21 +50,162 @@ export function inRange(value, min, max) {
 /**
  * A utility class for performing operations on 3D vectors.
  */
-export class VectorOperations {
+export class Vector {
     static apply(v, fn) {
-        return { x: fn(v.x), y: fn(v.y), z: fn(v.z) };
+        const result = { x: fn(v.x) };
+        if ("y" in v)
+            result.y = fn(v.y);
+        if ("z" in v)
+            result.z = fn(v.z);
+        return result;
+    }
+    static add(v1, ...vectors) {
+        const result = Vector.copy(v1);
+        for (const v of vectors) {
+            result.x += v.x;
+            if ("y" in result && "y" in v) {
+                result.y += v.y;
+            }
+            if ("z" in result && "z" in v) {
+                result.z += v.z;
+            }
+        }
+        return result;
+    }
+    static subtract(v1, ...vectors) {
+        const result = Vector.copy(v1);
+        for (const v of vectors) {
+            result.x -= v.x;
+            if ("y" in result && "y" in v) {
+                result.y -= v.y;
+            }
+            if ("z" in result && "z" in v) {
+                result.z -= v.z;
+            }
+        }
+        return result;
+    }
+    static scalarDivide(v, scalar) {
+        return Vector.apply(v, (component) => component / scalar);
+    }
+    static scalarMultiply(v, scalar) {
+        return Vector.apply(v, (component) => component * scalar);
+    }
+    static dot(v1, v2) {
+        let result = v1.x * v2.x;
+        if ("y" in v1 && "y" in v2)
+            result += v1.y * v2.y;
+        if ("z" in v1 && "z" in v2)
+            result += v1.z * v2.z;
+        return result;
     }
-    static add(v1, v2) {
-        return { x: v1.x + v2.x, y: v1.y + v2.y, z: v1.z + v2.z };
+    static magnitude(v) {
+        let sumOfSquares = v.x * v.x;
+        if ("y" in v)
+            sumOfSquares += v.y * v.y;
+        if ("z" in v)
+            sumOfSquares += v.z * v.z;
+        return Math.sqrt(sumOfSquares);
     }
-    static subtract(v1, v2) {
-        return { x: v1.x - v2.x, y: v1.y - v2.y, z: v1.z - v2.z };
+    static normalize(v) {
+        const mag = Vector.magnitude(v);
+        if (mag === 0)
+            return v;
+        return Vector.scalarDivide(v, mag);
     }
-    static multiply(v, scalar) {
-        return VectorOperations.apply(v, (component) => component * scalar);
+    static distance(v1, v2) {
+        const diff = Vector.subtract(v1, v2);
+        return Vector.magnitude(diff);
     }
     static stringify(v) {
-        return `${v.x} ${v.y} ${v.z}`;
+        let result = `${v.x}`;
+        if ("y" in v)
+            result += ` ${v.y}`;
+        if ("z" in v)
+            result += ` ${v.z}`;
+        return result;
+    }
+    static rotateVector(vector, rotationDegrees) {
+        const rad = Trigonometry.radians(rotationDegrees);
+        const sin = Math.sin(rad);
+        const cos = Math.cos(rad);
+        return {
+            x: vector.x * cos + vector.z * sin,
+            y: vector.y,
+            z: vector.x * sin + vector.z * cos,
+        };
+    }
+    static new(x, y, z) {
+        if (z === undefined) {
+            return { x, y };
+        }
+        else {
+            return { x, y, z };
+        }
+    }
+    static copy(vector) {
+        return { ...vector };
+    }
+}
+export class Trigonometry {
+    static fromAngle(rotation) {
+        if (typeof rotation === "number") {
+            const rad = Trigonometry.radians(rotation);
+            return { x: -Math.sin(rad), y: Math.cos(rad) };
+        }
+        else {
+            const rad = Trigonometry.radians(rotation.y);
+            const pitchRad = Trigonometry.radians(rotation.x);
+            return {
+                x: -Math.sin(rad) * Math.cos(pitchRad),
+                y: Math.sin(pitchRad),
+                z: Math.cos(rad) * Math.cos(pitchRad),
+            };
+        }
+    }
+    /** Converts an angle in degrees to radians.
+     *
+     * @param degrees - The angle in degrees to be converted.
+     * @returns The angle in radians.
+     */
+    static radians(degrees) {
+        return degrees * (Math.PI / 180);
+    }
+    /**
+     * Converts an angle in radians to degrees.
+     *
+     * @param radians - The angle in radians to be converted.
+     * @returns The angle in degrees.
+     */
+    static degrees(radians) {
+        return radians * (180 / Math.PI);
+    }
+    /**
+     * Converts an angle in degrees to its signed equivalent in the range [-180, 180].
+     * @param angle - The angle in degrees to be converted.
+     * @returns The signed angle in degrees, normalized to the range [-180, 180].
+     */
+    static signedAngle(degrees) {
+        const wrapped = ((degrees % 360) + 360) % 360;
+        return wrapped > 180 ? wrapped - 360 : wrapped;
+    }
+    /**
+     * Converts an angle in degrees to its unsigned equivalent in the range [0, 360].
+     *
+     * @param angle - The angle in degrees to be converted.
+     * @returns The unsigned angle in degrees, normalized to the range [0, 360].
+     */
+    static unsignedAngle(degrees) {
+        return ((degrees % 360) + 360) % 360;
+    }
+    /** Calculates the shortest arc between two angles in degrees.
+     *
+     * @param from - The starting angle in degrees.
+     * @param to - The target angle in degrees.
+     * @returns The shortest arc from the starting angle to the target angle in degrees.
+     */
+    static shortestArc(from, to) {
+        return -this.signedAngle((to - from + 360) % 360);
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/math/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/math/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/math/index.ts"],"names":[],"mappings":"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"}

package/dist/minecraft/effectsAPI.d.ts

@@ -0,0 +1,69 @@
+import { Entity, RGBA, StartupEvent } from "@minecraft/server";
+import { SimpleObject } from "../database";
+interface EffectObject extends SimpleObject {
+    id: string;
+    namespace: string;
+    effectType: string;
+    amplifier: number;
+    duration: number;
+    color: RGBA;
+}
+interface EffectConfig {
+    effectType: string;
+    color: RGBA;
+    sounds?: {
+        ambient?: string;
+        start?: string;
+        end?: string;
+    };
+    particleType?: string;
+    handler: (entity: Entity, effect: EffectObject) => void;
+}
+interface PotionConfig {
+    effectKey: string;
+    namespace: string;
+    effectId: number;
+    handler: (entity: Entity, amplifier: number, duration: number, color: RGBA) => void;
+    splashRange?: number;
+    lingeringMaxRadius?: number;
+    lingeringLifetime?: number;
+    lingeringDurationMultiplier?: number;
+}
+declare class EffectManager {
+    private static instance;
+    private effectConfigs;
+    private potionConfigs;
+    private areaEffectClouds;
+    private cloudIdCounter;
+    private trackedEntities;
+    private entityDatabases;
+    static getInstance(): EffectManager;
+    private constructor();
+    private getEntityDatabase;
+    private getEffect;
+    private getAllEffects;
+    private hasActiveEffects;
+    private debug;
+    registerEffect(config: EffectConfig): {
+        addEffect: (entity: Entity, amplifier: number, durationTicks: number) => void;
+        removeEffect: (entity: Entity) => void;
+        applyEffect: (entity: Entity, effect: EffectObject) => void;
+    };
+    addEffect(entity: Entity, effectType: string, amplifier: number, duration: number): void;
+    removeEffect(entity: Entity, effectType: string): void;
+    removeAllEffects(entity: Entity): void;
+    hasEffect(entity: Entity, effectType: string): boolean;
+    getEffects(entity: Entity): EffectObject[];
+    registerPotion(config: PotionConfig): {
+        handler: (entity: Entity, amplifier: number, duration: number, color: RGBA) => void;
+    };
+    start(startup?: StartupEvent, debug?: boolean): void;
+    private handleProjectileHit;
+    private handleSplash;
+    private handleLingering;
+    private updateCloud;
+    private getColorFromEntity;
+}
+declare const effectManager: EffectManager;
+export { EffectManager, effectManager, EffectObject, EffectConfig, PotionConfig };
+//# sourceMappingURL=effectsAPI.d.ts.map

package/dist/minecraft/effectsAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectsAPI.d.ts","sourceRoot":"","sources":["../../src/minecraft/effectsAPI.ts"],"names":[],"mappings":"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"}