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.

4.7 KB
Raw Blame

下城避难所 · Cyber Rooftop

以赛博生存建造参考图为目标搭建的 Estella 项目。世界由可编辑的 3D 模型构成,2D HUD 使用原生 Canvas、UINode、UIVisual 和 Text;没有把概念图作为游戏背景。包含屋顶安全屋、双层种植架、集装箱、管线、水处理设施、补给箱、城市建筑、广告牌、高架列车、雨、蒸汽、局部积水反射及第一人称建造工具。

这是可运行的场景重建版本,尚未达到参考图的一比一视觉精度:建筑表面密度、角色手部、工具造型、城市广告布局和电影级光照仍与参考图有差距。验收截图必须使用 output/cyber-rooftop/actual.png。

打开与运行

在 Estella 编辑器中打开本目录的 project.esproject,打开 assets/scenes/main.esscene。本地自动验证仅使用 Blender 后台模式、CLI 和无界面 Chromium;编辑器验收留给 CI。

从仓库根目录执行:

node pipeline/bin/estella.mjs export examples/cyber-rooftop --out output/cyber-rooftop/web --no-aot
node examples/cyber-rooftop/tools/preview.mjs

随后访问 http://127.0.0.1:5186/。预览服务仅监听本机,可用 PORT 环境变量指定端口。Web 包包含运行资源,不依赖纹理 CDN。

操作 按键
移动 / 加速 WASD / 左 Shift
环视 按住鼠标右键拖动,或方向键
回到参考构图 Home
平台 / 净水装置 4 / 5,或点击对应快捷栏
旋转 / 放置 R / 在场景中单击左键
退出 / 恢复建造 Esc / B
回收右侧补给箱 靠近后按 F,最多四次

平台消耗 4 废钢、2 电子元件;净水装置消耗 8 废钢、4 电子元件。放置检查完整旋转占地、建筑区域、屋顶边缘、材料余额和已建物件。样区最多建造 12 个对象。净水装置完成任务并将饮水状态提升到 84%。生命、义体和能量目前显示样区初值;其余快捷栏是场景展示,尚无完整生存模拟、背包逻辑或存档。刷新会重置建造。

编辑与资源

仓库只保留游戏运行用到的资源。屋顶模型的源文件、生成脚本和参考图已移除,assets/models 下的 .esprefab、.esmesh、.esmaterial 和贴图是最终资源,直接在编辑器中修改。

  • tools/textures.py:重建 roof-normal.png、roof-wetness.png 等表面数据图;需要 Python Pillow 和 Windows 微软雅黑字体。末尾调用 tools/hud.py。
  • tools/hud.py:重建 HUD 边框、勾选状态、按键帽和选中描边,可单独执行 python examples/cyber-rooftop/tools/hud.py。
  • assets/textures/hud-inventory-atlas.png:八件物品共用的透明图集;tools/hud-inventory-frames.json 保存各图块边界,原生 UIVisual 按 UV 引用。hud-map.png 是独立的区域示意底图;玩家标记由运行时更新。重建边框不会覆盖这两张图片。
  • src/hud-layout.json:HUD 锚定布局参数,运行时读取。
  • src/building.ts、src/main.ts:空间约束及交互;场景几何和 HUD 都使用 Estella 运行时。

重新生成贴图后执行 node tools/asset-meta.js examples/cyber-rooftop/assets 更新侧车文件。环境与软粒子图复用本仓库 neon-ascension 中的资源。

展示质量与资源约定

顶棚和上层种植灯使用向下的原生聚光灯,入口保留全向点光阴影。加上月光,共请求九块阴影图;不要把聚光灯改成全向点光来补亮,否则六面阴影会挤占其他灯的预算。使用灯光状态检查实际分配,不能仅凭 meshShadows: true 判断阴影已经生效。

roof-normal.png 和 roof-wetness.png 保存的是法线及湿度数据,侧车文件必须保留 sRGB: false。制作工具通过 assetExclude 排除在资源导入和发布之外。

后续以实机画面与参考构图对照打磨建筑层次、近景工具和手部、湿地材质、植被与城市远景。每轮同时验收建造交互、原生 HUD、粒子与性能;记录分辨率和设备,后台节流或暂停采样不作为帧率证据。

验证

node build-tools/cli.js check-examples
& ./sdk/node_modules/.bin/tsc.cmd -p examples/cyber-rooftop/tsconfig.json
node --test examples/cyber-rooftop/tools/building.test.mjs
node tools/asset-meta.js examples/cyber-rooftop/assets --check
node examples/cyber-rooftop/tools/verify.mjs

最后一步使用已导出的 Web 包,在真正无界面的 Chromium 中通过真实键鼠操作,检验旋转、材料扣除、重复放置拦截、取消、移动边界、净水任务、快捷栏和粒子动画。逐帧观察使用引擎原有只读 Playthrough 接口。报告与 1672×940 / 1280×720 截图写入 output/cyber-rooftop/。此结果不代表移动设备或编辑器验收。