Skip to content

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.

docs(changelog): the replication subpath and the per-app plugin fix

esengine9b7db142a064
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5663d798d..1392f52d1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -23,6 +23,13 @@ published separately; it ships inside the editor.
### Changed
+- **Replication is a subpath: `import { Net, Replicated } from 'esengine/replication'`.** The base plugin set named the replication
+ plugin, so every package carried the wire protocol, the codec, the interest query and the
+ prediction replay — 64KB of a single-player game that nothing in it can reach. A game that
+ opens no session now pays 2.9KB; one that does pays what it did before. The sockets stay
+ on `esengine`: `createSocket`, `GameSocket` and the platform sockets are where they were,
+ because a game may talk to a server over a channel with no replication at all.
+
- **The AI runtimes are a subpath: `import { NavAgent } from 'esengine/ai'`.** Navigation,
perception, state machines and behaviour trees were 77KB in every package. What stays on
`esengine` is the verb vocabulary — `registerAction`, `aiRegistry`, `Blackboard` — because
@@ -54,6 +61,10 @@ published separately; it ships inside the editor.
### Fixed
+- **Two games in one process no longer share an optional subsystem's plugin.** Tilemaps, script graphs and the four
+ AI runtimes each registered their module-level plugin singleton, so a second app installed
+ the first app's instance and the app state it carries.
+
- **A project whose art weighs less than the transcoder no longer compresses any of it.**
Reading a KTX2 costs a package about a megabyte of Basis transcoder, and compressing can
never save more than the textures themselves weigh — so a project lighter than that is
diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjs
index aca54a85c..f20d22917 100644
--- a/tools/releaseNotes.mjs
+++ b/tools/releaseNotes.mjs
@@ -696,6 +696,10 @@ export const NOTED = {
{ internal: 'the order a stack of plugins is assembled in' },
'docs(manual): the AI, tilemap and script-graph pages import from their subpaths':
{ internal: "a manual page's import line, following the move it documents" },
+ 'refactor(net): replication moves to its own subpath':
+ { note: "Replication is a subpath: `import { Net, Replicated } from 'esengine/replication'`." },
+ 'fix(app): an optional subsystem\'s plugin is built per app, not shared':
+ { note: "Two games in one process no longer share an optional subsystem's plugin." },
'refactor(ai): the AI runtimes move to their own subpath':
{ note: "The AI runtimes are a subpath: `import { NavAgent } from 'esengine/ai'`." },
'refactor(ai): the editor imports the AI runtimes from their subpath':