Emberveil

项目地址：

GitHub: FSWei/Emberveil · Gitee: FSW_ei/emberveil
License: MIT

开发时间：

2026.04 - 2026.05（已全面开源）

Emberveil

像素风叙事解谜游戏，跑在 ESP32-S3 + 240×240 屏幕上——巴掌大的机器里塞下一个有故事的横版游戏。

---

项目概述

Emberveil 是一款为 ESP32-S3 打造的像素风叙事解谜游戏（embedded side-scroller）——不是把网页游戏塞进单片机，而是从硬件约束出发设计的游戏：240×240 的 ST7789 屏、有限的算力与内存，决定了它的美术密度、关卡长度和渲染方式。

开发全程用了 4 期视频记录（从第一行代码到"全面开源"），美术资产全部手绘 + Aseprite 导出，仓库里连导出用的 Lua 脚本都开源了。

---

核心功能

• 横版叙事解谜：像素美术 + 关卡推进 + 故事碎片
• 硬件原生运行：ESP32-S3 + ST7789 240×240，PlatformIO 构建
• 全套美术开源：角色 / 动物 / 场景的 .aseprite 源文件 + GIF 预览
• 工程化美术管线：Aseprite Lua 导出脚本（export_char / export_scene / export_scene_enhanced）
• MIT 许可：代码与美术都可自由取用

---

效果展示

Emberveil 封面

游戏画面 01

游戏画面 02

游戏画面 03

---

技术栈说明

部分	说明
主控	ESP32-S3
显示	ST7789 240×240
构建	PlatformIO
语言	C++
美术	Aseprite（源文件 + Lua 导出脚本）
许可	MIT

---

项目架构

Emberveil/
├── src/                 # 游戏逻辑（C++ / PlatformIO）
├── art/                 # 全部美术源资产
│   ├── 主角/ 场景/ 动物/ 小白/ 标题页/   # .aseprite 源文件
│   ├── *.gif *.png                        # 导出预览
│   └── aseprite_scripts/                  # export_char / export_scene(.lua)
├── README.md / README.zh-CN.md
└── LICENSE              # MIT

---

开发历程

阶段	内容
立项	决定"小屏幕也要有故事"，选 ESP32-S3 + ST7789
引擎层	PlatformIO 工程、渲染与输入
美术管线	Aseprite 手绘 + Lua 脚本批量导出
内容	关卡 / 叙事 / 角色动画
开源	中英双语 README + MIT，4 期开发日志视频

为什么开源：硬件游戏的门槛在"别人不知道怎么起步"——把 .aseprite 源文件和导出脚本一起放出来，别人才能真的接着做。