autotyler

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #llm #docker #java #awesome-list #vue #pytorch #security #mcp #ios #openai #open-source

(★ 50)

An autotile tilemap generator written in Rust

autotyler Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Deprecated. Use https://wareya.github.io/webtyler/ (web version) instead.

# autotyler

Autotyler is a program that turns small "incomplete" tilemaps into complete godot 3x3 minimal autotile tilemaps, including support for configuring edge sizes.

Licensed under the Apache license, version 2.0.

Download here: https://github.com/wareya/autotyler/releases

In: ![in_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/basic.png)

Out: ![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/basic_output.png)

## Why?

Existing tools for this generally don't allow you to specify how much of the tile is taken up by edges. This means that they could chop off parts of edges when copying them onto other tiles, particularly when using platformer tilesets where having edges wider than half the tile is very common. For example, [Godot Autotiles Assembler](https://github.com/lunarfyre7/GodotAutotileAssembler) assembles this input:

![minitiles](https://raw.githubusercontent.com/wareya/autotyler/master/readme/nat_minitiles.png)

something like this:

![minitiles](https://raw.githubusercontent.com/wareya/autotyler/master/readme/nat_mini_out_raw.png)

while autotyler can assemble it like this, using `edges=8,12,8,4`:

![minitiles](https://raw.githubusercontent.com/wareya/autotyler/master/readme/nat_mini_out.png)

(Example adapted from [this entry on opengameart](https://opengameart.org/content/2d-nature-platformer-tileset-16x16))

Also, autotyler supports more commonly-shaped input formats (3x3 and 4x4), and also a pathetically small input format (literally just two tiles).

There are seven algorithms with varying levels of sophistication, as below:

### basic

![in_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/basic.png)

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/basic_output.png)

Or:

![in_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/basicborder.png)

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/basic2_output.png)

### basic_border

![in_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/basicborder.png)

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/basicborder_output.png)

(This example's input tiles are inspired by, but are not based on, a pair of tiles from [this entry on opengameart](https://opengameart.org/content/tiny-16-basic))

### 3x3

![in_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/3x3.png)

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/3x3_output.png)

or with edges=8,6,8,10:

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/3x3_output_edges_8,6,8,10.png)

### 3x3plus

![in_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/3x3plus.png)

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/3x3plus_output.png)

or with edges=8,6,8,10:

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/3x3plus_output_edges_8,6,8,10.png)

### 4x4

![in_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/4x4.png)

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/4x4_output.png)

### 4x4plus

![in_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/4x4plus.png)

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/4x4plus_output.png)

### minitiles

![in_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/minitiles.png)

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/minitiles_output.png)

![in_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/minitiles2.png)

![out_basic](https://raw.githubusercontent.com/wareya/autotyler/master/examples/minitiles2_output.png)

The minitiles algorithm has the same input as https://github.com/lunarfyre7/GodotAutotileAssembler

## Usage
```
autotyler <infile> <outfile> <options> [tile list]

options:
  mode=basic | basic_border | 3x3 | 4x4 | minitiles
    The algorithm used to generate the tilemap.
      basic: 2 tiles, see examples. (default)
      basic_border: 2 tiles, see examples.
      3x3: 9 tiles, see examples.
      3x3plus: 10 tiles, see examples.
      4x4: 16 tiles, see examples.
      4x4plus: 17 tiles, see examples.
      minitiles: 5 tiles, see https://github.com/lunarfyre7/GodotAutotileAssembler and examples.
  size=N
    The height and width of the tile in pixels. Currently only support square tiles.
  edges=LEFT,TOP,RIGHT,BOTTOM | LEFT,TOP | LEFT
    The amount of space taken up by edges. Omitted dimensions are generated by subtracting the opposite dimension from the tile size, or by copying the adjacent edge. Only minitiles is guaranteed to work with edges settings where opposite edges don't add up to the tilesize.
  offset=N,N
    The offset, in TILES (not pixels), from the top left corner of the screen from which to search for tiles. Useful for using the same input tilesheet to generate many tilemaps.
  border=N
    Used exclusively by the basic_border algorithm. The default is 2.

Do not place spaces around the = when specifying options.

tile list:
  The basic, basic_border, and minitiles modes allow you to list arbitrary tile coordinates to grab tiles from. For basic, basic_border, and minitiles moeds, this is a list of tiles from the top left of the image to the other side. For 3x3 and 4x4 modes, it's the location of the top left tile. For the plus modes, it's the top left tile followed by the plus tile.
  Example:
    autotyler basic.png out.png size=32 offset=4,1 0,0 0,2
This gets the first tile from 4,1 and the second tile from 4,3.

The tile list is optional.
```

## Output

The output is a tilemap set up for godot 3x3 minimal autotiling with this bitmask:

![bitmask](https://raw.githubusercontent.com/wareya/autotyler/master/readme/out%20bitmask.png)

## Modes

The seven algorithms take these kinds of inputs, in terms of autotile bitmasks:

### basic

![bitmask](https://raw.githubusercontent.com/wareya/autotyler/master/readme/2x1%20bitmask.png)

### basic_border

![bitmask](https://raw.githubusercontent.com/wareya/autotyler/master/readme/2x1%20bitmask.png)

### 3x3

![bitmask](https://raw.githubusercontent.com/wareya/autotyler/master/readme/3x3%20bitmask.png)

### 3x3plus

![bitmask](https://raw.githubusercontent.com/wareya/autotyler/master/readme/3x3plus%20bitmask.png)

### 4x4

![bitmask](https://raw.githubusercontent.com/wareya/autotyler/master/readme/4x4%20bitmask.png)

### 4x4plus

![bitmask](https://raw.githubusercontent.com/wareya/autotyler/master/readme/4x4plus%20bitmask.png)

### minitiles

![bitmask](https://raw.githubusercontent.com/wareya/autotyler/master/readme/5x1%20bitmask.png)

autotyler

autotyler Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

autotyler

autotyler Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README