sapdon 2.0.2 → 3.0.0

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

@@ -0,0 +1,73 @@
+export class AddonAnimationController {
+    constructor(format_version, definition) {
+        this.format_version = format_version;
+        this.definition = definition;
+    }
+    toJson() {
+        return {
+            format_version: this.format_version,
+            ["animation_controllers"]: this.definition
+        };
+    }
+}
+export class AddonAnimationStateMachine {
+    constructor(identifier) {
+        this.identifier = identifier; // 状态机的唯一标识符（例如 "helicopter.blade"）
+        this.namespace = identifier.split(":")[0]; // 标识符的命名空间部分（冒号前的部分）
+        this.name = identifier.split(":")[1]; // 标识符的名称部分（冒号后的部分）
+        // 状态机属性
+        this.initialState = null; // 状态机的初始状态
+        this.states = new Map(); // 使用 Map 存储所有状态，键为状态名，值为状态数据
+    }
+    /**
+     * 设置状态机的初始状态。
+     * @param {string} stateName - 初始状态的名称。
+     * @returns {AddonAnimationStateMachine} - 返回实例以支持链式调用。
+     */
+    setInitialState(stateName) {
+        this.initialState = stateName;
+        return this; // 支持链式调用
+    }
+    /**
+     * 添加一个新状态到状态机。
+     * @param {string} stateName - 状态的名称。
+     * @param {string[]} animations - 该状态播放的动画列表。
+     * @returns {AddonAnimationStateMachine} - 返回实例以支持链式调用。
+     */
+    addState(stateName, animations = []) {
+        this.states.set(stateName, {
+            animations: animations, // 该状态的动画列表
+            transitions: [] // 该状态的过渡条件列表
+        });
+        return this; // 支持链式调用
+    }
+    /**
+     * 添加一个状态之间的过渡条件。
+     * @param {string} fromState - 过渡的起始状态名称。
+     * @param {string} toState - 过渡的目标状态名称。
+     * @param {string} condition - 触发过渡的条件（例如 "q.is_on_ground"）。
+     * @returns {AddonAnimationStateMachine} - 返回实例以支持链式调用。
+     */
+    addTransition(fromState, toState, condition) {
+        if (!this.states.has(fromState)) {
+            throw new Error(`状态 "${fromState}" 不存在。`);
+        }
+        const state = this.states.get(fromState);
+        state.transitions.push({
+            [toState]: condition // 添加过渡条件
+        });
+        return this; // 支持链式调用
+    }
+    /**
+     * 将整个状态机转换为 JSON 兼容的对象。
+     * @returns {object} - 包含格式版本的完整动画控制器定义。
+     */
+    toJson() {
+        return {
+            [`controller.animation.${this.namespace}.${this.name}`]: {
+                initial_state: this.initialState,
+                states: Object.fromEntries(this.states)
+            }
+        };
+    }
+}

package/dist/core/addon/entity/clientEntity.d.ts

