tile_bank_create - ryzom/ryzomcore GitHub Wiki


title: Creating the tile bank description: Step-by-step guide to creating a tile bank using tile_edit.exe published: true date: 2023-03-16T23:02:14.195Z tags: editor: markdown dateCreated: 2022-03-13T04:50:36.346Z

This guide walks through creating a tile bank using tile_edit.exe. Screenshots have red highlighted areas to indicate the relevant button or area of the interface.

See tile bank for an explanation of the tile bank structure, and tile textures for how to create the texture files.

Launch

Launch the tile editor (tile_edit.exe). You should see the main tile bank manager window:

Tile bank manager main window showing land and tileset lists, with buttons for Add/Del/Edit land, Add/Del/Edit tile set, Choose Veget, Up/Down ordering, Surface data field, and Load/Save/Export at the bottom

Click the button next to Absolute path and set it to the directory containing your tile textures (e.g. Y:\ryzomcore\graphics\landscape\_texture_tiles\). This path is stored in the .bank file and is used to locate tile bitmaps at runtime.

Adding a land

Click Add land to create a new land. Enter the name you want for this land.

Tile bank manager with the Add land button highlighted

Enter a name dialog

Adding a tileset

Click Add tile set to create a new tileset. Enter a name for the tileset (e.g. "grass", "rock", "dirt").

Tile bank manager with the Add tile set button highlighted

Enter a name dialog

Editing a tileset

Select a tileset in the lower list and click Edit tile set to open the tile browser. This is where you add all the tile textures for a material.

Tile bank manager with the Edit tile set button highlighted

The tile browser has several control groups on the left side:

Tile browser window showing Texture, Size, Texte info, Tiles, and Subtile set control groups on the left, with the tile grid on the right

  • Texture — select which channel to add or view: Diffuse, Additive, or Alpha (alpha is only available for transitions).
  • Size — controls the display size of tile thumbnails in the editor (Small, Normal, Big).
  • Texte info — choose whether to display the tile's index number or filename below each thumbnail.
  • Tiles — switch between tile types: 128x128, 256x256, Transitions, or Displace (displacement maps).
  • Subtile set — assign tiles to one or more of 12 groups (Group 0–11). These groups can be used by the landscape painter plugin to filter which tiles are available when painting.
  • Oriented — when checked, tiles in this tileset have a fixed orientation and will not be randomly rotated during painting.

Adding diffuse tiles

  1. Select Diffuse in the Texture group.
  2. Select 128 x 128 or 256 x 256 in the Tiles group, depending on your texture size.

Tile browser with Diffuse selected and 256x256 tile size

Tile browser with Diffuse selected and 128x128 tile size

  1. Right-click on the empty tile area and select Add... from the context menu.

Context menu showing Add, Replace, Del bitmap, Del tile

  1. Browse to your TGA tile image and open it.

File open dialog filtered to Targa bitmap (*.tga)

Tile TGA images must be saved as uncompressed. {.is-warning}

Repeat this process with Additive selected to add the additive channel textures for each tile.

Adding transition tiles

Transitions require all three channels: diffuse, additive, and alpha. The tile browser shows a grid of 48 transition slots (8 rows of 6).

  1. Select Transitions in the Tiles group.

Transition diffuse and additive

  1. Select Diffuse (or Additive) in the Texture group.

Tile browser showing Transitions with Diffuse selected — 48 empty transition slots

  1. Click on the transition slot you want to fill.

First transition slot selected (highlighted in red)

  1. Right-click and select Replace... to assign a texture to that slot.

Context menu showing Replace highlighted

  1. Browse to the TGA file.

File open dialog

Transition alpha

  1. Select Alpha in the Texture group.

Tile browser showing Transitions with Alpha selected

  1. Click a transition slot, right-click, and Replace... to assign the alpha map.

First alpha transition slot selected

You can use the Batch load... button to load all 12 unique alpha transitions at once. The tool will automatically generate the remaining 36 by rotation. See tile textures — naming conventions for the required file naming. {.is-info}

Adding displacement maps

  1. Select Displace in the Tiles group.

Tile browser showing Displace view with 16 displacement map slots arranged in three rows

  1. Right-click on a slot and use Replace... to assign a 32x32 grayscale TGA displacement map.

Each tileset has 16 displacement map slots. These define micro-height variation on the landscape surface. See tile bank — displacement maps for details.

Assigning tilesets to a land

After editing your tilesets, you need to assign them to a land. A land defines which tilesets are available together when painting terrain.

  1. Select a land in the upper list and click Edit land (labelled "Edit tile set" in the upper button group — this is the button next to the land list, not the tileset list).

Tile bank manager with the upper Edit tile set button highlighted (this edits the selected land)

  1. In the "Tile sets use by Tilebank" dialog, select a tileset from the dropdown.

Tileset assignment dialog showing a dropdown to select a tileset

  1. Click Add to add the selected tileset to the land.

Tileset assignment dialog with the Add button highlighted

  1. Click OK when done.

Tileset assignment dialog with the OK button highlighted

Other tileset settings

Back in the main tile bank manager window, there are additional settings for the selected tileset:

  • Choose Veget — assign a vegetation descriptor file (.vegetdesc) to this tileset. This defines which vegetation shapes are procedurally spawned on tiles of this material. See vegetation sets.
  • Surface data — a 32-bit integer value associated with this tileset, used by gameplay code (e.g. for footstep sounds or movement speed modifiers).
  • Up / Down — reorder tilesets within the bank.

Saving

Use Save or Save as... to write the tile bank to a .bank file. Use Export... to export the tile bank data.

Terminology

Term Description
Tile bank A file containing lands and tilesets
Land A named group of tilesets that can be used together on terrain
Tileset A set of tiles representing one surface material
Tile A 128x128 or 256x256 pixel terrain surface texture
Transition A set of 48 alpha-blended tiles for smooth transitions between tilesets
Displacement A 32x32 grayscale map for micro-height variation
TGA Uncompressed Targa image format used for tile textures
DDS Compressed texture format used at runtime (converted from TGA at build time)
⚠️ **GitHub.com Fallback** ⚠️