sapdon 2.0.0

package/src/core/addon/feature_rule.js

@@ -0,0 +1,29 @@
+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/src/core/addon/item/attachable.js

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

package/src/core/addon/item/item.js

@@ -0,0 +1,29 @@
+//item json的结构对应的class
+
+export class AddonItem {
+    constructor(format_version,definitions){
+        this.format_version = format_version;
+        //键名为 ["minecfat:item"]
+        this.definitions = definitions;
+    }
+    toJson(){
+        return {
+            format_version:this.format_version,
+            ["minecraft:item"]:this.definitions
+        }
+    }
+}
+
+export class AddonItemDefinition{
+    constructor(description,components){
+        this.description = description;
+        this.components = components;
+    }
+}
+
+export class AddonItemDescription{
+    constructor(identifier,menu_category){
+        this.identifier = identifier;
+        this.menu_category = menu_category;
+    }
+}

package/src/core/addon/manifest.js

@@ -0,0 +1,71 @@
+
+// 定义语义化版本号类
+export class AddonSemanticVersion {
+    constructor(major, minor, patch) {
+        this.major = major;
+        this.minor = minor;
+        this.patch = patch;
+    }
+
+    toString() {
+        return `[${this.major}, ${this.minor}, ${this.patch}]`;
+    }
+}
+
+// 定义头部信息类
+export class AddonManifestHeader {
+    constructor(name, description, version, uuid, options = {}) {
+        this.name = name;
+        this.description = description;
+        this.version = version;
+        this.uuid = uuid;
+        this.allow_random_seed = options.allow_random_seed;
+        this.lock_template_options = options.lock_template_options;
+        this.pack_scope = options.pack_scope;
+        this.base_game_version = options.base_game_version;
+        this.min_engine_version = options.min_engine_version;
+    }
+}
+
+// 定义模块信息类
+export class AddonManifestModule {
+    constructor(description, moduleType, uuid, version) {
+        this.description = description;
+        this.type = moduleType;
+        this.uuid = uuid;
+        this.version = version;
+    }
+}
+
+// 定义依赖信息类
+export class AddonManifestDependency {
+    constructor(name, uuid, version) {
+        this.module_name = name;
+        this.uuid = uuid;
+        this.version = version;
+    }
+}
+
+// 定义元数据信息类
+export class AddonManifestMetadata {
+    constructor(authors, license, generatedWith, productType, url) {
+        this.authors = authors;
+        this.license = license;
+        this.generated_with = generatedWith;
+        this.product_type = productType;
+        this.url = url;
+    }
+}
+
+// 定义清单文件类
+export class AddonManifest {
+    constructor(formatVersion, header, modules, dependencies, capabilities=null, metadata=null) {
+        this.format_version = formatVersion;
+        this.header = header;
+        this.modules = modules;
+        this.dependencies = dependencies;
+        if(capabilities != null) this.capabilities = capabilities;
+        if(metadata != null) this.metadata = metadata;
+    }
+}
+

package/src/core/addon/menu_category.js

@@ -0,0 +1,7 @@
+export class AddonMenuCategory{
+    constructor(category,group,is_hidden){
+        this.category = category;
+        this.group = group ;
+        this.is_hidden_in_commands = is_hidden;
+    }
+}

package/src/core/addon/recipe/data.js