@@ -0,0 +1,107 @@
+export class AddonClientEntity {
+    /**
+     * 客户端实体类
+     * @param {string} format_version 格式版本
+     * @param {AddonClientEntityDefinition} definitions 实体定义
+     */
+    constructor(format_version: string, definitions: AddonClientEntityDefinition);
+    format_version: string;
+    definitions: AddonClientEntityDefinition;
+    /**
+     * 将对象转换为 JSON 格式
+     * @returns {Object} JSON 对象
+     */
+    toJson(): any;
+}
+export class AddonClientEntityDefinition {
+    /**
+     * 客户端实体定义类
+     * @param {Description} description 实体描述
+     */
+    constructor(description: Description);
+    description: Description;
+}
+export class AddonClientEntityDescription {
+    /**
+     * 实体描述类
+     * @param {string} identifier 实体标识符
+     * @param {string} min_engine_version 最低引擎版本
+     */
+    constructor(identifier: string, min_engine_version: string);
+    identifier: string;
+    min_engine_version: string;
+    /**
+     * 添加材质
+     * @param {string} name 材质名称
+     * @param {string} material 材质路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addMaterial(name: string, material: string): AddonClientEntityDescription;
+    materials: {};
+    /**
+     * 添加纹理
+     * @param {string} name 纹理名称
+     * @param {string} texture 纹理路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addTexture(name: string, texture: string): AddonClientEntityDescription;
+    textures: {};
+    /**
+     * 添加几何体
+     * @param {string} name 几何体名称
+     * @param {string} geometry 几何体路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addGeometry(name: string, geometry: string): AddonClientEntityDescription;
+    geometry: {};
+    /**
+     * 添加动画
+     * @param {string} name 动画名称
+     * @param {string} animation 动画路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addAnimation(name: string, animation: string): AddonClientEntityDescription;
+    animations: {};
+    /**
+     * 添加动画控制器
+     * @param {string} name 控制器名称
+     * @param {string} controller 控制器路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addAnimationController(name: string, controller: string): AddonClientEntityDescription;
+    animation_controllers: any[];
+    /**
+     * 添加渲染控制器
+     * @param {string} controller 渲染控制器路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addRenderController(controller: string): AddonClientEntityDescription;
+    render_controllers: any[];
+    /**
+     * 添加定位器
+     * @param {string} name 定位器名称
+     * @param {Object} locator 定位器数据
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addLocator(name: string, locator: any): AddonClientEntityDescription;
+    locators: {};
+    /**
+     * 设置生成蛋
+     * @param {string} texture 生成蛋纹理
+     * @param {number} texture_index 生成蛋纹理索引
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    setSpawnEgg(texture: string, texture_index: number): AddonClientEntityDescription;
+    spawn_egg: {
+        texture: string;
+        texture_index: number;
+    };
+    /**
+     * 设置脚本
+     * @param {string} key 脚本键
+     * @param {string} value 脚本值
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    setScript(key: string, value: string): AddonClientEntityDescription;
+    scripts: {};
+}

package/dist/core/addon/entity/clientEntity.js

@@ -0,0 +1,149 @@
+export class AddonClientEntity {
+    /**
+     * 客户端实体类
+     * @param {string} format_version 格式版本
+     * @param {AddonClientEntityDefinition} definitions 实体定义
+     */
+    constructor(format_version, definitions) {
+        this.format_version = format_version;
+        this.definitions = definitions;
+    }
+    /**
+     * 将对象转换为 JSON 格式
+     * @returns {Object} JSON 对象
+     */
+    toJson() {
+        return {
+            format_version: this.format_version,
+            ["minecraft:client_entity"]: this.definitions
+        };
+    }
+}
+export class AddonClientEntityDefinition {
+    /**
+     * 客户端实体定义类
+     * @param {Description} description 实体描述
+     */
+    constructor(description) {
+        this.description = description;
+    }
+}
+export class AddonClientEntityDescription {
+    /**
+     * 实体描述类
+     * @param {string} identifier 实体标识符
+     * @param {string} min_engine_version 最低引擎版本
+     */
+    constructor(identifier, min_engine_version) {
+        this.identifier = identifier;
+        this.min_engine_version = min_engine_version;
+    }
+    /**
+     * 添加材质
+     * @param {string} name 材质名称
+     * @param {string} material 材质路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addMaterial(name, material) {
+        if (this.materials == undefined)
+            this.materials = {};
+        this.materials[name] = material;
+        return this;
+    }
+    /**
+     * 添加纹理
+     * @param {string} name 纹理名称
+     * @param {string} texture 纹理路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addTexture(name, texture) {
+        if (this.textures == undefined)
+            this.textures = {};
+        this.textures[name] = texture;
+        return this;
+    }
+    /**
+     * 添加几何体
+     * @param {string} name 几何体名称
+     * @param {string} geometry 几何体路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addGeometry(name, geometry) {
+        if (this.geometry == undefined)
+            this.geometry = {};
+        this.geometry[name] = geometry;
+        return this;
+    }
+    /**
+     * 添加动画
+     * @param {string} name 动画名称
+     * @param {string} animation 动画路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addAnimation(name, animation) {
+        if (this.animations == undefined)
+            this.animations = {};
+        this.animations[name] = animation;
+        return this;
+    }
+    /**
+     * 添加动画控制器
+     * @param {string} name 控制器名称
+     * @param {string} controller 控制器路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addAnimationController(name, controller) {
+        if (this.animation_controllers == undefined)
+            this.animation_controllers = [];
+        this.animation_controllers.push({ [name]: controller });
+        return this;
+    }
+    /**
+     * 添加渲染控制器
+     * @param {string} controller 渲染控制器路径
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addRenderController(controller) {
+        if (this.render_controllers == undefined)
+            this.render_controllers = [];
+        this.render_controllers.push(controller);
+        return this;
+    }
+    /**
+     * 添加定位器
+     * @param {string} name 定位器名称
+     * @param {Object} locator 定位器数据
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    addLocator(name, locator) {
+        if (this.locators == undefined)
+            this.locators = {};
+        this.locators[name] = locator;
+        return this;
+    }
+    /**
+     * 设置生成蛋
+     * @param {string} texture 生成蛋纹理
+     * @param {number} texture_index 生成蛋纹理索引
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    setSpawnEgg(texture, texture_index) {
+        this.spawn_egg = {
+            texture: texture,
+            texture_index: texture_index
+        };
+        return this;
+    }
+    /**
+     * 设置脚本
+     * @param {string} key 脚本键
+     * @param {string} value 脚本值
+     * @returns {AddonClientEntityDescription} 返回当前实例以支持链式调用
+     */
+    setScript(key, value) {
+        if (this.scripts == undefined)
+            this.scripts = {};
+        this.scripts[key] = value;
+        return this;
+    }
+}

