keystonemc 1.0.1 → 1.1.0

package/dist/core/index.d.ts

@@ -1,5 +1,6 @@
 export { keystone } from './keystone';
 export { Vector3 } from './math/vector3';
+export { AxisAlignedBB } from './math/axisAlignedBB';
 export { Priority } from './event/priority';
 export { EventManager } from './event/eventManager';
 export { debug } from './utils/debugger';

package/dist/core/math/axisAlignedBB.d.ts

@@ -0,0 +1,114 @@
+import { AABB, Vector3 } from '@minecraft/server';
+export declare class AxisAlignedBB implements AABB {
+    center: Vector3;
+    extent: Vector3;
+    constructor(center: Vector3, extent: Vector3);
+    /**
+     * 最小点最大点からオブジェクト化
+     * @param min
+     * @param max
+     * @returns {AxisAlignedBB}
+     */
+    static fromMinMax(min: Vector3, max: Vector3): AxisAlignedBB;
+    /**
+     * 大きさ1のAABB生成
+     * @returns {AxisAlignedBB}
+     */
+    static one(): AxisAlignedBB;
+    /**
+     * {center, extent} オブジェクトから生成
+     * @param aabb
+     * @returns {AxisAlignedBB}
+     */
+    static fromBDS(aabb: AABB): AxisAlignedBB;
+    /**
+     * 最小点
+     * @returns {Vector3}
+     */
+    get min(): Vector3;
+    /**
+     * 最大点
+     * @returns {Vector3}
+     */
+    get max(): Vector3;
+    /**
+     * オフセット
+     * @param dx
+     * @param dy
+     * @param dz
+     * @returns {AxisAlignedBB}
+     */
+    offset(dx: number, dy: number, dz: number): AxisAlignedBB;
+    /**
+     * 拡大
+     * @param dx
+     * @param dy
+     * @param dz
+     * @returns {AxisAlignedBB}
+     */
+    expand(dx: number, dy: number, dz: number): AxisAlignedBB;
+    /**
+     * 縮小
+     * @param dx
+     * @param dy
+     * @param dz
+     * @returns {AxisAlignedBB}
+     */
+    contract(dx: number, dy: number, dz: number): AxisAlignedBB;
+    /**
+     * 接触判定
+     * @param other
+     * @param epsilon
+     * @returns {boolean}
+     */
+    intersects(other: AxisAlignedBB, epsilon?: number): boolean;
+    /**
+     * 対象座標が内包されているか
+     * @param v
+     * @returns {boolean}
+     */
+    contains(v: Vector3): boolean;
+    /**
+     * Xの長さ
+     * @returns {number}
+     */
+    getXLength(): number;
+    /**
+     * Yの長さ
+     * @returns {number}
+     */
+    getYLength(): number;
+    /**
+     * Zの長さ
+     * @returns {number}
+     */
+    getZLength(): number;
+    /**
+     * 体積
+     * @returns {number}
+     */
+    getVolume(): number;
+    /**
+     * キューブ判定
+     * @param epsilon
+     * @returns {boolean}
+     */
+    isCube(epsilon?: number): boolean;
+    /**
+     * BDS ScriptAPIで使える {center, extent} 形式に変換
+     * @returns {AABB}
+     */
+    toBDS(): AABB;
+    /**
+     * オブジェクトに変換
+     */
+    toObject(): {
+        center: Vector3;
+        extent: Vector3;
+    };
+    /**
+     * toString
+     * @returns {string}
+     */
+    toString(): string;
+}

package/dist/core/math/vector3.d.ts

