sapdon 3.0.3 → 3.1.0

package/README.md

@@ -81,8 +81,9 @@ hello_sapdon/
 
 ## 📚 学习资源
 
-- [官方文档](https://docs.sapdon.org)
-- [示例模组仓库](https://github.com/Meteage/sapdon/examples)
+- [官方文档](./doc/)
+- [入门教程](./doc/hello_sapdon)
+- [示例模组仓库](./examples/)
 
 
 ## ❓ 常见问题

package/dist/cli/build.js

@@ -22,7 +22,9 @@ const __dirname = path.dirname(__filename);
 const rollupIgnores = [
     'rollup',
     'typescript',
-    '@sapdon',
+    '@sapdon/core',
+    '@sapdon/cli',
+    '@minecraft',
 ];
 //脚本打包器
 export const scriptBundler = {

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

@@ -17,13 +17,16 @@ export async function syncDevFilesServer(projectPath, projectName) {
 }
 export async function writeLib(projectPath) {
     const projectModules = path.join(projectPath, "node_modules");
-    const rootDir = path.join(dirname(import.meta), '../../');
+    const rootDir = path.join(dirname(import.meta), '../');
     const corePath = path.join(rootDir, 'core');
     const cliPath = path.join(rootDir, 'cli');
+    const ocPath = path.join(rootDir, 'oc');
     const targetCorePath = path.join(projectModules, '@sapdon/core');
     const targetCliPath = path.join(projectModules, '@sapdon/cli');
+    const targetOcPath = path.join(projectModules, '@sapdon/oc');
     fs.cpSync(corePath, targetCorePath, { recursive: true, force: true });
     fs.cpSync(cliPath, targetCliPath, { recursive: true, force: true });
+    fs.cpSync(ocPath, targetOcPath, { recursive: true, force: true });
     fs.writeFileSync(path.join(targetCorePath, 'package.json'), JSON.stringify({
         name: '@sapdon/core',
         main: 'index.js',
@@ -34,4 +37,9 @@ export async function writeLib(projectPath) {
         main: 'index.js',
         version: '1.0.0',
     }));
+    fs.writeFileSync(path.join(targetOcPath, 'package.json'), JSON.stringify({
+        name: '@sapdon/oc',
+        main: 'index.js',
+        version: '1.0.0',
+    }));
 }

package/dist/cli/index.d.ts

@@ -1,11 +1,6 @@
 import http from 'http';
 
-declare enum ServerHandles {
-    WRITE_ADDON = "write-addon",
-    WRITE_GAME_DEV = "write-dev"
-}
-
-type ServerHandler = (...args: Transferable[]) => void;
+type ServerHandler = (...args: (Uint8Array & string)[]) => void | Promise<void>;
 type HandlerInterceptor = (handler: ServerHandler) => ServerHandler;
 declare class DevelopmentServer {
     readonly cliServerHandlers: Map<string, ServerHandler>;
@@ -18,6 +13,8 @@ declare class DevelopmentServer {
 }
 declare const server: DevelopmentServer;
 
-declare function startDevServer(GRegistry: any, UIRegistry: any): void;
+declare namespace client {
+    function call(name: any, ...args: any[]): Promise<void>;
+}
 
-export { ServerHandles, server as devServer, startDevServer };
+export { client, server as devServer };

package/dist/cli/index.js

@@ -1 +1,90 @@
-import e from"path";import t,{readFileSync as r}from"fs";import"crypto";import"node:url";import s from"fs/promises";import n from"http";const i=(r,s)=>{t.mkdirSync(e.dirname(r),{recursive:!0}),t.writeFile(r,s,(e=>{if(e)return console.error(e)}))},o=(r,s)=>{if(t.mkdirSync(e.dirname(s),{recursive:!0}),!t.existsSync(r))return void console.log(`Source path ${r} does not exist.`);t.existsSync(s)||t.mkdirSync(s);t.readdirSync(r).forEach((n=>{const i=e.join(r,n),a=e.join(s,n);t.lstatSync(i).isDirectory()?o(i,a):t.copyFileSync(i,a)}))},a=async(t,r,n="")=>{const i={},o=await s.readdir(t);for(const c of o){const o=e.join(t,c);if((await s.stat(o)).isDirectory()){const e=await a(o,r,n);Object.assign(i,e)}else if(c.endsWith(".png")){const t=e.basename(c,".png"),s=`${n}${e.relative(r,o).replace(/\.png$/,"").replace(/\\/g,"/")}`;i[t]={textures:s}}}return i},c=async(e,t,r)=>{try{const n=JSON.stringify(t,null,2);await s.writeFile(e,n),console.log(r)}catch(e){console.error("Error writing JSON file:",e)}};class l{static item_texture_sets=new Map;static getItemTextureSet(){return this.item_texture_sets}static getItemTextures(){return Object.fromEntries(this.item_texture_sets)}static registerTextureData(e,t){this.item_texture_sets.set(e,t)}static registerTexture(e,t){this.registerTextureData(e,{textures:t})}}class u{static terrain_texture_sets=new Map;static getTerrainTextureSet(){return this.terrain_texture_sets}static getTerrainTextures(){return Object.fromEntries(this.terrain_texture_sets)}static registerTextureData(e,t){this.terrain_texture_sets.set(e,t)}static registerTexture(e,t){this.registerTextureData(e,{textures:t})}}const g={flipbook_textures:[],registerFlipbookTexture(e,t,r,s={}){const n={atlas_tile:e,flipbook_texture:t,ticks_per_frame:r};Object.assign(n,s),this.flipbook_textures.push(n)}};var _;!function(e){e.WRITE_ADDON="write-addon",e.WRITE_GAME_DEV="write-dev"}(_||(_={}));const d=(t,r)=>async(s,n,o)=>{try{const _=e.join(n,`${o}_BP`),d=e.join(n,`${o}_RP`),f=t=>e.join(d,t),x=e.join(_,"blocks.json"),p={format_version:"1.20.20"},m=f("textures/items");!async function(e,t,r,s){try{const n=await a(e,e,"textures/items/");s&&Object.assign(n,s);const i={resource_pack_name:r,texture_name:"atlas.items",texture_data:n};await c(t,i,"Item texture JSON file generated successfully.")}catch(e){console.error("Error generating item texture JSON:",e)}}(m,f("textures/item_texture.json"),o,l.getItemTextures());const h=f("textures/blocks");!async function(e,t,r,s){try{const n=await a(e,e,"textures/blocks/");s&&Object.assign(n,s);const i={texture_name:"atlas.terrain",resource_pack_name:r,padding:8,num_mip_levels:4,texture_data:n};await c(t,i,"Block texture JSON file generated successfully.")}catch(e){console.error("Error generating block texture JSON:",e)}}(h,f("textures/terrain_texture.json"),o,u.getTerrainTextures());const y=f("textures/flipbook_textures.json");i(y,JSON.stringify(g.flipbook_textures,null,2));const j=r.getUIdefList();i(f("ui/_ui_defs.json"),JSON.stringify({ui_defs:j},null,2)),r.getUISystemList().forEach((e=>{i(f(e.path,`${e.name}.json`),JSON.stringify(e.toJson(),null,2))}));t.getDataList().forEach((({name:t,root:r,path:s,data:a})=>{if("blocks/"===s){const e=(e=>{const t=e.textures;if(6!==t.length)return console.warn(`blocks.json 的 textures 数组长度不为 6，实际长度: ${t.length}`),{};const r={};return r[e.identifier]={textures:{up:t[0],down:t[1],east:t[2],west:t[3],south:t[4],north:t[5]}},r})(a);Object.assign(p,e)}const c="behavior"===r?`${o}_BP`:`${o}_RP`,l=e.join(n,c),u=e.join(l,s,`${t}.json`);i(u,JSON.stringify(a.toJson(),null,2))})),console.log("保存 blocks.json 文件:",x),i(x,JSON.stringify(p,null,2)),console.log(`已加载并执行 ${s} 文件！`)}catch(e){console.error(`加载或执行 ${s} 失败：${e.message}`),console.error(e.stack)}},{port:f}={port:49037};const x=new class{cliServerHandlers=new Map;listening=!1;isListening(){return this.listening}bootstrap(){this.listening=!0;const e=n.createServer((async(e,t)=>{const r=this.cliServerHandlers.get((e.url??"/").slice(1));if(r){try{const{promise:t,resolve:s,reject:n}=Promise.withResolvers();let i=Buffer.alloc(0);e.on("data",(e=>i=Buffer.concat([i,e]))),e.on("end",(()=>{try{s(JSON.parse(i))}catch(e){n(e)}})),await r(...await t)}catch(e){return console.error(e),t.writeHead(500),void t.end()}t.writeHead(200),t.end()}else t.writeHead(404),t.end()})).listen(f,(()=>console.log(`Dev Server listening on port ${f}`)));return e.on("error",(()=>this.listening=!1)),e}handle(e,t){this.cliServerHandlers.set(e,t)}getHandler(e){return this.cliServerHandlers.get(e)}interceptHandler(e,t){const r=t(this.getHandler(e)??Function.prototype);return this.cliServerHandlers.set(e,r),r}};async function p(t,s){const n=JSON.parse(r(e.join(t,"build.config"))),i=e.join(t,n.defaultConfig.buildDir),a=e.join(i,`${s}_BP`),c=e.join(i,`${s}_RP`);o(a,e.join(n.mojangPath,"development_behavior_packs/",`${s}_BP/`)),o(c,e.join(n.mojangPath,"development_resource_packs/",`${s}_RP/`))}function m(e,t){x.isListening()||(!function(e,t){x.bootstrap(),x.handle(_.WRITE_ADDON,d(e,t)),x.handle(_.WRITE_GAME_DEV,p)}(e,t),process.send("initialized"))}export{_ as ServerHandles,x as devServer,m as startDevServer};
+import http from 'http';
+
+const devServerConfig = {
+    port: 49037
+};
+
+const {
+    port: port$1
+} = devServerConfig;
+
+async function cliRequest(path, ...params) {
+    try {
+        await fetch(`http://localhost:${port$1}/${path}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(params)
+        });
+    } catch (error) {
+        console.error(error);
+        console.error('尝试在构建脚本中使用 server.startDevServer() 启动开发服务器');
+    }
+}
+
+const { port } = devServerConfig;
+class DevelopmentServer {
+    cliServerHandlers = new Map();
+    listening = false;
+    isListening() {
+        return this.listening;
+    }
+    bootstrap() {
+        this.listening = true;
+        const svr = http.createServer(async (req, res) => {
+            const handler = this.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', () => this.listening = false);
+        return svr;
+    }
+    handle(url, handler) {
+        this.cliServerHandlers.set(url, handler);
+    }
+    getHandler(url) {
+        return this.cliServerHandlers.get(url);
+    }
+    interceptHandler(url, interceptor) {
+        const currentHandler = this.getHandler(url) ?? Function.prototype;
+        const newHandler = interceptor(currentHandler);
+        this.cliServerHandlers.set(url, newHandler);
+        return newHandler;
+    }
+}
+const server = new DevelopmentServer();
+
+const client = {
+    call: async (name, ...args) => {
+        return await cliRequest(name, ...args)
+    }
+};
+
+export { client, server as devServer };