迄今最大的一次 Deki 发布:一台新掌机、一个新的游玩之处、一个物理引擎,以及一个从头到尾都能做出来的第一个游戏。
Anbernic RG40XX H
感谢 Deki 的新赞助商 Anbernic 寄来一台 RG40XX H。这是一台 Linux 掌机,有 640x480 屏幕、按键和两个摇杆,Deki 现在能为它做游戏。
- 通过 Wi-Fi 安装。 在编辑器里填一次掌机的地址,Install 就会把游戏发过去。替换旧文件之前,每个文件都会先校验。
- 也可以放到 SD 卡上,在 Apps 列表里带着自己的图片。
- 每秒 60 帧。 封面里的农场在 640x480 屏幕上以两倍大小绘制,稳定运行在 60 fps。这次发布之前是 35 到 47。
- 两个摇杆和所有按键。 游戏把摇杆当摇杆读取,左摇杆也能当方向键用。
手柄现在到处都能用:编辑器的播放视图、桌面构建和掌机上。
在浏览器里玩
新增 Web 平台。在构建面板里选中它,按下 Build & Open in Browser,游戏就会在网页浏览器里打开。第一次时编辑器会安装所需的工具(Emscripten,约 2 GB)。
就在这里试试:这是指南里的农场,为网页构建的版本。
它和开发板、桌面用的是同一个项目:同样的场景,同样的代码。构建出来的是一个带文件的网页,可以放到任何网站上,不需要开发板,谁都能玩。
你的第一个游戏
一份新指南从头到尾做出 Tiny Farm。用按键、手柄按钮或点按来走路,种下萝卜,成熟后收获,叠成摇摇晃晃的塔扛着,在谷仓卖掉。地图用 Tiled 绘制,每一步、每一行代码都有讲解。

它在 LilyGO T-Deck 上以 60 fps 运行。从这里开始:你的第一个游戏。
2D 物理
新包 deki-physics-2d。箱子能堆起来,球会滚会弹,绳子会摆,门绕着铰链转。

- 形状: 箱子、圆、胶囊,以及最多 8 个角的任意形状。
- 关节: 带限位和马达的铰链、距离关节和绳子。
- 触发器、层和射线,以及两个物体接触时的通知。
- 每台机器上都一样。 物理按固定步长运行,所以游戏在任何帧率下表现一致,在电脑上能立住的一摞箱子在 ESP32 上也能立住。
- 轻到能跑在开发板上。 在 T-Deck 上,30 个运动中的箱子每步 1.6 ms。已经静止的一堆几乎不花时间。
- 在场景视图里编辑: 碰撞体和关节会画在那里,带手柄可拖动大小和角。
Tiled 地图
用 Tiled 做的地图现在会照你画的样子导入:等距、六边形和交错地图,放在地图上的对象,动画图块,图像层,组图层,按各自速度滚动的图层,以及混合的图层。这个农场就是其中之一。
开发板上更流畅
- 滚动时只重绘新露出的边。 相机移动时,上一帧跟着移动,只绘制新进入视野的部分。在 T-Deck 上,有 8 个村民走动的农场从每帧 20.6 ms 降到 16.7 ms,达到屏幕的满 60 fps。
- 像素画移动更顺滑。 打开 Pixel Perfect 后,相机每次移动一个屏幕像素,在两倍大小的地图上行走的角色不再抖动。
- ESP32 开发板上留给游戏的内存更多: 内部 RAM 多出约 20 KB,ESP32-S3 上帧时间更稳定。
3D
glTF 模型。 .gltf 和 .glb 文件现在可以像 .obj 一样载入,带颜色和纹理。
编辑器
- 从项目列表更新。 有新版本时,编辑器会提示,下载并校验,在你重启时完成切换。
- 打开旧项目时有一份清单。 每个编辑器无法自动转换的变更都有一条说明该怎么做,并指出受影响的场景和代码行。

- 在开发板上查看每个对象的绘制开销,实时测量。
- 工作更快: 打开一个代码没变的项目只要几秒,不再是两分钟。
文档
这次发布中,文档大大丰富了:
- 新指南。 入门:从下载编辑器到代码在开发板上运行(也有日文、中文和韩文版);一步一步做出来的「你的第一个游戏」和「你的第一个应用」;以及组件、资源、精灵、文本、动画、输入、物理和使用自己设备的指南。
- 每个设备一页: 设备上已经配置好了什么、怎样把游戏装上去,掌机上每个按键对应哪个键。
- 更容易找到。 首页和侧栏按用途给指南和包分组,API 参考从一份简单的类列表开始,大多数代码的起点放在最上面。
更新之前
精灵的旋转现在也是逆时针,与子对象、光照、3D 和物理一直以来的方向一致。如果你凭眼睛旋转过某个精灵,请把旋转的正负号反过来。上面的清单会告诉你在哪里。
所有包都升到 0.40。请在包管理器里一起更新。
致谢
Tiny Farm 的美术来自 Aibyzz 的 Simple Cozy - Farm Asset Pack,字体是 Vinícius Menézio 的 monogram。感谢两位。




