Fox Studios logo Fox StudiosGame projects, devlogs and Scratch builds
Tools

Tiled Map Editor Guide for Building 2D Levels Faster

Our last platformer had 14 levels, and the first three took me longer to build than the other eleven combined. The difference was not skill.

Tiled map editor window showing a 2D platformer level with tile and object layers

Our last platformer had 14 levels, and the first three took me longer to build than the other eleven combined. The difference was not skill. Halfway through, I stopped placing tiles one by one inside the engine and moved the layout work to the Tiled map editor, a free program that does one job and does it very well.

If you are building a 2D game with a grid, whether it is a top down adventure, a puzzle game or a side scroller, Tiled can save you hours per level. This guide covers how I set it up, the features that matter for a small project, how it connects to different engines, and the mistakes I made so you can skip them.

What the Tiled Map Editor Actually Does

Tiled is a free, open source level editor for maps built from tiles. You load a tileset image, which is a single picture split into squares, and then paint those squares onto a grid. It runs on Windows, macOS and Linux, and it saves maps as TMX or JSON files that many engines and frameworks can read.

It supports orthogonal grids, which is the standard square layout, plus isometric and hexagonal maps. For most first projects, orthogonal is all you need.

The important point is that Tiled is not a game engine. It does not run your game, handle physics or play sounds. It only builds the map. That narrow focus is exactly why it is fast.

Setting Up Your First Map in Ten Minutes

The setup screen asks a few questions that are hard to change later, so answer them carefully.

  1. Choose your tile size. I use 16 by 16 pixels for pixel art and 32 by 32 for slightly more detailed art.
  2. Set the map size in tiles, not pixels. A 40 by 23 map at 16 pixel tiles fits a 640 by 368 view with a little room to scroll.
  3. Create a new tileset from your image and make sure the tile width and height match the map.
  4. Save the tileset as its own file so several maps can share it.

That last step matters. If each map embeds its own copy of the tileset, changing one tile means fixing every level by hand. On our platformer, a shared tileset let me recolour the ground tiles for a winter world in one evening instead of reopening all 14 maps.

Layers That Keep a Level Organised

Layers are where Tiled starts to pay for itself. A typical level of ours uses four.

LayerTypeWhat goes on it
BackgroundTile layerSky, distant hills, decoration with no collision
GroundTile layerFloors and walls the player can touch
DetailsTile layerGrass, signs and props drawn over the ground
ObjectsObject layerSpawn points, enemies, coins, doors

Keeping collision tiles on their own layer means your code only checks one layer for walls. When a tester says a ledge feels wrong, you know exactly where to look.

Custom Properties Instead of Hard Coded Values

Every tile and object in Tiled can carry custom properties. I give each enemy object a speed and a patrol distance, and each door a target level name. My code reads those values when it loads the map.

The result is that tuning a level no longer means editing scripts. If the third enemy in level five is too fast, I change one number in Tiled, save and test. This also helps if you are working with a friend who designs levels but does not write code. They can tune the difficulty curve without touching a single script, which ties nicely into the ideas in designing your first game level.

Getting Maps Into Your Engine

How you load a Tiled map depends on what you are building with. Some tools read Tiled files directly, while others need a plugin or a small importer.

  • Phaser loads Tiled JSON maps natively.
  • Godot has its own tilemap editor, but community importers can bring in Tiled maps if you prefer the Tiled workflow.
  • Unity works with Tiled through community importers such as SuperTiled2Unity.
  • LOVE users often rely on the Simple Tiled Implementation library.
  • Scratch cannot read Tiled files, but you can export a finished layout as a PNG image and use it as a backdrop or a costume.

If you have not picked an engine yet, check how each one handles tilemaps before you commit. We compare a few options in choosing a game engine for your first solo project.

Why a Huge Tileset Slows You Down

A lot of beginner guides tell you to grab the largest asset pack you can find so you never run out of tiles. I think that advice costs more than it saves. With 2,000 tiles in the palette, you spend more time hunting for the right corner piece than building the level.

For our platformer I limited myself to about 60 tiles: ground, edges, corners, a few platforms and some decoration. Levels came together faster and looked more consistent, because every map used the same small vocabulary. You can always add tiles once you know what is missing.

The same goes for advanced features. Automapping and terrain sets, which place matching edges for you, are useful, but learn them after your second or third map, not on day one. Painting by hand first teaches you how your tileset fits together.

Mistakes That Cost Me a Week

A few habits caused most of my Tiled problems, and each is easy to avoid.

  • Moving the tileset image to a new folder after making maps, which breaks the file path.
  • Mixing tile sizes on one map, which makes collision boxes misalign.
  • Forgetting to save the tileset after editing a property, so the change never reached the engine.
  • Leaving map files out of backups. Keep them in the same project folder as your code.

Tiled Map Editor FAQ

Is the Tiled map editor really free?

Yes. Tiled is open source and free to download and use, including for commercial games. The developer accepts donations, but nothing is locked behind a payment.

Do I need Tiled if my engine has its own tilemap tool?

Not always. If the built in editor feels comfortable, stay with it. Tiled is most helpful when you want to reuse maps across engines, edit levels outside the engine or tune many object properties quickly.

Can Tiled handle large maps?

It handles big maps well, and it also supports infinite maps that grow as you paint. For performance in the game itself, split very large worlds into several smaller maps.

The Takeaway

Start with a small tileset, a fixed tile size and four clear layers, and put enemy and door settings into custom properties. Build two maps by hand before trying automation. That setup turned level building from our slowest task into one of the most enjoyable parts of the project. For more free software we rely on, browse our game development tools section.

MK
Mira Kovac

Mira teaches coding to beginners and writes the step-by-step guides, always testing each one on someone who has never coded before.

More posts by Mira

More in Tools

01doorganico 084goad 3hot8 4465456 after5internprogram ahandfulofblessings ahmadpc ahomcybersecurity allodialresources annodex antiquesandperiodcollectibles aotc asianworldkashmir beedlectrics bloggertemplatefree bluefeatheragency bodyweightsolution campaign08blog carfixadvisor catstreetcollective cbstvsports cnfanspurchasing committeeof500yearsofdignityandresistance covertopsdjs cs-kaiyuangame cuestacomunicaciontotal cxoutlet dancebetgame deskgearhub destinyvillastay detectmagazine di33 diamondsteelbuildings donmo dyanadropship emarsysfinance emimattl escapechan eskitarih evautoplay everythingweddings-orlando farmzone feedviewerapp gamevui123 gleasongrade greetingsday hacklabasu haskell iw-kaiyun jagoanproperti jilidskripsi joltbusinessfinance juegodepokergratis juegospucca kaeru-festival latestmehndidesigns lestanzediottaviano litemagazines localcommunityhero lustrsazan mariashebets menswheels newwebstechs1 nikkit ootheday oxigenvpn plurfitness prefetial probudgetcarpetcleaning psychicmrsmartin pyaten qvantor rejoignezlogis rexzbot riselayouts ruchin rwxqsgd5 sakaltime shibiaowang shop-bot skrtips spotlesshaven strcoding tetapatrium topselller uneplanteartificielle vipertechcr webtech1223411 wo-kygaming yamaha-mekar yeknava yoybuysheets zenunwa yamaha-mekar jilidskripsi ankertoto ankertoto ankertoto