{"id":14961775,"url":"https://github.com/kiamo2/yati","last_synced_at":"2026-03-08T12:02:15.038Z","repository":{"id":135468948,"uuid":"610374166","full_name":"Kiamo2/YATI","owner":"Kiamo2","description":"Addon to import Tiled maps into Godot 4","archived":false,"fork":false,"pushed_at":"2025-03-30T10:56:17.000Z","size":277,"stargazers_count":191,"open_issues_count":0,"forks_count":23,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-04T08:06:37.782Z","etag":null,"topics":["csharp-script","gdscript","godot","godot-engine","godot4","importer","tiled","tilemap"],"latest_commit_sha":null,"homepage":"","language":"GDScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kiamo2.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["https://www.buymeacoffee.com/kiamo2"]}},"created_at":"2023-03-06T16:38:13.000Z","updated_at":"2025-04-03T10:32:04.000Z","dependencies_parsed_at":"2024-08-19T17:07:21.615Z","dependency_job_id":"720fef5d-6c4f-4e25-aa9f-4a5e3326787d","html_url":"https://github.com/Kiamo2/YATI","commit_stats":{"total_commits":66,"total_committers":9,"mean_commits":7.333333333333333,"dds":"0.31818181818181823","last_synced_commit":"34b8a5e2d5c730792cc389e245a185b905cc44c3"},"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kiamo2%2FYATI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kiamo2%2FYATI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kiamo2%2FYATI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kiamo2%2FYATI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kiamo2","download_url":"https://codeload.github.com/Kiamo2/YATI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247142063,"owners_count":20890652,"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":["csharp-script","gdscript","godot","godot-engine","godot4","importer","tiled","tilemap"],"created_at":"2024-09-24T13:27:31.921Z","updated_at":"2026-03-08T12:02:14.983Z","avatar_url":"https://github.com/Kiamo2.png","language":"GDScript","readme":"# YATI (Yet Another Tiled Importer) for Godot 4\n\nThis is an addon for the [Godot Engine](https://godotengine.org) for importing files (.tmx, .tmj)\ncreated by the [Tiled Map Editor](http://www.mapeditor.org).\n\n**Please note: This addon is for Godot 4 only and won't work with Godot 3.x**\n\nTested on Windows 10 with Godot 4.3/4.2.2 and Tiled 1.11.0 (Tiled maps from older Tiled versions may work too)\n\nLatest version: 2.0.2 (needs Godot 4.3.0 or higher)  \nDownloads: [GDScript version](../../releases/download/v2.0.2/v2.0.2-gdscript.zip) / [CSharp version](../../releases/download/v2.0.2/v2.0.2-csharp.zip)\n\nLatest version for Godot 4.2.x: 1.6.9  \nVersion 1.6.9 downloads: [GDScript version](../../releases/download/v1.6.9/v1.6.9-gdscript.zip) / [CSharp version](../../releases/download/v1.6.9/v1.6.9-csharp.zip)\n\n**New since v1.5.2:** Runtime packages are now additionally available.  \nFor installation and usage please refer to the [runtime document](Runtime.md)\n\n## Installation\n\nThe addon is available in GDScript as well as in C# for the Mono version of Godot 4.\n\n- Download either the [GDScript version](../../releases/download/v2.0.2/v2.0.2-gdscript.zip) or the [CSharp version](../../releases/download/v2.0.2/v2.0.2-csharp.zip)\n- Move the unzipped addon folder with its entire content to your Godot project folder\n- After starting your project in Godot the plugin should appear at Project\u003e\u003eProject Settings...\u003e\u003ePlugins\n\n\u003e**C# version:** Run your project once for building the plugin, otherwise enabling will fail  \n'Run your project' means 'Press the Play button'. For this to work a main scene must have been configured.`\n\n- Enable the plugin by ticking the enable checkbox\n\n## Usage\n\n- Place your Tiled map(s) with all its parts (.PNGs/.tsx/.tsj/.tx/.tj/...) somewhere inside your Godot project.    \n  If you do this by copying a full Tiled project from elsewhere please ensure that its folder structure is preserved.  \n  (Otherwise, the references stored in the maps and tilesets may be incorrect and errors will occur)\n- Please check: Tiled editor should seamlessly work with all maps *inside* your project i.e. all its references must be ok\n\n\u003e Strictly speaking, only the tiled map files (.tmx/.tmj) and the map resources (.PNGs) *need* to be inside your Godot project so that they can be recognised and imported by Godot.\nTilesets - if they are not embedded anyway - *can* be outside the Godot project as long as they are correctly referenced in the map file(s).\nThe same goes for template files (.tx/.tj) and Tiled project files.  \nHowever, I doubt this to be very useful, as the PNG files referenced by the tileset must also be inside the project.  \nThus we'd end up with internal references pointing outwards and external references pointing inwards.\n\n- Once these requirements are all met, (re-)starting the project lets the import run automatically\n- **Important recommendation:** Untick \"Use multiple threads\" in Project Settings (Advanced) Editor\u003e\u003eImport  \nOtherwise - if you have more than one Tiled map - Godot may freeze (+crash) during import.\n\n## Features\n\n(Hopefully) nearly all Tiled features are supported:\n- all kinds of layers\n- all kinds of objects\n- all map orientations \n- visibility, opacity, tint, offsets, probability\n- parallaxes\n- tile collisions\n- tile animations\n- templates\n- custom properties  \n...\n\nBy assigning values to the class attributes and by setting custom properties the resulting scene can be largely customized.\n\nFor details please refer to the [reference document](Reference.md)\n\n## Limitations \u0026 Particularities\n\n1. Ellipses are not available in Godot. Where appropriate a capsule is used instead. (Where not appropriate it's skipped)\n2. Tileset animation in Godot requires involved tiles being equidistant and either horizontally or vertically arranged.\u003cp\u003e\nIn Tiled you can randomly choose every frame tile, such animations won't map and are skipped.\n3. Godot 4 seems to make a left-down render - at least the 'perspective walls' example from the Tiled github site suggests this.  \nI've not yet found anything to change this.\n4. The C# version does not support zstd compression.\n5. I'm currently using Windows 10 therefore I can only ensure the functionality for this OS.\n\n## Known issues\n\n1. Godot may freeze during import, see my recommendation concerning \"Use Multiple Threads\" in the Usage section.  \nMaybe this is only a problem on Windows though...\n\n## Support\n\nSupport is active i.e. if issues should arise I'll do my best to resolve them.\u003cbr\u003e\nIf you would like to sponsor the project I'd be thrilled if you [buy me a coffee](https://www.buymeacoffee.com/kiamo2).\n\n## License\n[MIT License](LICENSE). Copyright (c) 2023 Roland Helmerichs.\n","funding_links":["https://www.buymeacoffee.com/kiamo2"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiamo2%2Fyati","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkiamo2%2Fyati","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiamo2%2Fyati/lists"}