create-yeow 0.2.121 → 0.2.123

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "create-yeow",
-    "version": "0.2.121",
+    "version": "0.2.123",
     "description": "Scaffold a Yeow plugin project",
     "type": "module",
     "bin": {

package/templates/default/.yeow/dev-server.js

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, copyFileSync, writeFileSync, readFileSync, creat
 import { resolve, dirname, basename } from 'path';
 import { spawn, execSync } from 'child_process';
 import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
 import https from 'https';
 import { createServer } from 'http';
 import { WebSocketServer } from 'ws';
@@ -15,9 +16,24 @@ const SERVER = resolve(DEVDIR, 'server');
 const WS_PORT = 17368;
 
 const YES = process.argv.includes('-y') || process.env.CI === 'true';
+const EULA = process.argv.includes('--eula') || YES;
 const PROXY = process.argv.find(a => a.startsWith('--proxy='))?.split('=').slice(1).join('=');
 const STOP = (() => { const a = process.argv.find(a => a.startsWith('--stop=')); if (!a) return null; const m = a.split('=')[1].match(/^(\d+)(s|m|h)?$/); return m ? parseInt(m[1]) * (m[2] === 'm' ? 60 : m[2] === 'h' ? 3600 : 1) : null; })();
 
+// ── AI 工作流参数（headless 模式）─────────────────────────────
+function parseDur(flag, def) {
+  const a = process.argv.find(a => a.startsWith(flag));
+  if (!a) return def;
+  const m = a.split('=')[1].match(/^(\d+)(s|m|h)?$/);
+  return m ? parseInt(m[1]) * (m[2] === 'm' ? 60 : m[2] === 'h' ? 3600 : 1) : def;
+}
+const TIMEOUT = parseDur('--timeout=', 120);   // 服务器加载超时（秒，默认 2m）
+const WAIT = parseDur('--wait=', 30);          // 加载成功后等待（秒，默认 30s）
+const OUTFILE = process.argv.find(a => a.startsWith('--outfile='))?.split('=').slice(1).join('=') || null;
+const KEEP = process.argv.includes('--keep');
+const HEADLESS = process.argv.includes('--eula') || process.argv.includes('--timeout')
+  || process.argv.includes('--wait') || process.argv.includes('--outfile') || KEEP;
+
 const cfg = JSON.parse(readFileSync(resolve(ROOT, 'yeow.config.json'), 'utf-8'));
 const RUNTIME = resolve(ROOT, '.yeow', 'assets', 'yeow-runtime-0.1.0.jar');
 
@@ -132,9 +148,9 @@ function download(url, dest, agent) {
             if (res.statusCode !== 200) { f.close(); reject(new Error(`HTTP ${res.statusCode}`)); return; }
             const total = parseInt(res.headers['content-length'], 10);
             let dl = 0;
-            res.on('data', chunk => { dl += chunk.length; if (total) process.stdout.write(`\r   ${c.B}Downloading...${c.r} ${(dl / 1024 / 1024).toFixed(1)}MB / ${(total / 1024 / 1024).toFixed(1)}MB`); });
+            res.on('data', chunk => { dl += chunk.length; if (total && !HEADLESS) process.stdout.write(`\r   ${c.B}Downloading...${c.r} ${(dl / 1024 / 1024).toFixed(1)}MB / ${(total / 1024 / 1024).toFixed(1)}MB`); });
             res.pipe(f);
-            f.on('finish', () => { f.close(); process.stdout.write('\n'); resolve(); });
+            f.on('finish', () => { f.close(); if (!HEADLESS) process.stdout.write('\n'); resolve(); });
         }).on('error', e => { f.close(); reject(e); });
     });
 }
