sapdon 2.0.2 → 3.0.0

package/dist/core/feature-rule/condition/featureConditions.js

@@ -0,0 +1,37 @@
+import { BiomeFilter } from "./biomeFilter.js";
+/**
+ * 表示功能规则生成条件的类
+ */
+export class FeatureConditions {
+    constructor() {
+        this.conditions = {
+            placement_pass: "underground_pass", // 默认值
+            "minecraft:biome_filter": []
+        };
+    }
+    /**
+     * 设置生成阶段（placement_pass）
+     * @param {string} pass - 生成阶段标识符（如 "underground_pass"）
+     * @returns {FeatureConditions} 返回自身以支持链式调用
+     */
+    setPlacementPass(pass) {
+        this.conditions.placement_pass = pass;
+        return this;
+    }
+    /**
+     * 设置生物群系过滤器
+     * @param {BiomeFilter} biomeFilter - 生物群系过滤条件对象
+     * @returns {FeatureConditions} 返回自身以支持链式调用
+     */
+    setBiomeFilter(biomeFilter) {
+        this.conditions["minecraft:biome_filter"] = biomeFilter.toJson();
+        return this;
+    }
+    /**
+     * 转换为 JSON 格式
+     * @returns {Object} 返回生成条件对象
+     */
+    toJson() {
+        return this.conditions;
+    }
+}

package/dist/core/feature-rule/distribution/coordinateDistribution.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 表示单个坐标轴（x/y/z）分布规则的类
+ */
+export class CoordinateDistribution {
+    /**
+     * @param {"uniform" | "triangle"} distribution - 分布类型
+     * @param {Array<number>} extent - 范围（如 [0, 16]）
+     */
+    constructor(distribution?: "uniform" | "triangle", extent?: Array<number>);
+    distribution: "triangle" | "uniform";
+    extent: number[];
+    /**
+     * 转换为 JSON 格式
+     * @returns {Object} 返回坐标分布配置
+     */
+    toJson(): any;
+}

package/dist/core/feature-rule/distribution/coordinateDistribution.js

@@ -0,0 +1,23 @@
+/**
+ * 表示单个坐标轴（x/y/z）分布规则的类
+ */
+export class CoordinateDistribution {
+    /**
+     * @param {"uniform" | "triangle"} distribution - 分布类型
+     * @param {Array<number>} extent - 范围（如 [0, 16]）
+     */
+    constructor(distribution = "uniform", extent = [0, 16]) {
+        this.distribution = distribution;
+        this.extent = extent;
+    }
+    /**
+     * 转换为 JSON 格式
+     * @returns {Object} 返回坐标分布配置
+     */
+    toJson() {
+        return {
+            distribution: this.distribution,
+            extent: this.extent
+        };
+    }
+}

package/dist/core/feature-rule/distribution/featureDistribution.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 表示功能规则分布配置的类
+ */
+export class FeatureDistribution {
+    distribution: {
+        iterations: number;
+        coordinate_eval_order: string;
+        x: any;
+        y: any;
+        z: any;
+    };
+    /**
+     * 设置迭代次数
+     * @param {number} iterations - 放置尝试次数
+     * @returns {FeatureDistribution} 返回自身以支持链式调用
+     */
+    setIterations(iterations: number): FeatureDistribution;
+    /**
+     * 设置坐标轴的分布规则
+     * @param {"x" | "y" | "z"} axis - 坐标轴
+     * @param {CoordinateDistribution} config - 分布配置
+     * @returns {FeatureDistribution} 返回自身以支持链式调用
+     */
+    setAxisDistribution(axis: "x" | "y" | "z", config: CoordinateDistribution): FeatureDistribution;
+    /**
+     * 转换为 JSON 格式
+     * @returns {Object} 返回分布规则对象
+     */
+    toJson(): any;
+}
+import { CoordinateDistribution } from "./coordinateDistribution.js";

package/dist/core/feature-rule/distribution/featureDistribution.js

