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): excluded modules in the component menu

esengine8d8410a93fa9
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6900eb32c..ad3956461 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -33,6 +33,16 @@ published separately; it ships inside the editor.
install it. A project using a subsystem no subpath installs (video today) takes the whole
entry as before. Measured on the UI-game template: 1,305KB → 1,090KB, 57 files → 32.
+- **A component whose module Project Settings excludes is greyed out in Add Component, not hidden.** The export
+ refuses a build whose content uses an excluded module, which is the last possible moment
+ to find out; the editor knows the same thing when the menu opens. Greyed rather than
+ hidden, because a component that vanished reads as one the engine does not have.
+
+- **Excluding 3D physics, DragonBones or script graphs is now enforced like every other
+ module.** The refusal is enforced by detecting the components that put a module in use,
+ and those three had no such list — so excluding one passed silently and shipped the
+ package the refusal exists to prevent.
+
- **Project Settings has an Engine Modules page: force a module into the build, or refuse one.** A build works out which
subsystems a package needs from what the content uses, which is right for almost
everything — but not for a module only a script reaches, and not when a build must not
diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjs
index 3f7a71e25..960f5f26e 100644
--- a/tools/releaseNotes.mjs
+++ b/tools/releaseNotes.mjs
@@ -698,6 +698,10 @@ export const NOTED = {
{ internal: "a manual page's import line, following the move it documents" },
'refactor(play): the play realm asks for the whole import map by name':
{ internal: "the editor's preview page names the same subpaths it always did" },
+ 'feat(details): a component whose module the project refused cannot be added':
+ { note: "A component whose module Project Settings excludes is greyed out in Add Component, not hidden." },
+ 'fix(project): every module a project can refuse is one a build can detect':
+ { note: "Excluding 3D physics, DragonBones or script graphs is now enforced like every other module." },
'feat(project): a project can force an engine module in, or refuse one':
{ note: "Project Settings has an Engine Modules page: force a module into the build, or refuse one." },
'feat(settings): an Engine Modules page, one row per module':