sapdon 2.0.2 → 3.0.0

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,156 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import inquirer from 'inquirer';
+import path from 'path';
+import os from 'os';
+import { initMojangPath, initNPMProject, initProject, readPackageJson } from './init.js';
+import { buildProject, projectCanBuild } from './build.js';
+import { readFile } from "./utils.js";
+import fs from "fs";
+import { fileURLToPath } from "url";
+import { writeLib } from './dev-server/syncFiles.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+process.removeAllListeners('warning');
+function start() {
+    // 额外添加的init方法
+    program.command("init").description("初始化一个基于NodeJS的项目").action(() => {
+        const currentDir = process.cwd();
+        const packageJsonPath = path.join(currentDir, 'package.json');
+        let packageJsonData;
+        if (!fs.existsSync(packageJsonPath)) {
+            console.error("没有找到package.json文件，请使改用create命令进行创建。");
+            return;
+        }
+        try {
+            packageJsonData = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+        }
+        catch (error) {
+            console.error("读取package.json文件时出错:", error);
+            console.log("请使改用create命令进行创建。");
+            return;
+        }
+        // 添加或更新scripts字段
+        packageJsonData.scripts = {
+            ...packageJsonData.scripts,
+            init: "sapdon init",
+            pack: "sapdon pack",
+            config: "sapdon config"
+        };
+        try {
+            fs.writeFileSync(packageJsonPath, JSON.stringify(packageJsonData, null, 2), 'utf-8');
+        }
+        catch (error) {
+            console.error("写入package.json文件时出错:", error);
+            return;
+        }
+        inquirer.prompt([
+            {
+                type: "input",
+                name: "min_engine_version",
+                message: "最低引擎版本:",
+                default: "1.19.50"
+            }
+        ]).then((answers) => {
+            initNPMProject(currentDir, { ...readPackageJson(currentDir), ...answers });
+            console.log("请使用命令sapdon config配置框架的build.config文件。");
+        });
+    });
+    program.command("create <project-name>").description("Create a new project").action((projectName) => {
+        inquirer.prompt([
+            {
+                type: "input",
+                name: "name",
+                message: "Project Name:",
+                default: path.basename(projectName)
+            },
+            {
+                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((answers) => {
+            const projectPath = path.join(process.cwd(), projectName);
+            console.log('项目路径:', projectPath);
+            initProject(projectPath, answers);
+            initMojangPath(projectPath);
+            writeLib(projectPath);
+        });
+    });
+    program.command("build <project-name>").description("Build the project").action((projectName) => {
+        console.log("Building the project...");
+        const projectPath = path.join(process.cwd(), projectName);
+        if (projectCanBuild(projectPath)) {
+            buildProject(projectPath, path.basename(projectPath));
+        }
+    });
+    // pack 命令
+    program.command("pack").description("Pack the current project").action(() => {
+        console.log("Packing the current project...");
+        const projectPath = process.cwd();
+        if (projectCanBuild(projectPath)) {
+            buildProject(projectPath, path.basename(projectPath));
+        }
+    });
+    // 配置build.config文件的命令
+    program.command("config").description("Configure build.config file").action(() => {
+        const buildConfigPath = path.join(__dirname, "./build.config");
+        let buildConfigData;
+        try {
+            buildConfigData = JSON.parse(readFile(buildConfigPath));
+        }
+        catch (error) {
+            console.error("读取build.config文件时出错:", error);
+            return;
+        }
+        inquirer.prompt([
+            {
+                type: "input",
+                name: "mojangPath",
+                message: "Mojang Path (must end with LocalState/games/com.mojang/):",
+                default: path.join(os.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: path.join(os.homedir(), "AppData/Local/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang/")
+            }
+        ]).then((answers) => {
+            try {
+                fs.writeFileSync(buildConfigPath, JSON.stringify({ ...buildConfigData, ...answers }, null, 2), 'utf-8');
+                console.log("build.config文件已更新。");
+            }
+            catch (error) {
+                console.error("写入build.config文件时出错:", error);
+            }
+        });
+    });
+    program.parse(program.argv);
+}
+start();

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;
+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: any, permutations?: any[]);
+    description: AddonBlockDescription;
+    components: any;
+    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;
+    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;
+}