https://github.com/krylphi/autotiler

Unpacks tilesets from a compressed 2x3 tileset
https://github.com/krylphi/autotiler

game-development gamedev godot godot-engine godot4 godotengine pixel-art pixelart tiled tiled-map-editor tilemaps tileset-generator tilesets

Last synced: 12 days ago
JSON representation

Unpacks tilesets from a compressed 2x3 tileset

• Host: GitHub
• URL: https://github.com/krylphi/autotiler
• Owner: krylphi
• License: mit
• Created: 2024-05-20T19:05:55.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-06-09T22:08:57.000Z (7 months ago)
• Last Synced: 2024-11-10T18:09:32.061Z (about 2 months ago)
• Topics: game-development, gamedev, godot, godot-engine, godot4, godotengine, pixel-art, pixelart, tiled, tiled-map-editor, tilemaps, tileset-generator, tilesets
• Language: Go
• Homepage:
• Size: 304 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Autotiler

Unpacks tilesets from a compressed one

Pure go. No external dependencies

## Disclaimer

Project is in alpha state. Was quickly developed to do stuff, so code is not pretty, but functional.

## Features

Autotiler unpacks tileset like this to formats more suitable for map generation (e.g. 16 and 47 wang tilesets):

![packed](./examples/2x3_packed.png)

## How to use

* [get yourself Go](https://go.dev/doc/install)

* clone this repository or download sources.

* put simple tileset image (for example 2x3_packed.png) to source folder

* run ```go run . -in  [-o ] [-p ] [-e ]```

  e.g. ```go run . -in ./examples/2x3_packed.png -o ./out/output.local.png -p 1 -e 16 -e 28 -e 48```

* you can optionally set padding for tiles in px. To do so you need to add desired padding as argument:

  e.g. ```go run . -in ./examples/2x3_packed.png -p 1``` - this will create tilesets with 1 px margin and 2px spacing.

* grab complete tilesets from directory specified in `-o`.

* you can pass several `-in` and `-o` parameters to unpack several tilesets at once. They will match the order. In case there are fewer `-o` parameters, the default name will be used and results will be placed in current directory. 

* alternatively you can just run `make unpack FILE_IN=` and it will place all results in `./out` directory

* don't worry about filenames, as program will automatically prefix output files with necessary information. E.g. for options `-o ./out/output.local.png -e 16` output files will be `./out/16x1_terrain1_output.local.png` and `./out/16x1_terrain2_output.local.png`

* enjoy

* alternatively you can build an application using `make build` command to use it as a standalone application without Go

## Output Examples

16x1 Terrain 1 to 2:

![16x1_T1](examples/output/tileset/16x1_terrain1_output.png)

14x2:

![14x2](examples/output/tileset/14x2_output.png)

14x2 (with 1px padding):

![14x2_padding](examples/output/tileset/14x2_output.padding.png)

12x4 Terrain 2 to 1:

![12x4_T1](examples/output/tileset/12x4_terrain2_output.png)

## Roadmap and plans

- [x] Unpack from 6 tiles to 16 tiles

- [x] Unpack from 6 tiles to 28 tiles

- [x] Unpack from 6 to 47 tiles

- [ ] Unpack from 6 or 16 tiles to 256 tiles

- [ ] Export to Tiled

- [ ] Export to Godot

- [ ] More build options (Win, Mac)

- [ ] Document, prettify code and make application more versatile