{"id":13912435,"url":"https://github.com/excaliburjs/excalibur-tiled","last_synced_at":"2025-12-30T09:26:20.950Z","repository":{"id":38108945,"uuid":"44888236","full_name":"excaliburjs/excalibur-tiled","owner":"excaliburjs","description":"Adds Tiled Map Editor File support to Excalibur","archived":false,"fork":false,"pushed_at":"2025-07-09T05:37:12.000Z","size":32518,"stargazers_count":53,"open_issues_count":16,"forks_count":25,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-07-09T06:37:32.974Z","etag":null,"topics":["excalibur","excaliburjs","plugin","tiled-map-editor"],"latest_commit_sha":null,"homepage":"https://excaliburjs.com/docs/tiled-plugin","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/excaliburjs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-10-24T22:56:49.000Z","updated_at":"2025-07-09T05:37:15.000Z","dependencies_parsed_at":"2023-11-08T04:16:05.967Z","dependency_job_id":"8194e7d8-04fe-430c-9639-d530be478906","html_url":"https://github.com/excaliburjs/excalibur-tiled","commit_stats":{"total_commits":537,"total_committers":12,"mean_commits":44.75,"dds":0.5121042830540037,"last_synced_commit":"f97dbcc31b29fe7762826cab41c188132de44fed"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/excaliburjs/excalibur-tiled","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/excaliburjs%2Fexcalibur-tiled","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/excaliburjs%2Fexcalibur-tiled/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/excaliburjs%2Fexcalibur-tiled/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/excaliburjs%2Fexcalibur-tiled/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/excaliburjs","download_url":"https://codeload.github.com/excaliburjs/excalibur-tiled/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/excaliburjs%2Fexcalibur-tiled/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265760330,"owners_count":23824007,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["excalibur","excaliburjs","plugin","tiled-map-editor"],"created_at":"2024-08-07T01:01:27.627Z","updated_at":"2025-12-30T09:26:20.895Z","avatar_url":"https://github.com/excaliburjs.png","language":"TypeScript","funding_links":[],"categories":["others","Plugins \u0026 Tools"],"sub_categories":["Videos"],"readme":"# Tiled Plugin for Excalibur.js\n\nTiled is a super useful tool for building game levels across the industry. The Tiled plugin for Excalibur offers support for both Orthogonal (standard) and Isometric maps!\n\nThe current Tiled plugin aims to support *parsing all data* in the Map (.tmx/.tmj), Tileset (.tsx, .tsj.) and Template files (.tx, tj). The plugin however does not support rendering all map types, currently hexagons and isometric staggered are not supported.\n\nThe plugin officially supports the latest version of Tiled that has been published and will warn if you are using an older version. This is because there have been many breaking changes to the Tiled map format over time that are difficult to reconcile.\n\n![](./readme/example.gif)\n\n## Installation\n\n```sh\nnpm install --save-exact @excaliburjs/plugin-tiled\n```\n\nCreate your resource, load it, then add it to your scene!\n\n```typescript\nconst game = new ex.Engine({...});\n\nconst tiledMap = new TiledResource('./path/to/map.tmx');\n\nconst loader = new ex.Loader([tiledMap]);\n\ngame.start(loader).then(() =\u003e {\n    tiledMap.addToScene(game.currentScene);\n});\n\n```\n\n## Documentation\n\nFor information on how to use the plugin visit https://excaliburjs.com/docs/tiled-plugin\n\n## Contributing\n\n- Built with webpack 5\n- Uses webpack-dev-server\n\nTo start development server:\n\n    npm start\n\nTo watch:\n\n    npm run watch\n\nTo compile only:\n\n    npm run build\n\nTo run tests:\n\n    npx playwright install\n    npm test\n\nTo update snapshots\n\n* Windows\n\n   ```powershell\n   npx playwright test --update-snapshots\n   ```\n\n* Linux for CI\n\n   ```powershell\n   docker run --rm --network host -v ${PWD}:/work/ -w /work/ -it mcr.microsoft.com/playwright:v1.49.1-jammy /bin/bash\n   npm install\n   npx playwright test --update-snapshots\n   ```\n   \n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexcaliburjs%2Fexcalibur-tiled","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexcaliburjs%2Fexcalibur-tiled","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexcaliburjs%2Fexcalibur-tiled/lists"}