sapdon 2.1.0 → 3.0.0

package/README.md

@@ -1,26 +1,111 @@
-Sapdon框架是一个功能强大的JavaScript框架，专门设计用于开发基岩版的模组。该框架致力于统一开发形式和简化开发过程，使开发者能够更轻松地创建基岩版的模组。
 
-使用Sapdon框架，开发者能够充分利用JavaScript语言的灵活性和易用性，快速编写出高效且功能丰富的基岩版模组。框架提供了丰富的API和工具,帮助开发者处理模组的生命周期、实体的创建、方块的定义、物品的添加和食谱的制作等功能。
+# Sapdon 框架
 
-该框架的一个主要优势是其自动编译功能，它可以将开发者编写的代码自动转换为mcaddon包，使模组的发布和分享变得非常简便。开发者只需专注于编写模组的逻辑和功能，不需要手动处理繁琐的打包和转换过程。
+![Sapdon Logo](pack_icon.png)
 
-此外，Sapdon框架还提供了全面的文档和示例代码，帮助开发者快速上手并解决在开发过程中遇到的问题。同时，框架还积极维护更新，以确保与最新版本的基岩版游戏保持兼容性。
+Sapdon 是一个基于 JavaScript 开发的 Minecraft 基岩版模组开发框架。它通过提供丰富的 API 和自动化工具，帮助开发者简化传统开发流程，降低 JSON 配置复杂度，让您专注于模组逻辑实现。
 
