This is an addon for the Godot Engine for importing files (.tmx, .tmj) created by the Tiled Map Editor.
Please note: This addon is for Godot 4 only and won't work with Godot 3.x
Tested on Windows 10 with Godot 4.3/4.2.2 and Tiled 1.11.0 (Tiled maps from older Tiled versions may work too)
Latest version: 2.0.0 (needs Godot 4.3.0 or higher)
Downloads: GDScript version / CSharp version
Latest version for Godot 4.2.x: 1.6.8
Version 1.6.8 downloads: GDScript version / CSharp version
New since v1.5.2: Runtime packages are now additionally available.
For installation and usage please refer to the runtime document
The addon is available in GDScript as well as in C# for the Mono version of Godot 4.
C# version: Run your project once for building the plugin, otherwise enabling will fail
'Run your project' means 'Press the Play button'. For this to work a main scene must have been configured.`
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. Tilesets - if they are not embedded anyway - can be outside the Godot project as long as they are correctly referenced in the map file(s). The same goes for template files (.tx/.tj) and Tiled project files.
However, I doubt this to be very useful, as the PNG files referenced by the tileset must also be inside the project.
Thus we'd end up with internal references pointing outwards and external references pointing inwards.
(Hopefully) nearly all Tiled features are supported:
By assigning values to the class attributes and by setting custom properties the resulting scene can be largely customized.
For details please refer to the reference document
In Tiled you can randomly choose every frame tile, such animations won't map and are skipped.
Support is active i.e. if issues should arise I'll do my best to resolve them.
If you would like to sponsor the project I'd be thrilled if you buy me a coffee.
MIT License. Copyright (c) 2023 Roland Helmerichs.