sapdon 2.0.2 → 2.1.0

package/src/core/factory/BlockFactory.js

@@ -1,159 +1,167 @@
-import { BasicBlock } from "../block/BasicBlock.js";
-import { Block } from "../block/block.js";
-import { CropBlock } from "../block/cropBlock.js";
-import { GeometryBlock } from "../block/GeometryBlock.js";
-import { OreBlock } from "../block/OreBlock.js";
-import { RotatableBlock } from "../block/RotatableBlock.js";
-import { GRegistry } from "../registry.js";
-
-
-/**
- * 注册方块到注册表中。
- * @param {Block} block - 要注册的方块对象。
- */
-const registerBlock = (block) => {
-    if (!block || !block.identifier) {
-        throw new Error("无效的方块对象或缺少 identifier。");
-    }
-
-    const block_name = block.identifier.replace(":", "_");
-    GRegistry.register(block_name, "behavior", "blocks/", block);
-};
-
-const registerFeature = (feature)=>{
-    const feature_name = feature.identifier.split(":")[feature.identifier.split(":").length - 1];
-    GRegistry.register(feature_name,"behavior","features/",feature);
-};
-
-const registerFeatureRule = (feature_rule)=>{
-    const feature_rule_name = feature_rule.identifier.split(":")[feature_rule.identifier.split(":").length - 1];
-    GRegistry.register(feature_rule_name,"behavior","feature_rules/",feature_rule);
-};
-
-export const BlockAPI = {
-    /**
-     * 创建一个基础方块。
-     * @param {string} identifier - 方块的唯一标识符。
-     * @param {string} category - 方块的分类（如 "construction"）。
-     * @param {Array} textures_arr - 纹理数组，顺序为 [上, 下, 东, 西, 南, 北]。
-     * @param {Object} options - 可选参数。
-     * @param {string} options.group - 分组，默认为 "construction"。
-     * @param {boolean} options.hide_in_command - 是否在命令中隐藏，默认为 false。
-     * @returns {BasicBlock} 创建的基础方块对象。
-     */
-    createBasicBlock: function (identifier, category, textures_arr, options = {}) {
-        if (!identifier || !category || !textures_arr ) {
-            throw new Error("必须提供 identifier、category 和长度为 6 的 textures_arr。");
-        }
-
-        const block = new BasicBlock(identifier, category, textures_arr, {
-            hide_in_command: false,
-            ...options, // 用传入的选项覆盖默认值
-        });
-
-        registerBlock(block); // 调用注册方法
-        return block;
-    },
-
-    /**
-     * 创建一个普通方块。
-     * @param {string} identifier - 方块的唯一标识符。
-     * @param {string} category - 方块的分类（如 "construction"）。
-     * @param {Array} variantDatas - 方块的变体数据，包含每个变体的状态标签和纹理。
-     * @param {Object} options - 可选参数。
-     * @param {string} options.group - 分组，默认为 "construction"。
-     * @param {boolean} options.hide_in_command - 是否在命令中隐藏，默认为 false。
-     * @param {boolean} options.ambient_occlusion - 是否应用环境光遮蔽，默认为 false。
-     * @param {boolean} options.face_dimming - 是否根据面的方向进行亮度调整，默认为 false。
-     * @param {string} options.render_method - 渲染方法，默认为 "alpha_test"。
-     * @returns {Block} 创建的方块对象。
-     */
-    createBlock: function (identifier, category, variantDatas, options = {}) {
-        if (!identifier || !category || !variantDatas || variantDatas.length === 0) {
-            throw new Error("必须提供 identifier、category 和 variantDatas。");
-        }
-
-        const block = new Block(identifier, category, variantDatas, {
-            hide_in_command: false,
-            ambient_occlusion: false,
-            face_dimming: false,
-            render_method: "alpha_test",
-            ...options, // 用传入的选项覆盖默认值
-        });
-
-        registerBlock(block); // 调用注册方法
-        return block;
-    },
-
-    /**
-     * 创建一个可旋转方块。
-     * @param {string} identifier - 方块的唯一标识符。
-     * @param {string} category - 方块的分类（如 "construction"）。
-     * @param {Array} textures_arr - 纹理数组，顺序为 [上, 下, 东, 西, 南, 北]。
-     * @param {Object} options - 可选参数。
-     * @param {string} options.group - 分组，默认为 "construction"。
-     * @param {boolean} options.hide_in_command - 是否在命令中隐藏，默认为 false。
-     * @param {string} options.rotationType - 旋转类型，默认为 "cardinal"。
-     * @param {number} options.yRotationOffset - 初始旋转偏移量，默认为 180。
-     * @returns {RotatableBlock} 创建的可旋转方块对象。
-     */
-    createRotatableBlock: function (identifier, category, textures_arr, options = {}) {
-        if (!identifier || !category || !textures_arr ) {
-            throw new Error("必须提供 identifier、category 和 textures_arr。");
-        }
-
-        const block = new RotatableBlock(identifier, category, textures_arr, {
-            hide_in_command: false,
-            rotationType: "cardinal",
-            yRotationOffset: 180,
-            ...options, // 用传入的选项覆盖默认值
-        });
-
-        registerBlock(block); // 调用注册方法
-        return block;
-    },
-    createGeometryBlock: function (identifier, category, geometry, material_instances, options = {}) {
-        if (!identifier || !category || !geometry || !material_instances ) {
-            throw new Error("必须提供 identifier、category、geometry 和 material_instances。");
-        }
-        const block = new GeometryBlock(identifier, category, geometry, material_instances, options);
-        registerBlock(block); // 调用注册方法
-        return block;
-    },
-    createOreBlock(identifier, category, textures_arr, options = {}){
-        const ore_block = new OreBlock(identifier, category, textures_arr, options)
-        registerBlock(ore_block.block); // 调用注册方法
-        registerFeature(ore_block.feature); // 调用注册方法
-        registerFeatureRule(ore_block.feature_rules); // 调用注册方法
-        return ore_block;
-    },
-    /**
-     * 创建一个作物方块。
-     * @param {string} identifier - 方块的唯一标识符。
-     * @param {string} category - 方块的分类（如 "construction"）。
-     * @param {Array} variantDatas - 方块的变体数据，包含每个变体的状态标签和纹理。
-     * @param {Object} options - 可选参数。
-     * @param {string} options.group - 分组，默认为 "construction"。
-     * @param {boolean} options.hide_in_command - 是否在命令中隐藏，默认为 false。
-     * @param {boolean} options.ambient_occlusion - 是否应用环境光遮蔽，默认为 false。
-     * @param {boolean} options.face_dimming - 是否根据面的方向进行亮度调整，默认为 false。
-     * @param {string} options.render_method - 渲染方法，默认为 "alpha_test"。
-     * @returns {CropBlock} 创建的方块对象。
-     */
-    createCropBlock: function (identifier, category, variantDatas, options = {}) {
-        if (!identifier || !category || !variantDatas || variantDatas.length === 0) {
-            throw new Error("必须提供 identifier、category 和 variantDatas。");
-        }
-
-        const block = new CropBlock(identifier, category, variantDatas, {
-            hide_in_command: false,
-            ambient_occlusion: true,
-            face_dimming: true,
-            render_method: "alpha_test",
-            ...options, // 用传入的选项覆盖默认值
-        });
-
-        registerBlock(block); // 调用注册方法
-        return block;
-    },
+import { BasicBlock } from "../block/BasicBlock.js";
+import { Block } from "../block/block.js";
+import { CropBlock } from "../block/cropBlock.js";
+import { GeometryBlock } from "../block/GeometryBlock.js";
+import { OreBlock } from "../block/OreBlock.js";
+import { RotatableBlock } from "../block/RotatableBlock.js";
+import { TileBlock } from "../block/TileBlock.js";
+import { GRegistry } from "../registry.js";
+import { registerEntity } from "./EntityFactory.js";
+
+
+/**
+ * 注册方块到注册表中。
+ * @param {Block} block - 要注册的方块对象。
+ */
+const registerBlock = (block) => {
+    if (!block || !block.identifier) {
+        throw new Error("无效的方块对象或缺少 identifier。");
+    }
+
+    const block_name = block.identifier.replace(":", "_");
+    GRegistry.register(block_name, "behavior", "blocks/", block);
+};
+
+const registerFeature = (feature)=>{
+    const feature_name = feature.identifier.split(":")[feature.identifier.split(":").length - 1];
+    GRegistry.register(feature_name,"behavior","features/",feature);
+};
+
+const registerFeatureRule = (feature_rule)=>{
+    const feature_rule_name = feature_rule.identifier.split(":")[feature_rule.identifier.split(":").length - 1];
+    GRegistry.register(feature_rule_name,"behavior","feature_rules/",feature_rule);
+};
+
+export const BlockAPI = {
+    /**
+     * 创建一个基础方块。
+     * @param {string} identifier - 方块的唯一标识符。
+     * @param {string} category - 方块的分类（如 "construction"）。
+     * @param {Array} textures_arr - 纹理数组，顺序为 [上, 下, 东, 西, 南, 北]。
+     * @param {Object} options - 可选参数。
+     * @param {string} options.group - 分组，默认为 "construction"。
+     * @param {boolean} options.hide_in_command - 是否在命令中隐藏，默认为 false。
+     * @returns {BasicBlock} 创建的基础方块对象。
+     */
+    createBasicBlock: function (identifier, category, textures_arr, options = {}) {
+        if (!identifier || !category || !textures_arr ) {
+            throw new Error("必须提供 identifier、category 和长度为 6 的 textures_arr。");
+        }
+
+        const block = new BasicBlock(identifier, category, textures_arr, {
+            hide_in_command: false,
+            ...options, // 用传入的选项覆盖默认值
+        });
+
+        registerBlock(block); // 调用注册方法
+        return block;
+    },
+
+    /**
+     * 创建一个普通方块。
+     * @param {string} identifier - 方块的唯一标识符。
+     * @param {string} category - 方块的分类（如 "construction"）。
+     * @param {Array} variantDatas - 方块的变体数据，包含每个变体的状态标签和纹理。
+     * @param {Object} options - 可选参数。
+     * @param {string} options.group - 分组，默认为 "construction"。
+     * @param {boolean} options.hide_in_command - 是否在命令中隐藏，默认为 false。
+     * @param {boolean} options.ambient_occlusion - 是否应用环境光遮蔽，默认为 false。
+     * @param {boolean} options.face_dimming - 是否根据面的方向进行亮度调整，默认为 false。
+     * @param {string} options.render_method - 渲染方法，默认为 "alpha_test"。
+     * @returns {Block} 创建的方块对象。
+     */
+    createBlock: function (identifier, category, variantDatas, options = {}) {
+        if (!identifier || !category || !variantDatas || variantDatas.length === 0) {
+            throw new Error("必须提供 identifier、category 和 variantDatas。");
+        }
+
+        const block = new Block(identifier, category, variantDatas, {
+            hide_in_command: false,
+            ambient_occlusion: false,
+            face_dimming: false,
+            render_method: "alpha_test",
+            ...options, // 用传入的选项覆盖默认值
+        });
+
+        registerBlock(block); // 调用注册方法
+        return block;
+    },
+
+    /**
+     * 创建一个可旋转方块。
+     * @param {string} identifier - 方块的唯一标识符。
+     * @param {string} category - 方块的分类（如 "construction"）。
+     * @param {Array} textures_arr - 纹理数组，顺序为 [上, 下, 东, 西, 南, 北]。
+     * @param {Object} options - 可选参数。
+     * @param {string} options.group - 分组，默认为 "construction"。
+     * @param {boolean} options.hide_in_command - 是否在命令中隐藏，默认为 false。
+     * @param {string} options.rotationType - 旋转类型，默认为 "cardinal"。
+     * @param {number} options.yRotationOffset - 初始旋转偏移量，默认为 180。
+     * @returns {RotatableBlock} 创建的可旋转方块对象。
+     */
+    createRotatableBlock: function (identifier, category, textures_arr, options = {}) {
+        if (!identifier || !category || !textures_arr ) {
+            throw new Error("必须提供 identifier、category 和 textures_arr。");
+        }
+
+        const block = new RotatableBlock(identifier, category, textures_arr, {
+            hide_in_command: false,
+            rotationType: "cardinal",
+            yRotationOffset: 180,
+            ...options, // 用传入的选项覆盖默认值
+        });
+
+        registerBlock(block); // 调用注册方法
+        return block;
+    },
+    createGeometryBlock: function (identifier, category, geometry, material_instances, options = {}) {
+        if (!identifier || !category || !geometry || !material_instances ) {
+            throw new Error("必须提供 identifier、category、geometry 和 material_instances。");
+        }
+        const block = new GeometryBlock(identifier, category, geometry, material_instances, options);
+        registerBlock(block); // 调用注册方法
+        return block;
+    },
+    createOreBlock(identifier, category, textures_arr, options = {}){
+        const ore_block = new OreBlock(identifier, category, textures_arr, options)
+        registerBlock(ore_block.block); // 调用注册方法
+        registerFeature(ore_block.feature); // 调用注册方法
+        registerFeatureRule(ore_block.feature_rules); // 调用注册方法
+        return ore_block;
+    },
+    /**
+     * 创建一个作物方块。
+     * @param {string} identifier - 方块的唯一标识符。
+     * @param {string} category - 方块的分类（如 "construction"）。
+     * @param {Array} variantDatas - 方块的变体数据，包含每个变体的状态标签和纹理。
+     * @param {Object} options - 可选参数。
+     * @param {string} options.group - 分组，默认为 "construction"。
+     * @param {boolean} options.hide_in_command - 是否在命令中隐藏，默认为 false。
+     * @param {boolean} options.ambient_occlusion - 是否应用环境光遮蔽，默认为 false。
+     * @param {boolean} options.face_dimming - 是否根据面的方向进行亮度调整，默认为 false。
+     * @param {string} options.render_method - 渲染方法，默认为 "alpha_test"。
+     * @returns {CropBlock} 创建的方块对象。
+     */
+    createCropBlock: function (identifier, category, variantDatas, options = {}) {
+        if (!identifier || !category || !variantDatas || variantDatas.length === 0) {
+            throw new Error("必须提供 identifier、category 和 variantDatas。");
+        }
+
+        const block = new CropBlock(identifier, category, variantDatas, {
+            hide_in_command: false,
+            ambient_occlusion: true,
+            face_dimming: true,
+            render_method: "alpha_test",
+            ...options, // 用传入的选项覆盖默认值
+        });
+
+        registerBlock(block); // 调用注册方法
+        return block;
+    },
+    createTileBlock: function (identifier, category, textures_arr, options = {}) {
+        const block = new TileBlock(identifier, category, textures_arr, options);
+        registerBlock(block.block); // 调用注册方法
+        registerEntity(block.entity.entity,block.entity.client_entity)
+        return block;
+    }
 };

package/src/core/factory/EntityFactory.js

@@ -1,83 +1,83 @@
-import { BasicEntity } from "../entity/BasicEntity.js";
-import { ClientEntity } from "../entity/ClientEntity.js";
-import { Entity } from "../entity/Entity.js";
-import { NativeEntity } from "../entity/NativeEntity.js";
-import { Projectile } from "../entity/Projectile.js";
-import { GRegistry } from "../registry.js";
-
-const registerEntity = (behData, resData) => {
-    // 如果 behData 存在且不为空，则注册行为数据
-    if (behData && Object.keys(behData).length > 0) {
-        GRegistry.register(behData.identifier.replace(":", "_"), "behavior", "entities/", behData);
-    }
-
-    // 如果 resData 存在且不为空，则注册资源数据
-    if (resData && Object.keys(resData).length > 0) {
-        GRegistry.register(resData.identifier.replace(":", "_"), "resource", "entity/", resData);
-    }
-};
-
-export const EntityAPI = {
-    /**
-     * 创建一个原生实体。
-     * @param {string} identifier - 实体的唯一标识符。
-     * @param {string} proto_id - 实体的原型 ID。
-     * @param {string} texture - 实体的纹理。
-     * @param {Object} options - 额外选项。
-     * @returns {{ behavior: BasicEntity, resource: ClientEntity }} 包含行为数据和资源数据的对象。
-     */
-    createNativeEntity: function (identifier, proto_id, options = {}) {
-        if (!identifier || !proto_id ) {
-            throw new Error("必须提供 identifier、proto_id 和 texture。");
-        }
-
-        const nativeEntity = new NativeEntity(identifier, proto_id, options);
-        registerEntity(nativeEntity.entity, nativeEntity.client_entity);
-        return {
-            behavior: nativeEntity.entity,
-            resource: nativeEntity.client_entity,
-        };
-    },
-
-    /**
-     * 创建一个普通实体。
-     * @param {string} identifier - 实体的唯一标识符。
-     * @param {string} texture - 实体的纹理。
-     * @param {Object} behData - 实体的行为数据。
-     * @param {Object} resData - 实体的资源数据。
-     * @param {Object} options - 额外选项。
-     * @returns {{ behavior: BasicEntity, resource: ClientEntity }} 包含行为数据和资源数据的对象。
-     */
-    createEntity: function (identifier, texture, behData, resData, options = {}) {
-        if (!identifier || !texture) {
-            throw new Error("必须提供 identifier 和 texture。");
-        }
-
-        const entity = new Entity(identifier, texture, behData, resData, options);
-        registerEntity(entity.entity, entity.client_entity);
-        return {
-            behavior: entity.entity,
-            resource: entity.client_entity,
-        };
-    },
-
-    /**
-     * 创建一个投射物实体。
-     * @param {string} identifier - 投射物的唯一标识符。
-     * @param {string} texture - 投射物的纹理。
-     * @param {Object} options - 额外选项。
-     * @returns {{ behavior: BasicEntity, resource: ClientEntity }} 包含行为数据和资源数据的对象。
-     */
-    createProjectile: function (identifier, texture, options = {}) {
-        if (!identifier || !texture) {
-            throw new Error("必须提供 identifier 和 texture。");
-        }
-
-        const entity = new Projectile(identifier, texture, options);
-        registerEntity(entity.entity, entity.client_entity);
-        return {
-            behavior: entity.entity,
-            resource: entity.client_entity,
-        };
-    },
+import { BasicEntity } from "../entity/BasicEntity.js";
+import { ClientEntity } from "../entity/ClientEntity.js";
+import { Entity } from "../entity/Entity.js";
+import { NativeEntity } from "../entity/NativeEntity.js";
+import { Projectile } from "../entity/Projectile.js";
+import { GRegistry } from "../registry.js";
+
+export const registerEntity = (behData, resData) => {
+    // 如果 behData 存在且不为空，则注册行为数据
+    if (behData && Object.keys(behData).length > 0) {
+        GRegistry.register(behData.identifier.replace(":", "_"), "behavior", "entities/", behData);
+    }
+
+    // 如果 resData 存在且不为空，则注册资源数据
+    if (resData && Object.keys(resData).length > 0) {
+        GRegistry.register(resData.identifier.replace(":", "_"), "resource", "entity/", resData);
+    }
+};
+
+export const EntityAPI = {
+    /**
+     * 创建一个原生实体。
+     * @param {string} identifier - 实体的唯一标识符。
+     * @param {string} proto_id - 实体的原型 ID。
+     * @param {string} texture - 实体的纹理。
+     * @param {Object} options - 额外选项。
+     * @returns {{ behavior: BasicEntity, resource: ClientEntity }} 包含行为数据和资源数据的对象。
+     */
+    createNativeEntity: function (identifier, proto_id, options = {}) {
+        if (!identifier || !proto_id ) {
+            throw new Error("必须提供 identifier、proto_id 和 texture。");
+        }
+
+        const nativeEntity = new NativeEntity(identifier, proto_id, options);
+        registerEntity(nativeEntity.entity, nativeEntity.client_entity);
+        return {
+            behavior: nativeEntity.entity,
+            resource: nativeEntity.client_entity,
+        };
+    },
+
+    /**
+     * 创建一个普通实体。
+     * @param {string} identifier - 实体的唯一标识符。
+     * @param {string} texture - 实体的纹理。
+     * @param {Object} behData - 实体的行为数据。
+     * @param {Object} resData - 实体的资源数据。
+     * @param {Object} options - 额外选项。
+     * @returns {{ behavior: BasicEntity, resource: ClientEntity }} 包含行为数据和资源数据的对象。
+     */
+    createEntity: function (identifier, texture, behData, resData, options = {}) {
+        if (!identifier || !texture) {
+            throw new Error("必须提供 identifier 和 texture。");
+        }
+
+        const entity = new Entity(identifier, texture, behData, resData, options);
+        registerEntity(entity.entity, entity.client_entity);
+        return {
+            behavior: entity.entity,
+            resource: entity.client_entity,
+        };
+    },
+
+    /**
+     * 创建一个投射物实体。
+     * @param {string} identifier - 投射物的唯一标识符。
+     * @param {string} texture - 投射物的纹理。
+     * @param {Object} options - 额外选项。
+     * @returns {{ behavior: BasicEntity, resource: ClientEntity }} 包含行为数据和资源数据的对象。
+     */
+    createProjectile: function (identifier, texture, options = {}) {
+        if (!identifier || !texture) {
+            throw new Error("必须提供 identifier 和 texture。");
+        }
+
+        const entity = new Projectile(identifier, texture, options);
+        registerEntity(entity.entity, entity.client_entity);
+        return {
+            behavior: entity.entity,
+            resource: entity.client_entity,
+        };
+    },
 };