@@ -0,0 +1,41 @@
+import { CoordinateDistribution } from "./coordinateDistribution.js";
+/**
+ * 表示功能规则分布配置的类
+ */
+export class FeatureDistribution {
+    constructor() {
+        this.distribution = {
+            iterations: 10, // 默认值
+            coordinate_eval_order: "zyx",
+            x: new CoordinateDistribution().toJson(),
+            y: new CoordinateDistribution().toJson(),
+            z: new CoordinateDistribution().toJson()
+        };
+    }
+    /**
+     * 设置迭代次数
+     * @param {number} iterations - 放置尝试次数
+     * @returns {FeatureDistribution} 返回自身以支持链式调用
+     */
+    setIterations(iterations) {
+        this.distribution.iterations = iterations;
+        return this;
+    }
+    /**
+     * 设置坐标轴的分布规则
+     * @param {"x" | "y" | "z"} axis - 坐标轴
+     * @param {CoordinateDistribution} config - 分布配置
+     * @returns {FeatureDistribution} 返回自身以支持链式调用
+     */
+    setAxisDistribution(axis, config) {
+        this.distribution[axis] = config.toJson();
+        return this;
+    }
+    /**
+     * 转换为 JSON 格式
+     * @returns {Object} 返回分布规则对象
+     */
+    toJson() {
+        return this.distribution;
+    }
+}

package/dist/core/feature-rule/featureRule.d.ts

@@ -0,0 +1,17 @@
+export class FeatureRule {
+    constructor(identifier: any, places_feature: any);
+    identifier: any;
+    places_feature: any;
+    condition: FeatureConditions;
+    distribution: FeatureDistribution;
+    setPlacementPass(pass: any): void;
+    setBiomeFilter(biomeFilter: any): void;
+    setIterations(iterations: any): void;
+    setAxisDistribution(axis: any, config: any): void;
+    toJson(): {
+        format_version: any;
+        "minecraft:feature_rules": any;
+    };
+}
+import { FeatureConditions } from "./condition/featureConditions.js";
+import { FeatureDistribution } from "./distribution/featureDistribution.js";

package/dist/core/feature-rule/featureRule.js

@@ -0,0 +1,26 @@
+import { AddonFeatureRule, AddonFeatureRuleDecription, AddonFeatureRuleDenifition } from "../addon/featureRule.js";
+import { FeatureConditions } from "./condition/featureConditions.js";
+import { FeatureDistribution } from "./distribution/featureDistribution.js";
+export class FeatureRule {
+    constructor(identifier, places_feature) {
+        this.identifier = identifier;
+        this.places_feature = places_feature;
+        this.condition = new FeatureConditions();
+        this.distribution = new FeatureDistribution();
+    }
+    setPlacementPass(pass) {
+        this.condition.setPlacementPass(pass);
+    }
+    setBiomeFilter(biomeFilter) {
+        this.condition.setBiomeFilter(biomeFilter);
+    }
+    setIterations(iterations) {
+        this.distribution.setIterations(iterations);
+    }
+    setAxisDistribution(axis, config) {
+        this.distribution.setAxisDistribution(axis, config);
+    }
+    toJson() {
+        return new AddonFeatureRule("1.13.0", new AddonFeatureRuleDenifition(new AddonFeatureRuleDecription(this.identifier, this.places_feature), this.condition.toJson(), this.distribution.toJson())).toJson();
+    }
+}

package/dist/core/index.d.ts

@@ -0,0 +1,24 @@
+export * from "./factory/itemExtra.js";
+import { ItemAPI } from "./factory/itemFactory.js";
+import { BlockAPI } from "./factory/blockFactory.js";
+import { FeatureAPI } from "./factory/featureFactory.js";
+import { EntityAPI } from "./factory/entityFactory.js";
+import { RecipeAPI } from "./factory/recipeFactory.js";
+import { BlockComponent } from "./block/blockComponent.js";
+import { ItemComponent } from "./item/itemComponents.js";
+import { Image } from "./ui/elements/image.js";
+import { Panel } from "./ui/elements/panel.js";
+import { Label } from "./ui/elements/label.js";
+import { UIElement } from "./ui/elements/uiElement.js";
+import { UISystem } from "./ui/systems/system.js";
+import { DataBindingObject } from "./ui/dataBindingObject.js";
+import { ServerUISystem } from "./ui/systems/serverForm.js";
+import { ServerFormSystem } from "./ui/systems/serverForm.js";
+import { ItemTextureManager } from "./texture.js";
+import { terrainTextureManager } from "./texture.js";
+import { FlipbookTextures } from "./texture.js";
+import { GRegistry } from "./registry.js";
+import { UISystemRegistry } from "./ui/registry/uiSystemRegistry.js";
+import { Grid } from "./ui/elements/grid.js";
+import { StackPanel } from "./ui/elements/stackPanel.js";
+export { ItemAPI, BlockAPI, FeatureAPI, EntityAPI, RecipeAPI, BlockComponent, ItemComponent, Image, Panel, Label, UIElement, UISystem, DataBindingObject, ServerUISystem, ServerFormSystem, ItemTextureManager, terrainTextureManager, FlipbookTextures, GRegistry, UISystemRegistry, Grid, StackPanel };

