Fang Auto Tile is an easy and fully featured auto-tiling system for Unity.
- Rapidity: Fang Auto Tile needs only 5 patterns of tiles defined in the format to generate all 47 adjacent connecting tile patterns.
- Performance: Fang Auto Tile has the powerful tile packer system that packs generated sprites into a single texture. It can help you to reduce rendering passes and improve GPU performance.
- Practicality: Useful features are provided; animation, random, slopes, and additional maps.
- Fang Auto Tile
- Unity 2021.3 or later
Add git URL from Package Manager:
https://github.com/ruccho/FangAutoTile.git?path=/Packages/com.ruccho.fang-auto-tile
Asset page here (there is a time lag in updates): https://assetstore.unity.com/packages/slug/132602
Samples are available in the package information page.
Download a template, or create a image in the size:
- Width: tile size
- Height: tile size * 5
Tile sheets must have 5 tile patterns arranged vertically like this:
An example above is colored for convenience and will be displayed like this:
Import tile sheet and set copression settings to None.
Open create menu on the project view and select Fang > Tile to create a Fang Auto Tile asset.
Open the inspector of created tile asset. Here is a list of the essential settings:
- Main Channel: Set the texture of the tile sheet you have imported.
- One Tile Per Unit: Enable it if your tilemap is in one tile per one unit sizing. Disabling it to customize sizing.
Then click Generate! button.
Place your tile asset on the Tile Palette window and use it!
- Frame Mode: described in 🎞️ Animation / Random section below.
- Animation: described in 🎞️ Animation / Random section below.
- Collision
None: the tile will have no collider.Sprite: the tile will have a collider created from the sprite's physics shape.Grid: the tile will have a collider that fills its tile rect.
- Is Slope: described in ⛰️ Slopes (experimental) section below.
- Connectable Tiles: You can specify other Fang Auto Tiles that this tile should consider connected to.
These settings is used in generation process and don't applied in realtime. To apply them, click Generate! button again.
- Enable Padding: avoids dirty lines appear between tiles. It extrudes the pixels on the outer edge of tiles.
- One Tile Per Unit: automatically sets number of pixels per unit (PPU) to be adjusted to 1 tile per unit. Disabling this will show custom PPU property.
- Physics Shape Generation
Sprite: generates a physics shape from the content of the sprite.Fine: generates a physics shape geometrically simple.
- Wrap Mode: wrap mode of generated tile textures.
- Filter Mode: filer mode of generated tile textures.
- Num Slopes: described in ⛰️ Slopes (experimental) section below.
- Main Channel: tile sheet texture used in generation process.
- Sub Channels: described in 💡 Sub-channels section below.
- Packer: the packer used by this tile. (described in 📦 Packer section below)
Fang Auto Tile supports animated tiles and randomly selected tiles.
To use them, make a tile sheet with frames arranged horizontally.
After generating with the frames, set Frame Mode in Tile Settings to Animation or Random.
With Animation frame mode, additional settings are available in Tile Settings.
- Animation Min Speed: the minimum possible speed at which the animation of the tile is played.
- Animation Max Speed: the maximum possible speed at which the animation of the tile is played.
- Animation Start Time: the starting time of the animation.
You can use multiple channels for your tiles such as nornal maps and emission maps.
Fang Auto Tile generates a texture containing all adjascent combinations of the tile and the texture is used for actual rendering. To use multiple channels with Fang Auto Tiles, all channels have to be baked into each textures.
To work with this, set Sub Channels property in Tile Generation Settings. Sub-channels must be same size as the main channel.
Then click Generate! again and baked textures will appear as sub assets of the tile asset.
Packer is a feature to pack generated textures of multiple tiles into a single texture. It helps you to reduce rendering passes and improve performance.
Open create menu on the project view and select Fang > Packer to create a Fang Auto Tile Packer asset.
Then register Fang Auto Tile assets you want to pack and click Generate! button.
Connector Tile is a invisible tile that can be tricked into thinking it is adjacent to surrounding tiles.
For example, connector tiles can be used to connect multiple divided tilemaps seamlessly.
To create connector tiles, open create menu on the project view and select Fang > Connector Tile.
Connector tiles are invisible but you can make them visible only on the editor by setting the Editor Tint property in the inspector.
Fang Auto Tile can handle auto-tiled slopes.
Note
Slope is a experimental feature and the tile sheet format to define slopes maybe changed in future.
Additional tiles for slopes have to be appended to the tile sheet.
Slopes are appended in order of decreasing size.
First is size=1 section, tiles are arranged as follows:
- ◢ Floor Up
- ◣ Floor Down
- ◤ Ceil Up
- ◥ Ceil Down
Second is size=2 section. From this section, horizonral (2x1) and vertical (1x2) tiles are required. The slope shape order is the same as for size=1. For each shapes, tiles are arranged in order of proximity from corner.
Note
Available sizes of slopes are restricted to the height or the width is 1. (1x1, 2x1, 1x2, 3x1, 1x3, ...) It is because supporting arbitary sizes of slopes makes it too complex to resolve shapes automatically.
After preparing all sections, you have to specify number of slope sections included in your tile sheet and Generate! again.
To set the tile is a slope, enable Is Slope property in Tile Settings.
With slopes, you may want to specify which tiles are slopes and the others are rectangle. You can use Override Tiles feature to create a variant of the original Fang Auto Tile asset that behaves as a slope tile or a rectangle tile.
To create override tiles, open create menu on the project view and select Fang > Override Tile.
- Original: Set original Fang Auto Tile asset.
- Is Slope: Overrides original Is Slope property.
- Editor Tint: Color applied to this tile to distinguish which tiles are overridden on the tilemap. This property is only applied in the edit mode.
This is the example how override tiles work (blue tiles are overridden as rectangle tiles):
The tile sheet format of Fang Auto Tile is the superset of the format used in WOLF RPG Editor by SmokingWOLF, which is a popular game development software especially in Japan. Materials made for WOLF RPG Editor can be used for Fang Auto Tile.