Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time


ponytiled is a simple Tiled Map Loader for Corona SDK

Screenshot of ponytiled in action

In about 675 lines of code, ponytiled loads a sub-set of Tiled layers, tilesets and image collections. Built in plugin hooks and extensions make it easy to add support for many custom object types.

  • Loads .LUA + .JSON exports from
  • Adds basic properties from tiled including physics
  • Supports object layers and tile layers
  • Supports collections of images and tileset images
  • Supports object x/y flipping and re-centering of anchorX/anchorY for Corona
  • Particle plugin
  • Rectangle shape with fillColor and strokeColor support
  • Polygon import with physics support for edge chains
  • Support for tilesheet based external tilesets (TSX files)
  • Basic support for collection of images external tilesets (TSX files)
  • Basic UI plugins for dragables, buttons and labels
  • Particle plugin support for JSON particles
  • Basic animated tiles

Quick Start Guide

tiled = require "com.ponywolf.ponytiled"
map = data, dir )


Data is a lua table that contains an export of the tiled map in either .lua or .json format. The easiest way to populate that table is to export a map from Tiled in .lua format and require it in your code.

Lua export via Tiled

local mapData = require "sandbox" -- load from lua export
local map =


Most of the time you will store you maps and images/tilesets in a directory. The dir parameter overides where ponytiled looks for images.

local mapData = require "maps.objects.sandbox" -- load from lua export
local map =, "maps/objects") -- look for images in /maps/objects/


ponytiled returns a map display object that contains all the layers, objects and tiles for the exported map. (0,0) is the designed upper left hand corner of the map. Objects may be above or to the left of the origin or beyond the designed width and height.

map display objects have all the same properties of a normal display group.

map.xScale = 2
map.alpha = 0.5

map.designedWidth and map.designedHeight are the width and height of you map as specified in tiled's new map options. map objects also have functions to make it easy to find image objects to manipulate them with code.


This funtion will return the first display object with the name specified. Great for getting to the display object of a unique item in the map.

Setting a hero name

myHero = map:findObject("hero")


To find multiple objects, use map:listTypes(). This will return a table of display objects matching the type specified. Setting a "coin" type

myCoins = map:listTypes( "coin" )
print("Number of coins in map", #myCoins)


To find a layer (which itself is a nested display group), use map:findLayer().

myLayer = map:findLayer( "hud" )
myLayer.alpha = 0.5



The extend() function attaches a lua code module to a image object. You can use this to build custom classes in your game.

There are code examples of this in the "com/ponywolf/plugins" folder.

Custom Properties

The most exciting part of working in Tiled & Corona is the idea of custom properites. You can select any image object on any object layer in tiled and add any number of custom properties. ponytiled will apply those properties to the image object as it loads. This allows you to put physics properties, custom draw modes, user data, etc. on an in-game item via the editor.

Setting a bodyType object


One special custom property is bodyType. This triggers ponytiled to add a physics body to an object and pass the rest of the custom properties as physics options. Rectangle bodies are currently supported by default, adding a radius property will give you a round body.


  • Only the most basic support for TSX files (also known as external tilesets)
  • Ellipse types are rendered as circles
  • Only supports XML or CSV layer data types (see below)

Setting up a CSV layer type


PonyTiled a simple Tiled Map Loader for Corona SDK




No releases published


No packages published


You can’t perform that action at this time.