@@ -143,19 +159,19 @@ async function ensurePaper() {
     if (PAPER_URL) {
         // User-specified URL or file path
         if (PAPER_URL.startsWith('http://') || PAPER_URL.startsWith('https://')) {
-            if (existsSync(PAPER_PATH) && statSync(PAPER_PATH).size > 1_000_000) { ok('Paper found in cache'); return; }
+            if (existsSync(PAPER_PATH) && statSync(PAPER_PATH).size > 1_000_000) { if (!HEADLESS) ok('Paper found in cache'); return; }
             mkdirSync(CACHE, { recursive: true });
             let agent = null;
             if (PROXY) { info(`Proxy: ${PROXY}`); try { const { HttpsProxyAgent } = await import('https-proxy-agent'); agent = new HttpsProxyAgent(PROXY); } catch {} }
-            info('Downloading Paper...');
-            try { await download(PAPER_URL, PAPER_PATH, agent); ok('Paper downloaded'); }
+            if (!HEADLESS) info('Downloading Paper...');
+            try { await download(PAPER_URL, PAPER_PATH, agent); if (!HEADLESS) ok('Paper downloaded'); }
             catch (e) { fail('Download failed: ' + e.message); console.log('  Manually: ' + PAPER_PATH); process.exit(1); }
         } else {
             if (!existsSync(PAPER_PATH)) { fail(`Paper JAR not found: ${PAPER_PATH}`); process.exit(1); }
-            ok('Paper found at specified path');
+            if (!HEADLESS) ok('Paper found at specified path');
         }
     } else {
-        if (existsSync(PAPER_PATH) && statSync(PAPER_PATH).size > 1_000_000) { ok('Paper found in cache'); return; }
+        if (existsSync(PAPER_PATH) && statSync(PAPER_PATH).size > 1_000_000) { if (!HEADLESS) ok('Paper found in cache'); return; }
         mkdirSync(CACHE, { recursive: true });
         info('Downloading Paper...');
         try {
@@ -164,7 +180,7 @@ async function ensurePaper() {
             const latestBuild = versions.builds[versions.builds.length - 1];
             const dlUrl = `https://api.papermc.io/v2/projects/paper/versions/${PAPER_VERSION}/builds/${latestBuild}/downloads/paper-${PAPER_VERSION}-${latestBuild}.jar`;
             await download(dlUrl, PAPER_PATH, null);
-            ok('Paper downloaded');
+            if (!HEADLESS) ok('Paper downloaded');
         } catch (e) {
             fail('Download failed: ' + e.message);
             console.log('  Manually download to: ' + PAPER_PATH);
@@ -425,6 +441,8 @@ async function main() {
     console.log(`\n${c.b}${c.B}  Yeow Dev Server${c.r}\n`);
     if (!existsSync(RUNTIME)) { fail(`Runtime JAR not found: ${RUNTIME}`); process.exit(1); }
 
+    if (HEADLESS) { await runHeadless(); return; }
+
     startWebSocket();
     await ensurePaper();
     mkdirSync(SERVER, { recursive: true });
@@ -439,4 +457,71 @@ async function main() {
     startServer();
 }
 
+// ── AI 工作流（headless）─────────────────────────────────────────
+// 适合 AI 代理/CI：--eula 自动接受 → 下载 → 启动 → 检测加载完成 →
+// 等待 --wait 秒后命令自动结束（--keep 保留服务器子进程，日志见 --outfile）。
+async function runHeadless() {
+    if (!EULA) {
+        fail('AI 模式需要 --eula（自动接受 EULA）');
+        process.exit(1);
+    }
+    const log = OUTFILE ? createWriteStream(OUTFILE, { flags: 'a' }) : null;
+    const out = (line) => { if (log) log.write(line + '\n'); else console.log(line); };
+
+    info('正在下载/准备服务端…');
+    await ensurePaper();
+    mkdirSync(SERVER, { recursive: true });
+    await initServer();
+    serverProps(cfg.dev?.port || 17367);
+    buildPlugin();
+    removeStaleDevJar();
+    copyToYeowDir(resolve(ROOT, 'dist', 'plugins', `${cfg.name}-${cfg.version}.yeow.zip`), 'Plugin (.yeow.zip → plugins/Yeow/)');
+    copyToPlugins(RUNTIME, 'Runtime');
+
+    const jvmArgs = ['-Xmx4G', '-Xms4G', '-Dyeow.dev=true', '-Dyeow.ws.port=' + WS_PORT];
+    info(`正在启动 Paper ${PAPER_VERSION}...`);
+    proc = spawn('java', [...jvmArgs, '-jar', resolve(SERVER, PAPER_JAR), '--nogui'], { cwd: SERVER, stdio: ['ignore', 'pipe', 'pipe'] });
+    info(`Server PID: ${proc.pid}`);
+
+    let started = false, done = false, waitTimer = null;
+    const failTimer = setTimeout(() => {
+        if (done) return;
+        fail(`服务器在 ${TIMEOUT}s 内未完成加载——请检查网络/依赖下载，或加大超时（--timeout=3m）`);
+        killProc();
+        process.exit(1);
+    }, TIMEOUT * 1000);
+
+    const onLine = (line) => {
+        out(line);
+        if (!started && line.includes('Starting org.bukkit.craftbukkit.Main')) {
+            started = true;
+            info('开始加载（Starting org.bukkit.craftbukkit.Main）');
+        }
+        if (!done && line.includes('Done (') && line.includes('For help')) {
+            done = true;
+            clearTimeout(failTimer);
+            info(`加载完成——等待 ${WAIT}s 后命令结束${KEEP ? '（--keep 保留服务器进程）' : '（关闭服务器进程）'}…`);
+            waitTimer = setTimeout(() => {
+                info(`等待结束。日志${OUTFILE ? '：' + OUTFILE : '输出于上方'}；PID=${proc.pid}${KEEP ? '（服务器仍在运行，按需 kill）' : ''}`);
+                if (log) log.end();
+                if (KEEP) process.exit(0);
+                killProc();
+                process.exit(0);
+            }, WAIT * 1000);
+        }
+    };
+    readline.createInterface({ input: proc.stdout }).on('line', onLine);
+    if (proc.stderr) readline.createInterface({ input: proc.stderr }).on('line', (l) => out('[err] ' + l));
+
+    proc.on('exit', (code) => {
+        if (!done) fail(`服务器提前退出（code ${code}）——见${OUTFILE ? '日志 ' + OUTFILE : '上方输出'}`);
+        if (log) log.end();
+        process.exit(1);
+    });
+}
+
+function killProc() {
+    if (proc && !proc.killed) { try { proc.kill('SIGKILL'); } catch {} }
+}
+
 main().catch(e => { fail(e.message); process.exit(1); });

package/templates/default/src/index.js

@@ -1,6 +1,6 @@
 import {
   onInit, onLoad, onUnload, registerCommand, eventOn,
-  Player, Location, pdcSet, pdcGet, log,
+  Location, pdcSet, pdcGet, log,
 } from 'yeow-api';
 
 onInit(() => { log.info('Init'); });
@@ -20,23 +20,26 @@ onLoad(() => {
 
   registerCommand('back', {
     description: 'Teleport to your death location',
+    permission: { node: 'back.use', default: 'all' },   // 声明权限节点：普通玩家默认可用，服主可经权限插件管理
     executor: async (p) => {
-      const raw = await pdcGet(p.sender.uuid, 'back.deathLocation');
-      if (!raw) return p.sender.sendMessage('<red>No death location recorded</red>');
+      if (p.sender === 'CONSOLE') return;
+      const player = p.sender;                           // 已确认非 CONSOLE → Player
+      const raw = await pdcGet(player.uuid, 'back.deathLocation');
+      if (!raw) return player.sendMessage('<red>No death location recorded</red>');
 
       const loc = JSON.parse(raw);
-      const player = await Player.get(p.sender.uuid);
-      if (!player) return;
       await player.teleport(new Location(loc.x, loc.y, loc.z, 0, 0, loc.world));
-      p.sender.sendMessage('<green>Teleported to death location</green>');
+      await player.sendMessage('<green>Teleported to death location</green>');
     },
   });
 
   // ── /ping ──
   registerCommand('ping', {
+    permission: { node: 'ping.use', default: 'all' },
     executor: async (p) => {
-      const player = await Player.get(p.sender.uuid);
-      if (player) p.sender.sendMessage(`Ping: ${player.ping}ms`);
+      if (p.sender === 'CONSOLE') { log.info('Ping: console'); return; }
+      const player = p.sender;                           // Player
+      await player.sendMessage(`Ping: ${player.ping}ms`);
     },
   });
 

package/templates/default/src/index.ts

@@ -1,6 +1,6 @@
 import {
   onInit, onLoad, onUnload, registerCommand, eventOn,
-  Player, Location, pdcSet, pdcGet, log,
+  Location, pdcSet, pdcGet, log,
 } from 'yeow-api';
 import type { PlayerDeathEvent } from 'yeow-api';
 
@@ -21,23 +21,26 @@ onLoad(() => {
 
   registerCommand('back', {
     description: 'Teleport to your death location',
+    permission: { node: 'back.use', default: 'all' },   // 声明权限节点：普通玩家默认可用，服主可经权限插件管理
     executor: async (p) => {
-      const raw = await pdcGet(p.sender.uuid, 'back.deathLocation');
-      if (!raw) return p.sender.sendMessage('<red>No death location recorded</red>');
+      if (p.sender === 'CONSOLE') return;
+      const player = p.sender;                           // 已确认非 CONSOLE → Player
+      const raw = await pdcGet(player.uuid, 'back.deathLocation');
+      if (!raw) return player.sendMessage('<red>No death location recorded</red>');
 
       const loc = JSON.parse(raw);
-      const player = await Player.get(p.sender.uuid);
-      if (!player) return;
       await player.teleport(new Location(loc.x, loc.y, loc.z, 0, 0, loc.world));
-      p.sender.sendMessage('<green>Teleported to death location</green>');
+      await player.sendMessage('<green>Teleported to death location</green>');
     },
   });
 
   // ── /ping ──
   registerCommand('ping', {
+    permission: { node: 'ping.use', default: 'all' },
     executor: async (p) => {
-      const player = await Player.get(p.sender.uuid);
-      if (player) p.sender.sendMessage(`Ping: ${player.ping}ms`);
+      if (p.sender === 'CONSOLE') { log.info('Ping: console'); return; }
+      const player = p.sender;                           // Player
+      await player.sendMessage(`Ping: ${player.ping}ms`);
     },
   });