# @excaliburjs/plugin-tiled 中文文档

规范地址：https://npmcn.com/package/%40excaliburjs/plugin-tiled/

版本：1\.0\.0
npm 元数据更新时间：2026-11-08T06:53:48.217Z
中文译文更新时间：2026-11-14T03:08:55.286Z
软件包许可：BSD-2-Clause

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40excaliburjs/plugin-tiled
原文对照：https://npmcn.com/package/%40excaliburjs/plugin-tiled/?lang=original
项目主页：https://github.com/excaliburjs/excalibur-tiled
源码仓库：https://github.com/excaliburjs/excalibur-tiled

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3 MB，37 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：excalibur ^1\.0\.0
- 首次发布：2021-08-27T14:11:53.554Z
- 最新版本发布：2026-11-08T06:53:47.934Z
- 近 30 天下载量：11361（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 2 个）

## 中文简介

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

## 安装

```sh
npm install @excaliburjs/plugin-tiled
```

也可以使用：`pnpm add @excaliburjs/plugin-tiled`、`yarn add @excaliburjs/plugin-tiled`、`bun add @excaliburjs/plugin-tiled`

## README

# Excalibur.js 的平铺插件

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

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

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

![](https://npmcn.com/package/%40excaliburjs/plugin-tiled/readme/example.gif)

## 安装

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

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

```typescript
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 页面存档备份,存于互联网档案馆](https://excaliburjs.com/docs/tiled-plugin)

## 捐款

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

要启动开发服务器 :

```
npm start
```

观看:

```
npm run watch
```

只编译 :

```
npm run build
```

进行测试:

```
npx playwright install
npm test
```

更新快照

-   窗口
    
    ```powershell
    npx playwright test --update-snapshots
    ```
    
-   用于 CI 的 Linux
    
    ```powershell
    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 是什么？

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 和提交记录判断。