@@ -11,53 +11,77 @@ export declare class Vector3 {
     static zero(): Vector3;
     /**
      * {x, y, z} オブジェクトから生成
-     * @param {_Vector3} pos
-     * @returns
+     * @param pos
+     * @returns {Vector3}
      */
     static fromBDS(pos: _Vector3): Vector3;
+    /**
+     * x
+     * @returns {number}
+     */
     getX(): number;
+    /**
+     * y
+     * @returns {number}
+     */
     getY(): number;
+    /**
+     * z
+     * @returns {number}
+     */
     getZ(): number;
+    /**
+     * x (整数値)
+     * @returns {number}
+     */
     getFloorX(): number;
+    /**
+     * y (整数値)
+     * @returns {number}
+     */
     getFloorY(): number;
+    /**
+     * z (整数値)
+     * @returns {number}
+     */
     getFloorZ(): number;
     /**
      * 加算
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
+     * @param x
+     * @param y
+     * @param z
      * @return {Vector3}
      */
     add(x: number, y: number, z: number): Vector3;
     /**
      * ベクトル単位での加算
-     * @param {_Vector3} v
+     * @param v
      * @returns {Vector3}
      */
     addVector(v: _Vector3): Vector3;
     /**
      * 減算
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
+     * @param x
+     * @param y
+     * @param z
      * @return {Vector3}
      */
     subtract(x: number, y: number, z: number): Vector3;
     /**
      * ベクトル単位での減算
-     * @param {_Vector3} v
+     * @param v
      * @return {Vector3}
      */
     subtractVector(v: _Vector3): Vector3;
     /**
      * 乗算
-     * @param {number} value
+     * @param value
      * @return {Vector3}
      */
     multiply(value: number): Vector3;
     /**
      * 除算
-     * @param {number} value
+     * @param value
      * @return {Vector3}
      */
     divide(value: number): Vector3;
@@ -73,7 +97,7 @@ export declare class Vector3 {
     floor(): Vector3;
     /**
      * ベクトルの内部数値小数点四捨五入
-     * @param {number} precision
+     * @param precision
      * @return {Vector3}
      */
     round(precision?: number): Vector3;
@@ -84,31 +108,31 @@ export declare class Vector3 {
     abs(): Vector3;
     /**
      * 指定した2点間のユークリッド距離
-     * @param {_Vector3} pos
+     * @param pos
      * @return {number}
      */
     distance(pos: _Vector3): number;
     /**
      * 指定した2点間のユークリッド距離の2乗
-     * @param {_Vector3} pos
+     * @param pos
      * @return {number}
      */
     distanceSquared(pos: _Vector3): number;
     /**
      * 内積
-     * @param {_Vector3} pos
+     * @param pos
      * @return {number}
      */
     dot(pos: _Vector3): number;
     /**
      * 外積
-     * @param {_Vector3} pos
+     * @param pos
      * @return {Vector3}
      */
     cross(pos: _Vector3): Vector3;
     /**
      * ベクトルの比較
-     * @param {_Vector3} pos
+     * @param pos
      * @return {boolean}
      */
     equals(pos: _Vector3): boolean;
@@ -129,9 +153,9 @@ export declare class Vector3 {
     normalize(): Vector3;
     /**
      * オブジェクトの数値指定再生成
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
+     * @param x
+     * @param y
+     * @param z
      * @return {Vector3}
      */
     withComponents(x?: number, y?: number, z?: number): Vector3;
@@ -139,21 +163,21 @@ export declare class Vector3 {
    * X座標をxValueにしたとき線分上に存在する点を返す
    * @param end 終点
    * @param xValue 途中点のX値
-   * @returns {Vector3 | undefined}
+   * @returns {Vector3|undefined}
    */
     getIntermediateWithXValue(end: Vector3, xValue: number): Vector3 | undefined;
     /**
      * Y座標をyValueにしたとき線分上に存在する点を返す
      * @param end 終点
      * @param yValue 途中点のY値
-     * @returns {Vector3 | undefined}
+     * @returns {Vector3|undefined}
      */
     getIntermediateWithYValue(end: Vector3, yValue: number): Vector3 | undefined;
     /**
      * Z座標をzValueにしたとき線分上に存在する点を返す
      * @param end 終点
      * @param zValue 途中点のZ値
-     * @returns {Vector3 | undefined}
+     * @returns {Vector3|undefined}
      */
     getIntermediateWithZValue(end: Vector3, zValue: number): Vector3 | undefined;
     /**
@@ -161,30 +185,36 @@ export declare class Vector3 {
      * @returns {_Vector3}
      */
     toBDS(): _Vector3;
-    /** 通常のオブジェクトに変換 */
+    /**
+     * オブジェクトに変換
+     */
     toObject(): {
         x: number;
         y: number;
         z: number;
     };
+    /**
+     * toString
+     * @returns {string}
+     */
     toString(): string;
     /**
      * 最大点
-     * @param {_Vector3} vector
-     * @param {_Vector3[]} vectors
+     * @param vector
+     * @param vectors
      * @returns {Vector3}
      */
     static maxComponents(vector: _Vector3, ...vectors: _Vector3[]): Vector3;
     /**
      * 最小点
-     * @param {_Vector3} vector
-     * @param {_Vector3[]} vectors
+     * @param vector
+     * @param vectors
      * @returns {Vector3}
      */
     static minComponents(vector: _Vector3, ...vectors: _Vector3[]): Vector3;
     /**
      * 合計
-     * @param {_Vector3[]} vectors
+     * @param vectors
      * @returns {Vector3}
      */
     static sum(...vectors: {

package/dist/index.js

@@ -19,36 +19,59 @@ class Vector3 {
   }
   /**
    * {x, y, z} オブジェクトから生成
-   * @param {_Vector3} pos 
-   * @returns 
+   * @param pos 
+   * @returns {Vector3}
    */
   static fromBDS(pos) {
     return new Vector3(pos.x, pos.y, pos.z);
   }
-  // ===== 基本ゲッター =====
+  /**
+   * x
+   * @returns {number}
+   */
   getX() {
     return this.x;
   }
+  /**
+   * y
+   * @returns {number}
+   */
   getY() {
     return this.y;
   }
+  /**
+   * z
+   * @returns {number}
+   */
   getZ() {
     return this.z;
   }
+  /**
+   * x (整数値)
+   * @returns {number}
+   */
   getFloorX() {
     return Math.floor(this.x);
   }
+  /**
+   * y (整数値)
+   * @returns {number}
+   */
   getFloorY() {
     return Math.floor(this.y);
   }
+  /**
+   * z (整数値)
+   * @returns {number}
+   */
   getFloorZ() {
     return Math.floor(this.z);
   }
   /**
    * 加算
-   * @param {number} x 
-   * @param {number} y 
-   * @param {number} z 
+   * @param x 
+   * @param y 
+   * @param z 
    * @return {Vector3}
    */
   add(x, y, z) {
@@ -60,7 +83,7 @@ class Vector3 {
   }
   /**
    * ベクトル単位での加算
-   * @param {_Vector3} v 
+   * @param v 
    * @returns {Vector3}
    */
   addVector(v) {
@@ -68,9 +91,9 @@ class Vector3 {
   }
   /**
    * 減算
-   * @param {number} x
-   * @param {number} y
-   * @param {number} z
+   * @param x
+   * @param y
+   * @param z
    * @return {Vector3}
    */
   subtract(x, y, z) {
@@ -78,7 +101,7 @@ class Vector3 {
   }
   /**
    * ベクトル単位での減算
-   * @param {_Vector3} v
+   * @param v
    * @return {Vector3}
    */
   subtractVector(v) {
@@ -86,7 +109,7 @@ class Vector3 {
   }
   /**
    * 乗算
-   * @param {number} value
+   * @param value
    * @return {Vector3}
    */
   multiply(value) {
@@ -98,7 +121,7 @@ class Vector3 {
   }
   /**
    * 除算
-   * @param {number} value
+   * @param value
    * @return {Vector3}
    */
   divide(value) {
@@ -132,7 +155,7 @@ class Vector3 {
   }
   /**
    * ベクトルの内部数値小数点四捨五入
-   * @param {number} precision
+   * @param precision
    * @return {Vector3}
    */
   round(precision = 0) {
@@ -156,7 +179,7 @@ class Vector3 {
   }
   /**
    * 指定した2点間のユークリッド距離
-   * @param {_Vector3} pos 
+   * @param pos 
    * @return {number}
    */
   distance(pos) {
@@ -164,7 +187,7 @@ class Vector3 {
   }
   /**
    * 指定した2点間のユークリッド距離の2乗
-   * @param {_Vector3} pos 
+   * @param pos 
    * @return {number}
    */
   distanceSquared(pos) {
@@ -175,7 +198,7 @@ class Vector3 {
   }
   /**
    * 内積
-   * @param {_Vector3} pos 
+   * @param pos 
    * @return {number}
    */
   dot(pos) {
@@ -183,7 +206,7 @@ class Vector3 {
   }
   /**
    * 外積
-   * @param {_Vector3} pos 
+   * @param pos 
    * @return {Vector3}
    */
   cross(pos) {
@@ -195,7 +218,7 @@ class Vector3 {
   }
   /**
    * ベクトルの比較
-   * @param {_Vector3} pos 
+   * @param pos 
    * @return {boolean}
    */
   equals(pos) {
@@ -228,9 +251,9 @@ class Vector3 {
   }
   /**
    * オブジェクトの数値指定再生成
-   * @param {number} x 
-   * @param {number} y 
-   * @param {number} z 
+   * @param x 
+   * @param y 
+   * @param z 
    * @return {Vector3}
    */
   withComponents(x, y, z) {
@@ -244,7 +267,7 @@ class Vector3 {
   * X座標をxValueにしたとき線分上に存在する点を返す
   * @param end 終点
   * @param xValue 途中点のX値
-  * @returns {Vector3 | undefined}
+  * @returns {Vector3|undefined}
   */
   getIntermediateWithXValue(end, xValue) {
     const dx = end.x - this.x;
@@ -261,7 +284,7 @@ class Vector3 {
    * Y座標をyValueにしたとき線分上に存在する点を返す
    * @param end 終点
    * @param yValue 途中点のY値
-   * @returns {Vector3 | undefined}
+   * @returns {Vector3|undefined}
    */
   getIntermediateWithYValue(end, yValue) {
     const dy = end.y - this.y;
@@ -278,7 +301,7 @@ class Vector3 {
    * Z座標をzValueにしたとき線分上に存在する点を返す
    * @param end 終点
    * @param zValue 途中点のZ値
-   * @returns {Vector3 | undefined}
+   * @returns {Vector3|undefined}
    */
   getIntermediateWithZValue(end, zValue) {
     const dz = end.z - this.z;
@@ -298,17 +321,23 @@ class Vector3 {
   toBDS() {
     return { x: this.x, y: this.y, z: this.z };
   }
-  /** 通常のオブジェクトに変換 */
+  /** 
+   * オブジェクトに変換
+   */
   toObject() {
     return { x: this.x, y: this.y, z: this.z };
   }
+  /**
+   * toString
+   * @returns {string}
+   */
   toString() {
     return `_Vector3(x=${this.x}, y=${this.y}, z=${this.z})`;
   }
   /**
    * 最大点
-   * @param {_Vector3} vector
-   * @param {_Vector3[]} vectors 
+   * @param vector
+   * @param vectors 
    * @returns {Vector3}
    */
   static maxComponents(vector, ...vectors) {
@@ -324,8 +353,8 @@ class Vector3 {
   }
   /**
    * 最小点
-   * @param {_Vector3} vector
-   * @param {_Vector3[]} vectors 
+   * @param vector
+   * @param vectors 
    * @returns {Vector3}
    */
   static minComponents(vector, ...vectors) {
@@ -341,7 +370,7 @@ class Vector3 {
   }
   /**
    * 合計
-   * @param {_Vector3[]} vectors
+   * @param vectors
    * @returns {Vector3}
    */
   static sum(...vectors) {
@@ -354,6 +383,194 @@ class Vector3 {
     return new Vector3(x, y, z);
   }
 }
+class AxisAlignedBB {
+  constructor(center, extent) {
+    this.center = center;
+    this.extent = extent;
+  }
+  /**
+   * 最小点最大点からオブジェクト化
+   * @param min 
+   * @param max 
+   * @returns {AxisAlignedBB}
+   */
+  static fromMinMax(min, max) {
+    return new AxisAlignedBB(
+      {
+        x: (min.x + max.x) / 2,
+        y: (min.y + max.y) / 2,
+        z: (min.z + max.z) / 2
+      },
+      {
+        x: (max.x - min.x) / 2,
+        y: (max.y - min.y) / 2,
+        z: (max.z - min.z) / 2
+      }
+    );
+  }
+  /**
+   * 大きさ1のAABB生成
+   * @returns {AxisAlignedBB}
+   */
+  static one() {
+    return AxisAlignedBB.fromMinMax(
+      { x: 0, y: 0, z: 0 },
+      { x: 1, y: 1, z: 1 }
+    );
+  }
+  /**
+   * {center, extent} オブジェクトから生成
+   * @param aabb 
+   * @returns {AxisAlignedBB}
+   */
+  static fromBDS(aabb) {
+    return new AxisAlignedBB(aabb.center, aabb.extent);
+  }
+  /**
+   * 最小点
+   * @returns {Vector3}
+   */
+  get min() {
+    return {
+      x: this.center.x - this.extent.x,
+      y: this.center.y - this.extent.y,
+      z: this.center.z - this.extent.z
+    };
+  }
+  /**
+   * 最大点
+   * @returns {Vector3}
+   */
+  get max() {
+    return {
+      x: this.center.x + this.extent.x,
+      y: this.center.y + this.extent.y,
+      z: this.center.z + this.extent.z
+    };
+  }
+  /**
+   * オフセット
+   * @param dx 
+   * @param dy 
+   * @param dz 
+   * @returns {AxisAlignedBB}
+   */
+  offset(dx, dy, dz) {
+    return new AxisAlignedBB(
+      { x: this.center.x + dx, y: this.center.y + dy, z: this.center.z + dz },
+      this.extent
+    );
+  }
+  /**
+   * 拡大
+   * @param dx 
+   * @param dy 
+   * @param dz 
+   * @returns {AxisAlignedBB} 
+   */
+  expand(dx, dy, dz) {
+    return new AxisAlignedBB(
+      this.center,
+      {
+        x: this.extent.x + dx,
+        y: this.extent.y + dy,
+        z: this.extent.z + dz
+      }
+    );
+  }
+  /**
+   * 縮小
+   * @param dx 
+   * @param dy 
+   * @param dz 
+   * @returns {AxisAlignedBB}
+   */
+  contract(dx, dy, dz) {
+    return this.expand(-dx, -dy, -dz);
+  }
+  /**
+   * 接触判定
+   * @param other 
+   * @param epsilon 
+   * @returns {boolean}
+   */
+  intersects(other, epsilon = 1e-6) {
+    const aMin = this.min;
+    const aMax = this.max;
+    const bMin = other.min;
+    const bMax = other.max;
+    return bMax.x - aMin.x > epsilon && aMax.x - bMin.x > epsilon && bMax.y - aMin.y > epsilon && aMax.y - bMin.y > epsilon && bMax.z - aMin.z > epsilon && aMax.z - bMin.z > epsilon;
+  }
+  /**
+   * 対象座標が内包されているか
+   * @param v 
+   * @returns {boolean}
+   */
+  contains(v) {
+    const min = this.min;
+    const max = this.max;
+    return v.x > min.x && v.x < max.x && v.y > min.y && v.y < max.y && v.z > min.z && v.z < max.z;
+  }
+  /**
+   * Xの長さ
+   * @returns {number} 
+   */
+  getXLength() {
+    return this.extent.x * 2;
+  }
+  /**
+   * Yの長さ
+   * @returns {number} 
+   */
+  getYLength() {
+    return this.extent.y * 2;
+  }
+  /**
+   * Zの長さ
+   * @returns {number} 
+   */
+  getZLength() {
+    return this.extent.z * 2;
+  }
+  /**
+   * 体積
+   * @returns {number} 
+   */
+  getVolume() {
+    return this.getXLength() * this.getYLength() * this.getZLength();
+  }
+  /**
+   * キューブ判定
+   * @param epsilon 
+   * @returns {boolean}
+   */
+  isCube(epsilon = 1e-6) {
+    const x = this.getXLength();
+    const y = this.getYLength();
+    const z = this.getZLength();
+    return Math.abs(x - y) < epsilon && Math.abs(y - z) < epsilon;
+  }
+  /**
+   * BDS ScriptAPIで使える {center, extent} 形式に変換
+   * @returns {AABB}
+   */
+  toBDS() {
+    return { center: this.center, extent: this.extent };
+  }
+  /** 
+   * オブジェクトに変換
+   */
+  toObject() {
+    return { center: this.center, extent: this.extent };
+  }
+  /**
+   * toString
+   * @returns {string}
+   */
+  toString() {
+    return `AxisAlignedBB{center=(${this.center.x}, ${this.center.y}, ${this.center.z}), extent=(${this.center.x}, ${this.center.y}, ${this.center.z})}`;
+  }
+}
 var Priority = /* @__PURE__ */ ((Priority2) => {
   Priority2[Priority2["LOWEST"] = 5] = "LOWEST";
   Priority2[Priority2["LOW"] = 4] = "LOW";
@@ -757,6 +974,7 @@ function sleep(tick) {
   });
 }
 export {
+  AxisAlignedBB,
   DelayedTimer,
   EventManager,
   Priority,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keystonemc",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "ScriptAPI Wrapper",
   "type": "module",
   "scripts": {