sapdon 2.0.2 → 2.1.0

package/src/cli/tools/textureSet.js

@@ -1,115 +1,115 @@
-import fs from "fs/promises";
-import path from "path";
-
-
-/**
- * 递归遍历目录，收集所有 PNG 文件的路径
- * @param {string} directory - 要遍历的目录
- * @param {string} basePath - 基础路径（用于计算相对路径）
- * @param {string} prefix - 路径前缀（如 "textures/items/"）
- * @returns {Promise<Object>} - 返回一个对象，键为文件名，值为相对路径（不带 .png 后缀）
- */
-const traverseDirectory = async (directory, basePath, prefix = "") => {
-  const texturesSet = {};
-
-  const files = await fs.readdir(directory);
-
-  for (const file of files) {
-    const filePath = path.join(directory, file);
-    const fileStats = await fs.stat(filePath);
-
-    if (fileStats.isDirectory()) {
-      // 如果是目录，递归遍历
-      const subDirectoryTextures = await traverseDirectory(filePath, basePath, prefix);
-      Object.assign(texturesSet, subDirectoryTextures);
-    } else if (file.endsWith(".png")) {
-      // 如果是 PNG 文件，提取文件名并生成 texture_data
-      const fileName = path.basename(file, ".png"); // 去掉 .png 后缀
-      const relativePath = path.relative(basePath, filePath).replace(/\.png$/, ""); // 去掉 .png 后缀
-      const normalizedPath = `${prefix}${relativePath.replace(/\\/g, "/")}`; // 确保路径使用正斜杠
-
-      texturesSet[fileName] = {
-        textures: normalizedPath,
-      };
-    }
-  }
-
-  return texturesSet;
-};
-
-/**
- * 生成 JSON 文件
- * @param {string} outputPath - 输出的 JSON 文件路径
- * @param {Object} jsonData - 要写入的 JSON 数据
- * @param {string} successMessage - 成功时的日志消息
- */
-const generateJsonFile = async (outputPath, jsonData, successMessage) => {
-  try {
-    const jsonString = JSON.stringify(jsonData, null, 2);
-    await fs.writeFile(outputPath, jsonString);
-    console.log(successMessage);
-  } catch (err) {
-    console.error("Error writing JSON file:", err);
-  }
-};
-
-/**
- * 生成 block_texture.json 文件
- * @param {string} itemTexturesPath - 包含 PNG 文件的根目录
- * @param {string} outputPath - 输出的 JSON 文件路径
- * @param {string} projectName - 项目名称
- */
-export async function generateBlockTextureJson(itemTexturesPath, outputPath, projectName, userTerrainTextures) {
-  try {
-    // 递归遍历目录，获取所有 PNG 文件的路径
-    const itemTexturesSet = await traverseDirectory(itemTexturesPath, itemTexturesPath,"textures/blocks/");
-    
-    // 合并用户自定义的texture_data
-    if(userTerrainTextures){
-      Object.assign(itemTexturesSet,userTerrainTextures);
-    }
-
-    // 生成 JSON 数据
-    const jsonData = {
-      texture_name: "atlas.terrain",
-      resource_pack_name: projectName,
-      padding: 8,
-      num_mip_levels: 4,
-      texture_data: itemTexturesSet,
-    };
-
-    // 写入文件
-    await generateJsonFile(outputPath, jsonData, "Block texture JSON file generated successfully.");
-  } catch (err) {
-    console.error("Error generating block texture JSON:", err);
-  }
-}
-
-/**
- * 生成 item_texture.json 文件
- * @param {string} itemTexturesPath - 包含 PNG 文件的根目录
- * @param {string} outputPath - 输出的 JSON 文件路径
- */
-export async function generateItemTextureJson(itemTexturesPath, outputPath,projectName,userItemTextures) {
-  try {
-    // 递归遍历目录，获取所有 PNG 文件的路径
-    const itemTexturesSet = await traverseDirectory(itemTexturesPath, itemTexturesPath, "textures/items/");
-
-    // 合并用户自定义的texture_data
-    if(userItemTextures){
-      Object.assign(itemTexturesSet,userItemTextures);
-    }
-
-    // 生成 JSON 数据
-    const jsonData = {
-      resource_pack_name: projectName,
-      texture_name: "atlas.items",
-      texture_data: itemTexturesSet,
-    };
-
-    // 写入文件
-    await generateJsonFile(outputPath, jsonData, "Item texture JSON file generated successfully.");
-  } catch (err) {
-    console.error("Error generating item texture JSON:", err);
-  }
+import fs from "fs/promises";
+import path from "path";
+
+
+/**
+ * 递归遍历目录，收集所有 PNG 文件的路径
+ * @param {string} directory - 要遍历的目录
+ * @param {string} basePath - 基础路径（用于计算相对路径）
+ * @param {string} prefix - 路径前缀（如 "textures/items/"）
+ * @returns {Promise<Object>} - 返回一个对象，键为文件名，值为相对路径（不带 .png 后缀）
+ */
+const traverseDirectory = async (directory, basePath, prefix = "") => {
+  const texturesSet = {};
+
+  const files = await fs.readdir(directory);
+
+  for (const file of files) {
+    const filePath = path.join(directory, file);
+    const fileStats = await fs.stat(filePath);
+
+    if (fileStats.isDirectory()) {
+      // 如果是目录，递归遍历
+      const subDirectoryTextures = await traverseDirectory(filePath, basePath, prefix);
+      Object.assign(texturesSet, subDirectoryTextures);
+    } else if (file.endsWith(".png")) {
+      // 如果是 PNG 文件，提取文件名并生成 texture_data
+      const fileName = path.basename(file, ".png"); // 去掉 .png 后缀
+      const relativePath = path.relative(basePath, filePath).replace(/\.png$/, ""); // 去掉 .png 后缀
+      const normalizedPath = `${prefix}${relativePath.replace(/\\/g, "/")}`; // 确保路径使用正斜杠
+
+      texturesSet[fileName] = {
+        textures: normalizedPath,
+      };
+    }
+  }
+
+  return texturesSet;
+};
+
+/**
+ * 生成 JSON 文件
+ * @param {string} outputPath - 输出的 JSON 文件路径
+ * @param {Object} jsonData - 要写入的 JSON 数据
+ * @param {string} successMessage - 成功时的日志消息
+ */
+const generateJsonFile = async (outputPath, jsonData, successMessage) => {
+  try {
+    const jsonString = JSON.stringify(jsonData, null, 2);
+    await fs.writeFile(outputPath, jsonString);
+    console.log(successMessage);
+  } catch (err) {
+    console.error("Error writing JSON file:", err);
+  }
+};
+
+/**
+ * 生成 block_texture.json 文件
+ * @param {string} itemTexturesPath - 包含 PNG 文件的根目录
+ * @param {string} outputPath - 输出的 JSON 文件路径
+ * @param {string} projectName - 项目名称
+ */
+export async function generateBlockTextureJson(itemTexturesPath, outputPath, projectName, userTerrainTextures) {
+  try {
+    // 递归遍历目录，获取所有 PNG 文件的路径
+    const itemTexturesSet = await traverseDirectory(itemTexturesPath, itemTexturesPath,"textures/blocks/");
+    
+    // 合并用户自定义的texture_data
+    if(userTerrainTextures){
+      Object.assign(itemTexturesSet,userTerrainTextures);
+    }
+
+    // 生成 JSON 数据
+    const jsonData = {
+      texture_name: "atlas.terrain",
+      resource_pack_name: projectName,
+      padding: 8,
+      num_mip_levels: 4,
+      texture_data: itemTexturesSet,
+    };
+
+    // 写入文件
+    await generateJsonFile(outputPath, jsonData, "Block texture JSON file generated successfully.");
+  } catch (err) {
+    console.error("Error generating block texture JSON:", err);
+  }
+}
+
+/**
+ * 生成 item_texture.json 文件
+ * @param {string} itemTexturesPath - 包含 PNG 文件的根目录
+ * @param {string} outputPath - 输出的 JSON 文件路径
+ */
+export async function generateItemTextureJson(itemTexturesPath, outputPath,projectName,userItemTextures) {
+  try {
+    // 递归遍历目录，获取所有 PNG 文件的路径
+    const itemTexturesSet = await traverseDirectory(itemTexturesPath, itemTexturesPath, "textures/items/");
+
+    // 合并用户自定义的texture_data
+    if(userItemTextures){
+      Object.assign(itemTexturesSet,userItemTextures);
+    }
+
+    // 生成 JSON 数据
+    const jsonData = {
+      resource_pack_name: projectName,
+      texture_name: "atlas.items",
+      texture_data: itemTexturesSet,
+    };
+
+    // 写入文件
+    await generateJsonFile(outputPath, jsonData, "Item texture JSON file generated successfully.");
+  } catch (err) {
+    console.error("Error generating item texture JSON:", err);
+  }
 }

package/src/cli/utils.js

@@ -1,82 +1,82 @@
-import fs from "fs";
-import path from "path";
-import downlaod from "download";
-import { randomUUID } from "crypto";
-
-export const generateUUID = () => {
-	return randomUUID();
-};
-
-/**
- * 同步复制文件
- * @param {string} src 源文件路径
- * @param {string} dest 目标文件路径
- */
-export function copyFileSync(src, dest) {
-	try {
-		fs.copyFileSync(src, dest);
-	} catch (err) {
-		console.error("文件复制失败：", err);
-	}
-}
-
-//检查路径
-export const checkPath = filePath => {
-	return !fs.existsSync(filePath);
-};
-
-//读取文件
-export const readFile = filePath => {
-	try {
-		return fs.readFileSync(filePath, "utf8");
-	} catch (error) {
-		console.log(error);
-	}
-	return null;
-};
-
-/**
- * 保存文件
- * @param {string} filePath 绝对路径
- * @param {string} data 数据
- */
-export const saveFile = (filePath, data) => {
-	// 确保目录存在
-	fs.mkdirSync(path.dirname(filePath), { recursive: true });
-
-	// 创建文件并写入内容
-	fs.writeFile(filePath, data, err => {
-		if (err) {
-			return console.error(err);
-		}
-	});
-};
-
-export const copyFolder = (sourcePath, destinationPath) => {
-	// 确保目录存在
-	fs.mkdirSync(path.dirname(destinationPath), { recursive: true });
-	// 检查源路径是否存在
-	if (!fs.existsSync(sourcePath)) {
-		console.log(`Source path ${sourcePath} does not exist.`);
-		return;
-	}
-	// 检查目标路径是否存在，如果不存在则创建它
-	if (!fs.existsSync(destinationPath)) {
-		fs.mkdirSync(destinationPath);
-	}
-	// 获取源路径下的所有文件和文件夹
-	const files = fs.readdirSync(sourcePath);
-	// 遍历文件和文件夹
-	files.forEach(file => {
-		const sourceFile = path.join(sourcePath, file);
-		const destinationFile = path.join(destinationPath, file);
-		// 判断是文件还是文件夹
-		if (fs.lstatSync(sourceFile).isDirectory()) {
-			// 如果是文件夹，则递归调用copyFolder函数
-			copyFolder(sourceFile, destinationFile);
-		} else {
-			// 如果是文件，则直接复制到目标路径
-			fs.copyFileSync(sourceFile, destinationFile);
-		}
-	});
-};
+import fs from "fs";
+import path from "path";
+import downlaod from "download";
+import { randomUUID } from "crypto";
+
+export const generateUUID = () => {
+	return randomUUID();
+};
+
+/**
+ * 同步复制文件
+ * @param {string} src 源文件路径
+ * @param {string} dest 目标文件路径
+ */
+export function copyFileSync(src, dest) {
+	try {
+		fs.copyFileSync(src, dest);
+	} catch (err) {
+		console.error("文件复制失败：", err);
+	}
+}
+
+//检查路径
+export const checkPath = filePath => {
+	return !fs.existsSync(filePath);
+};
+
+//读取文件
+export const readFile = filePath => {
+	try {
+		return fs.readFileSync(filePath, "utf8");
+	} catch (error) {
+		console.log(error);
+	}
+	return null;
+};
+
+/**
+ * 保存文件
+ * @param {string} filePath 绝对路径
+ * @param {string} data 数据
+ */
+export const saveFile = (filePath, data) => {
+	// 确保目录存在
+	fs.mkdirSync(path.dirname(filePath), { recursive: true });
+
+	// 创建文件并写入内容
+	fs.writeFile(filePath, data, err => {
+		if (err) {
+			return console.error(err);
+		}
+	});
+};
+
+export const copyFolder = (sourcePath, destinationPath) => {
+	// 确保目录存在
+	fs.mkdirSync(path.dirname(destinationPath), { recursive: true });
+	// 检查源路径是否存在
+	if (!fs.existsSync(sourcePath)) {
+		console.log(`Source path ${sourcePath} does not exist.`);
+		return;
+	}
+	// 检查目标路径是否存在，如果不存在则创建它
+	if (!fs.existsSync(destinationPath)) {
+		fs.mkdirSync(destinationPath);
+	}
+	// 获取源路径下的所有文件和文件夹
+	const files = fs.readdirSync(sourcePath);
+	// 遍历文件和文件夹
+	files.forEach(file => {
+		const sourceFile = path.join(sourcePath, file);
+		const destinationFile = path.join(destinationPath, file);
+		// 判断是文件还是文件夹
+		if (fs.lstatSync(sourceFile).isDirectory()) {
+			// 如果是文件夹，则递归调用copyFolder函数
+			copyFolder(sourceFile, destinationFile);
+		} else {
+			// 如果是文件，则直接复制到目标路径
+			fs.copyFileSync(sourceFile, destinationFile);
+		}
+	});
+};

package/src/core/addon/controllers/animation_controller.js

@@ -0,0 +1,80 @@
+
+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/src/core/addon/entity/entity.js

@@ -1,52 +1,53 @@
-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, runtime_identifier) {
-        this.identifier = identifier;
-        this.is_spawnable = is_spawnable;
-        this.is_summonable = is_summonable;
-        this.runtime_identifier = runtime_identifier;
-    }
+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/src/core/block/GeometryBlock.js

@@ -2,6 +2,14 @@ import { BasicBlock } from "./BasicBlock.js";
 import { BlockComponent } from "./blockComponent.js";
 
 export class GeometryBlock extends BasicBlock{
+    /**
+     * 带模型方块类
+     * @param {string} identifier 方块标识符 由命名空间和方块名组成 例如 "my_mod:stone"
+     * @param {string} category 方块的分类 "construction", "nature", "equipment", "items", and "none"
+     * @param {string} geometry 模型标识符
+     * @param {Object} material_instances 材质实例对象
+     * @param {Object} options 可选参数
+     */
     constructor(identifier, category, geometry, material_instances, options = {}) {
         super(identifier, category, [material_instances["*"]["texture"]], options);
         this.addComponent(

package/src/core/block/OreBlock.js

@@ -5,6 +5,7 @@ import { FeatureRule } from "../feature_rule/FeatureRule.js";
 import { BasicBlock } from "./BasicBlock.js";
 
 export class OreBlock{
+    
     constructor(identifier, category, textures_arr, options = {}){
         this.block = new BasicBlock(identifier, category, textures_arr, options);
         this.feature = new OreFeature(`${identifier}_ore_feature`,6,[