LittleJS 1.28 是 LittleJS 在 2026 年 10 月发布的新版本。LittleJS 是一款免费开源的 HTML5 游戏引擎,可以制作在浏览器里运行的 2D 和 3D 游戏。这次更新加入了开箱即用的跟随镜头、第三人称 3D 镜头、一行代码就能调用且会自动叠加和衰减的屏幕震动,以及用于单向平台和传送带的全新 Box2D 工具。如果你在做小型网页游戏,这些正是平时要自己手写的“手感”功能。
| 速览 | |
|---|---|
| 是什么 | LittleJS,轻量级 HTML5 游戏引擎,支持 2D 和 3D |
| 作者 | Frank Force(KilledByAPixel) |
| 本文版本 | 1.28.0,2026 年 10 月 20 日发布 |
| 许可与价格 | MIT 许可,免费开源 |
| 渲染 | WebGL2 + Canvas2D 混合渲染,内置 3D 渲染器 |
| 安装 | npm install littlejsengine |
| 在线试玩 | 官方示例浏览器,任何现代浏览器都能打开 |
LittleJS 是什么?
LittleJS 是一款追求简单和速度的 JavaScript 游戏引擎,作者是 Frank Force,以 MIT 许可在 GitHub 上开源,目前星标已超过 4,400。
它最大的特点是体积小但功能不少。根据官方 README,包含全部插件的完整压缩版 gzip 后约 135 KB;用 Vite 等工具打包的小型 2D 游戏只有约 26 KB,带光照的 3D 场景约 47 KB。它甚至有一个专为 js13kGames 比赛准备的分支,打包后的 zip 只有 7 KB。

这个小小的引擎里装了不少东西:
- 画面: 精灵与图集(TexturePacker、Aseprite)、粒子、Shadertoy 风格着色器、带柔和阴影的 2D 光照、视差背景。
- 3D: 形状生成、OBJ 和 glTF 加载、地形、体素地图、阴影贴图。
- 音频: 支持 mp3、ogg、wave 文件,并可用 ZzFX 生成音效。
- 输入: 鼠标、键盘、手柄、触屏,还为手机提供屏幕虚拟手柄。
- 物理: 带瓦片地图碰撞的简单街机物理,以及可选的 Box2D 插件。
- 工具: 内置 2D/3D 关卡编辑器、粒子设计器,支持 Tiled 的 JSON 格式。
LittleJS 1.28 有哪些新功能
这次版本的标题是“Cameras, Screen Shake and Box2D Platforms”,基本概括了全部重点。对网页游戏开发者最有用的改动如下:
| 功能 | 作用 | 为什么有用 |
|---|---|---|
FollowCamera(2D) |
平滑跟随、死区、关卡边界、缩放和前瞻 | 不必每个平台游戏都手写插值代码 |
ThirdPersonCamera3D |
在玩家身后跟随,可用鼠标或手柄控制,靠近墙壁时自动拉近 | 开箱即用的 3D 镜头 |
| 基于时间的平滑 | 镜头平滑不再受帧率影响 | 60 Hz 笔记本和 144 Hz 显示器上手感一致 |
cameraShake(amount) |
支持 2D 和 3D,震动可叠加、自动衰减,暂停或顿帧时也会继续 | 一行代码做出打击反馈 |
Box2D oneWay 平台 |
可从下方跳上平台,也能向下穿过 | 用真实物理实现经典平台跳跃 |
Box2D setSurfaceSpeed |
把表面变成传送带 | 无需自己写移动地面 |
Box2D beginContact |
提供接触位置和撞击力度 | 根据撞击轻重播放音效或火花 |
还有一些小改进:子对象现在会保持相对父对象的位置和角度偏移;新增 setWorldPos3D、setWorldRotation3D、getWorldRotation3D,用于在世界坐标中放置 3D 子对象;插件可以注册 updatePost 函数,在所有对象移动完成后执行。
新的跟随镜头与 3D 镜头
好的镜头是“看不见”的,玩家根本不会注意到它。FollowCamera 把常用技巧集中到一个对象里:死区让玩家小范围移动时镜头先不动,小跳不会让画面晃来晃去;前瞻把视野往移动方向推一些,让玩家看到前方;关卡边界防止镜头拍到地图边缘以外的空白。
由于平滑改为基于时间计算,不管游戏跑在 30 帧还是 144 帧,镜头的缓动都一样。这在网页上很重要,因为你永远不知道玩家用的是什么设备。