@@ -0,0 +1,76 @@
+/**
+ * 原版可用于配方输入的标签列表 (1.19.50)
+ */
+export const RecipeInputTags = {
+	Armor: "minecraft:is_armor",
+	Arrows: "minecraft:arrow",
+	Banners: "minecraft:banner",
+	Boats: "minecraft:boats",
+	BookshelfBooks: "minecraft:bookshelf_books",
+	ChainmailTier: "minecraft:chainmail_tier",
+	ChestBoat: "minecraft:chest_boat",
+	Coals: "minecraft:coals",
+	Cooked: "minecraft:is_cooked",
+	CrimsonStems: "minecraft:crimson_stems",
+	DiamondTier: "minecraft:diamond_tier",
+	Digger: "minecraft:digger",
+	Door: "minecraft:door",
+	Fish: "minecraft:is_fish",
+	Food: "minecraft:is_food",
+	GoldenTier: "minecraft:golden_tier",
+	HangingActor: "minecraft:hanging_actor",
+	HangingSign: "minecraft:hanging_sign",
+	Hatchet: "minecraft:is_axe",
+	Hoe: "minecraft:is_hoe",
+	HorseArmor: "minecraft:horse_armor",
+	IronTier: "minecraft:iron_tier",
+	LeatherTier: "minecraft:leather_tier",
+	LecternBooks: "minecraft:lectern_books",
+	Logs: "minecraft:logs",
+	LogsThatBurn: "minecraft:logs_that_burn",
+	MangroveLogs: "minecraft:mangrove_logs",
+	Meat: "minecraft:is_meat",
+	Minecart: "minecraft:is_minecart",
+	MusicDiscs: "minecraft:music_disc",
+	NetheriteTier: "minecraft:netherite_tier",
+	Pickaxe: "minecraft:is_pickaxe",
+	PiglinLoved: "minecraft:piglin_loved",
+	PiglinRepellents: "minecraft:piglin_repellents",
+	Planks: "minecraft:planks",
+	Sand: "minecraft:sand",
+	Shovel: "minecraft:is_shovel",
+	Sign: "minecraft:sign",
+	SoulFireBaseBlocks: "minecraft:soul_fire_base_blocks",
+	SpawnEgg: "minecraft:spawn_egg",
+	StoneBricks: "minecraft:stone_bricks",
+	StoneCraftingMaterials: "minecraft:stone_crafting_materials",
+	StoneTier: "minecraft:stone_tier",
+	StoneToolMaterials: "minecraft:stone_tool_materials",
+	Sword: "minecraft:is_sword",
+	Tool: "minecraft:is_tool",
+	VibrationDamper: "minecraft:vibration_damper",
+	WarpedStems: "minecraft:warped_stems",
+	WoodenSlabs: "minecraft:wooden_slabs",
+	WoodenTier: "minecraft:wooden_tier",
+	Wool: "minecraft:wool"
+};
+
+/**
+ * 原版可用于配方的标签列表
+ */
+export const RecipeTags = {
+	Furnace: "furnace",
+	smoker: "smoker",
+	Campfire: "campfire",
+	SoulCampfire: "soul_campfire",
+	CraftingTable: "crafting_table"
+}
+
+/**
+ * 原版可用于配方的类型列表
+ */
+export const RecipeTypes = {
+	Furnace: "minecraft:recipe_furnace",
+	Shaped: "minecraft:recipe_shaped",
+	Shapeless: "minecraft:recipe_shapeless"
+};

package/src/core/addon/recipe/recipe.js

@@ -0,0 +1,27 @@
+export class AddonRecipe {
+	constructor(format_version, recipe_type, definitions = {}) {
+		this.format_version = format_version;
+		this.recipe_type = recipe_type;
+		this.definitions = definitions;
+	}
+	
+	getId() {
+		return this.definitions.description.identifier;
+	}
+
+	identifier(identifier) {
+		this.definitions.description = { identifier };
+		return this;
+	}
+
+	tags(tags) {
+		this.definitions.tags = tags;
+		return this;
+	}
+
+	toJson() {
+		var json = { format_version: this.format_version };
+		json[this.recipe_type] = this.definitions;
+		return json;
+	}
+}

package/src/core/addon/recipe/recipeFurnace.js

