Iris

Iris is a utility that provides a set of tools to simplify working with maps in RedKit. It is designed for importing texture maps, procedural vegetation generation (currently in development), and slicing and renaming tiles into a format compatible with RedKit (also in development).

Texture Import

The utility allows you to import texture maps created in third-party editors, such as Gaea, into RedKit.

The prepared map must meet the following requirements:

  • The resolution must match the resolution of your map in RedKit.

  • The map must be grayscale, with pixel values ranging from 0 to 255.

You can define which texture corresponds to specific pixel value ranges on the map. For each range, you can configure the following settings:

  • Vertical Texture (the texture number in the list, starting from 1 in TerrainEditTool).

  • Horizontal Texture (the texture number in the list, starting from 1 in TerrainEditTool).

  • Slope Threshold.

  • UV Scale.

Steps for Importing a Texture Map

  • Step 1: Select the Texture Map First, choose the prepared texture map. After selection, the utility will display a preview of the map.

  • Step 2: Select the Folder with Tiles Select the folder containing the terrain tiles (terrain_tiles), located in the directory of your level.

  • Step 3: Add Textures To assign textures, click the "Add Texture" button. This will add a new range to the value scale. You can then click on this range to edit its texture and see how it will be applied.

  • Step 4: Import Textures After completing the setup, the "Import" button will become active. Click it to import the textures.

  • Step 5: Sync LOD in RedKit After importing the map and textures, open or reload your level in RedKit. Navigate to the TerrainEditTool and go to the Materials tab. Click the "Texture usage" button, select the topmost texture, and replace it with the same texture. This step is necessary to synchronize the LODs in the tile files, as the utility writes only the zero LOD. Once this is done, reload the level again.

Texture scale

The scale displays texture ranges. When a range is selected on the scale, it is highlighted in green on the map preview, allowing you to see the area of application. Additionally, when a specific range is activated, you can edit the texture that will be applied to that range.

Hotkeys for scale:

  • Up/Down Arrows: Switch the selected texture on the scale.

  • Insert: Splits the selected range, adding a new texture.

  • Delete: Removes the selected texture.

  • Mouse Wheel Up/Down: Adjusts the texture range.

  • Ctrl + Mouse Wheel Up/Down: Zooms the scale for detailed adjustments.

  • Middle Mouse Button + Drag: Moves the scale up or down when zoomed in.

Backup

The utility automatically creates a backup of your tiles, but only during the first import. These backups are not overwritten in subsequent imports. Backups are saved in a folder created in the same directory as the application's executable file.

Presets

Presets allow you to save scale ranges to a separate JSON file located in the presets folder within the program's launch directory. Saved presets can be loaded to continue working with them later.

Import example

Last updated