@debuffjp/tilemap

中文文档
0.33.0发布于 2026/11/11MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 8894

减压用提力:分批渲染、瓦片相撞、平板和 LDtk 导入

中文使用文档
文档目录3 节
  1. 绘制地图
  2. 碰撞
  3. API 密码

@ debuffjp/图示

卸载时的提力:已切开,分批渲染 draw,瓦片相撞,以及 铺设 财务报告和审定财务报表 LDtk 数字。 。 。 .

import { fromTiled } from "@debuffjp/tilemap";

const map = fromTiled(assets.json("level1"), { image: (path) => assets.image("tiles") });
const player = { x: 32, y: 32, w: 12, h: 14 };

// update(dt)
const hit = map.move(player, vx * dt, vy * dt);
if (hit.onGround) vy = 0;

// render(draw)
draw.withCamera(game.camera, () => map.draw(draw, { camera: game.camera }));

绘制地图

  • 铺设 (单位:千美元).tmj: fromTiled(json, { image, tilesets? }). Orthogonal mapers, CSV 或 无压缩 Base64, 无限地图, 层组(offets, 不透明, parallax), 翻转和旋转旗, 外部平板, 对象层.
  • LDtk 数字 (单位:千美元).ldtk: fromLdtk(project, { level?, image, intGrid? }). 平面, AutoLayer(被打碎的平面变为多层), IntGrid相撞, 实体和平面字段.
  • 在代码中数字 : new Tilemap({ width, height, tileWidth, tileHeight, tilesets, layers }),则 map.set(layer, col, row, id)用于程序层面.

碰撞

来源成为
平地平地财产 solid 编号 : collides固态
平地平地财产 oneWay单向( 从上而来)
平铺层属性 collision: true层中的每一块瓷砖都是坚固的
LDttk 内嵌值固态; 数值命名 oneWay, (中文(简体) ), one_way 或者说 platform 单向; 以 intGrid
代码map.setCollision(col, row, Collision.Solid)

map.move(body, dx, dy, { dropThrough? }) 移动 { x, y, w, h } 框中,解析 X 然后解析 Y。 它能快速地走入瓦片大小的台阶 所以没有隧道,然后返回 onGround, (中文(简体) ), hitCeiling, (中文(简体) ), hitLeft, (中文(简体) ), hitRight。 。 。 . map.edges 绘图边框为固态的控件(默认:侧为固态,上下打开).

API 密码

  • map.draw(draw, { camera?, layers? }): 仅绘制视图中的平面, 应用平面, 不分配每平面
  • map.get / set / tileAt, (中文(简体) ), map.tileProperties(id), (中文(简体) ), map.objects(layer), (中文(简体) ), map.properties
  • map.collisionAt(col, row), (中文(简体) ), map.collideFrom(layers, { everyTile? }), (中文(简体) ), overlapsSolid(map, body)
  • 资产管道装载量 .tmj, (中文(简体) ), .tsj 财务报告和审定财务报表 .ldtk 作为 JSON 的文件

版本与发布记录

@debuffjp/tilemap 共发布 56 个版本,首次发布于 2026/10/16;过去 12 个月发布了 56 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.33.0latest2026/11/11今天
0.32.02026/11/074 天前
0.31.12026/11/065 天前
0.31.02026/11/065 天前
0.30.02026/11/056 天前
0.29.22026/11/056 天前

关于 @debuffjp/tilemap 的常见问题

@debuffjp/tilemap 是什么?

减压用提力:分批渲染、瓦片相撞、平板和 LDtk 导入

如何安装 @debuffjp/tilemap?

在项目目录运行 npm install @debuffjp/tilemap,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@debuffjp/core(0.33.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@debuffjp/tilemap 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@debuffjp/tilemap 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@debuffjp/tilemap 可以商用吗?

@debuffjp/tilemap 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@debuffjp/tilemap 的下载量有多少?

根据 npm 官方下载统计,@debuffjp/tilemap 在 2026/10/12 – 2026/11/10 这 30 天内被下载 8,894 次,日均约 296 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@debuffjp/tilemap 还在维护吗?

最新版本 0.33.0 发布于 2026/11/11(今天);至今共发布 56 个版本,其中过去 12 个月发布了 56 个;首次发布于 2026/10/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。