Tile GID Split

Keep flipped tiles when a game loader cannot read packed IDs

When you flip a tile in Tiled, its tile layer stores the flag in the high bits of the global ID. A loader that clamps large values to its biggest signed integer can lose the tile ID before it sees the flags.

Open Tile GID Split

Check horizontal and vertical flags independently

Input

[6, 2147483654, 1073741830, 0]

Output

ids:   [6, 6, 6, 0]
flags: [0, 8, 4, 0]

The three visible cells all use global ID 6. The second is horizontal (8). The third is vertical (4). The fourth cell is empty. In CSV, the corresponding flag columns are 1 or 0, so there is no packed value to decode.

Check the result

  1. Paste the sample row, split it, and enable Flipped tiles only. The preview shows cell (1, 0) as H and cell (2, 0) as V. Download split JSON and check both arrays still contain four entries.
  2. Create a small map with one unflipped tile, one flipped tile and one empty cell. Compare the cells in Tiled with the layer and coordinates in the split CSV.
  3. Update your loader to read ids and flags at the same index. With multiple tilesets, subtract the highest eligible firstgid from positive IDs to get the index within a tileset.

Common problems

Select the correct layer format

Set Tile Layer Format to CSV in Tiled and save as TMJ. A Base64 layer stores bytes inside a string, which this tool reports as an unsupported input.

Check map orientation before rendering flags

On orthogonal and isometric maps the value 2 is a diagonal flip. In Tiled, apply diagonal before horizontal and vertical. On hexagonal maps, the values 2 and 1 are 60-degree and 120-degree clockwise rotation flags.

Keep the source map

The split file is a custom tile-data export. Keep the TMJ for editing and for any object layers or custom properties your game still needs.

Using Tile GID Split

Save the source in Tiled

Set the layer storage format to CSV and save as a TMJ file to get native JSON arrays.

Open the TMJ and split the IDs

Choose a layer and optionally filter to cells with flags.

Save split JSON or CSV

Split JSON contains all layers and chunks. CSV records coordinates and flag columns for the selected block.

Offline use

Open the tool once online and let it finish loading. Use the install option in your browser or Add to Home Screen on iPhone. Reopen the tool to process a new input offline.

References