From 20753fccef94d773e66e8836cbf74e5b39e31c1a Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 21 Jul 2026 17:36:07 +0000 Subject: [PATCH 1/6] fix(tools): convert check-catalog.js from ESM import to CommonJS require Root package.json has no "type": "module", so top-level ESM import syntax throws "Cannot use import statement outside a module" under plain node. This crashed tools/check-ootb.js's check-catalog step on every CI run. Match the CommonJS style used by every other tools/*.js script. Co-authored-by: Shiroha --- tools/check-catalog.js | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/tools/check-catalog.js b/tools/check-catalog.js index 26a3f4a..9453e96 100644 --- a/tools/check-catalog.js +++ b/tools/check-catalog.js @@ -11,12 +11,14 @@ * - entry.init 仅在 sapi 类型可选 * - 不允许循环依赖（拓扑排序检测） */ -import { accessSync, constants, readFileSync } from "node:fs"; -import { resolve, join, dirname } from "node:path"; -import { fileURLToPath } from 'node:url'; -import path from "node:path"; +// 仓库根 package.json 未声明 "type": "module"，本文件按 CommonJS 解析； +// 与其余 tools/*.js 保持一致改用 require()，避免在未开启 ESM 探测的 Node +// 版本（例如 CI 固定的 node-version）上直接抛出 "Cannot use import +// statement outside a module" 而崩溃。 +const { accessSync, constants, readFileSync } = require("node:fs"); +const { resolve, join } = require("node:path"); -const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), ".."); +const ROOT = resolve(__dirname, ".."); const CATALOG = join(ROOT, "modules", "catalog.json"); const SERVICES_CATALOG = join(ROOT, "services", "catalog.json"); /* SAPI modules no longer register through a single static entry.ts — From 5725ca8d013be494170393ecea5270bd4dab8e14 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 21 Jul 2026 17:36:13 +0000 Subject: [PATCH 2/6] fix(tools): correct db-server entry path to dist/index.js MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit db-server/index.js does not exist — the compiled entry is db-server/dist/index.js (per package.json main/start script). This made check-ootb's db-server startup check and sim-new-user.js time out waiting for the health endpoint, cascading into further failures. Co-authored-by: Shiroha --- tools/check-ootb.js | 2 +- tools/sim-new-user.js | 2 +- tools/test-db-api.js | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/tools/check-ootb.js b/tools/check-ootb.js index 970b038..240bb13 100644 --- a/tools/check-ootb.js +++ b/tools/check-ootb.js @@ -106,7 +106,7 @@ function fileContains(p, needle) { { let dbProc = null; try { - dbProc = spawn(process.execPath, [path.join(ROOT, "db-server", "index.js")], { + dbProc = spawn(process.execPath, [path.join(ROOT, "db-server", "dist", "index.js")], { cwd: ROOT, env: { ...process.env }, stdio: ["ignore", "pipe", "pipe"], diff --git a/tools/sim-new-user.js b/tools/sim-new-user.js index 18990b9..8206073 100644 --- a/tools/sim-new-user.js +++ b/tools/sim-new-user.js @@ -30,7 +30,7 @@ let dbProc = null; function startDb(simDir) { const env = { ...process.env, SFMC_ROOT: simDir, DB_PORT: String(DB_PORT) }; - dbProc = spawn(process.execPath, [path.join(ROOT, "db-server", "index.js")], { + dbProc = spawn(process.execPath, [path.join(ROOT, "db-server", "dist", "index.js")], { cwd: ROOT, env, stdio: ["ignore", "pipe", "pipe"], diff --git a/tools/test-db-api.js b/tools/test-db-api.js index b82892d..cee487a 100644 --- a/tools/test-db-api.js +++ b/tools/test-db-api.js @@ -62,11 +62,11 @@ async function main() { copy(path.join(ROOT, 'modules', 'module-lock.json'), path.join(workspace, 'modules', 'module-lock.json')); fs.mkdirSync(path.join(workspace, 'data'), { recursive: true }); fs.mkdirSync(path.join(workspace, 'configs'), { recursive: true }); - fs.writeFileSync(path.join(workspace, 'configs', 'db_config.json'), JSON.stringify({ db_port: PORT, dbDir: './data/sfmc_data.db', modulesDir: '../modules' }) + '\n'); + fs.writeFileSync(path.join(workspace, 'configs', 'db_config.json'), JSON.stringify({ db_port: PORT, dbDir: './data/sfmc_data.db', modulesDir: 'modules' }) + '\n'); copy(path.join(ROOT, 'configs', 'qq_config.json'), path.join(workspace, 'configs', 'qq_config.json')); copy(path.join(ROOT, 'configs', 'settings.json'), path.join(workspace, 'configs', 'settings.json')); - const child = spawn(process.execPath, [path.join(ROOT, 'db-server', 'index.js')], { + const child = spawn(process.execPath, [path.join(ROOT, 'db-server', 'dist', 'index.js')], { cwd: ROOT, env: { ...process.env, SFMC_ROOT: workspace, SFMC_DB_PATH: dbPath, SFMC_MODULES_DIR: path.join(workspace, 'modules'), DB_PORT: String(PORT) }, stdio: ['ignore', 'pipe', 'pipe'], From c109bbcba39466cd615e098012286d0a5a7695cc Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 21 Jul 2026 17:36:17 +0000 Subject: [PATCH 3/6] fix(config): correct modulesDir default from ../modules to modules modulesDir is resolved relative to PROJECT_ROOT (repo root), so "../modules" pointed one directory above the repo and made the module API return an empty catalog. The correct relative value is "modules". Co-authored-by: Shiroha --- configs-default/db_config.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/configs-default/db_config.json b/configs-default/db_config.json index 0dff98e..c1380db 100644 --- a/configs-default/db_config.json +++ b/configs-default/db_config.json @@ -3,5 +3,5 @@ "db_port": 3001, "http_auth": "", "dbDir": "./data/sfmc_data.db", - "modulesDir": "../modules" + "modulesDir": "modules" } From 18f5b672cb0def4da15772b54f1f93fd39ac10cb Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 21 Jul 2026 17:36:25 +0000 Subject: [PATCH 4/6] fix(ci): seed configs/ and pin Node 22.13 in ootb workflow MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Two independent bugs made the ootb workflow fail on every run: 1. configs/ is gitignored and never existed in CI, so check-ootb's required-files check and db-server startup both failed. Seed it from configs-default/ after the workspace build, mirroring the documented local setup step. 2. setup-node was pinned to node-version '22.5', which resolves to 22.5.1. db-server imports node:sqlite at module scope, and that builtin is gated behind --experimental-sqlite on 22.5.0-22.12.x — importing it unflagged throws ERR_UNKNOWN_BUILTIN_MODULE and db-server exits immediately. This is why db-server never became reachable on port 3001 even after the entry-path fix, timing out check-ootb's db-server check and sim-new-user.js. node:sqlite lost the flag requirement in 22.13.0, so pin to that instead. Co-authored-by: Shiroha --- .github/workflows/ootb.yml | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/.github/workflows/ootb.yml b/.github/workflows/ootb.yml index c6ac97d..349ac82 100644 --- a/.github/workflows/ootb.yml +++ b/.github/workflows/ootb.yml @@ -17,7 +17,11 @@ jobs: - name: Setup Node.js uses: actions/setup-node@v4 with: - node-version: '22.5' + # db-server imports `node:sqlite` at module scope. That builtin is + # gated behind --experimental-sqlite on 22.5.0-22.12.x and only + # became available unflagged from 22.13.0 onward — pinning to + # '22.5' here made db-server crash on import on every run. + node-version: '22.13' - name: Install root deps shell: pwsh @@ -27,6 +31,15 @@ jobs: shell: pwsh run: npm run build --workspaces --if-present + - name: Seed configs/ from configs-default/ + shell: pwsh + run: | + New-Item -ItemType Directory -Force -Path configs | Out-Null + Get-ChildItem -Path configs-default -Filter *.json | ForEach-Object { + $dest = Join-Path configs $_.Name + if (-not (Test-Path $dest)) { Copy-Item $_.FullName $dest } + } + - name: Run check-ootb shell: pwsh run: node tools/check-ootb.js From 185a9e6ee5be3048c4ade820cb4c574003673e31 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 21 Jul 2026 17:36:32 +0000 Subject: [PATCH 5/6] fix(db-server): raise Node version guard to 22.13 for node:sqlite MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit assertNodeVersion() defaulted to requiring only Node 22.5, but node:sqlite (imported at module scope in lib/sqlite.ts) needs --experimental-sqlite before 22.13.0 and throws ERR_UNKNOWN_BUILTIN_MODULE without it. Raise the documented/enforced floor to 22.13 to match reality; the guard still can't intercept the sqlite import crash itself due to ESM import hoisting, so this is mainly a correctness/documentation fix — the real enforcement point is the CI node-version pin and local Node install docs. Co-authored-by: Shiroha --- db-server/package.json | 2 +- db-server/src/index.ts | 2 +- db-server/src/lib/runtime.ts | 11 +++++++++-- sfmc/src/runtime.ts | 5 +++-- 4 files changed, 14 insertions(+), 6 deletions(-) diff --git a/db-server/package.json b/db-server/package.json index b2df17e..e88d8aa 100644 --- a/db-server/package.json +++ b/db-server/package.json @@ -15,7 +15,7 @@ "format": "prettier --write \"src/**/*.{ts,tsx,js,json}\"" }, "engines": { - "node": ">=22.5.0" + "node": ">=22.13.0" }, "dependencies": { "sql-template-strings": "^2.2.2", diff --git a/db-server/src/index.ts b/db-server/src/index.ts index ccfa88f..884f1cf 100644 --- a/db-server/src/index.ts +++ b/db-server/src/index.ts @@ -62,7 +62,7 @@ import { readJsonFile, writeJsonFile } from "./lib/json.js"; import { isEnabled, loadModuleLock, updateModuleState } from "./lib/module-state.js"; import { body as sharedBody, json as sharedJson } from "./lib/http.js"; -if (!assertNodeVersion(22, 5)) { +if (!assertNodeVersion(22, 13)) { process.exit(2); } diff --git a/db-server/src/lib/runtime.ts b/db-server/src/lib/runtime.ts index 7e8b09f..600fad3 100644 --- a/db-server/src/lib/runtime.ts +++ b/db-server/src/lib/runtime.ts @@ -15,13 +15,20 @@ export function parseNodeVersion(version: string = process.versions.node): { } /** + * 校验当前 Node.js 版本是否满足最低要求。 * + * 默认下限 22.13 —— `node:sqlite`（db-server 的核心依赖）在 22.5.0–22.12.x + * 仍需 `--experimental-sqlite` CLI 参数才能加载，未带参数时会在 import 阶段 + * 直接抛出 `ERR_UNKNOWN_BUILTIN_MODULE`；该模块从 22.13.0 起默认可用（仍标记为 + * experimental）。注意：由于 ESM 静态 import 会在本文件被调用之前完成解析， + * 这里的检查无法拦截 `./lib/sqlite.ts` 自身的 import 崩溃，只能作为其余场景 + * 的兜底防线与版本要求的单一事实来源。 * * @param {number} [minMajor=22] - * @param {number} [minMinor=5] + * @param {number} [minMinor=13] * @return {*} {boolean} */ -export function assertNodeVersion(minMajor: number = 22, minMinor: number = 5): boolean { +export function assertNodeVersion(minMajor: number = 22, minMinor: number = 13): boolean { const actual = parseNodeVersion(); if (!actual || actual.major < minMajor || (actual.major === minMajor && actual.minor < minMinor)) { log.error(`[Runtime] Node.js ${minMajor}.${minMinor}+ is required; found ${process.versions.node}`); diff --git a/sfmc/src/runtime.ts b/sfmc/src/runtime.ts index baf54bd..97f01f2 100644 --- a/sfmc/src/runtime.ts +++ b/sfmc/src/runtime.ts @@ -19,8 +19,9 @@ import { resolveRuntimeRoot } from "@sfmc/sdk/node/config"; * 子服务进程通过 SFMC_ROOT + SFMC_PACKAGES_DIR env 拿到项目根 + 模块目录, * db-server 据此定位 modules/packages/, 不依赖自身 __dirname(SEA-launched 时不可靠)。 * - * node:sea 在 Node 21.7+/22+ 可用;db-server 依赖 node:sqlite 已要求 Node 22.5+, - * 因此这里可直接顶层 import,无需降级。 + * node:sea 在 Node 21.7+/22+ 可用;db-server 依赖 node:sqlite 要求 Node 22.13+ + * (22.5–22.12 该模块仍需 --experimental-sqlite,否则 import 阶段直接抛出 + * ERR_UNKNOWN_BUILTIN_MODULE),因此这里可直接顶层 import,无需降级。 */ export const IS_SEA: boolean = typeof isSea === "function" && isSea(); From 24de76adb590a84a88115d168109357411706216 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 21 Jul 2026 17:36:43 +0000 Subject: [PATCH 6/6] docs: correct Node.js version requirement from 22.5+ to 22.13+ node:sqlite requires --experimental-sqlite on Node 22.5.0-22.12.x and is only unflagged from 22.13.0 onward. Every doc claiming '22.5+' was technically wrong for db-server and directly contributed to the ootb CI workflow pinning an unsupported version. Also ignore qq-bridge/dist/ and sfmc/dist/ like the other workspace dist/ folders. Co-authored-by: Shiroha --- .gitignore | 2 ++ AGENTS.md | 15 ++++++++------- CLAUDE.md | 4 ++-- HANDOFF.md | 2 +- README.en.md | 4 ++-- README.md | 4 ++-- docs/user-guide.en.md | 8 ++++---- docs/user-guide.zh.md | 6 +++--- 8 files changed, 24 insertions(+), 21 deletions(-) diff --git a/.gitignore b/.gitignore index 8337848..f949c9d 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,8 @@ bds-tools/dist/ db-server/dist/ panel/dist/ +qq-bridge/dist/ +sfmc/dist/ modules/sdk/@sfmc-sdk/dist/ modules/sdk/@sfmc-sdk/node_modules/ shared/**/dist/ diff --git a/AGENTS.md b/AGENTS.md index cd737df..45b3f60 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -6,7 +6,7 @@ npm workspaces monorepo (root `package.json` has `workspaces`): | Path | What | Runtime | |------|------|---------| -| `db-server/` | SQLite HTTP REST backend (plain `node:http` + `node:sqlite`) | Node.js >=22.5 | +| `db-server/` | SQLite HTTP REST backend (plain `node:http` + `node:sqlite`) | Node.js >=22.13 | | `qq-bridge/` | QQ bridge (LLBot OneBot 11, WS 3002) | Node.js | | `bds-tools/` | BDS auto-updater + behavior-pack assembler | Node.js | | `sfmc/` | CLI management tool (REPL + supervisor), assembles SAPI BP at deploy time | Node.js, can SEA-bundle | @@ -215,14 +215,15 @@ node tools/lock.js drift # detect drifted files ## Cursor Cloud specific instructions -The Cloud VM is Linux; the repo primarily targets Windows, but the Node services run fine on Linux (Node ≥22.5 provides `node:sqlite`). The update script only runs `npm install`. Everything below is required each session before running/verifying services. +The Cloud VM is Linux; the repo primarily targets Windows, but the Node services run fine on Linux (Node ≥22.13 provides unflagged `node:sqlite`; 22.5–22.12 require the `--experimental-sqlite` CLI flag or db-server crashes on startup with `ERR_UNKNOWN_BUILTIN_MODULE`). The update script only runs `npm install`. Everything below is required each session before running/verifying services. - **Build before running.** `dist/` is gitignored for `@sfmc/sdk`, `db-server`, `bds-tools`, etc., and services run from `dist/`. Run `npm run build --workspaces --if-present` (builds the SDK first, then the services) after `npm install`. Without it, imports like `@sfmc/sdk/node/config` fail. - **`configs/` is gitignored** — populate it once from `configs-default/` (`mkdir -p configs && cp -n configs-default/*.json configs/`). db-server also runs with defaults if `configs/` is absent. -- **Gotcha — `modulesDir` in `configs/db_config.json`.** The default value copied from `configs-default/` is `"../modules"`, which resolves *relative to `PROJECT_ROOT` (= `SFMC_ROOT`, the repo root)* → `/modules` (outside the repo) → the module API returns an empty catalog. Set it to `"modules"` (or delete the key so it falls back to `/modules`). When `configs/` is absent entirely, the fallback is already correct. +- **Fixed — `modulesDir` in `configs-default/db_config.json`.** Used to ship as `"../modules"`, which resolved *relative to `PROJECT_ROOT` (= `SFMC_ROOT`, the repo root)* → `/modules` (outside the repo) → the module API returned an empty catalog. It now ships as `"modules"` so `configs/db_config.json` copied from the default is correct out of the box. When `configs/` is absent entirely, the fallback (`/modules`) was already correct. - **Run db-server (main service, port 3001):** `SFMC_ROOT=$PWD node db-server/dist/index.js`. Health: `GET http://127.0.0.1:3001/api/health`. The module/config REST surface is JSON-backed and is the CI-tested core path (`GET /api/sfmc/modules/catalog`, `POST /api/sfmc/modules/:id/{enable|disable}`). -- **Pre-existing bugs (not environment issues), so don't chase them during setup:** - - `tools/smoke-modules.js` uses `spawnSync` without importing it from `node:child_process` → crashes immediately. - - `tools/sim-new-user.js` (and the start-order docs above) spawn `db-server/index.js`, which does not exist — the real entry is `db-server/dist/index.js`. This makes the `sim-new-user` check in `tools/check-ootb.js` time out, so a healthy env shows **check-ootb 5/6 pass**. - - The SQLite-backed gameplay routes (`economy`, `lands`, `coops`, `scoreboards`, …) return `near "?": syntax error` because table names are interpolated through `sql-template-strings` (`FROM ${TABLE}` → `FROM ?`). The JSON-backed module/config API and `/api/health` work. +- **`node:sqlite` needs Node ≥22.13, not just ≥22.5.** `db-server` imports `node:sqlite` at module scope. On 22.5.0–22.12.x the module is still gated behind `--experimental-sqlite`; importing it unflagged throws `ERR_UNKNOWN_BUILTIN_MODULE` and db-server exits immediately on startup. This is exactly what caused the `ootb` GitHub Actions workflow to fail repeatedly (`setup-node` was pinned to `node-version: '22.5'`, which resolves to `22.5.1`) — `check-ootb`'s "db-server 启动 + 模块接口" step timed out waiting for `/api/health`, and `sim-new-user`/`smoke-modules` cascaded into the same timeout. Fixed by pinning CI to `22.13`+. +- **Pre-existing bugs (not environment issues), fixed as of this note — kept here for history:** + - `tools/check-catalog.js` used top-level ESM `import` syntax while the repo root `package.json` has no `"type": "module"` → `SyntaxError: Cannot use import statement outside a module` under plain `node`. Converted to CommonJS `require()` to match every other `tools/*.js` script. + - `tools/check-ootb.js`, `tools/sim-new-user.js`, and `tools/test-db-api.js` spawned `db-server/index.js`, which does not exist — the real entry is `db-server/dist/index.js`. This made the `db-server 启动` and `sim-new-user` checks in `tools/check-ootb.js` time out, so a healthy env used to show **check-ootb 5/6 pass**; both are now fixed and should pass 6/6 given a built workspace + `--experimental-sqlite`-capable Node. + - The SQLite-backed gameplay routes (`economy`, `lands`, `coops`, `scoreboards`, …) return `near "?": syntax error` because table names are interpolated through `sql-template-strings` (`FROM ${TABLE}` → `FROM ?`). The JSON-backed module/config API and `/api/health` work. This one is still open. - **`npm run lint` is broken out-of-the-box** — ESLint v10 needs a flat `eslint.config.js` and none exists in the repo. Use per-workspace `npm run typecheck` for static checking instead. diff --git a/CLAUDE.md b/CLAUDE.md index 81a71d2..71f3ad8 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,7 +8,7 @@ ScriptsForMinecraftServer is a Minecraft Bedrock Script API (SAPI) plugin with f | Path | Role | Runtime | |------|------|---------| -| `db-server/` | SQLite HTTP REST API (port 3001) | Node.js 22.5+ | +| `db-server/` | SQLite HTTP REST API (port 3001) | Node.js 22.13+ | | `qq-bridge/` | QQ bridge via LLBot OneBot 11 (WS 3002 only) | Node.js | | `panel/` | TUI management dashboard | Node.js (Ink) | | `BDSTools/` | BDS auto-updater + behavior-pack assembler | Node.js | @@ -64,7 +64,7 @@ node tools/install-module.js uninstall # uninstall module ### Build prerequisites -- Node.js 22.5+ for everything (db-server requires `node:sqlite`) +- Node.js 22.13+ for everything (db-server requires `node:sqlite`, which needs the `--experimental-sqlite` CLI flag on 22.5–22.12; unflagged from 22.13) - Run `sfmc` (or `node sfmc/dist/main.js`) to fill `configs/*.json` via wizard ## Architecture diff --git a/HANDOFF.md b/HANDOFF.md index 6a3073a..9a1220e 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -34,7 +34,7 @@ Per the user's directives: │ HTTP @ 127.0.0.1:3001 ▼ ┌────────────────────────────────────────────────────────────┐ -│ db-server (Node 22.5+) │ +│ db-server (Node 22.13+) │ │ manifest-loader.ts ← v2 manifests │ │ schema-registry.ts ← collects db.defineTable calls │ │ tx-runner.ts ← /api/sfmc/db/tx POST │ diff --git a/README.en.md b/README.en.md index ed0e0a4..d561fd2 100644 --- a/README.en.md +++ b/README.en.md @@ -5,7 +5,7 @@ [![version](https://img.shields.io/github/v/tag/DogeLakeDev/ScriptsForMinecraftServer?style=flat-square&label=version)](https://github.com/DogeLakeDev/ScriptsForMinecraftServer/tags) [![license](https://img.shields.io/github/license/DogeLakeDev/ScriptsForMinecraftServer?style=flat-square)](./LICENSE) -[![node](https://img.shields.io/badge/node-22.5%2B-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org) +[![node](https://img.shields.io/badge/node-22.13%2B-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org) [![typescript](https://img.shields.io/badge/TypeScript-6.x-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org) [![sea](https://img.shields.io/badge/SEA-single--executable-FF6B6B?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org/api/single-executable-applications.html) [![modules](https://img.shields.io/badge/modules-25-7B68EE?style=flat-square&logo=cube&logoColor=white)](./modules/catalog.json) @@ -221,7 +221,7 @@ ScriptsForMinecraftServer/ | Component | Required | |-----------|----------| -| Node.js | 22.5+ (db-server uses native `node:sqlite`) + 18+ (SAPI bundle) | +| Node.js | 22.13+ (db-server uses native `node:sqlite`, needs `--experimental-sqlite` before 22.13) + 18+ (SAPI bundle) | | OS | Windows 10/11 (primary), Linux/macOS supported | | BDS | Bedrock Dedicated Server 1.26.x | | Disk | ~500 MB (BP + services + node_modules) | diff --git a/README.md b/README.md index 3817dc2..ebb4093 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ [![version](https://img.shields.io/github/v/tag/DogeLakeDev/ScriptsForMinecraftServer?style=flat-square&label=version)](https://github.com/DogeLakeDev/ScriptsForMinecraftServer/tags) [![license](https://img.shields.io/github/license/DogeLakeDev/ScriptsForMinecraftServer?style=flat-square)](./LICENSE) -[![node](https://img.shields.io/badge/node-22.5%2B-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org) +[![node](https://img.shields.io/badge/node-22.13%2B-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org) [![typescript](https://img.shields.io/badge/TypeScript-6.x-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org) [![sea](https://img.shields.io/badge/SEA-single--executable-FF6B6B?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org/api/single-executable-applications.html) [![modules](https://img.shields.io/badge/modules-25-7B68EE?style=flat-square&logo=cube&logoColor=white)](./modules/catalog.json) @@ -227,7 +227,7 @@ ScriptsForMinecraftServer/ | 组件 | 要求 | |------|------| -| Node.js | 22.5+(db-server 原生 `node:sqlite`)+ 18+(SAPI 打包) | +| Node.js | 22.13+(db-server 原生 `node:sqlite`,22.13 前需 `--experimental-sqlite`)+ 18+(SAPI 打包) | | OS | Windows 10/11(主要),Linux/macOS 也支持 | | BDS | Bedrock Dedicated Server 1.26.x | | 磁盘 | ~500 MB(含 BP + 服务 + node_modules) | diff --git a/docs/user-guide.en.md b/docs/user-guide.en.md index 689b145..06bc626 100644 --- a/docs/user-guide.en.md +++ b/docs/user-guide.en.md @@ -1,7 +1,7 @@ # ScriptsForMinecraftServer User Guide > End-to-end walkthrough from a fresh BDS install to daily ops. After reading this you can: -> 1. Set up the environment (Node 18+ / Node 22.5+ / Windows Loopback Exemption) +> 1. Set up the environment (Node 18+ / Node 22.13+ / Windows Loopback Exemption) > 2. Initialize configs (`db_config.json` / `qq_config.json` / BP `.env`) > 3. Start all five top-level services (db-server / qq-bridge / bds-tools / sfmc / BP) > 4. Enable / disable modules in BDS @@ -18,7 +18,7 @@ │ HTTP @ 127.0.0.1:3001 ▼ ┌─────────────────────────────────────────────────────────┐ -│ db-server (Node 22.5+) │ +│ db-server (Node 22.13+) │ │ └─ SQLite @ ./data/sfmc_data.db │ │ REST API /api/sfmc/* │ │ manifest loader @ modules/_manifests/...json │ @@ -52,12 +52,12 @@ | Component | Required | |-----------|----------| -| Node.js | 18.x (SAPI bundle) + 22.5+ (db-server) | +| Node.js | 18.x (SAPI bundle) + 22.13+ (db-server; `node:sqlite` needs `--experimental-sqlite` before 22.13) | | OS | Windows 10/11 (primary), Linux/macOS also supported | | BDS | Bedrock Dedicated Server 1.26.x (tested with preview.30) | | Disk | ~500MB (BP + services + node_modules) | -**Install Node**: grab 22.5+ LTS from [nodejs.org](https://nodejs.org/). Then verify: +**Install Node**: grab 22.13+ LTS from [nodejs.org](https://nodejs.org/). Then verify: ```bash node -v # should print v22.x.x diff --git a/docs/user-guide.zh.md b/docs/user-guide.zh.md index 8525600..6085f8b 100644 --- a/docs/user-guide.zh.md +++ b/docs/user-guide.zh.md @@ -19,7 +19,7 @@ │ HTTP @ 127.0.0.1:3001 ▼ ┌─────────────────────────────────────────────────────────┐ -│ db-server (Node 22.5+) │ +│ db-server (Node 22.13+) │ │ └─ SQLite @ ./data/sfmc_data.db │ │ REST API /api/sfmc/* │ │ manifest loader @ modules/_manifests/...json │ @@ -54,12 +54,12 @@ | 组件 | 要求 | |------|------| -| Node.js | 22.5+ | +| Node.js | 22.13+(db-server 依赖 `node:sqlite`,22.13 前该模块需 `--experimental-sqlite` 才能加载) | | 操作系统 | Windows 10/11(主要平台),Linux/macOS 也支持 | | BDS | Bedrock Dedicated Server 1.26.x | | 磁盘 | ~500MB(含 BP + 服务 + node_modules) | -**Node 安装**:从 [nodejs.org](https://nodejs.org/) 拉 22.5+ LTS。装完后: +**Node 安装**:从 [nodejs.org](https://nodejs.org/) 拉 22.13+ LTS。装完后: ```bash node -v # 应输出 v22.x.x