October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk3 min

How to Export One 2D Map to Phaser, Godot, Unity, GameMaker, and Tiled

Tiled can serve as a shared map-authoring hub, but moving one map across engines takes format choices and feature-by-feature validation—not a guaranteed one-click export.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

You can use Tiled as a map-authoring hub, but there is no documented one-click export that guarantees the same map will work unchanged in Phaser, Godot, Unity, and GameMaker. Tiled’s generic JSON is the best-supported general interchange option here, Phaser documents Tiled JSON input, and Tiled provides a separate GameMaker export. For Godot and Unity, choose an importer or conversion workflow that matches your engine version and validate the features your map uses.

What one map can—and cannot—mean across engines

Tiled can author a map and export it in several formats, but each game engine interprets map data through its own importer or runtime code. An export file is therefore not a promise that every layer, object, property, animation, tileset reference, or collision will behave identically in every destination. Treat this as a shared source-map workflow, then validate the result in each engine.

As an Amazon Associate I earn from qualifying purchases.

Tiled documents generic JSON, Lua, and CSV output, plus a GameMaker-specific export option. Its generic JSON format is described as supporting all Tiled features and as an alternative to TMX; JSON is particularly convenient for browser and JavaScript projects. Tiled generic export formats and Tiled export formats explain the available options.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose an export route

Route What the documentation establishes Best fit and caution
Tiled JSON Tiled describes JSON as supporting all Tiled features. Phaser documents Tiled JSON input and parsing of map layers and tilesets. Tiled JSON documentation; Phaser Tilemap workflow Strong general choice when Phaser or a JavaScript workflow is involved. The receiving engine still needs a compatible importer.
Tiled CSV CSV export represents tile layers only. Multiple tile layers export as separate files; numeric IDs can be ambiguous with multiple tilesets unless custom tile names are used. Tiled generic export formats Use when a simple tile-grid representation is sufficient. Do not expect it to carry object layers or the full map feature set.
Tiled GameMaker export Tiled documents a GameMaker-specific route that produces room files and includes a workflow involving room.yy. Tiled GameMaker export Use the instructions that match the GameMaker version installed; the documented steps are version-sensitive.
Godot or Unity importer/converter A current official import procedure is not established here for either engine. Select a version-compatible importer or conversion workflow, then confirm its supported map features before adopting it.

Set up the source map and export

  1. Keep the source organized. Save the map in Tiled and keep its tileset images and related map files together. This makes references easier to track when you import or convert the map elsewhere.
  2. Choose a route for the destination. For Phaser, the documented Phaser Editor workflow uses a Tiled JSON map with imported tileset images. For a tile-grid-only pipeline, CSV may be adequate, subject to its layer and tileset limits. For GameMaker, follow Tiled’s dedicated GameMaker instructions for your installed version.
  3. Import or convert using a matching tool. For Godot and Unity, identify an importer or converter intended for your engine release. Check its documentation for the Tiled features and file references it supports rather than assuming a generic format is accepted directly.
  4. Validate in the destination project. Compare the imported result with the Tiled source, checking the map features that matter to your game.

Check Phaser’s tileset handling

Phaser’s tilemap documentation covers loading Tiled JSON and parsing its layers and tilesets. However, the Phaser API documentation for ParseTilesets says external tilesets represented by a source property are unsupported by that function and produce a warning. If your map references external tilesets, confirm that your specific Phaser loading path handles them; do not assume this parser will resolve them. See the Phaser tilemaps API.

#1 Best Overall
Sale
Game Programming Patterns
  • Brand New in box. The product ships with all relevant accessories
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

What to verify after import

Do a feature-by-feature comparison in every engine you intend to ship with. Prioritize the parts of the map your game actually uses:

  • Tile placement and empty cells: Check that grid positions, gaps, and blank areas remain as intended.
  • Flips and layer order: Look for mirrored or rotated tiles and confirm foreground, background, and overlapping layers render in the right order.
  • Collisions and object layers: Verify collision shapes, object positions, and any gameplay objects are available to the engine code that needs them.
  • Properties and animations: Confirm custom metadata and animated tiles are preserved or deliberately recreated in the destination.
  • Tileset references: Check image paths, embedded versus external tilesets, and tile IDs. This is especially important for Phaser external tileset references and for CSV maps using multiple tilesets.

These are validation targets, not a claim that all five tools transfer every feature identically. The relevant editor and engine documentation is version-sensitive: the cited Tiled pages identify Tiled 1.12.2 documentation, while the Phaser Editor workflow is for Phaser Editor v5. Confirm behavior against the releases you use.

Quick Recap

SaleBestseller No. 1
Game Programming Patterns
Game Programming Patterns
Brand New in box. The product ships with all relevant accessories
$24.95
SaleBestseller No. 2
Designing Games: A Guide to Engineering Experiences
Designing Games: A Guide to Engineering Experiences
Used Book in Good Condition
$34.99
Rank #2

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.