sapdon 3.0.3 → 3.1.0

package/dist/core/addon/controllers/render_controllers.js

@@ -0,0 +1,162 @@
+/**
+ * 表示 Minecraft 插件中的渲染控制器组。
+ * 该类用于管理一组渲染控制器，并提供添加、设置和转换为 JSON 的方法。
+ */
+export class AddonRenderControllerGroup {
+    /**
+     * 创建一个新的 AddonRenderControllerGroup 实例。
+     * @param {string} format_version - 渲染控制器的格式版本。
+     * @param {Map} [render_controllers] - 渲染控制器的 Map（可选）。默认为空 Map。
+     */
+    constructor(format_version, render_controllers) {
+        /**
+         * 渲染控制器的格式版本。
+         * @type {string}
+         */
+        this.format_version = format_version;
+        /**
+         * 渲染控制器的 Map，键为标识符，值为渲染控制器。
+         * @type {Map<string, AddonRenderController>}
+         */
+        this.render_controllers = render_controllers || new Map();
+    }
+    /**
+     * 设置或更新组中的渲染控制器。
+     * @param {string} identifier - 渲染控制器的唯一标识符。
+     * @param {AddonRenderController} render_controller - 要添加或更新的渲染控制器。
+     */
+    setRenderController(identifier, render_controller) {
+        this.render_controllers.set(identifier, render_controller);
+        return this; // 支持链式调用
+    }
+    /**
+     * 使用渲染控制器的标识符将其添加到组中。
+     * @param {AddonRenderController} render_controller - 要添加的渲染控制器。
+     */
+    addRenderController(render_controller) {
+        this.render_controllers.set(render_controller.name, render_controller.toJson());
+        return this; // 支持链式调用
+    }
+    /**
+     * 将渲染控制器组转换为 JSON 对象。
+     * @returns {Object} - 渲染控制器组的 JSON 表示。
+     */
+    toJson() {
+        return {
+            format_version: this.format_version,
+            render_controllers: Object.fromEntries(this.render_controllers)
+        };
+    }
+}
+/**
+ * 表示 Minecraft 插件中的渲染控制器。
+ * 该类定义了用于渲染实体的几何体、材质、纹理和数组。
+ */
+export class AddonRenderController {
+    /**
+     * 创建一个新的 AddonRenderController 实例。
+     * @param {string} name - 渲染控制器的名称。
+     */
+    constructor(name) {
+        /**
+         * 渲染控制器的名称。
+         * @type {string}
+         */
+        this.name = `render_controller.${name}`;
+        /**
+         * 数组集合（例如纹理、几何体）。
+         * @type {Object}
+         */
+        this.arrays = {};
+        /**
+         * 用于渲染的默认几何体。
+         * @type {string}
+         */
+        this.geometry = "Geometry.default";
+        /**
+         * 用于渲染的材质列表。
+         * @type {Array<string>}
+         */
+        this.material = [];
+        /**
+         * 用于渲染的纹理列表。
+         * @type {Array<string>}
+         */
+        this.texture = [];
+    }
+    /**
+     * 设置渲染控制器的默认几何体。
+     * @param {string} geometry - 要设置的几何体。
+     */
+    setGeometry(geometry) {
+        this.geometry = geometry;
+        return this; // 支持链式调用
+    }
+    /**
+     * 向材质列表中添加一个材质。
+     * @param {string} material - 要添加的材质。
+     */
+    addMaterial(material) {
+        this.material.push(material);
+        return this; // 支持链式调用
+    }
+    /**
+     * 向纹理列表中添加一个纹理。
+     * @param {string} texture - 要添加的纹理。
+     */
+    addTexture(texture) {
+        this.texture.push(texture);
+        return this; // 支持链式调用
+    }
+    /**
+     * 注册一个数组。
+     * @param {string} name - 数组的名称。
+     * @param {Array} array - 要注册的数组。
+     */
+    registerArray(name, array) {
+        this.arrays[`Array.${name}`] = { [name]: array };
+        return this; // 支持链式调用
+    }
+    /**
+     * 注册几何体数组。
+     * @param {Array} array - 要注册的几何体数组。
+     */
+    registerGeometriesArray(array) {
+        this.registerArray("geometries", array);
+        return this; // 支持链式调用
+    }
+    /**
+     * 注册纹理数组。
+     * @param {Array} array - 要注册的纹理数组。
+     */
+    registerTexturesArray(array) {
+        this.registerArray("textures", array);
+        return this; // 支持链式调用
+    }
+    /**
+     * 将渲染控制器转换为 JSON 对象。
+     * @returns {Object} - 渲染控制器的 JSON 表示。
+     */
+    toJson() {
+        return {
+            arrays: this.arrays,
+            geometry: this.geometry,
+            material: this.material,
+            texture: this.texture
+        };
+    }
+}
+/*
+// 示例用法
+const renderControllerGroup = new AddonRenderControllerGroup("1.10.0");
+
+const renderController = new AddonRenderController("custom_entity");
+renderController.setGeometry("Geometry.custom");
+renderController.addMaterial("Material.default");
+renderController.addTexture("Texture.default");
+renderController.registerTexturesArray(["Texture.variant_1", "Texture.variant_2"]);
+
+renderControllerGroup.addRenderController(renderController);
+
+console.log(JSON.stringify(renderControllerGroup.toJson(), null, 4));
+*/ 