-总而言之，Sapdon框架是一个强大而便捷的工具，为开发者提供了简化基岩版模组开发的解决方案。无论是初学者还是有经验的开发者，都可以通过使用这个框架，快速构建出令人印象深刻的基岩版模组。
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D16.0-blue)](https://nodejs.org/)
+[![npm Version](https://img.shields.io/npm/v/sapdon)](https://www.npmjs.com/package/sapdon)
+[![QQ Group](https://img.shields.io/badge/QQ%E7%BE%A4-810904181-green)](https://qm.qq.com/q/2HrXHcKq9j)
 
-官方QQ群： 810904181  
+## ✨ 核心特性
 
-### sapdon cli 命令行工具
-功能：
-1.创建新项目 
-    sapdon create <project_name> 在当前目录下创建新项目文件夹，并初始化项目文件
+- **JavaScript 驱动开发** - 告别繁琐的 JSON 配置，使用现代 JS 语法编写模组
+- **模块化 API 设计** - 提供物品/方块/实体/配方等 30+ 核心 API 接口
+- **智能编译系统** - 一键生成标准 mcaddon 包文件
 
-2.编译项目 
-    sapdon build <project_name> 将指定项目编译为mcaddon包，并输出到指定目录
+## 🚀 快速入门
 
-### sadon core 核心模块
-提供API接口，方便其他模块调用
-采用注册方式
+### 环境准备
+
+1. 安装 [Node.js](https://nodejs.org/) (推荐 v16+)
+2. 安装 Visual Studio Code 或其他现代编辑器
+
+### 安装 CLI
+
+```bash
+npm install -g sapdon
+```
+
+### 创建新项目
+
+```bash
+sapdon create my-first-mod
+```
+
+根据提示输入项目信息：
+```text
+✔ Project Name: my-first-mod
+✔ Project Description: 我的第一个 Sapdon 模组
+✔ Author Name: YourName
+✔ Project Version: 1.0.0
+✔ Minimum Engine Version: 1.19.50
+```
+
+### 项目结构
+
+```
+my-first-mod/
+├── res/            # 资源文件（纹理/模型/音效）
+├── scripts/        # 游戏脚本
+├── build.config    # 构建配置
+├── main.mjs        # 主入口文件
+├── mod.info        # 模组元数据
+└── pack_icon.png   # 模组图标
+```
+
+## 📦 核心 API 示例
+
+### 创建一个基础物品
+1. 打开 `main.mjs` 文件。
+2. 写入以下内容以创建一个基础物品：
+   ```javascript
+   import { ItemAPI } from "../src/core";
+
+   ItemAPI.createItem("hello_sapdon:my_item", "items", "masterball");
+   ```
+   这段代码将创建一个名为 `my_item` 的物品，其命名空间为 `hello_sapdon`，类型为 `items`，并使用 `masterball` 作为图标。
+
+
+## 🛠 执行构建命令
+
+1. 在终端中输入以下命令以构建 `hello_sapdon` 项目：
+   ```bash
+   npm run build hello_sapdon
+   ```
+2. 构建完成后，您将在 `hello_sapdon` 文件夹下看到一个 `dev` 文件夹，其中包含构建好的 Addon 包。
+
+
+生成优化后的 mcaddon 包文件
+
+## 📚 学习资源
+
+- [官方文档](https://docs.sapdon.org)
+- [示例模组仓库](https://github.com/Meteage/sapdon/examples)
+
+
+## ❓ 常见问题
+
+### 如何更新框架版本？
+```bash
+npm update sapdon
+```
+
+### 如何添加依赖库？
+在 `build.config` 中添加：
+```json
+{
+  "dependencies": [
+    {
+      "module_name": "@minecraft/server-gametest",
+      "version": "1.0.0"
+    }
+  ]
+}
+```
+
+## 🤝 社区支持
+
+- 官方 QQ 群：`810904181`
 
-### 新特性
-更适合npm的体质，可以读取nodejs的项目信息作为基础配置。

package/dist/cli/build.d.ts

@@ -0,0 +1,7 @@
+export function projectCanBuild(projectPath: any, projectName: any): boolean;
+export namespace scriptBundler {
+    let __projectPath: string;
+    function js(source: any, target: any): void;
+    function ts(source: any, target: any, tname?: string, sname?: string): Promise<void>;
+}
+export function buildProject(projectPath: string, projectName: string): Promise<void>;

package/dist/cli/build.js

@@ -0,0 +1,232 @@
+import path from 'path';
+import { pathNotExist, readFile, generateUUID, saveFile, copyFileSync, copyFolder, asyncImport } from "./utils.js";
+import { generateAddonClient } from './load.js';
+import { AddonManifestHeader, AddonManifestModule, AddonManifest, AddonManifestMetadata } from '../core/addon/manifest.js';
+import { fileURLToPath } from 'url';
+import fs from 'fs';
+import { rollup } from 'rollup';
+import commonjs from '@rollup/plugin-commonjs';
+import { nodeResolve } from '@rollup/plugin-node-resolve';
+import ts from '@rollup/plugin-typescript';
+import { typescriptPaths as paths } from 'rollup-plugin-typescript-paths';
+import json from '@rollup/plugin-json';
+import { visualizer } from 'rollup-plugin-visualizer';
+import { syncDevFilesClient } from './dev-server/syncFiles.js';
+import { hmr } from './dev-server/hmr.js';
+import cp from 'child_process';
+// 获取当前文件的目录路径
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+//读取配置文件
+// const pathConfig = JSON.parse(readFile(path.join(__dirname, "./build.config")))
+const rollupIgnores = [
+    'rollup',
+    'typescript',
+    '@sapdon',
+];
+//脚本打包器
+export const scriptBundler = {
+    __projectPath: path.join(__dirname, '../../'),
+    js: (source, target) => {
+        copyFolder(source, target);
+    },
+    //ts先通过rollup处理后再复制
+    ts: async (source, target, tname = 'index.js', sname = 'index.ts') => {
+        // console.log(source, target, tname)
+        const tmpFile = path.join(scriptBundler.__projectPath, '.tmp', `sapdon-${crypto.randomUUID()}.js`);
+        try {
+            const bundle = await rollup({
+                input: path.join(source, sname),
+                plugins: [
+                    paths(),
+                    nodeResolve({
+                        preferBuiltins: true
+                    }),
+                    ts({
+                        tsconfig: path.join(scriptBundler.__projectPath, 'tsconfig.json'),
+                    }),
+                    commonjs(),
+                    json(),
+                    // visualizer({ open: true }),  //可视化分析, 打包出问题取消注释这一行
+                ],
+                external(name) {
+                    for (const candidate of rollupIgnores) {
+                        if (name.includes(candidate)) {
+                            return true;
+                        }
+                    }
+                    return false;
+                }
+            });
+            await bundle.write({
+                file: tmpFile,
+                format: 'esm',
+            });
+            bundle.close();
+            fs.cpSync(tmpFile, path.join(target, tname));
+        }
+        catch (e) {
+            console.error(e);
+        }
+        finally {
+            fs.rmSync(tmpFile, {
+                recursive: true,
+                force: true
+            });
+        }
+    }
+};
+async function bundleScripts(projectPath, scriptPath, element) {
+    const sourcePath = path.join(projectPath, element.path);
+    const elementType = element.type || 'js';
+    scriptBundler.__projectPath = projectPath;
+    scriptBundler[elementType](sourcePath, scriptPath);
+}
+function preload(filePath) {
+    fs.appendFileSync(filePath, `
+        ;(async () => {
+            const { startDevServer } = await import('@sapdon/cli')
+            const { GRegistry, UISystemRegistry } = await import('@sapdon/core')
+            startDevServer(GRegistry, UISystemRegistry)
+            process.send('initialized')
+        })();
+    `);
+}
+async function runOnChild(targetFilePath) {
+    const { promise, resolve } = Promise.withResolvers();
+    const child = cp.fork(targetFilePath, { stdio: 'inherit' });
+    child.once('message', message => {
+        if (message !== 'initialized') {
+            child.kill();
+        }
+        resolve();
+    });
+    await promise;
+}
+async function runScript(src) {
+    if (src.endsWith('.ts')) {
+        const randomName = crypto.randomUUID() + '.js';
+        const sourceDir = path.dirname(src);
+        const sourceFileName = src.replace(sourceDir, '');
+        const targetFilePath = path.join(sourceDir, randomName);
+        await scriptBundler.ts(sourceDir, sourceDir, randomName, sourceFileName);
+        preload(targetFilePath);
+        try {
+            await runOnChild(targetFilePath);
+        }
+        finally {
+            fs.rmSync(targetFilePath, { force: true });
+        }
+        return;
+    }
+    await runOnChild(src);
+}
+export function projectCanBuild(projectPath, projectName) {
+    console.log("开始构建项目");
+    console.log("项目路径：" + projectPath);
+    //检查项目是否存在
+    if (pathNotExist(projectPath)) {
+        console.log("项目不存在");
+        return false;
+    }
+    //检查项目是否有build.config文件
+    if (pathNotExist(path.join(projectPath, "build.config"))) {
+        console.log("项目没有build.config文件");
+        return false;
+    }
+    return true;
+}
+//构建项目
+/**
+ * `client`
+ *
+ * 在使用前使用 `projectCanBuild` 确保项目可以构建
+ * @param {string} projectPath
+ * @param {string} projectName
+ */
+export const buildProject = async (projectPath, projectName) => {
+    //读取build.config文件
+    const buildConfigPath = path.join(projectPath, "build.config");
+    const buildConfig = JSON.parse(readFile(buildConfigPath));
+    //console.log(buildConfig)
+    //读取mod.info文件
+    const modInfoPath = path.join(projectPath, "mod.info");
+    const modInfo = JSON.parse(readFile(modInfoPath));
+    const min_engine_version = versionStringToArray(modInfo.min_engine_version);
+    const buildDirPath = path.join(projectPath, buildConfig.defaultConfig.buildDir);
+    const buildBehDirPath = path.join(buildDirPath, `${projectName}_BP/`);
+    const buildResDirPath = path.join(buildDirPath, `${projectName}_RP/`);
+    //生成manifest.json文件
+    //判断manifest.json是否已经生成过了，生成过了就不用生成
+    const manifestPath = path.join(buildBehDirPath, "manifest.json");
+    if (pathNotExist(manifestPath)) {
+        const behManifest = generateBehManifest(modInfo.name, modInfo.description, modInfo.version, {
+            min_engine_version: min_engine_version,
+        }, buildConfig.defaultConfig.dependencies, buildConfig.defaultConfig.scriptEntry);
+        const resManifest = generateResManifest(modInfo.name, modInfo.description, modInfo.version, {
+            min_engine_version: min_engine_version,
+        }, []);
+        //BP
+        saveFile(path.join(buildBehDirPath, "manifest.json"), behManifest);
+        //RP
+        saveFile(path.join(buildResDirPath, "manifest.json"), resManifest);
+    }
+    //复制pack_icon.png
+    const packIconPath = path.join(projectPath, "pack_icon.png");
+    copyFileSync(packIconPath, path.join(buildBehDirPath, "pack_icon.png"));
+    copyFileSync(packIconPath, path.join(buildResDirPath, "pack_icon.png"));
+    const resources = buildConfig.resources;
+    resources.forEach(element => {
+        const sourcePath = path.join(projectPath, element.path);
+        copyFolder(sourcePath, buildResDirPath);
+    });
+    const scripts = buildConfig.scripts;
+    const scriptPath = path.join(buildBehDirPath, "scripts/");
+    for (const element of scripts) {
+        await bundleScripts(projectPath, scriptPath, element);
+    }
+    const absoluteModPath = path.join(projectPath, buildConfig.defaultConfig.buildEntry);
+    await runScript(absoluteModPath);
+    //只有当buildMode为development时才加载用户modjs文件
+    if (buildConfig.defaultConfig.buildMode === "development") {
+        //动态加载用户modjs文件
+        await generateAddonClient(absoluteModPath, buildDirPath, projectName);
+    }
+    syncDevFilesClient(projectPath, projectName);
+    if (buildConfig.useHMR === true) {
+        hmr(projectPath, projectName);
+    }
+};
+function versionStringToArray(versionString) {
+    // 使用 split 方法将字符串按 '.' 分割成数组
+    const parts = versionString.split('.');
+    // 使用 map 方法将每个部分转换为数字
+    const versionArray = parts.map(part => Number(part));
+    return versionArray;
+}
+const generateBehManifest = (name, description, version, options = {}, dependencies = [], entry) => {
+    console.log("开始生成behavior_packs/manifest.json");
+    console.log("Entry:", entry);
+    const header = new AddonManifestHeader((name + "_BP"), description, versionStringToArray(version), generateUUID(), options);
+    const module = new AddonManifestModule("行为模块", "data", generateUUID(), versionStringToArray(version));
+    const script_module = new AddonManifestModule("脚本模块", "script", generateUUID(), versionStringToArray(version));
+    if (entry) {
+        script_module.entry = entry;
+    }
+    const metadata = new AddonManifestMetadata(["@sapdon"], "MIT", {
+        "sapdon": ["1.0.0"]
+    }, "addon", "https://github.com/junjun260/sapdon");
+    const manifest = new AddonManifest(2, //格式版本
+    header, [module, script_module], dependencies, null, metadata);
+    return JSON.stringify(manifest, null, 2);
+};
+const generateResManifest = (name, description, version, options = {}, dependencies = []) => {
+    const header = new AddonManifestHeader((name + "_RP"), description, versionStringToArray(version), generateUUID(), options);
+    const module = new AddonManifestModule("资源模块", "resources", generateUUID(), versionStringToArray(version));
+    const metadata = new AddonManifestMetadata(["@sapdon"], "MIT", {
+        "sapdon": ["1.0.0"]
+    }, "addon", "https://github.com/junjun260/sapdon");
+    const manifest = new AddonManifest(2, //格式版本
+    header, [module], [], null, metadata);
+    return JSON.stringify(manifest, null, 2);
+};

package/dist/cli/dev-server/client.d.ts

@@ -0,0 +1,2 @@
+export function cliRequest(path: any, ...params: any[]): Promise<void>;
+export function writeAddon(modPath: any, buildPath: any, projectName: any): Promise<void>;

package/dist/cli/dev-server/client.js

@@ -0,0 +1,20 @@
+import { devServerConfig } from './config.js';
+const { port } = devServerConfig;
+export async function cliRequest(path, ...params) {
+    try {
+        await fetch(`http://localhost:${port}/${path}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(params)
+        });
+    }
+    catch (error) {
+        console.error(error);
+        console.error('尝试在构建脚本中使用 server.startDevServer() 启动开发服务器');
+    }
+}
+export async function writeAddon(modPath, buildPath, projectName) {
+    await cliRequest('write-addon', modPath, buildPath, projectName);
+}

package/dist/cli/dev-server/config.d.ts

@@ -0,0 +1,3 @@
+export namespace devServerConfig {
+    let port: number;
+}

package/dist/cli/dev-server/config.js

@@ -0,0 +1,3 @@
+export const devServerConfig = {
+    port: 49037
+};

package/dist/cli/dev-server/hmr.d.ts

@@ -0,0 +1 @@
+export function hmr(projectPath: any, projectName: any): void;

package/dist/cli/dev-server/hmr.js

@@ -0,0 +1,13 @@
+import fs from 'fs';
+import lodash from 'lodash';
+import { buildProject } from '../build.js';
+const debounce = lodash.debounce;
+export function hmr(projectPath, projectName) {
+    // fs.watch(projectPath, { recursive: true }, debounce(async (eventType, filename) => {
+    //     if (filename.endsWith('.js') || filename.endsWith('.ts')) {
+    //         process.stdout.write(`File ${filename} changed, reloading...\r`)
+    //         await buildProject(projectPath, projectName)
+    //         console.log(`Reloaded ${filename}`)
+    //     }
+    // }), 1000)
+}

package/dist/cli/dev-server/index.d.ts

@@ -0,0 +1,3 @@
+export function startDevServer(GRegistry: any, UIRegistry: any): void;
+export { server };
+import { server } from "./server.js";

package/dist/cli/dev-server/index.js

@@ -0,0 +1,11 @@
+import { generateAddon } from "../load.js";
+import { bootstrap, isListening, server } from "./server.js";
+import { syncDevFilesServer } from "./syncFiles.js";
+export function startDevServer(GRegistry, UIRegistry) {
+    if (!isListening()) {
+        bootstrap();
+        server.handle('write-addon', generateAddon(GRegistry, UIRegistry));
+        server.handle('sync-files', syncDevFilesServer);
+    }
+}
+export { server, };

package/dist/cli/dev-server/server.d.ts

@@ -0,0 +1,6 @@
+export function isListening(): boolean;
+export function bootstrap(): http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
+export namespace server {
+    function handle(url: any, handler: any): void;
+}
+import http from 'http';

package/dist/cli/dev-server/server.js

@@ -0,0 +1,50 @@
+import http from 'http';
+import { devServerConfig } from './config.js';
+const { port } = devServerConfig;
+const cliServerHandlers = new Map();
+let listening = false;
+export function isListening() {
+    return listening;
+}
+// server
+export function bootstrap() {
+    listening = true;
+    const svr = http.createServer(async (req, res) => {
+        const handler = cliServerHandlers.get(req.url.slice(1));
+        if (handler) {
+            try {
+                const { promise, resolve, reject } = Promise.withResolvers();
+                let buf = Buffer.alloc(0);
+                req.on('data', chunk => buf = Buffer.concat([buf, chunk]));
+                req.on('end', () => {
+                    try {
+                        resolve(JSON.parse(buf));
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                });
+                await handler(...await promise);
+            }
+            catch (error) {
+                console.error(error);
+                res.writeHead(500);
+                res.end();
+                return;
+            }
+            res.writeHead(200);
+            res.end();
+        }
+        else {
+            res.writeHead(404);
+            res.end();
+        }
+    }).listen(port, () => console.log(`Dev Server listening on port ${port}`));
+    svr.on('error', () => listening = false);
+    return svr;
+}
+export const server = {
+    handle(url, handler) {
+        cliServerHandlers.set(url, handler);
+    }
+};

package/dist/cli/dev-server/syncFiles.d.ts

@@ -0,0 +1,3 @@
+export function syncDevFilesClient(projectPath: any, projectName: any): Promise<void>;
+export function syncDevFilesServer(projectPath: any, projectName: any): Promise<void>;
+export function writeLib(projectPath: any): Promise<void>;

package/dist/cli/dev-server/syncFiles.js

@@ -0,0 +1,36 @@
+import { readFileSync } from "fs";
+import { cliRequest } from "./client.js";
+import { copyFolder, dirname } from "../utils.js";
+import path from "path";
+import fs from 'fs';
+export async function syncDevFilesClient(projectPath, projectName) {
+    await cliRequest('sync-files', projectPath, projectName);
+}
+export async function syncDevFilesServer(projectPath, projectName) {
+    const buildConfig = JSON.parse(readFileSync(path.join(projectPath, "build.config")));
+    const buildDir = path.join(projectPath, buildConfig.defaultConfig.buildDir);
+    const buildBehDirPath = path.join(buildDir, `${projectName}_BP`);
+    const buildResDirPath = path.join(buildDir, `${projectName}_RP`);
+    copyFolder(buildBehDirPath, path.join(buildConfig.mojangPath, "development_behavior_packs/", `${projectName}_BP/`));
+    copyFolder(buildResDirPath, path.join(buildConfig.mojangPath, "development_resource_packs/", `${projectName}_RP/`));
+}
+export async function writeLib(projectPath) {
+    const projectModules = path.join(projectPath, "node_modules");
+    const rootDir = path.join(dirname(import.meta), '../../');
+    const corePath = path.join(rootDir, 'core');
+    const cliPath = path.join(rootDir, 'cli');
+    const targetCorePath = path.join(projectModules, '@sapdon/core');
+    const targetCliPath = path.join(projectModules, '@sapdon/cli');
+    fs.cpSync(corePath, targetCorePath, { recursive: true, force: true });
+    fs.cpSync(cliPath, targetCliPath, { recursive: true, force: true });
+    fs.writeFileSync(path.join(targetCorePath, 'package.json'), JSON.stringify({
+        name: '@sapdon/core',
+        main: 'index.js',
+        version: '1.0.0',
+    }));
+    fs.writeFileSync(path.join(targetCliPath, 'package.json'), JSON.stringify({
+        name: '@sapdon/cli',
+        main: 'index.js',
+        version: '1.0.0',
+    }));
+}

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+export { server as devServer, startDevServer } from "./dev-server/index.js";

package/dist/cli/index.js

@@ -0,0 +1 @@
+export { server as devServer, startDevServer, } from './dev-server/index.js';

package/dist/cli/init.d.ts

@@ -0,0 +1,9 @@
+export function initMojangPath(projectPath: any): void;
+export function initProject(projectPath: any, data: any): void;
+export function initNPMProject(projectPath: any, data: any): void;
+export function readPackageJson(dir: any): {
+    name: string;
+    description: any;
+    author: any;
+    version: any;
+};

package/dist/cli/init.js

@@ -0,0 +1,80 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { pathNotExist, copyFolder, saveFile } from './utils.js';
+import fs from "fs";
+import cp from "child_process";
+import os from "os";
+// 获取当前文件的路径
+const __filename = fileURLToPath(import.meta.url);
+// 获取当前文件的目录
+const __dirname = path.dirname(__filename);
+const templateMapping = {
+    js: 'test_sapdon',
+    ts: 'ts_sapdon'
+};
+export function initMojangPath(projectPath) {
+    const mojangPath = path.join(os.homedir(), "AppData/Local/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang/");
+    const betaPath = path.join(os.homedir(), "AppData/Local/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang/");
+    const buildConfigPath = path.join(projectPath, './build.config');
+    const buildConfig = JSON.parse(fs.readFileSync(buildConfigPath));
+    buildConfig.mojangPath = mojangPath;
+    buildConfig.betaPath = betaPath;
+    saveFile(buildConfigPath, JSON.stringify(buildConfig, null, 2));
+}
+export const initProject = (projectPath, data) => {
+    console.log(1, data);
+    //检查项目目录是否存在
+    //如果不存在则创建项目目录
+    //从模板下载项目文件
+    //根据用户输入的项目信息生成项目配置文件
+    //根据用户选择是否生成脚本文件，生成脚本文件
+    if (!pathNotExist(projectPath)) {
+        console.log("项目名称已存在，创建项目目录失败");
+        return;
+    }
+    //模版目录
+    const templateDir = path.join(__dirname, `../../src/templates/${templateMapping[data.language || 'js']}`);
+    copyFolder(templateDir, projectPath);
+    //生成模组介绍文件
+    saveFile(path.join(projectPath, "mod.info"), JSON.stringify(data, null, 2));
+    //执行npm i
+    cp.execSync('npm i', { cwd: projectPath, stdio: 'inherit' });
+};
+export const initNPMProject = (projectPath, data) => {
+    //检查项目文件是否存在
+    //如果不存在则创建项目
+    //从模板下载项目文件
+    //根据用户输入的项目信息生成项目配置文件
+    //根据用户选择是否生成脚本文件，生成脚本文件
+    if (!pathNotExist(path.join(projectPath, "mod.info")) || !pathNotExist(path.join(projectPath, "main.mjs")) || !pathNotExist(path.join(projectPath, "scripts")) || !pathNotExist(path.join(projectPath, "build.config"))) {
+        console.log("项目已存在...");
+        return;
+    }
+    //模版目录
+    const templateDir = path.join(__dirname, "../templates/test_sapdon");
+    copyFolder(templateDir, projectPath);
+    //生成模组介绍文件
+    saveFile(path.join(projectPath, "mod.info"), JSON.stringify(data, null, 2));
+};
+// 读取package.json文件并提取信息
+export const readPackageJson = (dir) => {
+    const packageJsonPath = path.join(dir, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+            return {
+                name: path.basename(dir),
+                description: packageJson.description || "A new sapdon project",
+                author: packageJson.author || "Sapdon",
+                version: packageJson.version || "1.0.0"
+            };
+        }
+        catch (error) {
+            console.error("读取package.json文件时出错:", error);
+            return null;
+        }
+    }
+    else {
+        return null;
+    }
+};

package/dist/cli/load.d.ts

@@ -0,0 +1,3 @@
+export function processBlocksData(data: any): any;
+export function generateAddonClient(modPath: any, buildPath: any, projectName: any): Promise<void>;
+export function generateAddon(GRegistry: any, UISystemRegistry: any): (modPath: any, buildPath: any, projectName: any) => Promise<void>;