package/dist/core/addon/entity/entity.d.ts

@@ -0,0 +1,42 @@
+export class AddonEntity {
+    /**
+     * 实体类
+     * @param {string} format_version 格式版本
+     * @param {AddonEntityDefinition} definitions 实体定义
+     */
+    constructor(format_version: string, definitions: AddonEntityDefinition);
+    format_version: string;
+    definitions: AddonEntityDefinition;
+    /**
+     * 将对象转换为 JSON 格式
+     * @returns {Object} JSON 对象
+     */
+    toJson(): any;
+}
+export class AddonEntityDefinition {
+    /**
+     * 实体定义类
+     * @param {AddonEntityDescription} description 实体描述
+     * @param {Object} components 实体组件
+     */
+    constructor(description: AddonEntityDescription, components?: any, component_groups?: {}, events?: {});
+    description: AddonEntityDescription;
+    components: any;
+    component_groups: {};
+    events: {};
+}
+export class AddonEntityDescription {
+    /**
+     * 实体描述类
+     * @param {string} identifier 实体标识符
+     * @param {boolean} is_spawnable 是否可生成
+     * @param {boolean} is_summonable 是否可召唤
+     * @param {string} runtime_identifier 复刻标识符
+     */
+    constructor(identifier: string, is_spawnable: boolean, is_summonable: boolean, properties: {}, runtime_identifier: string);
+    identifier: string;
+    is_spawnable: boolean;
+    is_summonable: boolean;
+    properties: {};
+    runtime_identifier: string;
+}

package/dist/core/addon/entity/entity.js

@@ -0,0 +1,50 @@
+export class AddonEntity {
+    /**
+     * 实体类
+     * @param {string} format_version 格式版本
+     * @param {AddonEntityDefinition} definitions 实体定义
+     */
+    constructor(format_version, definitions) {
+        this.format_version = format_version;
+        this.definitions = definitions;
+    }
+    /**
+     * 将对象转换为 JSON 格式
+     * @returns {Object} JSON 对象
+     */
+    toJson() {
+        return {
+            format_version: this.format_version,
+            ["minecraft:entity"]: this.definitions
+        };
+    }
+}
+export class AddonEntityDefinition {
+    /**
+     * 实体定义类
+     * @param {AddonEntityDescription} description 实体描述
+     * @param {Object} components 实体组件
+     */
+    constructor(description, components = {}, component_groups = {}, events = {}) {
+        this.description = description;
+        this.components = components; // 修正拼写错误
+        this.component_groups = component_groups;
+        this.events = events;
+    }
+}
+export class AddonEntityDescription {
+    /**
+     * 实体描述类
+     * @param {string} identifier 实体标识符
+     * @param {boolean} is_spawnable 是否可生成
+     * @param {boolean} is_summonable 是否可召唤
+     * @param {string} runtime_identifier 复刻标识符
+     */
+    constructor(identifier, is_spawnable = false, is_summonable = false, properties = {}, runtime_identifier) {
+        this.identifier = identifier;
+        this.is_spawnable = is_spawnable;
+        this.is_summonable = is_summonable;
+        this.properties = properties;
+        this.runtime_identifier = runtime_identifier;
+    }
+}

package/dist/core/addon/feature/oreFeature.d.ts

@@ -0,0 +1,19 @@
+export class AddonOreFeature {
+    constructor(format_version: any, definition: any);
+    format_version: any;
+    definition: any;
+    toJson(): {
+        format_version: any;
+        "minecraft:ore_feature": any;
+    };
+}
+export class AddonOreFeatureDescription {
+    constructor(identifier: any);
+    identifier: any;
+}
+export class AddonOreFeatureDefinition {
+    constructor(description: any, count: any, replace_rules: any);
+    description: any;
+    count: any;
+    replace_rules: any;
+}

package/dist/core/addon/feature/oreFeature.js

@@ -0,0 +1,24 @@
+export class AddonOreFeature {
+    constructor(format_version, definition) {
+        this.format_version = format_version;
+        this.definition = definition;
+    }
+    toJson() {
+        return {
+            format_version: this.format_version,
+            ["minecraft:ore_feature"]: this.definition
+        };
+    }
+}
+export class AddonOreFeatureDescription {
+    constructor(identifier) {
+        this.identifier = identifier;
+    }
+}
+export class AddonOreFeatureDefinition {
+    constructor(description, count, replace_rules) {
+        this.description = description;
+        this.count = count;
+        this.replace_rules = replace_rules;
+    }
+}

package/dist/core/addon/featureRule.d.ts

