编辑器
Estella 编辑器是一个桌面应用(Electron + React),带 UE5 风格的可停靠工作区。你可视化地搭 场景、在检视器里调组件、绘制瓦片地图、连节点图,并直接在编辑器里运行游戏——在一个隔离的 运行时 realm 里,所以运行永远不会弄脏你的场景。
没有项目打开时,编辑器显示 启动器(Launcher):
- 最近 — 重新打开你做过的项目,带搜索和网格/列表视图。
- 新建项目 — 选一个模板,起名字、选位置,创建。模板分两组:Starters (Blank 模板——只有一个相机的空场景)和 Examples(随附的示例项目, 可直接探索和修改)。
一个项目就是磁盘上的一个文件夹。编辑器关心的几块:
| 路径 | 是什么 |
|---|---|
project.esproject |
项目清单——名字、默认场景、设计分辨率、启用的特性(物理、渲染)、打包。纳入版本控制。 |
.esengine/workspace.json |
编辑器本地状态(上次打开的场景、面板布局)。被 gitignore。 |
assets/scenes/*.esscene |
你的场景。 |
assets/… |
纹理、材质、瓦片集等资产,每个带一个 .meta 边车文件。 |
src/components.ts |
声明入口——编辑器会求值这个模块以及它 import 到的一切,以此认识你的组件。组件定义在哪都行,从这里 re-export 出来即可。见脚本。 |
src/main.ts |
启动入口——注册系统的地方。跑游戏的是它;编辑器从不求值它。 |
资产按 UUID(@uuid:…)可移植地引用,而不是按路径,所以移动或重命名文件不会断掉引用。
默认工作区:视口居中,世界大纲与细节在右侧,内容浏览器在底部,运行控制在顶部。
从外到内的默认布局:
- 活动栏(Activity Bar) — 最左侧的图标竖条:编辑模式(场景 / UI / 瓦片地图)、侧面板、项目设置。
- 菜单栏 — 文件 · 编辑 · 实体 · 视图 · 构建 · 窗口 · 帮助。
- 工具栏 — 保存、撤销/重做、各变换工具、吸附、显示网格、运行控制、显示 gizmo、构建。
- 视口(中央) — 实时 WebGL 场景视图。
- World Outliner(右) — 场景的实体层级。
- Details(右) — 当前选中项的检视器。
- 内容浏览器 + 输出日志(底部标签)。
- 状态栏 — 编辑模式、选中项、光标、FPS、draw calls、引擎版本。
面板可停靠——拖动标签即可重排、拆分或浮动,布局会自动保存。你也能用 Ctrl / ⌘ + Space 从任 何地方把内容浏览器唤成上滑浮层(内容抽屉)。
本章其余部分
Section titled “本章其余部分”上面的导览讲的是这个工具长什么样。下面几页是你会反复回来查的部分。