
Kaboom.js v3000 已正式移除 layers() 和 layer() API,改用基于父子关系与 z() 顺序的渲染层级管理机制,通过 fixed()、z() 和嵌套 add() 实现更灵活、语义更清晰的图层控制。
kaboom.js v3000 已正式移除 `layers()` 和 `layer()` api,改用基于父子关系与 `z()` 顺序的渲染层级管理机制,通过 `fixed()`、`z()` 和嵌套 `add()` 实现更灵活、语义更清晰的图层控制。
在 Kaboom.js v3000 中,传统的多层渲染系统(如 layers(["game", "ui"], "game"))已被彻底移除。官方认为,独立的 layer 系统增加了复杂性,而通过组合 z()(Z 轴渲染顺序)、fixed()(脱离相机影响)和父子节点结构,完全可以等效甚至更优雅地实现相同效果——UI 始终置顶、游戏对象受相机控制、特效按需分层等。
✅ 推荐替代方案:用 z() + 父容器模拟图层
核心思路是:创建带 z() 和可选 fixed() 的父对象,将相关实体作为子节点添加进去。Kaboom 渲染时会按 z 值升序绘制,且子节点继承父节点的变换与渲染属性。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
kaboom()
loadSprite("bean", "/sprites/bean.png")
// ✅ 创建 UI 层:固定位置 + 高 z 值(确保置顶)
const ui = add([
fixed(), // 不随相机移动
z(100), // 渲染优先级高于默认对象(默认 z=0)
])
// 所有添加到 ui 下的对象自动获得 UI 行为
ui.add([
sprite("bean"),
scale(5),
pos(200, 80),
color(0, 0, 255),
])
// ✅ 游戏主层:无需额外声明,默认 z=0,受相机控制
add([
sprite("bean"),
pos(100, 100),
scale(5),
area(), // 可加交互组件
])
// ✅ 特效层示例:中等 z 值,受相机影响但覆盖游戏对象
const effects = add([ z(50) ])
effects.add([
text("BOOM!", { size: 32 }),
pos(150, 150),
lifespan(1.5),
])⚠️ 注意事项与最佳实践
-
z()值决定全局渲染顺序:数值越大越靠前;建议为不同逻辑层级预留区间(如ui: 90–110、effects: 40–60、game: 0–20),避免冲突; -
fixed()仅影响位置/缩放/旋转,不影响z:它让对象脱离相机变换,但z仍参与全局排序; -
不要混用旧写法:
layer("ui")组件在 v3000 中已完全不存在,调用会抛出ReferenceError; -
性能更优:父子结构天然支持批量更新与销毁(如
ui.destroy()一键清除所有 UI 元素); - 若需动态切换“图层归属”,可使用
reparent()方法迁移对象(例如将某个敌人临时加入特效层):
const enemy = add([ sprite("slime"), pos(300, 200) ])
const effectLayer = add([ z(55) ])
// 动态加入特效层
enemy.reparent(effectLayer)总之,v3000 的设计回归了更通用的场景图(scene graph)模型,用组合代替配置,既简化了 API,又提升了表达力与可控性。掌握 z() 与父子结构,你将能构建比旧版 layer 更精细、更易维护的渲染层级体系。

















