sapdon 3.0.2 → 3.0.3

package/dist/cli/load.js

@@ -0,0 +1,94 @@
+import path from "path";
+import { saveFile } from "./utils.js";
+import { generateBlockTextureJson, generateItemTextureJson } from "./tools/textureSet.js";
+import { FlipbookTextures, ItemTextureManager, terrainTextureManager } from "../core/texture.js";
+import { writeAddon } from './dev-server/client.js';
+/**
+ * 处理 blocks.json 数据
+ * @param {Object} data blocks.json 数据
+ * @returns {Object} 处理后的 blocks 数据
+ */
+export const processBlocksData = (data) => {
+    const textures_arr = data.textures;
+    // 检查 textures 数组长度
+    if (textures_arr.length !== 6) {
+        console.warn(`blocks.json 的 textures 数组长度不为 6，实际长度: ${textures_arr.length}`);
+        return {};
+    }
+    // 构建 blocks 数据
+    const blocks = {};
+    blocks[data.identifier] = {
+        textures: {
+            up: textures_arr[0],
+            down: textures_arr[1],
+            east: textures_arr[2],
+            west: textures_arr[3],
+            south: textures_arr[4],
+            north: textures_arr[5]
+        }
+    };
+    return blocks;
+};
+export const generateAddonClient = async (modPath, buildPath, projectName) => {
+    writeAddon(modPath, buildPath, projectName);
+};
+/**
+ * Server
+ * 加载并执行模组文件
+ * @param {string} modPath 模组文件路径
+ * @param {string} buildPath 构建目录路径
+ * @param {string} projectName 项目名
+ */
+export const generateAddon = (GRegistry, UISystemRegistry) => async (modPath, buildPath, projectName) => {
+    try {
+        const buildBehDirPath = path.join(buildPath, `${projectName}_BP`);
+        const buildResDirPath = path.join(buildPath, `${projectName}_RP`);
+        const resDir = name => path.join(buildResDirPath, name);
+        // 初始化 blocks.json 数据
+        const blocksJsonPath = path.join(buildBehDirPath, "blocks.json");
+        const blocks = { "format_version": "1.20.20" };
+        //生成item_texture.json
+        const item_texture_dir = resDir("textures/items");
+        const item_texture_json_path = resDir("textures/item_texture.json");
+        generateItemTextureJson(item_texture_dir, item_texture_json_path, projectName, ItemTextureManager.getItemTextures());
+        //生成terrain_texture.json
+        const terrain_texture_dir = resDir("textures/blocks");
+        const terrain_texture_json_path = resDir("textures/terrain_texture.json");
+        generateBlockTextureJson(terrain_texture_dir, terrain_texture_json_path, projectName, terrainTextureManager.getTerrainTextures());
+        //生成flipbook_textures.json
+        const flipbook_textures_path = resDir("textures/flipbook_textures.json");
+        saveFile(flipbook_textures_path, JSON.stringify(FlipbookTextures.flipbook_textures, null, 2));
+        //_ui_defs.json
+        const ui_def = UISystemRegistry.getUIdefList();
+        saveFile(resDir("ui/_ui_defs.json"), JSON.stringify({ "ui_defs": ui_def }, null, 2));
+        UISystemRegistry.getUISystemList().forEach((ui_system) => {
+            saveFile(resDir(ui_system.path, `${ui_system.name}.json`), JSON.stringify(ui_system.toJson(), null, 2));
+        });
+        // 从全局注册表中获取数据
+        const dataList = GRegistry.getDataList();
+        // console.log("dataList:", dataList)
+        // 遍历数据并保存到相应的目录
+        dataList.forEach(({ name, root, path: dataPath, data }) => {
+            // 处理 blocks.json 数据
+            if (dataPath === "blocks/") {
+                const processedBlocks = processBlocksData(data);
+                Object.assign(blocks, processedBlocks);
+            }
+            // 根据数据类型确定根目录
+            const rootPath = root === "behavior" ? `${projectName}_BP` : `${projectName}_RP`;
+            const buildRootPath = path.join(buildPath, rootPath);
+            // 拼接文件路径
+            const filePath = path.join(buildRootPath, dataPath, `${name}.json`);
+            // 保存文件
+            saveFile(filePath, JSON.stringify(data.toJson(), null, 2));
+        });
+        // 保存 blocks.json
+        console.log("保存 blocks.json 文件:", blocksJsonPath);
+        saveFile(blocksJsonPath, JSON.stringify(blocks, null, 2));
+        console.log(`已加载并执行 ${modPath} 文件！`);
+    }
+    catch (err) {
+        console.error(`加载或执行 ${modPath} 失败：${err.message}`);
+        console.error(err.stack); // 打印堆栈跟踪以便调试
+    }
+};