@@ -0,0 +1,38 @@
+import { AddonRecipe } from "./recipe.js";
+import { RecipeTypes } from "./data.js";
+
+export class AddonRecipeFurnace extends AddonRecipe {
+	constructor(format_version, definitions) {
+		super(format_version, RecipeTypes.Furnace, definitions);
+	}
+
+	input(item, data, count) {
+		var input;
+		if (!data && !count) {
+			input = item;
+		} else {
+			input = { item };
+			if (data) input.data = data;
+			if (count) input.count = count;
+		}
+		this.definitions.input = input;
+		return this;
+	}
+
+	output(item) {
+		this.definitions.output = item;
+		return this;
+	}
+}
+
+export class AddonRecipeFurnace_1_12 extends AddonRecipeFurnace {
+	constructor(definitions = {}) {
+		super("1.12", definitions);
+	}
+}
+
+export class AddonRecipeFurnace_1_17 extends AddonRecipeFurnace {
+	constructor(definitions = {}) {
+		super("1.17", definitions);
+	}
+}

package/src/core/addon/recipe/recipeShaped.js

@@ -0,0 +1,56 @@
+import { AddonRecipe } from "./recipe.js";
+import { RecipeTypes } from "./data.js";
+
+export class AddonRecipeShaped extends AddonRecipe {
+	constructor(format_version, definitions) {
+		super(format_version, RecipeTypes.Shaped, definitions);
+	}
+
+	assumeSymmetry() {
+		this.definitions.assume_symmetry = true;
+	}
+
+	key(key) {
+		this.definitions.key = key;
+		return this;
+	}
+
+	pattern(pattern) {
+		this.definitions.pattern = pattern;
+		return this;
+	}
+
+	priority(priority) {
+		this.definitions.priority = priority;
+		return this;
+	}
+
+	output(item) {
+		this.definitions.result = typeof item == "string" ? { item } : item;
+		return this;
+	}
+}
+
+export class AddonRecipeShaped_1_12 extends AddonRecipeShaped {
+	constructor(definitions) {
+		super("1.12", RecipeTypes.Shaped, definitions);
+	}
+}
+
+export class AddonRecipeShaped_1_17 extends AddonRecipeShaped {
+	constructor(definitions) {
+		super("1.17", RecipeTypes.Shaped, definitions);
+	}
+}
+
+export class AddonRecipeShaped_1_19 extends AddonRecipeShaped {
+	constructor(definitions) {
+		super("1.19", RecipeTypes.Shaped, definitions);
+	}
+}
+
+export class AddonRecipeShaped_1_20 extends AddonRecipeShaped {
+	constructor(definitions) {
+		super("1.20", RecipeTypes.Shaped, definitions);
+	}
+}

package/src/core/addon/recipe/recipeShapeless.js

@@ -0,0 +1,35 @@
+import { AddonRecipe } from "./recipe.js";
+import { RecipeTypes } from "./data.js";
+
+export class AddonRecipeShapeless extends AddonRecipe {
+	constructor(format_version, definitions) {
+		super(format_version, RecipeTypes.Shapeless, definitions);
+	}
+
+	priority(priority) {
+		this.definitions.priority = priority;
+		return this;
+	}
+
+	ingredients(ingredients) {
+		this.definitions.ingredients = ingredients;
+		return this;
+	}
+
+	output(item) {
+		this.definitions.result = typeof item == "string" ? { item } : item;
+		return this;
+	}
+}
+
+export class AddonRecipeShapeless_1_12 extends AddonRecipeShapeless {
+	constructor(definitions) {
+		super("1.12", definitions);
+	}
+}
+
+export class AddonRecipeShapeless_1_17 extends AddonRecipeShapeless {
+	constructor(definitions) {
+		super("1.17", definitions);
+	}
+}

package/src/core/biome/Biome.js

