Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



22 Commits

Repository files navigation


This is an official fork and python 3 port of the pygame tmx library originally made by Richard Jones.

Tmx is a powerful tmx-based tile engine for pygame that allows for simple and fast animating of tile based maps and/or sprites.

TMX maps are flexible XML files can be eaisly developed and edited using a GUI tilemap editor and used to describe a tile based map with any tile size, any amount of layers, any number of tile sets and it allows custom properties to be set on most elements. For more information on how to build games using pygame using a tilemap editor, check out this tutorial.

I've decided to fork this so that people that would like to use python 3 to develop tiled based games will have access to compatible tools. If you'd still like to use python 2.x, you can use the python 2.x branch. There is no offical doumentation for tmx yet, but you can view an example of pratical use of this library in my project, pylletTown along with a video of it working in action.

Also included is a folder of various examples of different kinds of game to show what the library is capable of. There are some more in-depth examples in the original library as well.

Installiation of the pygame and any version of python3 is required to use tmx.

Getting Started

Below is a short annoted example that contains the bare minimum amount of code to get a tmx map up and running. Feel free to copy and paste it to play around with it or use it to learn more about each method.

import pygame
import tmx

# Initialize pygame and create a 500x500 display.
screen = pygame.display.set_mode((500 , 500))

# tmx.load parses the myMap.tmx file and returns a tilemap with all of
# the appropriate attributes. Note you must also include the viewport size. 
tilemap = tmx.load('myMap.tmx', screen.get_size())

# You must set the focus of the tilemap view to an x, y coordinate. This 
# tells the tmx library where to center its view. Usually this would be set 
# to the starting position of the main player's sprite.
tilemap.set_focus(0, 0)
clock = pygame.time.Clock()

# Main game loop
while 1:
    dt = clock.tick(30)
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
    # tilemap.update calls the update method on each layer in the map.
    # The update method can be customized for each layer to include logic
    # for animating sprite positions, and detecting collisions.              
    # Fill the screen with an R,G,B color to erase the previous drawings.
    # Draw all layers of the tilemap to the screen.
    # Refresh the display window. 

Running Examples

Make sure you are in the examples directory, then run the python file of the example you'd like to see.

$ cd tmx/examples
$ python3


A TMX map library for python3 and pygame







No releases published


No packages published