3D 方面,ThirdPersonCamera3D 会待在玩家身后,随鼠标或手柄转动,墙壁挡住视线时会自动拉近。新的“3D Third Person”演示用一颗在方块阵中奔跑的小球展示了这一点。
屏幕震动要恰到好处
屏幕震动是让打击感变强最便宜的办法之一,也最容易用过头。在 1.28 中只要调用 cameraShake(amount),剩下的交给引擎:多次震动会叠加,然后自动衰减。即使在暂停或短暂顿帧(hit stop)时也会继续播放,而这正是打击反馈最关键的时刻。

给休闲网页游戏的几条实用建议:
- 时间要短。 不到一秒就够了,震太久看起来像 bug。
- 力度要配合事件。 落地轻轻一震,爆炸再用大力。
- 阅读和瞄准时不要震。 文字、菜单和精准射击都要保持稳定。
- 提供关闭选项。 有些玩家对画面晃动会不舒服,加一个开关是好习惯。
- 和不震动的版本对比。 同一个场景两种方式各玩一次:看不出区别说明太弱,影响看清画面说明太强。
用 Box2D 做单向平台和传送带
LittleJS 自带轻量的街机物理,也可以通过可选插件使用 Box2D(2.3.1 版本,编译为 WebAssembly)。1.28 让这个插件更适合做平台跳跃游戏。

有了 oneWay 平台,玩家可以从下方跳上平台,按下键再穿过它落下,这是无数 2D 平台游戏的经典操作。setSurfaceSpeed 能把任何表面变成传送带,带着玩家和箱子移动。beginContact 现在会告诉你两个物体在哪里接触、撞得多重,方便根据撞击调整音效或粒子数量。遇到特殊情况,还可以用 preSolve 决定是否忽略某次接触。
新的“Box2D Platformer”演示把这些都放在了一起:单向平台、向下穿越、传送带和可推动的箱子。
五分钟上手 LittleJS 1.28
想看新功能不用安装任何东西。打开 LittleJS 官方示例浏览器,选择“Camera Shake”“Box2D Platformer”“3D Third Person”或“Platforming Game”即可。代码就显示在运行中的游戏旁边,可以边看边玩。

开始自己的项目:
- 安装 Node.js,然后运行
npx degit KilledByAPixel/LittleJS/examples/vite-starter my-game。 - 或者在现有项目中执行
npm install littlejsengine。 - 用本地 Web 服务器打开项目文件夹;直接双击文件打开时,加载图片或模块的页面无法正常运行。
- 从对应示例中复制需要的部分,再调整数值直到手感合适。
从旧版本升级? 有一处改动可能导致代码出错:CameraControl3D 和 FirstPersonCamera3D 现在会在所有对象移动之后才设置 3D 镜头,而不是在它们自己的 update() 里。如果你手动调用 update() 后要读取镜头,请在之后调用 updateCamera()。升级前先保留一个能正常运行的版本,再测试跳跃、落地、下穿和重开等核心操作。
LittleJS 适合谁?
LittleJS 适合想做小巧、快速的网页游戏、又不想用笨重编辑器的开发者。它很适合游戏 Jam 和体积限制比赛,也适合重视加载速度的手机网页游戏;同时它是很好的学习材料,因为整个引擎都是可读的 JavaScript。

官方 README 列出的作品包括 Space Huggers、Black Cat Squadron 和 The Way of the Dodo(后两者都在 js13kGames 获得第五名),以及许多 Jam 作品。项目中的“LittleJS Arcade”还收录了 50 多款可在浏览器里直接玩的示例游戏。
如果你需要大型可视化编辑器、庞大的素材商店或主机导出,更大的引擎可能更合适。如果你想要一个能从头到尾看懂、并能打包成极小文件发布的工具,LittleJS 很难被替代。
常见问题
LittleJS 免费吗?
免费。LittleJS 以 MIT 许可开源,免费游戏和商业游戏都可以使用。
LittleJS 1.28 是什么时候发布的?
1.28.0 版本于 2026 年 10 月 20 日在 GitHub 上发布。
LittleJS 支持 3D 吗?
支持。它内置与 2D 共用画布的 3D 渲染器,支持 glTF 和 OBJ 加载、地形、阴影贴图,从 1.28 起还提供第三人称镜头。
LittleJS 怎么加屏幕震动?
调用 cameraShake(amount) 即可。震动会叠加、自动衰减,在 2D 和 3D 中都能用,有没有镜头对象都可以。
能用 LittleJS 做手机网页游戏吗?
可以。它支持触屏输入并内置屏幕虚拟手柄,小型 2D 游戏 gzip 后约 26 KB,在手机上加载更快。




