A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
probe(net): which space an interest position is actually in
esengine58e14381a76d
diff --git a/package.json b/package.jsonindex 0d9e5e801..6c8bb5ff3 100644--- a/package.json+++ b/package.json@@ -31,6 +31,7 @@"render-host": "node tools/render-host/build.mjs","verify:mutation": "node tools/mutation-contract.mjs","census:mutation": "node tools/mutation-census.mjs",+ "probe:interest-space": "node tools/probe-interest-position-space.mjs","verify:render": "node tools/verify-render.mjs","test": "vitest run --config vitest.engine.config.ts","verify:aot": "rm -rf .aot-verify && node pipeline/bin/estella.mjs export examples/ecs-basics --out .aot-verify && node tools/run-electron.mjs tools/launchers/headless-aot-verify.mjs .aot-verify",diff --git a/tools/probe-interest-position-space.mjs b/tools/probe-interest-position-space.mjsnew file mode 100644index 000000000..eba0d2cbb--- /dev/null+++ b/tools/probe-interest-position-space.mjs@@ -0,0 +1,64 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/**+ * @file Which space is an entity's interest position in?+ *+ * `RadiusInterestOptions.position` documents its default as the Transform's+ * WORLD-space position, and `defaultPosition` reads `t.position` — the+ * authoring input, relative to the parent. Whether that is a one-line fix+ * depends on something this probe measures rather than assumes: whether a+ * composed world transform exists on an authoritative server at all.+ *+ * node tools/probe-interest-position-space.mjs+ *+ * Reports; asserts nothing. Exit 2 where the engine is not built.+ */+import { existsSync } from 'node:fs';+import path from 'node:path';+import { fileURLToPath, pathToFileURL } from 'node:url';++const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');+const DIST = path.join(ROOT, 'sdk', 'dist', 'index.node.js');+const WASM = process.env.ESENGINE_WASM_DIR ?? path.join(ROOT, 'build', 'wasm', 'web');++if (!existsSync(DIST) || !existsSync(path.join(WASM, 'esengine.js'))) {+ console.log('probe-interest-position-space: no SDK or engine build — did NOT run.');+ process.exit(2);+}++const sdk = await import(pathToFileURL(DIST).href);+const factory = (await import(pathToFileURL(path.join(WASM, 'esengine.js')).href)).default;+const module = await factory({ locateFile: (f) => path.join(WASM, f) });++/** A parent at 100 and a child 5 to its right, stepped like a server steps. */+async function measure(makeApp, label) {+ const app = makeApp();+ const world = app.world;+ const parent = world.spawn('parent');+ world.insert(parent, sdk.Transform, { position: { x: 100, y: 0, z: 0 } });+ const child = world.spawn('child');+ world.insert(child, sdk.Transform, { position: { x: 5, y: 0, z: 0 } });+ world.setParent(child, parent);+ await app.tick(1 / 60);+ await app.tick(1 / 60);+ const t = world.get(child, sdk.Transform);+ console.log(` ${label}`);+ console.log(` child authoring position.x = ${t.position.x}`);+ console.log(` child composed worldPosition.x = ${t.worldPosition.x} (expected 105)`);+ return t.worldPosition.x;+}++console.log('');+console.log('Where a server reads an entity\'s place from:');+const headless = await measure(+ () => sdk.createHeadlessApp(module),+ 'createHeadlessApp — the authoritative-server shape',+);+console.log('');+console.log(` radiusInterest's default reads position, not worldPosition.`);+console.log(headless === 105+ ? ' A composed world transform IS available here, so reading it is a fix.'+ : ' No composed world transform is available here: transform composition runs'+ + '\n in the renderer backend, which a headless server does not install. Reading'+ + '\n worldPosition instead would place every entity at the origin.');+console.log('');