@@ -0,0 +1,30 @@
+import { AddonBiome, AddonBiomeDefinition, AddonBiomeDescription } from "../addon/biome.js";
+
+export class Biome{
+    constructor(identifier){
+        this.identifier = identifier;
+        this.components = new Map();
+    }
+    /**
+     * 添加组件
+     * @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;
+    }
+    toJson(){
+        return new AddonBiome(
+            "1.13.0",
+            new AddonBiomeDefinition(
+                new AddonBiomeDescription(this.identifier),
+                Object.fromEntries(this.components)
+            )
+        ).toJson()
+    }
+}

package/src/core/biome/biomeComponent.js

@@ -0,0 +1,89 @@
+export class BiomeComponent {
+    /**
+     * 将多个组件集合合并为一个。
+     * @param {...Map} componentMaps - 多个组件集合。
+     * @returns {Map} - 合并后的组件集合。
+   */
+    static combineComponents(...componentMaps) {
+        return new Map(componentMaps.flatMap(map => [...map]));
+    }
+
+    /**
+     * 设置生物群系的气候参数
+     * @param {number} downfall - 降水量（范围通常为 0 到 1）
+     * @param {number} snow_accumulation - 积雪量（范围通常为 0 到 1）
+     * @param {number} temperature - 温度（范围通常为 0 到 1）
+     * @returns {Map} 返回一个包含气候参数的 Map 对象，键为 "minecraft:climate"
+     */
+    static setClimate(downfall, snow_accumulation, temperature) {
+        return new Map([
+            ["minecraft:climate", {
+                downfall: downfall,
+                snow_accumulation: snow_accumulation,
+                temperature: temperature
+            }]
+        ]);
+    }
+
+    /**
+     * 设置生物群系的世界高度参数（通常用于生成地形）
+     * @param {Object} noise_params - 噪声参数，用于控制地形生成
+     * @returns {Map} 返回一个包含高度参数的 Map 对象，键为 "minecraft:overworld_height"
+     */
+    static setOverworldHeight(noise_params) {
+        return new Map([
+            ["minecraft:overworld_height", {
+                noise_params: noise_params
+            }]
+        ]);
+    }
+
+    /**
+     * 设置生物群系的表面参数（如地表材料、海底材料等）
+     * @param {Object} params - 表面参数对象，包含以下属性：
+     * @param {number} params.sea_floor_depth - 海底深度
+     * @param {string} params.sea_floor_material - 海底材料（如 "minecraft:sand"）
+     * @param {string} params.foundation_material - 基础材料（如 "minecraft:stone"）
+     * @param {string} params.mid_material - 中间层材料（如 "minecraft:dirt"）
+     * @param {string} params.top_material - 顶层材料（如 "minecraft:grass_block"）
+     * @param {string} params.sea_material - 海洋材料（如 "minecraft:water"）
+     * @returns {Map} 返回一个包含表面参数的 Map 对象，键为 "minecraft:surface_parameters"
+     */
+    static setSurfaceParameters(params) {
+        const {
+            sea_floor_depth,
+            sea_floor_material,
+            foundation_material,
+            mid_material,
+            top_material,
+            sea_material
+        } = params;
+
+        return new Map([
+            ["minecraft:surface_parameters", {
+                sea_floor_depth: sea_floor_depth,
+                sea_floor_material: sea_floor_material,
+                foundation_material: foundation_material,
+                mid_material: mid_material,
+                top_material: top_material,
+                sea_material: sea_material
+            }]
+        ]);
+    }
+
+    /**
+    * 设置生物群系在生成时的规则（如适用于哪些气候类型）
+    * @returns {Map} 返回一个包含生成规则的 Map 对象，键为 "minecraft:overworld_generation_rules"
+    */
+    static setOverworldGenerationRules(medium_weight, warm_weight, cold_weight) {
+        return new Map([
+            ["minecraft:overworld_generation_rules", {
+                "generate_for_climates": [
+                    ["medium", medium_weight], // 适用于中等气候，权重为 100
+                    ["warm", warm_weight],   // 适用于温暖气候，权重为 100
+                    ["cold", cold_weight]    // 适用于寒冷气候，权重为 100
+                ]
+            }]
+        ]);
+    }
+}