package/dist/core/index.js

@@ -0,0 +1,21 @@
+import { BlockComponent } from "./block/blockComponent.js";
+import { BlockAPI } from "./factory/blockFactory.js";
+import { EntityAPI } from "./factory/entityFactory.js";
+import { FeatureAPI } from "./factory/featureFactory.js";
+import { ItemAPI } from "./factory/itemFactory.js";
+import { RecipeAPI } from "./factory/recipeFactory.js";
+import { GRegistry } from "./registry.js";
+import { ItemComponent } from "./item/itemComponents.js";
+import { FlipbookTextures, ItemTextureManager, terrainTextureManager } from "./texture.js";
+import { DataBindingObject } from "./ui/dataBindingObject.js";
+import { Grid } from "./ui/elements/grid.js";
+import { Image } from "./ui/elements/image.js";
+import { Label } from "./ui/elements/label.js";
+import { Panel } from "./ui/elements/panel.js";
+import { StackPanel } from "./ui/elements/stackPanel.js";
+import { UIElement } from "./ui/elements/uiElement.js";
+import { UISystemRegistry } from "./ui/registry/uiSystemRegistry.js";
+import { ServerFormSystem, ServerUISystem } from "./ui/systems/serverForm.js";
+import { UISystem } from "./ui/systems/system.js";
+export { ItemAPI, BlockAPI, FeatureAPI, EntityAPI, RecipeAPI, BlockComponent, ItemComponent, Image, Panel, Label, UIElement, UISystem, DataBindingObject, ServerUISystem, ServerFormSystem, ItemTextureManager, terrainTextureManager, FlipbookTextures, GRegistry, UISystemRegistry, Grid, StackPanel };
+export * from './factory/itemExtra.js';

package/dist/core/item/armor.d.ts

@@ -0,0 +1,21 @@
+export class Armor {
+    constructor(identifier: any, category: any, item_texture: any, texture_path: any, options?: {});
+    identifier: any;
+    item: Item;
+    attachable: Attachable;
+    setArrachableGeometry(key: any, geometry: any): this;
+}
+export class Chestplate extends Armor {
+    constructor(identifier: any, item_texture: any, texture_path: any, options?: {});
+}
+export class Boot extends Armor {
+    constructor(identifier: any, item_texture: any, texture_path: any, options?: {});
+}
+export class Leggings extends Armor {
+    constructor(identifier: any, item_texture: any, texture_path: any, options?: {});
+}
+export class Helmet extends Armor {
+    constructor(identifier: any, item_texture: any, texture_path: any, options?: {});
+}
+import { Item } from "./item.js";
+import { Attachable } from "./attachable.js";

package/dist/core/item/armor.js

