Tiled importer
A Godot Engine plugin to import tilemaps and tilesets created in the Tiled Map Editor.
What is Tiled importer?
Tiled Map Importer is a plugin for the Godot game engine that allows developers to import tilemaps and tilesets created in the Tiled Map Editor directly into their Godot projects. It solves the problem of manually recreating complex tile-based levels by providing an automated, feature-rich import process that preserves layer structures, custom properties, collision shapes, and animations.
Godot developers creating 2D games who use Tiled Map Editor for level design and want a streamlined workflow for importing those levels into their game engine.
Developers choose this plugin because it offers deep integration with both Tiled and Godot, supporting numerous Tiled features like custom properties, object layers, tile animations, and various map types, while providing customization options through post-import scripts and import presets.
Overview
Plugin for Godot Engine to import Tiled Map Editor tilemaps and tilesets
Use Cases
Best For
- Importing complex Tiled maps with multiple layers into Godot projects
- Converting Tiled object layers into Godot physics bodies and sprites
- Preserving custom properties and metadata from Tiled in Godot
- Working with isometric, hexagonal, or staggered map layouts in Godot
- Automatically generating collision and navigation shapes from Tiled objects
- Using Tiled's tile animations within Godot's TileMap system
Not Ideal For
- Projects using Godot 2.x, as the plugin is only compatible with Godot 3.0 or later
- Games requiring precise ellipse collision shapes, since ellipses are imprecisely converted to capsules or circles
- Teams that frequently update embedded images or external tilesets without changing the main map file, due to limited reimport triggers
- Projects with many non-Tiled JSON files, as the plugin can interfere and cause import errors unless disabled
Pros & Cons
Pros
Imports both XML and JSON formats for maps and tilesets, including compressed layers, making it versatile for different Tiled workflows.
Supports orthogonal, isometric, staggered, and hexagonal maps, preserving Tiled's complex layouts seamlessly in Godot.
Generates collision, occluder, and navigation shapes automatically from Tiled objects, reducing manual setup time.
Imports custom properties from Tiled as metadata in Godot nodes, enabling data-driven game logic and integration.
Allows custom modifications via a post-import script, giving developers control over the imported scene for tailored workflows.
Cons
Changes to embedded images or external tilesets don't automatically trigger map reimports, requiring manual intervention or workarounds.
Ellipse shapes from Tiled are converted to capsules or circles in Godot, which can lead to inaccurate collision detection for non-circular ellipses.
The plugin attempts to import all JSON files in the project, causing errors for non-Tiled JSON files unless disabled or isolated with .gdignore.
Objects in object layers cannot be set as navigation in Godot, restricting pathfinding setup for dynamic objects without additional scripting.
Frequently Asked Questions
Related Projects
WaterwaysA tool to generate river meshes with flow and foam maps based on bezier curves.
Open Source A-RPG DemoA-RPG demo made with Godot, MIT-licensed, from our Godot course
Godot NExtGodot Node Extensions - Basic Node Extensions for Godot Engine
Realistic Water ShaderGodot - Realistic Water Shader
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.