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.

fix: replace COMPONENT_TO_PLUGIN mapping with SDK uiPlugins

esengineda27c5268a49
diff --git a/editor/src/builder/EmitterUtils.ts b/editor/src/builder/EmitterUtils.ts
index b2128b2f2..41ac6c16b 100644
--- a/editor/src/builder/EmitterUtils.ts
+++ b/editor/src/builder/EmitterUtils.ts
@@ -14,67 +14,13 @@ import { isUUID, getComponentRefFields } from '../asset/AssetLibrary';
import { toBuildPath } from 'esengine';
// =============================================================================
-// Plugin Analysis
+// Plugin Resolution
// =============================================================================
-const COMPONENT_TO_PLUGIN: Record<string, string> = {
- 'Text': 'textPlugin',
- 'BitmapText': 'textPlugin',
- 'UIRect': 'uiLayoutPlugin',
- 'UIMask': 'uiMaskPlugin',
- 'Interactable': 'uiInteractionPlugin',
- 'Button': 'uiInteractionPlugin',
- 'TextInput': 'textInputPlugin',
- 'Image': 'imagePlugin',
- 'Toggle': 'togglePlugin',
- 'ToggleGroup': 'togglePlugin',
- 'ProgressBar': 'progressBarPlugin',
- 'Slider': 'sliderPlugin',
- 'Draggable': 'dragPlugin',
- 'ScrollView': 'scrollViewPlugin',
- 'Focusable': 'focusPlugin',
- 'SafeArea': 'safeAreaPlugin',
- 'ListView': 'listViewPlugin',
- 'Dropdown': 'dropdownPlugin',
- 'LayoutGroup': 'layoutGroupPlugin',
- 'AudioSource': 'audioPlugin',
- 'ParticleEmitter': 'particlePlugin',
- 'Tilemap': 'tilemapPlugin',
- 'TilemapLayer': 'tilemapPlugin',
- 'PostProcessVolume': 'postProcessPlugin',
-};
-
-export function analyzeUsedPlugins(artifact: BuildArtifact): string[] {
- const plugins = new Set<string>();
- let hasUI = false;
-
- for (const sceneData of artifact.scenes.values()) {
- const entities = (sceneData as any).entities as Array<{
- components: Array<{ type: string }>;
- }> | undefined;
- if (!entities) continue;
-
- for (const entity of entities) {
- for (const comp of entity.components) {
- const plugin = COMPONENT_TO_PLUGIN[comp.type];
- if (plugin) {
- plugins.add(plugin);
- hasUI = true;
- }
- }
- }
- }
-
- if (hasUI) {
- plugins.add('uiRenderOrderPlugin');
- }
-
- return Array.from(plugins);
-}
-
-// =============================================================================
-// Engine Module → Plugin Mapping
-// =============================================================================
+const BASE_PLUGINS = [
+ 'animationPlugin', 'audioPlugin', 'particlePlugin',
+ 'tilemapPlugin', 'postProcessPlugin', 'timelinePlugin',
+];
const MODULE_PLUGIN_MAP: Record<keyof EngineModules, string[]> = {
particles: ['particlePlugin'],
@@ -98,6 +44,17 @@ export function filterPluginsByModules(plugins: string[], modules?: EngineModule
return plugins.filter(p => !disabled.has(p));
}
+export function resolvePlayablePlugins(
+ engineModules?: EngineModules,
+): { imports: string; list: string } {
+ const optional = filterPluginsByModules(BASE_PLUGINS, engineModules);
+ const imports = ['uiPlugins', ...optional].join(', ');
+ const list = optional.length > 0
+ ? `...uiPlugins, ${optional.join(', ')}`
+ : '...uiPlugins';
+ return { imports, list };
+}
+
// =============================================================================
// Defines
// =============================================================================
diff --git a/editor/src/builder/PlayableEmitter.ts b/editor/src/builder/PlayableEmitter.ts
index e53b9b24a..9f5ecdefb 100644
--- a/editor/src/builder/PlayableEmitter.ts
+++ b/editor/src/builder/PlayableEmitter.ts
@@ -14,8 +14,7 @@ import { PLAYABLE_HTML_TEMPLATE } from './templates';
import type { NativeFS } from '../types/NativeFS';
import { getAssetMimeType, getAssetTypeEntry, toBuildPath } from 'esengine';
import {
- analyzeUsedPlugins,
- filterPluginsByModules,
+ resolvePlayablePlugins,
collectUserScriptImports,
compileUserScripts,
resolveSceneUUIDs,
@@ -174,14 +173,9 @@ export class PlayableEmitter implements PlatformEmitter {
): Promise<string> {
const { imports, hasSrcDir } = await collectUserScriptImports(fs, projectDir);
- const usedPlugins = analyzeUsedPlugins(artifact);
- const alwaysPlugins = ['animationPlugin', 'audioPlugin', 'particlePlugin'];
- const allPlugins = filterPluginsByModules(
- [...new Set([...usedPlugins, ...alwaysPlugins])],
+ const { imports: pluginImports, list: pluginList } = resolvePlayablePlugins(
context.config.engineModules,
);
- const pluginImports = allPlugins.join(', ');
- const pluginList = allPlugins.join(', ');
const entryContent = `
import { createWebApp as _cwa, initPlayableRuntime, RuntimeConfig, ${pluginImports} } from 'esengine';
diff --git a/editor/src/builder/index.ts b/editor/src/builder/index.ts
index 085788de9..5a0e3a257 100644
--- a/editor/src/builder/index.ts
+++ b/editor/src/builder/index.ts
@@ -25,7 +25,7 @@ export { type PlatformEmitter, type BuildArtifact } from './PlatformEmitter';
export { PlayableEmitter } from './PlayableEmitter';
export { WeChatEmitter } from './WeChatEmitter';
export { discoverProjectScenes } from './SceneDiscovery';
-export { analyzeUsedPlugins, buildDefinesMap, generatePhysicsConfig, compileUserScripts, resolveSceneUUIDs, collectUserScriptImports, type CompileOptions } from './EmitterUtils';
+export { resolvePlayablePlugins, filterPluginsByModules, buildDefinesMap, generatePhysicsConfig, compileUserScripts, resolveSceneUUIDs, collectUserScriptImports, type CompileOptions } from './EmitterUtils';
export { executeHooks, validateHook, createDefaultHook } from './BuildHooks';
export { TextureAtlasPacker, type AtlasFrame, type AtlasPage, type AtlasResult } from './TextureAtlas';
export { AssetDatabase, AssetDatabase as AssetLibrary, getAssetDatabase, getAssetDatabase as getAssetLibrary, resetAssetDatabase, resetAssetDatabase as resetAssetLibrary, isUUID } from '../asset/AssetDatabase';