@@ -0,0 +1,90 @@
+import { Attachable } from "./attachable.js";
+import { Item } from "./item.js";
+import { ItemComponent } from "./itemComponents.js";
+// 定义 Armor 基类
+export class Armor {
+    constructor(identifier, category, item_texture, texture_path, options = {}) {
+        this.identifier = identifier;
+        //默认分组
+        options["group"] = "minecraft:itemGroup.name.chestplate";
+        // 创建物品
+        this.item = new Item(identifier, category, item_texture, options);
+        // 创建附加物
+        this.attachable = new Attachable(identifier);
+        // 配置附加物
+        this.attachable
+            .addTexture("default", texture_path) // 添加默认纹理
+            .addMaterial("default", "armor") // 添加默认材质
+            .addMaterial("enchanted", "armor_enchanted") // 添加附魔材质
+            .addTexture("default", texture_path)
+            .addTexture("enchanted", "textures/misc/enchanted_actor_glint") // 添加附魔纹理
+            .addRenderController("controller.render.armor") // 添加渲染控制器
+            //默认类型 胸甲
+            .addGeometry("default", "geometry.player.armor.chestplate") // 添加几何模型
+            .setScript("parent_setup", "v.chest_layer_visible = 0.0;"); // 设置脚本
+    }
+    setArrachableGeometry(key, geometry) {
+        this.attachable.addGeometry(key, geometry);
+        return this;
+    }
+}
+// 扩展 Armor 类，实现胸甲
+export class Chestplate extends Armor {
+    constructor(identifier, item_texture, texture_path, options = {}) {
+        super(identifier, "equipment", item_texture, texture_path, options);
+        options["group"] = "minecraft:itemGroup.name.chestplate";
+        //头盔专属
+        this.attachable.addGeometry("default", "geometry.player.armor.chestplate") // 添加几何模型
+            .setScript("parent_setup", "v.chest_layer_visible = 0.0;"); // 设置脚本
+        // 自定义胸甲物品
+        this.item.addComponent(ItemComponent.combineComponents(ItemComponent.setDisplayName("我的自定义胸甲"), // 设置显示名称
+        ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
+        ItemComponent.setWearable(5, "slot.armor.chest") // 设置为可穿戴，并指定装备槽
+        ));
+    }
+}
+// 扩展 Armor 类，实现靴子
+export class Boot extends Armor {
+    constructor(identifier, item_texture, texture_path, options = {}) {
+        super(identifier, "equipment", item_texture, texture_path, options);
+        options["group"] = "minecraft:itemGroup.name.boots";
+        //头盔专属
+        this.attachable.addGeometry("default", "geometry.player.armor.boots") // 添加几何模型
+            .setScript("parent_setup", "v.boot_layer_visible = 0.0;"); // 设置脚本
+        // 自定义靴子物品
+        this.item.addComponent(ItemComponent.combineComponents(ItemComponent.setDisplayName("我的自定义靴子"), // 设置显示名称
+        ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
+        ItemComponent.setWearable(4, "slot.armor.feet") // 设置为可穿戴，并指定装备槽
+        ));
+    }
+}
+// 扩展 Armor 类，实现裤子
+export class Leggings extends Armor {
+    constructor(identifier, item_texture, texture_path, options = {}) {
+        super(identifier, "equipment", item_texture, texture_path, options);
+        options["group"] = "minecraft:itemGroup.name.leggings";
+        //头盔专属
+        this.attachable.addGeometry("default", "geometry.player.armor.leggings") // 添加几何模型
+            .setScript("parent_setup", "v.leg_layer_visible = 0.0;"); // 设置脚本
+        // 自定义裤子物品
+        this.item.addComponent(ItemComponent.combineComponents(ItemComponent.setDisplayName("我的自定义裤子"), // 设置显示名称
+        ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
+        ItemComponent.setWearable(6, "slot.armor.legs") // 设置为可穿戴，并指定装备槽
+        ));
+    }
+}
+// 扩展 Armor 类，实现头盔
+export class Helmet extends Armor {
+    constructor(identifier, item_texture, texture_path, options = {}) {
+        super(identifier, "equipment", item_texture, texture_path, options);
+        options["group"] = "minecraft:itemGroup.name.helmet";
+        //头盔专属
+        this.attachable.addGeometry("default", "geometry.player.armor.helmet") // 添加几何模型
+            .setScript("parent_setup", "v.helmet_layer_visible = 0.0;"); // 设置脚本
+        // 自定义头盔物品
+        this.item.addComponent(ItemComponent.combineComponents(ItemComponent.setDisplayName("我的自定义头盔"), // 设置显示名称
+        ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
+        ItemComponent.setWearable(3, "slot.armor.head") // 设置为可穿戴，并指定装备槽
+        ));
+    }
+}

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