package/dist/core/entity/bundles/BasicMoveBundle.js

@@ -0,0 +1,8 @@
+import { BasicBundle } from "./basicBundle.js";
+//移动捆绑包
+export const BasicMovementBundle = new BasicBundle();
+BasicMovementBundle.addComponents([
+    //speed
+    EntityComponent.setMovement(0.2),
+    EntityComponent.setMovementBasic()
+]);

package/dist/core/entity/bundles/basicBundle.js

@@ -36,10 +36,3 @@ export class BasicBundle {
         return this.#components;
     }
 }
-//移动捆绑包
-export const BasicMovementBundle = new BasicBundle();
-MovementBundle.addComponents([
-    //speed
-    EntityComponent.setMovement(0.2),
-    EntityComponent.setMovementBasic()
-]);

package/dist/core/entity/componets/entityComponet.js

@@ -1,4 +1,11 @@
 export class EntityComponent {
+    static setDamageSensor(deals_damage) {
+        return new Map().set("minecraft:damage_sensor", {
+            "triggers": {
+                "deals_damage": deals_damage
+            }
+        });
+    }
     static setMovement(speed) {
         return new Map().set("minecraft:movement", {
             "value": speed

package/dist/core/entity/dummyEntity.js

@@ -0,0 +1,14 @@
+import { EntityComponent } from "./componets/entityComponet.js";
+import { Entity } from "./entity.js";
+export class DummyEntity extends Entity {
+    constructor(identifier, texture, options = {}, behData, resData) {
+        super(identifier, texture, options, behData, resData);
+        //行为设置
+        this.behavior.addComponent(EntityComponent.combineComponents(EntityComponent.setPhysics(false, false), EntityComponent.setPushable(false, false), EntityComponent.setCollisionBox(0.001, 0.001), EntityComponent.setDamageSensor(false)));
+        //资源设置
+        this.resource.addMaterial("default", "entity_alphatest"); //添加默认材质
+        this.resource.addTexture("default", "textures/entity/none"); //添加默认纹理
+        this.resource.setGeometry("geometry.cube"); //设置默认几何体
+        this.resource.addRenderController("controller.render.cow"); //添加渲染控制器
+    }
+}

package/dist/core/entity/entity.js

@@ -1,18 +1,11 @@
 import { BasicEntity } from "./basicEntity.js";
 import { ClientEntity } from "./clientEntity.js";
 export class Entity {
-    /**
-     *
-     * @param {*} identifier
-     * @param {*} texture
-     * @param {*} behData
-     * @param {*} resData
-     * @param {*} options
-     */
-    constructor(identifier, texture, behData, resData, options = {}) {
+    constructor(identifier, texture, options = {}, behData, resData) {
         // 创建行为实体和客户端实体
         this.identifier = identifier;
-        this.entity = new BasicEntity(identifier, options, behData);
-        this.client_entity = new ClientEntity(identifier, resData).addTexture("default", texture);
+        this.behavior = new BasicEntity(identifier, options, behData);
+        this.resource = new ClientEntity(identifier, resData);
+        this.resource.addTexture("default", texture);
     }
 }

package/dist/core/entity/nativeEntity.js

@@ -17,8 +17,8 @@ export class NativeEntity {
             options["runtime_identifier"] = proto_id;
             // 创建行为实体和客户端实体
             this.identifier = identifier;
-            this.entity = new BasicEntity(identifier, options, behData);
-            this.client_entity = new ClientEntity(identifier, resData);
+            this.behavior = new BasicEntity(identifier, options, behData);
+            this.resource = new ClientEntity(identifier, resData);
         }
         catch (error) {
             console.error(`Failed to create NativeEntity ${identifier}:`, error);

package/dist/core/factory/entityFactory.js

@@ -28,10 +28,10 @@ export const EntityAPI = {
             throw new Error("必须提供 identifier、proto_id 和 texture。");
         }
         const nativeEntity = new NativeEntity(identifier, proto_id, options);
-        registerEntity(nativeEntity.entity, nativeEntity.client_entity);
+        registerEntity(nativeEntity.behavior, nativeEntity.resource);
         return {
-            behavior: nativeEntity.entity,
-            resource: nativeEntity.client_entity,
+            behavior: nativeEntity.behavior,
+            resource: nativeEntity.resource,
         };
     },
     /**
@@ -48,10 +48,10 @@ export const EntityAPI = {
             throw new Error("必须提供 identifier 和 texture。");
         }
         const entity = new Entity(identifier, texture, behData, resData, options);
-        registerEntity(entity.entity, entity.client_entity);
+        registerEntity(entity.behavior, entity.resource);
         return {
-            behavior: entity.entity,
-            resource: entity.client_entity,
+            behavior: entity.behavior,
+            resource: entity.resource,
         };
     },
     /**
@@ -66,10 +66,10 @@ export const EntityAPI = {
             throw new Error("必须提供 identifier 和 texture。");
         }
         const entity = new Projectile(identifier, texture, options);
-        registerEntity(entity.entity, entity.client_entity);
+        registerEntity(entity.behavior, entity.resource);
         return {
-            behavior: entity.entity,
-            resource: entity.client_entity,
+            behavior: entity.behavior,
+            resource: entity.resource,
         };
     },
 };

package/dist/core/index.d.ts

@@ -7,6 +7,187 @@ declare enum ItemCategory {
     None = "none"
 }
 
+declare function getMetadata(target: any): any;
+declare function getOrCreateMetadata(target: any): any;
+
+interface ISerializer<T> {
+    (instance: any): T;
+}
+declare namespace Serializer {
+    const json: ISerializer<string>;
+    const jsonDev: ISerializer<string>;
+}
+declare function Serializable(serializer?: ISerializer<any>): (_: any, ctx: DecoratorContext) => void;
+declare function serialize<R, T extends object>(inst: T): R;
+
+type ConstructorOf<T, Arg extends unknown[] = []> = new (...args: Arg) => T;
+
+declare class ArrayEx extends Array {
+    constructor(init?: number[]);
+    set(arr: Iterable<number>): void;
+}
+
+interface Vector3 {
+    x: number;
+    y: number;
+    z: number;
+}
+declare class Vec3 extends ArrayEx implements Vector3 {
+    x: number;
+    y: number;
+    z: number;
+    constructor(init: number[]);
+    static fromXYZ(x: number, y: number, z: number): Vec3;
+    static fromVec3(vec3: Vector3): Vec3;
+    static m(vec3: Vector3): number;
+    m(): number;
+    static isZero(vec: Vector3): boolean;
+    isZero(): boolean;
+    static normalize(vec: Vector3): false | undefined;
+    n(): false | undefined;
+    static add(vec1: Vector3, vec2: Vector3): Vec3;
+    add(vec: Vector3): Vec3;
+    static sub(vec1: Vector3, vec2: Vector3): Vec3;
+    sub(vec: Vector3): Vec3;
+    static mul(vec: Vector3, scalar: number): Vec3;
+    mul(scalar: number): Vec3;
+    static div(vec: Vector3, scalar: number): Vec3;
+    div(scalar: number): Vec3;
+    static dot(vec1: Vector3, vec2: Vector3): number;
+    dot(vec: Vector3): number;
+    static cross(vec1: Vector3, vec2: Vector3): Vec3;
+    cross(vec: Vector3): Vec3;
+    valueOf(): ArrayEx;
+    toString(): string;
+}
+
+interface Vector4 extends Vector3 {
+    w: number;
+}
+declare class Vec4 extends ArrayEx implements Vector4 {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+    constructor(init: number[]);
+    static fromXYZW(x: number, y: number, z: number, w: number): Vec4;
+    static fromVec3(vec3: Vector4): Vec4;
+    static fromVec4(vec4: Vector4): Vec4;
+    static m(vec: Vector4): number;
+    m(): number;
+    static isZero(vec: Vector4): boolean;
+    isZero(): boolean;
+    static normalize(vec: Vector4): false | undefined;
+    n(): false | undefined;
+    static add(vec1: Vector4, vec2: Vector4): Vec4;
+    add(vec: Vector4): Vec4;
+    static sub(vec1: Vector4, vec2: Vector4): Vec4;
+    sub(vec: Vector4): Vec4;
+    static mul(vec: Vector4, scalar: number): Vec4;
+    mul(scalar: number): Vec4;
+    static div(vec: Vector4, scalar: number): Vec4;
+    div(scalar: number): Vec4;
+    static dot(vec1: Vector4, vec2: Vector4): number;
+    dot(vec: Vector4): number;
+    static multiply(vec: Vector4, mat: Matrix): number[] | Vec4;
+    multiply(mat: Matrix): number[] | Vec4;
+    valueOf(): ArrayEx;
+    toString(): string;
+}
+
+declare class Matrix extends ArrayEx {
+    constructor();
+    get m11(): any;
+    get m12(): any;
+    get m13(): any;
+    get m14(): any;
+    get m21(): any;
+    get m22(): any;
+    get m23(): any;
+    get m24(): any;
+    get m31(): any;
+    get m32(): any;
+    get m33(): any;
+    get m34(): any;
+    get m41(): any;
+    get m42(): any;
+    get m43(): any;
+    get m44(): any;
+    set m11(v: any);
+    set m12(v: any);
+    set m13(v: any);
+    set m14(v: any);
+    set m21(v: any);
+    set m22(v: any);
+    set m23(v: any);
+    set m24(v: any);
+    set m31(v: any);
+    set m32(v: any);
+    set m33(v: any);
+    set m34(v: any);
+    set m41(v: any);
+    set m42(v: any);
+    set m43(v: any);
+    set m44(v: any);
+    get a(): any;
+    get b(): any;
+    get c(): any;
+    get d(): any;
+    get e(): any;
+    get f(): any;
+    set a(v: any);
+    set b(v: any);
+    set c(v: any);
+    set d(v: any);
+    set e(v: any);
+    set f(v: any);
+    static init(init: Iterable<number>, mapfn: (v: number, k: number) => number, thisArg?: any): Matrix;
+    clone(): Matrix;
+    setIdentity(): this;
+    static identity(): Matrix;
+    static add(m1: Matrix, m2: Matrix): Matrix;
+    add(m: Matrix): Matrix;
+    static sub(m1: Matrix, m2: Matrix): Matrix;
+    sub(m: Matrix): Matrix;
+    setTranslation(x: number, y: number, z: number): this;
+    setRotation(angle: number, axis: Vec3): this;
+    setScale(x: number, y: number, z: number): this;
+    setRotationX(angle: number): this;
+    setRotationY(angle: number): this;
+    setRotationZ(angle: number): this;
+    setRotationXYZ(yaw: number, pitch: number, roll: number): this;
+    static translate(mat: Matrix, vec: Vector3): Matrix;
+    translate(vec: Vector3): Matrix;
+    static transpose(mat: Matrix): any[];
+    transpose(): any[];
+    static multiply(mat1: Matrix, t: Matrix | Vector4): number[] | Vec4;
+    multiply(t: Matrix | Vector4): number[] | Vec4;
+    valueOf(): ArrayEx;
+    toString(): string;
+    static perspective(fov: number, aspect: number, near: number, far: number): number[];
+    static orthographic(right: number, top: number, near: number, far: number): number[];
+    static lookAt(eye: Vector3, target: Vector3, up: Vector3): number[];
+}
+
+/**
+ * Client
+ */
+declare class GRegistry {
+    /**
+     * 生成注册器
+     * @param {string} name 文件名字
+     * @param {string} root 根目录，如 "behavior"、"resource" 等
+     * @param {string} path 数据的路径，如 "blocks/"、"items/"、"recipes/" 等
+     * @param {string} data 实例 必须包含 toJson 方法
+     */
+    static register(name: string, root: string, path: string, data: string): void;
+    static submit(): void;
+}
+declare namespace registry {
+    function sumbit(): void;
+    function log(...info: any[]): void;
+}
+
 declare class Item {
     /**
      * 物品类
@@ -502,7 +683,7 @@ declare class BasicEntity {
     is_spawnable: boolean;
     is_summonable: boolean;
     runtime_identifier: string | undefined;
-    properties: Map<string, any>;
+    properties: any;
     components: Map<string, any>;
     component_groups: Map<string, any>;
     events: Map<string, any>;
@@ -597,6 +778,14 @@ declare class AddonClientEntityDescription {
     constructor(identifier: string, min_engine_version: string);
     identifier: string;
     min_engine_version: string;
+    /**
+     * 注册粒子效果
+     * @param {string} name 组件名称
+     * @param {Object} component 组件数据
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+    */
+    addParticleEffect(name: string, particle: any): AddonClientEntityDescription;
+    particle_effects: {} | undefined;
     /**
      * 添加材质
      * @param {string} name 材质名称
@@ -706,6 +895,10 @@ declare namespace EntityAPI {
         behavior: BasicEntity;
         resource: ClientEntity;
     };
+    function createDummyEntity(identifier: string, texture: string, options: Object | undefined, behData: Object, resData: Object): {
+        behavior: BasicEntity;
+        resource: ClientEntity;
+    };
 }
 
 declare class AddonRecipe {
@@ -1913,13 +2106,13 @@ declare class DataBindingObject {
 
 declare const ServerFormSystem: UISystem;
 declare class ServerUISystem {
-    static "__#4256@#binding_map": Map<any, any>;
-    static "__#4256@#binding_title_list": any[];
+    static "__#6307@#binding_map": Map<any, any>;
+    static "__#6307@#binding_title_list": any[];
     static addBindingTitle(title_name: any): void;
     static getBindingTitleList(): any[];
     static getBindingContentList(): any[];
     static bindingTitlewithContent(title_name: any, content: any): void;
-    static "__#4256@#updateServerFormSystem"(): void;
+    static "__#6307@#updateServerFormSystem"(): void;
 }
 
 declare class ItemTextureManager {
@@ -1941,26 +2134,12 @@ declare namespace FlipbookTextures {
     function registerFlipbookTexture(atlas_tile: any, texture: any, ticks_per_frame: any, options?: {}): void;
 }
 
-declare class GRegistry {
-    static dataList: any[];
-    /**
-     * 生成注册器
-     * @param {string} name 文件名字
-     * @param {string} root 根目录，如 "behavior"、"resource" 等
-     * @param {string} path 数据的路径，如 "blocks/"、"items/"、"recipes/" 等
-     * @param {string} data 实例 必须包含 toJson 方法
-     */
-    static register(name: string, root: string, path: string, data: string): void;
-    static getDataList(): any[];
-}
-
 declare class UISystemRegistry {
-    static "__#4255@#ui_system_map": Map<any, any>;
-    static "__#4255@#ui_def_list": any[];
+    static "__#6305@#ui_system_map": {};
+    static "__#6305@#ui_def_list": any[];
     static registerUISystem(ui_system: any): void;
-    static getUISystemList(): any[];
     static addOuterUIdefs(ui_defs: any): void;
-    static getUIdefList(): any[];
+    static submit(): void;
 }
 
 declare class CollectionPanel extends UIElement {
@@ -2059,4 +2238,4 @@ declare class StackPanel extends Panel {
     setOrientation(orientation: any): this;
 }
 
-export { BlockAPI, BlockComponent, DataBindingObject, EntityAPI, FeatureAPI, FlipbookTextures, GRegistry, Grid, Image, ItemAPI, ItemCategory, ItemComponent, ItemTextureManager, Label, Panel, RecipeAPI, ServerFormSystem, ServerUISystem, StackPanel, UIElement, UISystem, UISystemRegistry, terrainTextureManager };
+export { BlockAPI, BlockComponent, type ConstructorOf, DataBindingObject, EntityAPI, FeatureAPI, FlipbookTextures, GRegistry, Grid, type ISerializer, Image, ItemAPI, ItemCategory, ItemComponent, ItemTextureManager, Label, Matrix, Panel, RecipeAPI, Serializable, Serializer, ServerFormSystem, ServerUISystem, StackPanel, UIElement, UISystem, UISystemRegistry, Vec3, Vec4, type Vector3, type Vector4, getMetadata, getOrCreateMetadata, registry, serialize, terrainTextureManager };