https://github.com/insoft-uk/xtiled

A command-line tool that converts a tile-based image into a TMJ (Tiled Map Editor JSON) file by generating a tileset and map layout automatically.
https://github.com/insoft-uk/xtiled

generator json tiled tiled-map-editor tiles tileset tmj

Last synced: 15 days ago
JSON representation

A command-line tool that converts a tile-based image into a TMJ (Tiled Map Editor JSON) file by generating a tileset and map layout automatically.

• Host: GitHub
• URL: https://github.com/insoft-uk/xtiled
• Owner: Insoft-UK
• License: mit
• Created: 2024-12-10T21:06:17.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-12-17T05:04:21.000Z (over 1 year ago)
• Last Synced: 2025-03-31T14:18:26.864Z (about 1 year ago)
• Topics: generator, json, tiled, tiled-map-editor, tiles, tileset, tmj
• Language: C++
• Homepage:
• Size: 157 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


# TMJ File Generator

A command-line tool that takes an image composed of tiles and generates a TMJ (Tiled Map Editor JSON) file. This utility automates the process of creating a tileset and map data from a tile-based image, making it easy to integrate into Tiled-based workflows for game development and level design.

Features

    •    Automated Tileset Creation: Extracts unique tiles from the input image.

    •    Map Layout Generation: Builds a map structure representing the arrangement of tiles in the input image.

    •    TMJ File Output: Outputs a ready-to-use TMJ file compatible with the Tiled Map Editor.

Usage

Run the tool via the command line, specifying the input image and output file:

xtiled input-image.png -o output-file.tmj

Example

xtiled level.png -o level.tmj

This command processes the level.png image, generates a tileset and map data, and saves them as a level.tmj file.

Requirements

    •    A tile-based input image (e.g., PNG).

    •    Compatible with standard TMJ file specifications.

Why Use This Tool?

This tool streamlines the workflow of creating TMJ files directly from graphical assets, eliminating manual tileset creation and enabling faster iteration for developers and designers.

> [!NOTE]

The only image file format currently supported by this utility tool is the Portable Network Graphic (PNG) format.