package/dist/cli/start.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/start.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import{program as n}from"commander";import o from"inquirer";import e from"path";import i from"os";import{fileURLToPath as t}from"url";import s from"fs";import{randomUUID as r}from"crypto";import{fileURLToPath as c}from"node:url";import a from"child_process";import"fs/promises";import{rollup as p}from"rollup";import l from"@rollup/plugin-commonjs";import{nodeResolve as m}from"@rollup/plugin-node-resolve";import d from"@rollup/plugin-typescript";import{typescriptPaths as u}from"rollup-plugin-typescript-paths";import f from"@rollup/plugin-json";import"rollup-plugin-visualizer";import g from"lodash";const j=()=>r();function y(n,o){try{s.copyFileSync(n,o)}catch(n){console.error("文件复制失败：",n)}}const h=n=>!s.existsSync(n),S=n=>{try{return s.readFileSync(n,"utf8")}catch(n){console.log(n)}return null},_=(n,o)=>{s.mkdirSync(e.dirname(n),{recursive:!0}),s.writeFile(n,o,(n=>{if(n)return console.error(n)}))},w=(n,o)=>{if(s.mkdirSync(e.dirname(o),{recursive:!0}),!s.existsSync(n))return void console.log(`Source path ${n} does not exist.`);s.existsSync(o)||s.mkdirSync(o);s.readdirSync(n).forEach((i=>{const t=e.join(n,i),r=e.join(o,i);s.lstatSync(t).isDirectory()?w(t,r):s.copyFileSync(t,r)}))};const v=t(import.meta.url),b=e.dirname(v),k={js:"test_sapdon",ts:"ts_sapdon"};const P=n=>{const o=e.join(n,"package.json");if(!s.existsSync(o))return null;try{const i=JSON.parse(s.readFileSync(o,"utf-8"));return{name:e.basename(n),description:i.description||"A new sapdon project",author:i.author||"Sapdon",version:i.version||"1.0.0"}}catch(n){return console.error("读取package.json文件时出错:",n),null}};var N;!function(n){n.WRITE_ADDON="write-addon",n.WRITE_GAME_DEV="write-dev"}(N||(N={}));const{port:O}={port:49037};async function D(n,...o){try{await fetch(`http://localhost:${O}/${n}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(o)})}catch(n){console.error(n),console.error("尝试在构建脚本中使用 server.startDevServer() 启动开发服务器")}}const J=async(n,o,e)=>{!async function(n,o,e){await D(N.WRITE_ADDON,n,o,e)}(n,o,e)};class M{constructor(n,o,e,i,t={}){this.name=n,this.description=o,this.version=e,this.uuid=i,this.allow_random_seed=t.allow_random_seed,this.lock_template_options=t.lock_template_options,this.pack_scope=t.pack_scope,this.base_game_version=t.base_game_version,this.min_engine_version=t.min_engine_version}}class E{constructor(n,o,e,i){this.description=n,this.type=o,this.uuid=e,this.version=i}}class x{constructor(n,o,e,i,t){this.authors=n,this.license=o,this.generated_with=e,this.product_type=i,this.url=t}}class F{constructor(n,o,e,i,t=null,s=null){this.format_version=n,this.header=o,this.modules=e,this.dependencies=i,null!=t&&(this.capabilities=t),null!=s&&(this.metadata=s)}}async function L(n){const o=e.join(n,"node_modules"),i=e.join(function(n){const o=c(n.url);return e.dirname(o)}(import.meta),"../"),t=e.join(i,"core"),r=e.join(i,"cli"),a=e.join(i,"oc"),p=e.join(o,"@sapdon/core"),l=e.join(o,"@sapdon/cli"),m=e.join(o,"@sapdon/oc");s.cpSync(t,p,{recursive:!0,force:!0}),s.cpSync(r,l,{recursive:!0,force:!0}),s.cpSync(a,m,{recursive:!0,force:!0}),s.writeFileSync(e.join(p,"package.json"),JSON.stringify({name:"@sapdon/core",main:"index.js",version:"1.0.0"})),s.writeFileSync(e.join(l,"package.json"),JSON.stringify({name:"@sapdon/cli",main:"index.js",version:"1.0.0"})),s.writeFileSync(e.join(m,"package.json"),JSON.stringify({name:"@sapdon/oc",main:"index.js",version:"1.0.0"}))}g.debounce;const R=t(import.meta.url),A=e.dirname(R),U=["rollup","typescript","@sapdon/core","@sapdon/cli","@minecraft"],I={__projectPath:e.join(A,"../../"),js:(n,o)=>{w(n,o)},ts:async(n,o,i="index.js",t="index.ts")=>{const r=e.join(I.__projectPath,".tmp",`sapdon-${crypto.randomUUID()}.js`);try{const c=await p({input:e.join(n,t),plugins:[u(),m({preferBuiltins:!0}),d({tsconfig:e.join(I.__projectPath,"tsconfig.json")}),l(),f()],external(n){for(const o of U)if(n.includes(o))return!0;return!1}});await c.write({file:r,format:"esm"}),c.close(),s.cpSync(r,e.join(o,i))}catch(n){console.error(n)}finally{s.rmSync(r,{recursive:!0,force:!0})}}};async function T(n,o,i){const t=e.join(n,i.path),s=i.type||"js";I.__projectPath=n,I[s](t,o)}async function W(n){const{promise:o,resolve:e}=Promise.withResolvers(),i=a.fork(n,{stdio:"inherit"});i.once("message",(n=>{"initialized"!==n&&i.kill(),e()})),await o}async function C(n){if(n.endsWith(".ts")){const i=crypto.randomUUID()+".js",t=e.dirname(n),r=n.replace(t,""),c=e.join(t,i);await I.ts(t,t,i,r),o=c,s.appendFileSync(o,"\n        ;(async () => {\n            const { startDevServer } = await import('@sapdon/cli')\n            const { GRegistry, UISystemRegistry } = await import('@sapdon/core')\n            startDevServer(GRegistry, UISystemRegistry)\n        })();\n    ");try{await W(c)}finally{s.rmSync(c,{force:!0})}}else{var o;await W(n)}}function B(n,o){return console.log("开始构建项目"),console.log("项目路径："+n),h(n)?(console.log("项目不存在"),!1):!h(e.join(n,"build.config"))||(console.log("项目没有build.config文件"),!1)}const $=async(n,o)=>{const i=e.join(n,"build.config"),t=JSON.parse(S(i)),s=e.join(n,"mod.info"),r=JSON.parse(S(s)),c=G(r.min_engine_version),a=e.join(n,t.defaultConfig.buildDir),p=e.join(a,`${o}_BP/`),l=e.join(a,`${o}_RP/`),m=e.join(p,"manifest.json");if(h(m)){const n=V(r.name,r.description,r.version,{min_engine_version:c},t.defaultConfig.dependencies,t.defaultConfig.scriptEntry),o=z(r.name,r.description,r.version,{min_engine_version:c},[]);_(e.join(p,"manifest.json"),n),_(e.join(l,"manifest.json"),o)}const d=e.join(n,"pack_icon.png");y(d,e.join(p,"pack_icon.png")),y(d,e.join(l,"pack_icon.png"));t.resources.forEach((o=>{const i=e.join(n,o.path);w(i,l)}));const u=t.scripts,f=e.join(p,"scripts/");for(const o of u)await T(n,f,o);const g=e.join(n,t.defaultConfig.buildEntry);await C(g),"development"===t.defaultConfig.buildMode&&await J(g,a,o),async function(n,o){await D(N.WRITE_GAME_DEV,n,o)}(n,o),t.useHMR};function G(n){return n.split(".").map((n=>Number(n)))}const V=(n,o,e,i={},t=[],s)=>{console.log("开始生成behavior_packs/manifest.json"),console.log("Entry:",s);const r=new M(n+"_BP",o,G(e),j(),i),c=new E("行为模块","data",j(),G(e)),a=new E("脚本模块","script",j(),G(e));s&&(a.entry=s);const p=new x(["@sapdon"],"MIT",{sapdon:["1.0.0"]},"addon","https://github.com/junjun260/sapdon"),l=new F(2,r,[c,a],t,null,p);return JSON.stringify(l,null,2)},z=(n,o,e,i={},t=[])=>{const s=new M(n+"_RP",o,G(e),j(),i),r=new E("资源模块","resources",j(),G(e)),c=new x(["@sapdon"],"MIT",{sapdon:["1.0.0"]},"addon","https://github.com/junjun260/sapdon"),a=new F(2,s,[r],[],null,c);return JSON.stringify(a,null,2)},q=t(import.meta.url),H=e.dirname(q);process.removeAllListeners("warning"),n.command("init").description("初始化一个基于NodeJS的项目").action((()=>{const n=process.cwd(),i=e.join(n,"package.json");let t;if(s.existsSync(i)){try{t=JSON.parse(s.readFileSync(i,"utf-8"))}catch(n){return console.error("读取package.json文件时出错:",n),void console.log("请使改用create命令进行创建。")}t.scripts={...t.scripts,init:"sapdon init",pack:"sapdon pack",config:"sapdon config"};try{s.writeFileSync(i,JSON.stringify(t,null,2),"utf-8")}catch(n){return void console.error("写入package.json文件时出错:",n)}o.prompt([{type:"input",name:"min_engine_version",message:"最低引擎版本:",default:"1.19.50"}]).then((o=>{((n,o)=>{if(!(h(e.join(n,"mod.info"))&&h(e.join(n,"main.mjs"))&&h(e.join(n,"scripts"))&&h(e.join(n,"build.config"))))return void console.log("项目已存在...");const i=e.join(b,"../templates/test_sapdon");w(i,n),_(e.join(n,"mod.info"),JSON.stringify(o,null,2))})(n,{...P(n),...o}),console.log("请使用命令sapdon config配置框架的build.config文件。")}))}else console.error("没有找到package.json文件，请使改用create命令进行创建。")})),n.command("create <project-name>").description("Create a new project").action((n=>{o.prompt([{type:"input",name:"name",message:"Project Name:",default:e.basename(n)},{type:"input",name:"description",message:"Project Description:",default:"A new sapdon project"},{type:"input",name:"author",message:"Author Name:",default:"Sapdon"},{type:"input",name:"version",message:"Project Version:",default:"1.0.0"},{type:"input",name:"min_engine_version",message:"Minimum Engine Version:",default:"1.19.50"},{type:"input",name:"language",message:"Language:(js/ts)",default:"ts"}]).then((o=>{const t=e.join(process.cwd(),n);console.log("项目路径:",t),((n,o)=>{if(console.log(1,o),!h(n))return void console.log("项目名称已存在，创建项目目录失败");const i=e.join(b,`../../src/templates/${k[o.language||"js"]}`);w(i,n),_(e.join(n,"mod.info"),JSON.stringify(o,null,2)),a.execSync("npm i",{cwd:n,stdio:"inherit"})})(t,o),function(n){const o=e.join(i.homedir(),"AppData/Local/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang/"),t=e.join(i.homedir(),"AppData/Local/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang/"),r=e.join(n,"./build.config"),c=JSON.parse(s.readFileSync(r));c.mojangPath=o,c.betaPath=t,_(r,JSON.stringify(c,null,2))}(t),L(t)}))})),n.command("build <project-name>").description("Build the project").action((n=>{console.log("Building the project...");const o=e.join(process.cwd(),n);B(o)&&$(o,e.basename(o))})),n.command("pack").description("Pack the current project").action((()=>{console.log("Packing the current project...");const n=process.cwd();B(n)&&$(n,e.basename(n))})),n.command("lib").description("Generate lib files for development server.").action((()=>{L(process.cwd())})),n.command("config").description("Configure build.config file").action((()=>{const n=e.join(H,"./build.config");let t;try{t=JSON.parse(S(n))}catch(n){return void console.error("读取build.config文件时出错:",n)}o.prompt([{type:"input",name:"mojangPath",message:"Mojang Path (must end with LocalState/games/com.mojang/):",default:e.join(i.homedir(),"AppData/Local/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang/")},{type:"input",name:"mojangBetaPath",message:"Mojang Beta Path (must end with LocalState/games/com.mojang/):",default:e.join(i.homedir(),"AppData/Local/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang/")}]).then((o=>{try{s.writeFileSync(n,JSON.stringify({...t,...o},null,2),"utf-8"),console.log("build.config文件已更新。")}catch(n){console.error("写入build.config文件时出错:",n)}}))})),n.parse(n.argv);

package/dist/cli/tools/textureSet.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 生成 block_texture.json 文件
+ * @param {string} itemTexturesPath - 包含 PNG 文件的根目录
+ * @param {string} outputPath - 输出的 JSON 文件路径
+ * @param {string} projectName - 项目名称
+ */
+export function generateBlockTextureJson(itemTexturesPath: string, outputPath: string, projectName: string, userTerrainTextures: any): Promise<void>;
+/**
+ * 生成 item_texture.json 文件
+ * @param {string} itemTexturesPath - 包含 PNG 文件的根目录
+ * @param {string} outputPath - 输出的 JSON 文件路径
+ */
+export function generateItemTextureJson(itemTexturesPath: string, outputPath: string, projectName: any, userItemTextures: any): Promise<void>;

package/dist/cli/tools/textureSet.js

@@ -0,0 +1,103 @@
+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/dist/cli/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 同步复制文件
+ * @param {string} src 源文件路径
+ * @param {string} dest 目标文件路径
+ */
+export function copyFileSync(src: string, dest: string): void;
+export function dirname(importMeta: any): string;
+export function asyncImport(path: any): Promise<any>;
+export function generateUUID(): `${string}-${string}-${string}-${string}-${string}`;
+export function pathNotExist(filePath: any): boolean;
+export function readFile(filePath: any): string | null;
+export function saveFile(filePath: string, data: string): void;
+export function copyFolder(sourcePath: any, destinationPath: any): void;

package/dist/cli/utils.js

@@ -0,0 +1,89 @@
+import fs from "fs";
+import path from "path";
+import { randomUUID } from "crypto";
+import { fileURLToPath } from "node:url";
+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 pathNotExist = 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);
+        }
+    });
+};
+export function dirname(importMeta) {
+    const __filename = fileURLToPath(importMeta.url);
+    const __dirname = path.dirname(__filename);
+    return __dirname;
+}
+export function asyncImport(path) {
+    if (!path.startsWith('.')) {
+        return import('file://' + path);
+    }
+    return import(path);
+}

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

@@ -0,0 +1,22 @@
+export class AddonBiome {
+    constructor(format_version: any, definition: any);
+    format_version: any;
+    definition: any;
+    toJson(): {
+        format_version: any;
+        "minecraft:biome": any;
+    };
+}
+export class AddonBiomeDescription {
+    constructor(identifier: any);
+    identifier: any;
+}
+export class AddonBiomeDefinition {
+    /**
+     *
+     * @param {AddonBiomeDescription} description
+     */
+    constructor(description: AddonBiomeDescription, components: any);
+    description: AddonBiomeDescription;
+    components: any;
+}

package/dist/core/addon/biome.js

@@ -0,0 +1,27 @@
+export class AddonBiome {
+    constructor(format_version, definition) {
+        this.format_version = format_version;
+        this.definition = definition;
+    }
+    toJson() {
+        return {
+            format_version: this.format_version,
+            ["minecraft:biome"]: this.definition
+        };
+    }
+}
+export class AddonBiomeDescription {
+    constructor(identifier) {
+        this.identifier = identifier;
+    }
+}
+export class AddonBiomeDefinition {
+    /**
+     *
+     * @param {AddonBiomeDescription} description
+     */
+    constructor(description, components) {
+        this.description = description;
+        this.components = components;
+    }
+}

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

@@ -0,0 +1,41 @@
+export class AddonBlock {
+    /**
+     * Addon方块类
+     * @param {string} format_version 格式版本
+     * @param {AddonBlockDefinition} definitions 方块定义
+     */
+    constructor(format_version: string, definitions: AddonBlockDefinition);
+    format_version: string;
+    definitions: AddonBlockDefinition;
+    toJson(): {
+        format_version: string;
+        "minecraft:block": AddonBlockDefinition;
+    };
+}
+export class AddonBlockDefinition {
+    /**
+     * 方块定义类
+     * @param {AddonBlockDescription} description 方块描述
+     * @param {Object} components 方块组件
+     * @param {Array} permutations 方块变体
+     */
+    constructor(description: AddonBlockDescription, components: Object, permutations?: any[]);
+    description: AddonBlockDescription;
+    components: Object;
+    permutations: any[];
+}
+export class AddonBlockDescription {
+    /**
+     * 方块描述类
+     * @param {string} identifier 唯一标识符
+     * @param {map} traits 方块特性
+     * @param {map} states 方块状态
+     * @param {AddonMenuCategory} menu_category
+     */
+    constructor(identifier: string, traits: map, states: map, menu_category: AddonMenuCategory);
+    identifier: string;
+    traits: map;
+    states: map;
+    menu_category: AddonMenuCategory;
+}
+import { AddonMenuCategory } from "../menuCategory.js";

package/dist/core/addon/block/block.js

@@ -0,0 +1,46 @@
+import { AddonMenuCategory } from "../menuCategory.js";
+export class AddonBlock {
+    /**
+     * Addon方块类
+     * @param {string} format_version 格式版本
+     * @param {AddonBlockDefinition} definitions 方块定义
+     */
+    constructor(format_version, definitions) {
+        this.format_version = format_version;
+        this.definitions = definitions;
+    }
+    toJson() {
+        return {
+            format_version: this.format_version,
+            ["minecraft:block"]: this.definitions
+        };
+    }
+}
+export class AddonBlockDefinition {
+    /**
+     * 方块定义类
+     * @param {AddonBlockDescription} description 方块描述
+     * @param {Object} components 方块组件
+     * @param {Array} permutations 方块变体
+     */
+    constructor(description, components, permutations = []) {
+        this.description = description;
+        this.components = components;
+        this.permutations = permutations;
+    }
+}
+export class AddonBlockDescription {
+    /**
+     * 方块描述类
+     * @param {string} identifier 唯一标识符
+     * @param {map} traits 方块特性
+     * @param {map} states 方块状态
+     * @param {AddonMenuCategory} menu_category
+     */
+    constructor(identifier, traits, states, menu_category) {
+        this.identifier = identifier;
+        this.traits = traits;
+        this.states = states;
+        this.menu_category = menu_category;
+    }
+}

package/dist/core/addon/controllers/animationController.d.ts

@@ -0,0 +1,43 @@
+export class AddonAnimationController {
+    constructor(format_version: any, definition: any);
+    format_version: any;
+    definition: any;
+    toJson(): {
+        format_version: any;
+        animation_controllers: any;
+    };
+}
+export class AddonAnimationStateMachine {
+    constructor(identifier: any);
+    identifier: any;
+    namespace: any;
+    name: any;
+    initialState: string | null;
+    states: Map<any, any>;
+    /**
+     * 设置状态机的初始状态。
+     * @param {string} stateName - 初始状态的名称。
+     * @returns {AddonAnimationStateMachine} - 返回实例以支持链式调用。
+     */
+    setInitialState(stateName: string): AddonAnimationStateMachine;
+    /**
+     * 添加一个新状态到状态机。
+     * @param {string} stateName - 状态的名称。
+     * @param {string[]} animations - 该状态播放的动画列表。
+     * @returns {AddonAnimationStateMachine} - 返回实例以支持链式调用。
+     */
+    addState(stateName: string, animations?: string[]): AddonAnimationStateMachine;
+    /**
+     * 添加一个状态之间的过渡条件。
+     * @param {string} fromState - 过渡的起始状态名称。
+     * @param {string} toState - 过渡的目标状态名称。
+     * @param {string} condition - 触发过渡的条件（例如 "q.is_on_ground"）。
+     * @returns {AddonAnimationStateMachine} - 返回实例以支持链式调用。
+     */
+    addTransition(fromState: string, toState: string, condition: string): AddonAnimationStateMachine;
+    /**
+     * 将整个状态机转换为 JSON 兼容的对象。
+     * @returns {object} - 包含格式版本的完整动画控制器定义。
+     */
+    toJson(): object;
+}

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)
+            }
+        };
+    }
+}