@excaliburjs/plugin-tiled

中文文档
1.0.0发布于 2026/11/08BSD-2-ClauseTypeScriptESM + CJS构建来源已验证近 30 天下载 1.1万

excalibur-tired 提供了平面图编辑器与 Excalibur.js 的集成

中文使用文档
文档目录3 节
  1. 安装
  2. 文档
  3. 捐款

Excalibur.js 的平铺插件

平分是建立整个行业的游戏水平的超实用工具. Excalibur 的平面插件为 Orthogonal (标准) 和 Isometric 映射提供了支持 !

当前平面插件旨在支持 解析所有数据 在地图(.tmx/.tmj),Tileset(.tsx,.tsj.)和模板文件(.tx,tj.)中。 但是,插件不支持渲染出所有映射类型,目前六边形和同位素交错不支持.

该插件正式支持已发布的最新版本的 Tiled, 并且会警告您是否使用更旧的版本 。 这是因为随着时间推移,平面图格式出现了许多难以调和的断裂变化.

安装

npm install --save-exact @excaliburjs/plugin-tiled

创建资源, 加载, 然后添加到您的场景中 !

const game = new ex.Engine({...});

const tiledMap = new TiledResource('./path/to/map.tmx');

const loader = new ex.Loader([tiledMap]);

game.start(loader).then(() => {
    tiledMap.addToScene(game.currentScene);
});

文档

如何使用插件访问的相关信息 https://excaliburjs.com/docs/tiled-plugin 页面存档备份,存于互联网档案馆

捐款

  • 由网络包建 5
  • 使用 Webpack- dev- server 服务器

要启动开发服务器 :

npm start

观看:

npm run watch

只编译 :

npm run build

进行测试:

npx playwright install
npm test

更新快照

  • 窗口

    npx playwright test --update-snapshots
    
  • 用于 CI 的 Linux

    docker run --rm --network host -v ${PWD}:/work/ -w /work/ -it mcr.microsoft.com/playwright:v1.49.1-jammy /bin/bash
    npm install
    npx playwright test --update-snapshots
    

版本与发布记录

@excaliburjs/plugin-tiled 共发布 22 个版本,首次发布于 2021/08/27;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.0.0latest2026/11/085 天前
0.32.02025/12/2410 个月前
0.31.02025/09/281.1 年前
0.30.22025/01/181.8 年前
0.30.12024/12/261.9 年前
0.30.02024/12/131.9 年前

其他发布通道:next → 0.29.0-alpha.1。

关于 @excaliburjs/plugin-tiled 的常见问题

@excaliburjs/plugin-tiled 是什么?

excalibur-tired 提供了平面图编辑器与 Excalibur.js 的集成

如何安装 @excaliburjs/plugin-tiled?

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

@excaliburjs/plugin-tiled 支持 TypeScript 吗?

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

@excaliburjs/plugin-tiled 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@excaliburjs/plugin-tiled 可以商用吗?

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

@excaliburjs/plugin-tiled 的下载量有多少?

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

@excaliburjs/plugin-tiled 还在维护吗?

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