@@ -0,0 +1,20 @@
+export class AddonFeatureRule {
+    constructor(format_version: any, denifition: any);
+    format_version: any;
+    denifition: any;
+    toJson(): {
+        format_version: any;
+        "minecraft:feature_rules": any;
+    };
+}
+export class AddonFeatureRuleDenifition {
+    constructor(description: any, conditions: any, distribution: any);
+    description: any;
+    conditions: any;
+    distribution: any;
+}
+export class AddonFeatureRuleDecription {
+    constructor(identifier: any, places_feature: any);
+    identifier: any;
+    places_feature: any;
+}

package/dist/core/addon/featureRule.js

@@ -0,0 +1,25 @@
+export class AddonFeatureRule {
+    constructor(format_version, denifition) {
+        this.format_version = format_version;
+        this.denifition = denifition;
+    }
+    toJson() {
+        return {
+            format_version: this.format_version,
+            ["minecraft:feature_rules"]: this.denifition
+        };
+    }
+}
+export class AddonFeatureRuleDenifition {
+    constructor(description, conditions, distribution) {
+        this.description = description;
+        this.conditions = conditions;
+        this.distribution = distribution;
+    }
+}
+export class AddonFeatureRuleDecription {
+    constructor(identifier, places_feature) {
+        this.identifier = identifier;
+        this.places_feature = places_feature;
+    }
+}

package/dist/core/addon/item/attachable.d.ts

@@ -0,0 +1,94 @@
+export class AddonAttachable {
+    /**
+   * 可附着物类 继承客户端实体
+   * @param {string} format_version 格式版本
+   * @param {AddonAttachableDefinition} definitions 实体定义
+   */
+    constructor(format_version: string, definitions: AddonAttachableDefinition);
+    format_version: string;
+    definitions: AddonAttachableDefinition;
+    /**
+     * 将对象转换为 JSON 格式
+     * @returns {Object} JSON 对象
+     */
+    toJson(): any;
+}
+export class AddonAttachableDefinition {
+    /**
+     * 客户端实体定义类
+     * @param {Description} description 实体描述
+     */
+    constructor(description: Description);
+    description: Description;
+}
+export class AddonAttachableDescription {
+    /**
+     * 可附着物描述类
+     * @param {string} identifier 标识符
+     */
+    constructor(identifier: string);
+    identifier: string;
+    /**
+     * 添加材质
+     * @param {string} name 材质名称
+     * @param {string} material 材质路径
+     * @returns {AddonAttachableDescription} 返回当前实例以支持链式调用
+     */
+    addMaterial(name: string, material: string): AddonAttachableDescription;
+    materials: {};
+    /**
+     * 添加纹理
+     * @param {string} name 纹理名称
+     * @param {string} texture 纹理路径
+     * @returns {AddonAttachableDescription} 返回当前实例以支持链式调用
+     */
+    addTexture(name: string, texture: string): AddonAttachableDescription;
+    textures: {};
+    /**
+     * 添加几何体
+     * @param {string} name 几何体名称
+     * @param {string} geometry 几何体路径
+     * @returns {AddonAttachableDescription} 返回当前实例以支持链式调用
+     */
+    addGeometry(name: string, geometry: string): AddonAttachableDescription;
+    geometry: {};
+    /**
+     * 添加动画
+     * @param {string} name 动画名称
+     * @param {string} animation 动画路径
+     * @returns {AddonAttachableDescription} 返回当前实例以支持链式调用
+     */
+    addAnimation(name: string, animation: string): AddonAttachableDescription;
+    animations: {};
+    /**
+     * 添加动画控制器
+     * @param {string} name 控制器名称
+     * @param {string} controller 控制器路径
+     * @returns {AddonAttachableDescription} 返回当前实例以支持链式调用
+     */
+    addAnimationController(name: string, controller: string): AddonAttachableDescription;
+    animation_controllers: any[];
+    /**
+     * 添加渲染控制器
+     * @param {string} controller 渲染控制器路径
+     * @returns {AddonAttachableDescription} 返回当前实例以支持链式调用
+     */
+    addRenderController(controller: string): AddonAttachableDescription;
+    render_controllers: any[];
+    /**
+     * 添加定位器
+     * @param {string} name 定位器名称
+     * @param {Object} locator 定位器数据
+     * @returns {AddonAttachableDescription} 返回当前实例以支持链式调用
+     */
+    addLocator(name: string, locator: any): AddonAttachableDescription;
+    locators: {};
+    /**
+     * 设置脚本
+     * @param {string} key 脚本键
+     * @param {string} value 脚本值
+     * @returns {AddonAttachableDescription} 返回当前实例以支持链式调用
+     */
+    setScript(key: string, value: string): AddonAttachableDescription;
+    scripts: {};
+}