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.

feat(content): New Scene in the Content Browser create menu

esengine7cf04c33646b
diff --git a/desktop/electron/importAssets.ts b/desktop/electron/importAssets.ts
index b7f167871..69ac65199 100644
--- a/desktop/electron/importAssets.ts
+++ b/desktop/electron/importAssets.ts
@@ -54,6 +54,28 @@ function uniqueName(absDir: string, name: string): string {
return candidate;
}
+/**
+ * Create a new asset file in `destDir` with `content` + a fresh `.meta` (uuid + the
+ * given type), deduping the name so it never clobbers. Returns the new project-
+ * relative path. Powers the Content Browser "New …" menu (e.g. New Scene).
+ */
+export async function createAsset(
+ root: string,
+ destDir: string,
+ baseName: string,
+ content: string,
+ type: string,
+): Promise<string> {
+ const absDir = resolveInRoot(root, destDir);
+ await mkdir(absDir, { recursive: true });
+ const name = uniqueName(absDir, baseName);
+ const abs = path.join(absDir, name);
+ await writeFile(abs, content, 'utf8');
+ const meta = { uuid: randomUUID(), version: META_VERSION, type, importer: importerDefaults(type) };
+ await writeFile(abs + META_EXT, JSON.stringify(meta, null, 2) + '\n', 'utf8');
+ return destDir ? `${destDir}/${name}` : name;
+}
+
export interface ImportResult {
/** New project-relative paths of the imported files. */
imported: string[];
diff --git a/desktop/electron/main.ts b/desktop/electron/main.ts
index 2ad9601af..ae98c202b 100644
--- a/desktop/electron/main.ts
+++ b/desktop/electron/main.ts
@@ -26,7 +26,7 @@ import { extractProjectSchemas } from './extractSchemas';
import { scanAssetDatabase } from './assetDb';
import { cookAssets } from './cookAssets';
import { startProjectWatch, stopProjectWatch } from './projectWatcher';
-import { importAssets, IMPORT_EXTENSIONS } from './importAssets';
+import { importAssets, createAsset, IMPORT_EXTENSIONS } from './importAssets';
import { exportGame } from './exportGame';
import { buildPlayRealm } from './buildPlayRealm';
import { resolveScripts } from '../src/project/format';
@@ -241,6 +241,11 @@ ipcMain.handle('project:importFiles', (_e, destDir: string, sources: string[]) =
importAssets(requireRoot(), destDir, sources),
);
+// Create a new asset file (+ .meta) from renderer-supplied content (e.g. New Scene).
+ipcMain.handle('project:createAsset', (_e, destDir: string, baseName: string, content: string, type: string) =>
+ createAsset(requireRoot(), destDir, baseName, content, type),
+);
+
ipcMain.handle('fs:read', (_e, relPath: string) => readInRoot(requireRoot(), relPath));
ipcMain.handle('fs:write', (_e, relPath: string, contents: string) =>
writeInRoot(requireRoot(), relPath, contents),
diff --git a/desktop/electron/preload.ts b/desktop/electron/preload.ts
index c1152ac0b..51e33a7bb 100644
--- a/desktop/electron/preload.ts
+++ b/desktop/electron/preload.ts
@@ -75,6 +75,9 @@ const api = {
/** Import already-resolved absolute paths (OS drag-drop) into `destDir`. */
importFiles: (destDir: string, sources: string[]): Promise<{ imported: string[]; skipped: string[] } | null> =>
ipcRenderer.invoke('project:importFiles', destDir, sources),
+ /** Create a new asset file (+ .meta) from `content`; returns its project path. */
+ createAsset: (destDir: string, baseName: string, content: string, type: string): Promise<string> =>
+ ipcRenderer.invoke('project:createAsset', destDir, baseName, content, type),
},
// New-project templates (launcher New tab).
templates: {
diff --git a/desktop/src/panels/ContentBrowser.tsx b/desktop/src/panels/ContentBrowser.tsx
index cf1c1d5ff..57333766c 100644
--- a/desktop/src/panels/ContentBrowser.tsx
+++ b/desktop/src/panels/ContentBrowser.tsx
@@ -396,6 +396,17 @@ export function ContentBrowser() {
}
};
+ const newScene = async () => {
+ try {
+ const path = await ProjectStore.createSceneFile(cwd);
+ refreshFs();
+ selectAsset(path);
+ setRenaming(path); // drop into rename, like New Folder
+ } catch (e) {
+ Toasts.push(`New scene failed: ${errMsg(e)}`, 'error');
+ }
+ };
+
const showInExplorer = async (path: string) => {
try {
await window.estella.shell.showItem(path);
@@ -526,6 +537,8 @@ export function ContentBrowser() {
return [
{ label: 'Import…', icon: <Import size={14} />, onClick: () => void importAssets() },
{ label: 'New Folder', icon: <FolderPlus size={14} />, onClick: () => void newFolder() },
+ { sep: true },
+ { label: 'New Scene', onClick: () => void newScene() },
{ label: 'New Material', onClick: () => void createMaterial(cwd) },
{ label: 'New Material Graph', onClick: () => void createMaterialGraph(cwd) },
{ sep: true },
diff --git a/desktop/src/project/ProjectStore.ts b/desktop/src/project/ProjectStore.ts
index 2f5c17ee7..0f2d2144e 100644
--- a/desktop/src/project/ProjectStore.ts
+++ b/desktop/src/project/ProjectStore.ts
@@ -345,6 +345,16 @@ class ProjectStoreImpl {
this.store.setState({ project: { ...st, currentScene: null } });
}
+ /**
+ * Create a new blank scene FILE (+ `.meta`) under `destDir` for the Content
+ * Browser's "New Scene" — writes it to disk WITHOUT switching the editor to it
+ * (unlike {@link newScene}). Returns its project-relative path.
+ */
+ async createSceneFile(destDir: string): Promise<string> {
+ const content = JSON.stringify(this.blankScene(), null, 2) + '\n';
+ return window.estella.project.createAsset(destDir, 'scene.esscene', content, 'scene');
+ }
+
/**
* Load the project's asset index (the main-process AssetDatabase scan)
* into a uuid→path registry, then point the engine
diff --git a/desktop/tests/project-fs.test.ts b/desktop/tests/project-fs.test.ts
index daa5c6241..14f35a211 100644
--- a/desktop/tests/project-fs.test.ts
+++ b/desktop/tests/project-fs.test.ts
@@ -18,7 +18,7 @@ import {
statInRoot,
} from '../electron/projectFs';
import { isIgnoredPath } from '../electron/projectWatcher';
-import { importAssets } from '../electron/importAssets';
+import { importAssets, createAsset } from '../electron/importAssets';
let root: string;
const read = (rel: string) => readFileSync(path.join(root, rel), 'utf8');
@@ -148,3 +148,19 @@ describe('duplicateInRoot', () => {
expect(JSON.parse(read('assets/pack copy/a.png.meta')).uuid).not.toBe('bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb');
});
});
+
+describe('createAsset', () => {
+ it('writes the file + a .meta (fresh uuid + type) and dedups the name', async () => {
+ const p1 = await createAsset(root, 'assets', 'scene.esscene', '{"v":"1.0"}', 'scene');
+ expect(p1).toBe('assets/scene.esscene');
+ expect(read('assets/scene.esscene')).toBe('{"v":"1.0"}');
+ const m = JSON.parse(read('assets/scene.esscene.meta'));
+ expect(m.type).toBe('scene');
+ expect(m.uuid).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-/);
+
+ // A second create with the same base name dedups rather than clobbering.
+ const p2 = await createAsset(root, 'assets', 'scene.esscene', '{}', 'scene');
+ expect(p2).toBe('assets/scene 2.esscene');
+ expect(read('assets/scene.esscene')).toBe('{"v":"1.0"}'); // original untouched
+ });
+});