@@ -0,0 +1,6 @@
+export class Attachable extends AddonAttachableDescription {
+    constructor(identifier: any);
+    getId(): string;
+    toJson(): any;
+}
+import { AddonAttachableDescription } from "../addon/item/attachable.js";

package/dist/core/item/attachable.js

@@ -0,0 +1,26 @@
+import { AddonAttachable, AddonAttachableDefinition, AddonAttachableDescription } from "../addon/item/attachable.js";
+export class Attachable extends AddonAttachableDescription {
+    constructor(identifier) {
+        super(identifier);
+    }
+    getId() {
+        return this.identifier;
+    }
+    toJson() {
+        const entity = new AddonAttachable("1.8.0", new AddonAttachableDefinition(this));
+        return entity.toJson();
+    }
+}
+/*
+const attachable = new Attachable("test")
+      attachable.addMaterial("default", "armor")
+      attachable.addMaterial("enchanted","armor_enchanted")
+      attachable.addTexture("default","textures/models/armor/custom_main")
+      attachable.addTexture("enchanted", "textures/misc/enchanted_actor_glint")
+      attachable.addGeometry("default", "geometry.player.armor.chestplate")
+      attachable.addRenderController("controller.render.armor")
+      attachable.setScript("parent_setup","v.chest_layer_visible = 0.0;")
+
+      console.log(JSON.stringify(attachable.toJson(),null,2))
+debugger
+*/ 

package/dist/core/item/food.d.ts

@@ -0,0 +1,24 @@
+export class Food extends Item {
+    /**
+     * 物品类
+     * @param {string} identifier 物品唯一标识符
+     * @param {string} category 菜单栏分类 可选："construction", "nature", "equipment", "items", and "none"
+     * @param {string} texture 物品纹理
+     * @param {Object} options 可选参数
+     * @param {string} options.group 分组
+     * @param {boolean} options.hide_in_command 是否在命令中隐藏，默认为 false
+     * @param {string} options.animation 使用动画，默认为 "eat"
+     * @param {boolean} options.canAlwaysEat 是否总是可以食用，默认为 false
+     * @param {number} options.nutrition 营养价值，默认为 0
+     * @param {number} options.saturationModifier 饱和度修正值，默认为 1
+     */
+    constructor(identifier: string, category: string, texture: string, options?: {
+        group: string;
+        hide_in_command: boolean;
+        animation: string;
+        canAlwaysEat: boolean;
+        nutrition: number;
+        saturationModifier: number;
+    });
+}
+import { Item } from "./item.js";

package/dist/core/item/food.js

@@ -0,0 +1,38 @@
+import { ItemComponent } from "./itemComponents.js";
+import { Item } from "./item.js";
+export class Food extends Item {
+    /**
+     * 物品类
+     * @param {string} identifier 物品唯一标识符
+     * @param {string} category 菜单栏分类 可选："construction", "nature", "equipment", "items", and "none"
+     * @param {string} texture 物品纹理
+     * @param {Object} options 可选参数
+     * @param {string} options.group 分组
+     * @param {boolean} options.hide_in_command 是否在命令中隐藏，默认为 false
+     * @param {string} options.animation 使用动画，默认为 "eat"
+     * @param {boolean} options.canAlwaysEat 是否总是可以食用，默认为 false
+     * @param {number} options.nutrition 营养价值，默认为 0
+     * @param {number} options.saturationModifier 饱和度修正值，默认为 1
+     */
+    constructor(identifier, category, texture, options = {}) {
+        // 继承父类
+        super(identifier, category, texture, options);
+        // 解构 options 并设置默认值
+        const { animation = "eat", movement = 1, useDuration = 1, canAlwaysEat = false, nutrition = 0, saturationModifier = 1, } = options;
+        // 参数验证
+        if (typeof nutrition !== "number" || nutrition < 0) {
+            throw new Error('nutrition 必须是一个非负数');
+        }
+        if (typeof saturationModifier !== "number" || saturationModifier <= 0) {
+            throw new Error('saturationModifier 必须是一个正数');
+        }
+        if (typeof animation !== "string") {
+            throw new Error('animation 必须是字符串类型');
+        }
+        if (typeof canAlwaysEat !== "boolean") {
+            throw new Error('canAlwaysEat 必须是布尔类型');
+        }
+        // 添加组件
+        this.addComponent(ItemComponent.combineComponents(ItemComponent.setUseModifiers(movement, useDuration), ItemComponent.setFoodComponent(canAlwaysEat, nutrition, saturationModifier), ItemComponent.setUseAnimation(animation)));
+    }
+}

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

