{"id":13574424,"url":"https://github.com/notnullgames/tiled-kaboom","last_synced_at":"2026-01-24T16:53:57.140Z","repository":{"id":65472987,"uuid":"389469765","full_name":"notnullgames/tiled-kaboom","owner":"notnullgames","description":"Load maps made in Tiled into Kaboom!","archived":false,"fork":false,"pushed_at":"2021-10-15T03:11:46.000Z","size":2236,"stargazers_count":20,"open_issues_count":5,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-26T11:36:58.436Z","etag":null,"topics":["kaboom","kaboom-js","tiled","tiled-map-editor","tilemap"],"latest_commit_sha":null,"homepage":"https://notnullgames.github.io/tiled-kaboom/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/notnullgames.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-26T00:44:05.000Z","updated_at":"2025-04-06T05:43:55.000Z","dependencies_parsed_at":"2023-01-25T02:55:13.889Z","dependency_job_id":null,"html_url":"https://github.com/notnullgames/tiled-kaboom","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/notnullgames/tiled-kaboom","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notnullgames%2Ftiled-kaboom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notnullgames%2Ftiled-kaboom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notnullgames%2Ftiled-kaboom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notnullgames%2Ftiled-kaboom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/notnullgames","download_url":"https://codeload.github.com/notnullgames/tiled-kaboom/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notnullgames%2Ftiled-kaboom/sbom","scorecard":{"id":695161,"data":{"date":"2025-08-11","repo":{"name":"github.com/notnullgames/tiled-kaboom","commit":"cf07f3b291a2a3087c7b63e9f6d188432323bb91"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.6,"checks":[{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}}]},"last_synced_at":"2025-08-22T03:28:24.556Z","repository_id":65472987,"created_at":"2025-08-22T03:28:24.556Z","updated_at":"2025-08-22T03:28:24.556Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28732209,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T10:24:43.181Z","status":"ssl_error","status_checked_at":"2026-01-24T10:24:36.112Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["kaboom","kaboom-js","tiled","tiled-map-editor","tilemap"],"created_at":"2024-08-01T15:00:51.487Z","updated_at":"2026-01-24T16:53:57.116Z","avatar_url":"https://github.com/notnullgames.png","language":"HTML","funding_links":[],"categories":["Plugins 🧩"],"sub_categories":[],"readme":"# tiled-kaboom\n\nThis is a map-loader for [kaboom](https://kaboomjs.com/) to load [tiled](https://www.mapeditor.org/) JSON maps.\n\n![screenshot](screenshot.png)\n\n\nHere is an [example of it running](https://notnullgames.github.io/tiled-kaboom/). Here is [the source](https://github.com/konsumer/tiled-kaboom/blob/main/index.html). This demo uses the latest ES6 module \u0026 JSON-import support in up-to-date browsers, and will not work in old browsers, but you can still use the methods below to support them, too.\n\n---\n\n\n## features\n\n- easy \u0026 fun to work with\n- think of it as an \"advanced map\" if you outgrow the awesome built-in kaboom maps\n- easier to make more complex maps\n- generates regular kaboom text-maps\n- handles layers in csv, base64, and 3 kinds of compression\n- many ways to import the plugin, depending on how your app is setup\n- use tiled map directly, so you don't need to generate a seperate map file for your game\n\n\n## usage\n\nIn your map-files, make sure the encoding is csv/base64/gzip/zlib (not Zstandard or Xml.) Embed your tilemaps.\n\n\nThe basic usage with Kaboom goes like this:\n\n```js\nconst k = kaboom({\n  plugins: [ tiledKaboom ]\n})\n\n// then later\n\nconst { sprites, levels, key } = await k.loadTiledMap(YOUR_MAP_OBJECT, ASSET_LOCATION)\nfor (let level of levels) {\n  k.addLevel(level, { width: 32, height: 32, ...key })\n}\n```\n\n`ASSET_LOCATION` is optional.\n\nThere are a few different ways to get `tiledKaboom` depending on how you are doing things.\n\n\n### regular tag\n\nIf you are not using `type=\"module\"` in your `\u003cscript\u003e` tags, and aren't using a bundler, you can do this:\n\n```html\n\u003cscript src=\"https://unpkg.com/tiled-kaboom\"\u003e\u003c/script\u003e\n```\n\nFor compressed maps, you also need pako:\n\n```html\n\u003cscript src=\"https://unpkg.com/pako@2.0.3/dist/pako.min.js\"\u003e\u003c/script\u003e\n```\n\n\nThis will add `tiledKaboom` to your global-scope, so it can be used with `kaboom`.\n\n\n### npm-based project\n\nIf you are using an npm-based project (like with a bundler of some kind) you can do this:\n\n```sh\nnpm i tiled-kaboom\n```\n\nAnd then use it:\n\n\n```js\nimport tiledKaboom from 'tiled-kaboom'\n```\n\nor \n\n```js\nconst tiledKaboom = require('tiled-kaboom')\n```\n\n### browser es6 module\n\nI personally like to use the new ES6 module support in modern browsers. You can do this a couple ways:\n\n```html\n\u003cscript type=\"module\"\u003e\nimport tiledKaboom from 'https://unpkg.com/tiled-kaboom@latest/dist/tiled-kaboom.modern.js'\n\u003c/script\u003e\n```\n\nYou can also use an import-map, if you want it to look neater in your actual code:\n\n```html\n\u003c!-- first tell your browser where to find tiled-kaboom --\u003e\n\u003cscript type=\"importmap\"\u003e\n{\n  \"imports\": {\n    \"pako\": \"https://unpkg.com/pako@2.0.3/dist/pako.esm.mjs\",\n    \"tiled-kaboom\": \"https://unpkg.com/tiled-kaboom@latest/dist/tiled-kaboom.modern.js\"\n  }\n}\n\u003c/script\u003e\n\n\u003c!-- now your imports will look like they do in node --\u003e\n\u003cscript type=\"module\"\u003e\nimport tiledKaboom from 'tiled-kaboom'\n\u003c/script\u003e\n```\n\nThis method is the way to go, if you are using compressed maps and browser ES6 module support.\n\n\n## credits\n\n- The terrain tiles in demo came from [here](https://opengameart.org/content/tiled-terrains) and uses a terrain-set to make it really fast \u0026 easy to make cool maps in tiled.\n- The waterfall in demo came from [here](https://opengameart.org/content/lpc-animated-water-and-waterfalls)\n- Obviously thanks to [kaboom](https://kaboomjs.com/) and [tiled](https://www.mapeditor.org/), 2 great tools for making games\n\n\n\n## TODO\n\nThere is still a lot to be done. Check out our [planned list of enhancements](https://github.com/notnullgames/tiled-kaboom/labels/enhancement)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnotnullgames%2Ftiled-kaboom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnotnullgames%2Ftiled-kaboom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnotnullgames%2Ftiled-kaboom/lists"}