Prototype/Tile

The prototype docs have moved to a new website with an improved format. This documentation page can now be found here: https://lua-api.factorio.com/latest/prototypes/TilePrototype.html

This wiki page is no longer updated and will be removed at some point in the future, so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback on the forums.

Template:Prototype parent A tile. Only 255 instances of this prototype may be defined.

Mandatory properties

Inherits all properties from PrototypeBase.

Template:Prototype property Specifies transition drawing priority.

Template:Prototype property Graphics for this tile. This has extra properties besides the properties from TileTransitions:

• main - table of TileSprite - Mandatory. Array of TileSprites with the following extra properties:
  • size - uint32 - Mandatory. - Only powers of 2 from 1 to 128 can be used. Square size of the tile arrangement this animation is used for. Used to calculate the width and height of the animation which cannot be set directly. (width or height) = size * 32 / scale.
  • probability - double - Optional. - Default: 1.0 - Probability of 1x1 (size = 1) version of tile must be 1.
  • weights - table of double - Optional. - Array of double.
• material_background - TileSprite - Optional. Width and height are given by the game, setting them will not have an effect. Width and height are calculated from the expected size (32) and the scale. So, for HR tiles at a size of 64x64, the scale needs to be 0.5.

Template:Prototype property Emissions absorbed per second by this tile. Use a negative value if pollution is created instead of removed.

Optional properties

Template:Prototype property One of "zero", "water", "water-overlay", "ground" and "top".

Template:Prototype property Used only for the layer_group default, see above.

Template:Prototype property Name of a tile.

Template:Prototype property Either one Sound or a table with the following optional key/value pairs:

• small - Sound
• medium - Sound
• large - Sound

If the Sound is provided directly, it is loaded as the "small" build sound.

Template:Prototype property Array of tile names that are allowed next to this one.

Template:Prototype property If you want the tile to not be mineable, don't specify the minable property. Only non-mineable tiles become hidden tiles when placing mineable tiles on top of them.

Template:Prototype property Name of a tile.

Template:Prototype property Name of a Prototype/TileEffect.

Template:Prototype property Called by InvokeTileEffectTriggerEffectItem.

Template:Prototype property If set to true, the game will check for collisions with entities before building or mining the tile. If entities are in the way it is not possible to mine/build the tile.

Template:Prototype property If this is not set, the material_background in variants is used as the icon.

Template:Prototype property Used by the pollution shader.

Template:Prototype property Extra transitions. Array of TileTransitions.

Each TileTransitions needs the extra mandatory property to_tiles, which is a table (array) of string which is the name of a tile.
Furthermore, each TileTransitions needs the extra mandatory property transition_group which is a uint8.

Template:Prototype property Array of TileTransitions.

Each TileTransitions needs the extra mandatory properties transition_group1 and transition_group2, which are of uint8.