@@ -0,0 +1,36 @@
+export class Item {
+    /**
+     * 物品类
+     * @param {string} identifier 物品唯一标识符
+     * @param {string} category 菜单栏分类 可选："construction", "nature", "equipment", "items", and "none"
+     * @param {string} texture 物品纹理
+     * @param {Object} options 可选参数
+     * @param {string} options.group 分组
+     * @param {boolean} options.hide_in_command 是否在命令中隐藏，默认为 false
+     */
+    constructor(identifier: string, category: string, texture: string, options?: {
+        group: string;
+        hide_in_command: boolean;
+    });
+    identifier: string;
+    category: string;
+    texture: string;
+    group: string;
+    hide_in_command: boolean;
+    components: Map<any, any>;
+    /**
+     * 添加组件
+     * @param {Map} componentMap 组件 Map
+     */
+    addComponent(componentMap: Map<any, any>): this;
+    /**
+     * 移除组件
+     * @param {string} key 组件名称
+     */
+    removeComponent(key: string): this;
+    /**
+     * 将物品转换为 JSON 格式
+     * @returns {Object} JSON 格式的物品对象
+     */
+    toJson(): any;
+}

package/dist/core/item/item.js

@@ -0,0 +1,69 @@
+import { ItemComponent } from "./itemComponents.js";
+import { AddonItem, AddonItemDefinition, AddonItemDescription } from "../addon/item/item.js";
+import { AddonMenuCategory } from "../addon/menuCategory.js";
+export class Item {
+    /**
+     * 物品类
+     * @param {string} identifier 物品唯一标识符
+     * @param {string} category 菜单栏分类 可选："construction", "nature", "equipment", "items", and "none"
+     * @param {string} texture 物品纹理
+     * @param {Object} options 可选参数
+     * @param {string} options.group 分组
+     * @param {boolean} options.hide_in_command 是否在命令中隐藏，默认为 false
+     */
+    constructor(identifier, category, texture, options = {}) {
+        // 参数校验
+        if (!identifier || typeof identifier !== "string") {
+            throw new Error("identifier is required and must be a string");
+        }
+        if (!category || typeof category !== "string") {
+            throw new Error("category is required and must be a string");
+        }
+        if (!texture || typeof texture !== "string") {
+            throw new Error("texture is required and must be a string");
+        }
+        const { group, hide_in_command = false, max_stack_size = 64, } = options;
+        this.identifier = identifier;
+        this.category = category;
+        this.texture = texture;
+        this.group = group;
+        this.hide_in_command = hide_in_command;
+        this.components = new Map();
+        // 初始化默认组件
+        this.addComponent(ItemComponent.combineComponents(ItemComponent.setIcon(this.texture), ItemComponent.setMaxStackSize(max_stack_size)));
+    }
+    /**
+     * 添加组件
+     * @param {Map} componentMap 组件 Map
+     */
+    addComponent(componentMap) {
+        if (!componentMap || !(componentMap instanceof Map)) {
+            throw new Error("componentMap is required and must be a Map");
+        }
+        for (const [key, value] of componentMap.entries()) {
+            this.components.set(key, value);
+        }
+        return this;
+    }
+    /**
+     * 移除组件
+     * @param {string} key 组件名称
+     */
+    removeComponent(key) {
+        if (!key || typeof key !== "string") {
+            throw new Error("key is required and must be a string");
+        }
+        this.components.delete(key);
+        return this;
+    }
+    /**
+     * 将物品转换为 JSON 格式
+     * @returns {Object} JSON 格式的物品对象
+     */
+    toJson() {
+        const item = new AddonItem("1.21.40", // 格式版本
+        new AddonItemDefinition(new AddonItemDescription(this.identifier, new AddonMenuCategory(this.category, this.group, this.hide_in_command)), Object.fromEntries(this.components) // 将 Map 转换为普通对象
+        ));
+        return item.toJson();
+    }
+}