@yeow/create-yeow 0.1.0

package/README.md

@@ -0,0 +1,23 @@
+# @yeow/create-yeow
+
+Scaffold a Yeow plugin project.
+
+```bash
+npm create @yeow/yeow@latest
+```
+
+## Templates
+
+- **JavaScript** — ES2020 + Rspack + Babel
+- **TypeScript** — ES2020 + Rspack + SWC
+
+## Development
+
+```bash
+# From monorepo root, link locally
+cd packages/create-yeow
+npm link
+
+# Then use anywhere
+npm create @yeow/yeow
+```

package/bin/index.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, copyFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
+import { execSync } from 'child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+function prompt(query) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(query, (answer) => { rl.close(); resolve(answer.trim()); });
+    });
+}
+
+function green(msg) { return `\x1b[32m${msg}\x1b[0m`; }
+function dim(msg) { return `\x1b[2m${msg}\x1b[0m`; }
+function bold(msg) { return `\x1b[1m${msg}\x1b[0m`; }
+function cyan(msg) { return `\x1b[36m${msg}\x1b[0m`; }
+function log(msg) { console.log(`  ${msg}`); }
+function logOk(msg) { console.log(`  ${green('\u2713')} ${msg}`); }
+function logInfo(msg) { console.log(`  ${cyan('\u24D8')} ${msg}`); }
+
+function toClassName(str) {
+    return str.replace(/[^a-zA-Z0-9]+/g, ' ').split(' ').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join('');
+}
+
+async function main() {
+    console.log(`\n  ${bold('Welcome to Yeow!')} ${dim('v0.1.0')}\n`);
+
+    const name = await prompt(`  ${bold('Project name')}: `) || 'my-yeow-plugin';
+    const author = await prompt(`  ${bold('Author')}: `);
+    const description = await prompt(`  ${bold('Description')}: `) || 'A Yeow plugin';
+    const lang = await prompt(`  ${bold('Language')} ${dim('(JS/TS)')} [JS]: `);
+    const useTs = lang.toLowerCase().startsWith('t');
+
+    const projectDir = resolve(process.cwd(), name);
+    const pluginName = toClassName(name);
+    const tplDir = resolve(__dirname, '..', 'templates', useTs ? 'typescript' : 'javascript');
+
+    console.log();
+    logInfo(`Scaffolding ${bold(name)}...`);
+
+    if (!existsSync(projectDir)) mkdirSync(projectDir, { recursive: true });
+    cpSync(tplDir, projectDir, { recursive: true });
+
+    // customize package.json
+    const pkgPath = resolve(projectDir, 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    pkg.name = name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+    pkg.description = description;
+    if (author) pkg.author = author;
+    writeFileSync(pkgPath, JSON.stringify(pkg, null, 4) + '\n');
+    logOk('package.json configured');
+
+    // customize yeow.config.js
+    const configPath = resolve(projectDir, 'yeow.config.js');
+    let config = readFileSync(configPath, 'utf-8');
+    config = config
+        .replace(/name:\s*'.*?'/, `name: '${pluginName}'`)
+        .replace(/author:\s*'.*?'/, `author: '${author || 'Unknown'}'`)
+        .replace(/description:\s*'.*?'/, `description: '${description}'`)
+        .replace(/output:\s*'.*?'/, `output: 'dist/${pluginName}-1.0.0.jar'`);
+    writeFileSync(configPath, config);
+    logOk('yeow.config.js configured');
+
+    // copy JARs from @yeow/bukkit-template
+    const assetsDir = resolve(projectDir, '.yeow', 'assets');
+    if (!existsSync(assetsDir)) mkdirSync(assetsDir, { recursive: true });
+
+    try {
+        const { runtimeJar, templateJar } = await import('@yeow/bukkit-template');
+        if (existsSync(templateJar)) {
+            copyFileSync(templateJar, resolve(assetsDir, 'yeow-template-1.0.0.jar'));
+            logOk('Template JAR copied');
+        }
+        if (existsSync(runtimeJar)) {
+            copyFileSync(runtimeJar, resolve(assetsDir, 'yeow-runtime-1.0.0.jar'));
+            logOk('Runtime JAR copied');
+        }
+    } catch {
+        logInfo('@yeow/bukkit-template not resolved, JARs will need manual copy');
+    }
+
+    // npm install
+    logInfo('Installing dependencies...');
+    try {
+        execSync('npm install', { cwd: projectDir, stdio: 'pipe' });
+        logOk('Dependencies installed');
+    } catch {
+        logInfo('npm install failed, run manually: cd ' + name + ' && npm install');
+    }
+
+    console.log(`\n  ${green('\u2713')} ${bold('Done!')}\n`);
+    console.log(`    ${dim('$')} ${cyan('cd ' + name)}`);
+    console.log(`    ${dim('$')} ${cyan('npm run dev')}      ${dim('Start development server')}`);
+    console.log(`    ${dim('$')} ${cyan('npm run build')}    ${dim('Build plugin JAR')}\n`);
+}
+
+main().catch((err) => { console.error(err); process.exit(1); });

package/package.json

@@ -0,0 +1,16 @@
+{
+    "name": "@yeow/create-yeow",
+    "version": "0.1.0",
+    "description": "Scaffold a Yeow plugin project",
+    "bin": {
+        "create-yeow": "./bin/index.js"
+    },
+    "type": "module",
+    "dependencies": {
+        "@yeow/bukkit-template": "0.1.0"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "license": "MIT"
+}

package/templates/javascript/.yeow/build.js

@@ -0,0 +1,24 @@
+const path = require('path');
+const fs = require('fs');
+const { execSync } = require('child_process');
+const AdmZip = require('adm-zip');
+const configPath = path.resolve('yeow.config.js');
+function loadConfig() { if (!fs.existsSync(configPath)) { console.error('yeow.config.js not found'); process.exit(1); } return require(configPath); }
+function compileUserCode() { console.log('Compiling user code with Rspack...'); try { execSync('npx rspack build', { stdio: 'inherit' }); console.log('User code compiled'); } catch (error) { console.error('Compilation failed:', error.message); process.exit(1); } }
+function buildPlugin() {
+    const config = loadConfig(); const { plugin, build } = config;
+    console.log('\nBuilding Yeow plugin...'); console.log('   ' + plugin.name + ' v' + plugin.version);
+    compileUserCode();
+    const templateJarPath = path.resolve(build.templateJar);
+    if (!fs.existsSync(templateJarPath)) { console.error('Template JAR not found:', templateJarPath); process.exit(1); }
+    const templateZip = new AdmZip(templateJarPath);
+    templateZip.updateFile('plugin.yml', Buffer.from('name: ' + plugin.name + '\nversion: ' + plugin.version + '\nmain: yeow.template.YeowPluginBootstrap\napi-version: \"1.21\"\ndepend:\n  - Yeow-Runtime\nauthor: ' + (plugin.author || 'Unknown') + '\ndescription: ' + (plugin.description || 'A Yeow plugin') + '\n'));
+    const userCodePath = path.resolve('dist/.yeow/main.js');
+    if (fs.existsSync(userCodePath)) { templateZip.addFile('.yeow/main.js', fs.readFileSync(userCodePath)); } else { console.error('Compiled user code not found'); process.exit(1); }
+    const outputPath = build.output || 'dist/plugin.jar';
+    const outputDir = path.dirname(outputPath);
+    if (!fs.existsSync(outputDir)) fs.mkdirSync(outputDir, { recursive: true });
+    templateZip.writeZip(outputPath);
+    console.log('Plugin built successfully!'); console.log('   Output: ' + outputPath); console.log('   Size: ' + (fs.statSync(outputPath).size / 1024).toFixed(2) + ' KB');
+}
+buildPlugin();

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

@@ -0,0 +1,135 @@
+const path = require('path');
+const fs = require('fs');
+const { spawn, execSync } = require('child_process');
+const readline = require('readline');
+
+const DEV_DIR = path.resolve(__dirname, 'dev');
+const CACHE_DIR = path.join(DEV_DIR, 'cache');
+const SERVER_DIR = path.join(DEV_DIR, 'server');
+const PAPER_VERSION = '1.21.4';
+const PAPER_BUILD = 232;
+const PAPER_FILENAME = 'paper-' + PAPER_VERSION + '-' + PAPER_BUILD + '.jar';
+const PAPER_URL = 'https://api.papermc.io/v2/projects/paper/versions/' + PAPER_VERSION + '/builds/' + PAPER_BUILD + '/downloads/' + PAPER_FILENAME;
+const PAPER_CACHE_PATH = path.join(CACHE_DIR, PAPER_FILENAME);
+const DOUBLE_CTRL_C_WINDOW = 3000;
+const YEOW_CONFIG_PATH = path.resolve('yeow.config.js');
+const c = { reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m', green: '\x1b[32m', yellow: '\x1b[33m', blue: '\x1b[34m', cyan: '\x1b[36m', red: '\x1b[31m', ok: '\x1b[32m\u2713\x1b[0m', fail: '\x1b[31m\u2717\x1b[0m', info: '\x1b[36m\u24D8\x1b[0m', warn: '\x1b[33m\u26A0\x1b[0m' };
+let serverProcess = null, ctrlCPressCount = 0, ctrlCTimer = null, srcWatcher = null, isCompiling = false;
+function log(msg, color) { if (!color) color = ''; console.log(c.dim + '[' + new Date().toLocaleTimeString() + ']' + c.reset + ' ' + color + msg + c.reset); }
+function logOk(msg) { log(c.ok + ' ' + msg, c.green); }
+function logFail(msg) { log(c.fail + ' ' + msg, c.red); }
+function logWarn(msg) { log(c.warn + ' ' + msg, c.yellow); }
+function logInfo(msg) { log(c.info + ' ' + msg, c.cyan); }
+function logBright(msg) { log(msg, c.bold); }
+
+async function ensurePaperJar(devConfig) {
+  if (fs.existsSync(PAPER_CACHE_PATH) && fs.statSync(PAPER_CACHE_PATH).size > 1000000) { logOk('Paper jar found in cache'); return; }
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const proxy = await new Promise(function(r) { rl.question('   Proxy address [blank to skip]: ', function(v) { rl.close(); r(v.trim()); }); });
+  if (proxy) { devConfig.proxy = proxy; var cfg = require(YEOW_CONFIG_PATH); cfg.dev = cfg.dev || {}; cfg.dev.proxy = proxy; fs.writeFileSync(YEOW_CONFIG_PATH, 'module.exports = ' + JSON.stringify(cfg, null, 4) + ';\n'); }
+  fs.mkdirSync(CACHE_DIR, { recursive: true });
+  logInfo('Downloading Paper ' + PAPER_VERSION + '...');
+  var agent = null;
+  if (proxy) { try { var m = await import('https-proxy-agent'); agent = new m.HttpsProxyAgent(proxy); } catch(e) {} }
+  var done = false;
+  try {
+    await new Promise(function(resolve, reject) {
+      var file = fs.createWriteStream(PAPER_CACHE_PATH);
+      var opts = {}; if (agent) opts.agent = agent;
+      var req = require('https').get(PAPER_URL, opts, function(res) {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) { file.close(); fs.unlinkSync(PAPER_CACHE_PATH); return reject(new Error('Redirect')); }
+        if (res.statusCode !== 200) { file.close(); fs.unlinkSync(PAPER_CACHE_PATH); return reject(new Error('HTTP ' + res.statusCode)); }
+        res.pipe(file);
+        file.on('finish', function() { file.close(); resolve(); });
+      });
+      req.on('error', function(err) { file.close(); if (fs.existsSync(PAPER_CACHE_PATH)) fs.unlinkSync(PAPER_CACHE_PATH); reject(err); });
+    });
+    logOk('Paper jar downloaded');
+  } catch(err) {
+    logFail('Download failed: ' + err.message);
+    process.exit(1);
+  }
+}
+
+async function ensureRuntimeJar(devConfig) {
+  var p = path.resolve(devConfig.runtimeJar);
+  if (fs.existsSync(p) && fs.statSync(p).size > 1000) return p;
+  logFail('Yeow-Runtime.jar not found at ' + p); process.exit(1);
+}
+
+function initServer(devConfig) {
+  var paperJar = path.join(SERVER_DIR, PAPER_FILENAME);
+  if (!fs.existsSync(paperJar)) fs.copyFileSync(PAPER_CACHE_PATH, paperJar);
+  var eulaPath = path.join(SERVER_DIR, 'eula.txt');
+  if (fs.existsSync(eulaPath) && fs.readFileSync(eulaPath, 'utf-8').includes('eula=true')) return;
+  var propsPath = path.join(SERVER_DIR, 'server.properties');
+  if (!fs.existsSync(propsPath)) {
+    logInfo('Initializing server...');
+    var p = spawn(devConfig.javaPath, ['-Xmx' + devConfig.memory, '-Xms' + devConfig.memory, '-jar', paperJar, '--nogui'], { cwd: SERVER_DIR, stdio: 'pipe' });
+    var t = setTimeout(function() { if (!p.killed) p.kill(); }, 15000);
+    p.on('exit', function() { clearTimeout(t); });
+    p.on('error', function() { clearTimeout(t); });
+  }
+  var rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  rl.question('   Press Enter to accept EULA... ', function() { rl.close(); fs.writeFileSync(eulaPath, 'eula=true\n'); logOk('EULA accepted'); });
+}
+
+function getServerProperties(port) {
+  var propsPath = path.join(SERVER_DIR, 'server.properties');
+  var merged = {};
+  if (fs.existsSync(propsPath)) {
+    fs.readFileSync(propsPath, 'utf-8').split('\n').forEach(function(line) {
+      line = line.trim(); if (line && !line.startsWith('#')) { var i = line.indexOf('='); if (i > 0) merged[line.substring(0, i).trim()] = line.substring(i + 1).trim(); }
+    });
+  }
+  merged.difficulty = 'easy'; merged['enable-command-block'] = 'true'; merged['max-players'] = '10'; merged.motd = 'A Yeow Dev Server'; merged['online-mode'] = 'false'; merged['server-port'] = String(port); merged['spawn-protection'] = '0';
+  var out = '#Minecraft server properties\n';
+  for (var k in merged) out += k + '=' + merged[k] + '\n'; fs.writeFileSync(propsPath, out);
+}
+
+function buildDevPlugin() {
+  logInfo('Building plugin...');
+  try { execSync('node .yeow/build.js', { stdio: 'inherit', cwd: path.resolve(__dirname, '..') }); logOk('Plugin built'); }
+  catch (e) { logFail('Build failed: ' + e.message); process.exit(1); }
+}
+
+function copyToPlugins(src, label) {
+  var dir = path.join(SERVER_DIR, 'plugins'); fs.mkdirSync(dir, { recursive: true });
+  var dest = path.join(dir, path.basename(src)); if (fs.existsSync(dest)) fs.unlinkSync(dest); fs.copyFileSync(src, dest); logOk(label + ' copied');
+}
+
+function startServer(devConfig) {
+  var paperJar = path.join(SERVER_DIR, PAPER_FILENAME);
+  logBright('\nStarting server (type commands to send)...\n');
+  serverProcess = spawn(devConfig.javaPath, ['-Xmx' + devConfig.memory, '-Xms' + devConfig.memory, '-Dyeow.dev=true', '-jar', paperJar, '--nogui'], { cwd: SERVER_DIR, stdio: ['pipe', 'inherit', 'inherit'] });
+  serverProcess.on('exit', function(code) { logWarn('Server exited with code ' + code); process.exit(0); });
+  serverProcess.on('error', function(err) { logFail('Failed: ' + err.message); process.exit(1); });
+  var rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  rl.on('line', function(line) { if (serverProcess && !serverProcess.killed && line.trim()) serverProcess.stdin.write(line.trim() + '\n'); });
+}
+
+process.on('SIGINT', function() {
+  ctrlCPressCount++;
+  if (ctrlCPressCount >= 2) { if (serverProcess && !serverProcess.killed) serverProcess.kill(); process.exit(0); }
+  if (serverProcess && !serverProcess.killed) serverProcess.stdin.write('stop\n');
+  if (ctrlCTimer) clearTimeout(ctrlCTimer);
+  ctrlCTimer = setTimeout(function() { ctrlCPressCount = 0; }, DOUBLE_CTRL_C_WINDOW);
+});
+
+async function main() {
+  var yeowConfig = require(YEOW_CONFIG_PATH);
+  var devConfig = yeowConfig.dev || {};
+  devConfig.port = devConfig.port || 17367; devConfig.memory = devConfig.memory || '8G'; devConfig.javaPath = devConfig.javaPath || 'java'; devConfig.runtimeJar = devConfig.runtimeJar || '.yeow/assets/yeow-runtime-1.0.0.jar';
+  console.log('\n' + c.bold + c.blue + '  Yeow Dev Server' + c.reset + '\n  ' + c.dim + '----------------------------------------' + c.reset + '\n  Port:   ' + c.bold + devConfig.port + c.reset + '\n  Memory: ' + c.bold + devConfig.memory + c.reset + '\n');
+  var runtimeJarPath = await ensureRuntimeJar(devConfig);
+  await ensurePaperJar(devConfig);
+  fs.mkdirSync(SERVER_DIR, { recursive: true });
+  initServer(devConfig);
+  getServerProperties(devConfig.port);
+  buildDevPlugin();
+  copyToPlugins(path.resolve(yeowConfig.build.output || 'dist/plugin.jar'), 'Plugin');
+  copyToPlugins(runtimeJarPath, 'Yeow-Runtime');
+  startServer(devConfig);
+}
+
+main().catch(function(err) { logFail(err.message); process.exit(1); });

package/templates/javascript/package.json

@@ -0,0 +1,19 @@
+{
+    "name": "my-yeow-plugin",
+    "version": "1.0.0",
+    "description": "A Yeow plugin",
+    "scripts": {
+        "build": "node .yeow/build.js",
+        "dev": "node .yeow/dev-server.js"
+    },
+    "devDependencies": {
+        "@babel/core": "^7.24.0",
+        "@babel/preset-env": "^7.24.0",
+        "@rspack/cli": "^1.0.0",
+        "@rspack/core": "^1.0.0",
+        "adm-zip": "^0.5.10",
+        "babel-loader": "^9.1.0",
+        "core-js": "^3.36.0",
+        "https-proxy-agent": "^9.0.0"
+    }
+}

package/templates/javascript/rspack.config.js

@@ -0,0 +1,9 @@
+const path = require('path');
+const { defineConfig } = require('@rspack/cli');
+module.exports = defineConfig({
+    target: ['web', 'es2020'],
+    entry: { main: './src/index.js' },
+    output: { path: path.resolve(__dirname, 'dist/.yeow'), filename: 'main.js', library: { type: 'commonjs2' }, clean: true },
+    module: { rules: [{ test: /\.js$/, exclude: /node_modules/, use: { loader: 'babel-loader', options: { presets: [['@babel/preset-env', { targets: { esmodules: true }, modules: 'cjs', useBuiltIns: false, corejs: false }]] } } }] },
+    optimization: { minimize: true }
+});

package/templates/javascript/src/index.js

@@ -0,0 +1,40 @@
+yeow.command.register('hello', {
+    description: 'Say hello',
+    usage: '/hello [name]',
+    executor(params) {
+        const name = params.args[0] || 'World';
+        params.sender.sendMessage(`Hello, ${name}!`);
+        console.log(`${params.sender.name} ran /hello`);
+    }
+});
+
+yeow.command.register('playerinfo', {
+    description: 'Show your player info',
+    usage: '/playerinfo',
+    executor(params) {
+        const player = params.sender;
+        player.sendMessage(`Name: ${player.name}`);
+        player.sendMessage(`UUID: ${player.uuid}`);
+        player.sendMessage(`Ping: ${player.ping}ms`);
+        player.sendMessage(`Health: ${player.health}/${player.maxHealth}`);
+        player.sendMessage(`Food: ${player.foodLevel}`);
+        player.sendMessage(`Gamemode: ${player.gamemode}`);
+        player.sendMessage(`OP: ${player.isOp}`);
+    }
+});
+
+yeow.command.register('setblock2', {
+    description: 'Set a block',
+    usage: '/setblock2 <x> <y> <z> <type>',
+    executor(params) {
+        const [x, y, z, type] = params.args;
+        if (!x || !y || !z || !type) {
+            params.sender.sendMessage('Usage: /setblock2 <x> <y> <z> <type>');
+            return;
+        }
+        const world = yeow.world.get('world');
+        if (!world) { params.sender.sendMessage('World not found'); return; }
+        world.setBlock(parseInt(x), parseInt(y), parseInt(z), type);
+        params.sender.sendMessage(`Set block at ${x} ${y} ${z} to ${type}`);
+    }
+});

package/templates/javascript/yeow.config.js

@@ -0,0 +1,15 @@
+module.exports = {
+    plugin: {
+        name: 'MyPlugin', version: '1.0.0', author: 'Unknown',
+        description: 'A Yeow plugin'
+    },
+    build: {
+        entry: 'src/index.js',
+        output: 'dist/MyPlugin-1.0.0.jar',
+        templateJar: '.yeow/assets/yeow-template-1.0.0.jar'
+    },
+    dev: {
+        port: 17367, memory: '8G', javaPath: 'java',
+        runtimeJar: '.yeow/assets/yeow-runtime-1.0.0.jar', proxy: ''
+    }
+};

package/templates/typescript/.yeow/build.js

@@ -0,0 +1,24 @@
+const path = require('path');
+const fs = require('fs');
+const { execSync } = require('child_process');
+const AdmZip = require('adm-zip');
+const configPath = path.resolve('yeow.config.js');
+function loadConfig() { if (!fs.existsSync(configPath)) { console.error('yeow.config.js not found'); process.exit(1); } return require(configPath); }
+function compileUserCode() { console.log('Compiling user code with Rspack...'); try { execSync('npx rspack build', { stdio: 'inherit' }); console.log('User code compiled'); } catch (error) { console.error('Compilation failed:', error.message); process.exit(1); } }
+function buildPlugin() {
+    const config = loadConfig(); const { plugin, build } = config;
+    console.log('\nBuilding Yeow plugin...'); console.log('   ' + plugin.name + ' v' + plugin.version);
+    compileUserCode();
+    const templateJarPath = path.resolve(build.templateJar);
+    if (!fs.existsSync(templateJarPath)) { console.error('Template JAR not found:', templateJarPath); process.exit(1); }
+    const templateZip = new AdmZip(templateJarPath);
+    templateZip.updateFile('plugin.yml', Buffer.from('name: ' + plugin.name + '\nversion: ' + plugin.version + '\nmain: yeow.template.YeowPluginBootstrap\napi-version: "1.21"\ndepend:\n  - Yeow-Runtime\nauthor: ' + (plugin.author || 'Unknown') + '\ndescription: ' + (plugin.description || 'A Yeow plugin') + '\n'));
+    const userCodePath = path.resolve('dist/.yeow/main.js');
+    if (fs.existsSync(userCodePath)) { templateZip.addFile('.yeow/main.js', fs.readFileSync(userCodePath)); } else { console.error('Compiled user code not found'); process.exit(1); }
+    const outputPath = build.output || 'dist/plugin.jar';
+    const outputDir = path.dirname(outputPath);
+    if (!fs.existsSync(outputDir)) fs.mkdirSync(outputDir, { recursive: true });
+    templateZip.writeZip(outputPath);
+    console.log('Plugin built successfully!'); console.log('   Output: ' + outputPath); console.log('   Size: ' + (fs.statSync(outputPath).size / 1024).toFixed(2) + ' KB');
+}
+buildPlugin();

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

@@ -0,0 +1,153 @@
+const path = require('path');
+const fs = require('fs');
+const { spawn, execSync } = require('child_process');
+const readline = require('readline');
+
+const DEV_DIR = path.resolve(__dirname, 'dev');
+const CACHE_DIR = path.join(DEV_DIR, 'cache');
+const SERVER_DIR = path.join(DEV_DIR, 'server');
+const PAPER_VERSION = '1.21.4';
+const PAPER_BUILD = 232;
+const PAPER_FILENAME = 'paper-' + PAPER_VERSION + '-' + PAPER_BUILD + '.jar';
+const PAPER_URL = 'https://api.papermc.io/v2/projects/paper/versions/' + PAPER_VERSION + '/builds/' + PAPER_BUILD + '/downloads/' + PAPER_FILENAME;
+const PAPER_CACHE_PATH = path.join(CACHE_DIR, PAPER_FILENAME);
+const DOUBLE_CTRL_C_WINDOW = 3000;
+const YEOW_CONFIG_PATH = path.resolve('yeow.config.js');
+const c = { reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m', green: '\x1b[32m', yellow: '\x1b[33m', blue: '\x1b[34m', cyan: '\x1b[36m', red: '\x1b[31m', ok: '\x1b[32m\u2713\x1b[0m', fail: '\x1b[31m\u2717\x1b[0m', info: '\x1b[36m\u24D8\x1b[0m', warn: '\x1b[33m\u26A0\x1b[0m' };
+let serverProcess = null, ctrlCPressCount = 0, ctrlCTimer = null, srcWatcher = null, isCompiling = false;
+function log(msg, color) { if (!color) color = ''; console.log(c.dim + '[' + new Date().toLocaleTimeString() + ']' + c.reset + ' ' + color + msg + c.reset); }
+function logOk(msg) { log(c.ok + ' ' + msg, c.green); }
+function logFail(msg) { log(c.fail + ' ' + msg, c.red); }
+function logWarn(msg) { log(c.warn + ' ' + msg, c.yellow); }
+function logInfo(msg) { log(c.info + ' ' + msg, c.cyan); }
+function logBright(msg) { log(msg, c.bold); }
+
+async function ensurePaperJar(devConfig) {
+  if (fs.existsSync(PAPER_CACHE_PATH) && fs.statSync(PAPER_CACHE_PATH).size > 1000000) { logOk('Paper jar found in cache'); return; }
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const proxy = await new Promise(function(r) { rl.question('   Proxy address [blank to skip]: ', function(v) { rl.close(); r(v.trim()); }); });
+  if (proxy) { devConfig.proxy = proxy; var cfg = require(YEOW_CONFIG_PATH); cfg.dev = cfg.dev || {}; cfg.dev.proxy = proxy; fs.writeFileSync(YEOW_CONFIG_PATH, 'module.exports = ' + JSON.stringify(cfg, null, 4) + ';\n'); }
+  fs.mkdirSync(CACHE_DIR, { recursive: true });
+  logInfo('Downloading Paper ' + PAPER_VERSION + '...');
+  var agent = null;
+  if (proxy) { try { var m = await import('https-proxy-agent'); agent = new m.HttpsProxyAgent(proxy); } catch(e) {} }
+  try {
+    await new Promise(function(resolve, reject) {
+      var file = fs.createWriteStream(PAPER_CACHE_PATH);
+      var opts = {}; if (agent) opts.agent = agent;
+      var req = require('https').get(PAPER_URL, opts, function(res) {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) { file.close(); fs.unlinkSync(PAPER_CACHE_PATH); return reject(new Error('Redirect')); }
+        if (res.statusCode !== 200) { file.close(); fs.unlinkSync(PAPER_CACHE_PATH); return reject(new Error('HTTP ' + res.statusCode)); }
+        res.pipe(file);
+        file.on('finish', function() { file.close(); resolve(); });
+      });
+      req.on('error', function(err) { file.close(); if (fs.existsSync(PAPER_CACHE_PATH)) fs.unlinkSync(PAPER_CACHE_PATH); reject(err); });
+    });
+    logOk('Paper jar downloaded');
+  } catch(err) {
+    logFail('Download failed: ' + err.message);
+    process.exit(1);
+  }
+}
+
+async function ensureRuntimeJar(devConfig) {
+  var p = path.resolve(devConfig.runtimeJar);
+  if (fs.existsSync(p) && fs.statSync(p).size > 1000) return p;
+  logFail('Yeow-Runtime.jar not found at ' + p); process.exit(1);
+}
+
+function initServer(devConfig) {
+  var paperJar = path.join(SERVER_DIR, PAPER_FILENAME);
+  if (!fs.existsSync(paperJar)) fs.copyFileSync(PAPER_CACHE_PATH, paperJar);
+  var eulaPath = path.join(SERVER_DIR, 'eula.txt');
+  if (fs.existsSync(eulaPath) && fs.readFileSync(eulaPath, 'utf-8').includes('eula=true')) return;
+  var propsPath = path.join(SERVER_DIR, 'server.properties');
+  if (!fs.existsSync(propsPath)) {
+    logInfo('Initializing server...');
+    var p = spawn(devConfig.javaPath, ['-Xmx' + devConfig.memory, '-Xms' + devConfig.memory, '-jar', paperJar, '--nogui'], { cwd: SERVER_DIR, stdio: 'pipe' });
+    var t = setTimeout(function() { if (!p.killed) p.kill(); }, 15000);
+    p.on('exit', function() { clearTimeout(t); });
+    p.on('error', function() { clearTimeout(t); });
+  }
+  var rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  rl.question('   Press Enter to accept EULA... ', function() { rl.close(); fs.writeFileSync(eulaPath, 'eula=true\n'); logOk('EULA accepted'); });
+}
+
+function getServerProperties(port) {
+  var propsPath = path.join(SERVER_DIR, 'server.properties');
+  var merged = {};
+  if (fs.existsSync(propsPath)) {
+    fs.readFileSync(propsPath, 'utf-8').split('\n').forEach(function(line) {
+      line = line.trim(); if (line && !line.startsWith('#')) { var i = line.indexOf('='); if (i > 0) merged[line.substring(0, i).trim()] = line.substring(i + 1).trim(); }
+    });
+  }
+  merged.difficulty = 'easy'; merged['enable-command-block'] = 'true'; merged['max-players'] = '10'; merged.motd = 'A Yeow Dev Server'; merged['online-mode'] = 'false'; merged['server-port'] = String(port); merged['spawn-protection'] = '0';
+  var out = '#Minecraft server properties\n';
+  for (var k in merged) out += k + '=' + merged[k] + '\n'; fs.writeFileSync(propsPath, out);
+}
+
+function buildDevPlugin() {
+  logInfo('Building plugin...');
+  try { execSync('node .yeow/build.js', { stdio: 'inherit', cwd: path.resolve(__dirname, '..') }); logOk('Plugin built'); }
+  catch (e) { logFail('Build failed: ' + e.message); process.exit(1); }
+}
+
+function copyToPlugins(src, label) {
+  var dir = path.join(SERVER_DIR, 'plugins'); fs.mkdirSync(dir, { recursive: true });
+  var dest = path.join(dir, path.basename(src)); if (fs.existsSync(dest)) fs.unlinkSync(dest); fs.copyFileSync(src, dest); logOk(label + ' copied');
+}
+
+function startHotReloadWatcher() {
+  const srcDir = path.resolve(__dirname, '../src');
+  if (!fs.existsSync(srcDir)) return;
+  let debounceTimer = null;
+  srcWatcher = fs.watch(srcDir, { recursive: true }, function(eventType, filename) {
+    if (!filename || !/\.ts$/.test(filename) || isCompiling) return;
+    if (debounceTimer) clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(function() {
+      isCompiling = true;
+      logInfo('Source changed, rebuilding...');
+      try { execSync('node .yeow/build.js', { stdio: 'pipe', cwd: path.resolve(__dirname, '..') }); logOk('Hot reload file updated'); }
+      catch (e) { logFail('Build failed: ' + e.message); }
+      isCompiling = false;
+    }, 1000);
+  });
+  logInfo('Watching src/ for changes (hot reload)...');
+}
+
+function startServer(devConfig) {
+  var paperJar = path.join(SERVER_DIR, PAPER_FILENAME);
+  logBright('\nStarting server (type commands to send)...\n');
+  serverProcess = spawn(devConfig.javaPath, ['-Xmx' + devConfig.memory, '-Xms' + devConfig.memory, '-Dyeow.dev=true', '-jar', paperJar, '--nogui'], { cwd: SERVER_DIR, stdio: ['pipe', 'inherit', 'inherit'] });
+  serverProcess.on('exit', function(code) { logWarn('Server exited with code ' + code); process.exit(0); });
+  serverProcess.on('error', function(err) { logFail('Failed: ' + err.message); process.exit(1); });
+  var rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  rl.on('line', function(line) { if (serverProcess && !serverProcess.killed && line.trim()) serverProcess.stdin.write(line.trim() + '\n'); });
+}
+
+process.on('SIGINT', function() {
+  ctrlCPressCount++;
+  if (ctrlCPressCount >= 2) { if (serverProcess && !serverProcess.killed) serverProcess.kill(); process.exit(0); }
+  if (serverProcess && !serverProcess.killed) serverProcess.stdin.write('stop\n');
+  if (ctrlCTimer) clearTimeout(ctrlCTimer);
+  ctrlCTimer = setTimeout(function() { ctrlCPressCount = 0; }, DOUBLE_CTRL_C_WINDOW);
+});
+
+async function main() {
+  var yeowConfig = require(YEOW_CONFIG_PATH);
+  var devConfig = yeowConfig.dev || {};
+  devConfig.port = devConfig.port || 17367; devConfig.memory = devConfig.memory || '8G'; devConfig.javaPath = devConfig.javaPath || 'java'; devConfig.runtimeJar = devConfig.runtimeJar || '.yeow/assets/yeow-runtime-1.0.0.jar';
+  console.log('\n' + c.bold + c.blue + '  Yeow Dev Server' + c.reset + '\n  ' + c.dim + '----------------------------------------' + c.reset + '\n  Port:   ' + c.bold + devConfig.port + c.reset + '\n  Memory: ' + c.bold + devConfig.memory + c.reset + '\n');
+  var runtimeJarPath = await ensureRuntimeJar(devConfig);
+  await ensurePaperJar(devConfig);
+  fs.mkdirSync(SERVER_DIR, { recursive: true });
+  initServer(devConfig);
+  getServerProperties(devConfig.port);
+  buildDevPlugin();
+  copyToPlugins(path.resolve(yeowConfig.build.output || 'dist/plugin.jar'), 'Plugin');
+  copyToPlugins(runtimeJarPath, 'Yeow-Runtime');
+  startHotReloadWatcher();
+  startServer(devConfig);
+}
+
+main().catch(function(err) { logFail(err.message); process.exit(1); });

package/templates/typescript/package.json

@@ -0,0 +1,15 @@
+{
+    "name": "my-yeow-plugin",
+    "version": "1.0.0",
+    "description": "A Yeow plugin",
+    "scripts": {
+        "build": "node .yeow/build.js",
+        "dev": "node .yeow/dev-server.js"
+    },
+    "devDependencies": {
+        "@rspack/cli": "^1.0.0",
+        "@rspack/core": "^1.0.0",
+        "adm-zip": "^0.5.10",
+        "https-proxy-agent": "^9.0.0"
+    }
+}

package/templates/typescript/rspack.config.js

@@ -0,0 +1,9 @@
+const path = require('path');
+const { defineConfig } = require('@rspack/cli');
+module.exports = defineConfig({
+    target: ['web', 'es2020'],
+    entry: { main: './src/index.ts' },
+    output: { path: path.resolve(__dirname, 'dist/.yeow'), filename: 'main.js', library: { type: 'commonjs2' }, clean: true },
+    module: { rules: [{ test: /\.ts$/, exclude: /node_modules/, loader: 'builtin:swc-loader', options: { jsc: { parser: { syntax: 'typescript' } } } }] },
+    optimization: { minimize: true }
+});

package/templates/typescript/src/index.ts

@@ -0,0 +1,24 @@
+yeow.command.register('hello', {
+    description: 'Say hello',
+    usage: '/hello [name]',
+    executor(params) {
+        const name = params.args[0] || 'World';
+        params.sender.sendMessage('Hello, ' + name + '!');
+        console.log(params.sender.name + ' ran /hello');
+    }
+});
+
+yeow.command.register('playerinfo', {
+    description: 'Show your player info',
+    usage: '/playerinfo',
+    executor(params) {
+        const p = params.sender;
+        p.sendMessage('Name: ' + p.name);
+        p.sendMessage('UUID: ' + p.uuid);
+        p.sendMessage('Ping: ' + p.ping + 'ms');
+        p.sendMessage('Health: ' + p.health + '/' + p.maxHealth);
+        p.sendMessage('Food: ' + p.foodLevel);
+        p.sendMessage('Gamemode: ' + p.gamemode);
+        p.sendMessage('OP: ' + p.isOp);
+    }
+});

package/templates/typescript/tsconfig.json

@@ -0,0 +1,13 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "ES2020",
+        "moduleResolution": "node",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "outDir": "./dist/ts",
+        "noEmit": true
+    },
+    "include": ["src/**/*.ts"]
+}

package/templates/typescript/yeow.config.js

@@ -0,0 +1,15 @@
+module.exports = {
+    plugin: {
+        name: 'MyPlugin', version: '1.0.0', author: 'Unknown',
+        description: 'A Yeow plugin'
+    },
+    build: {
+        entry: 'src/index.ts',
+        output: 'dist/MyPlugin-1.0.0.jar',
+        templateJar: '.yeow/assets/yeow-template-1.0.0.jar'
+    },
+    dev: {
+        port: 17367, memory: '8G', javaPath: 'java',
+        runtimeJar: '.yeow/assets/yeow-runtime-1.0.0.jar', proxy: ''
+    }
+};